wowlet-backend/README.md
dsc 42bb0c832e Feather-ws rewrite;
- Move recurring tasks into their own class; inherits from `FeatherTask`
- CCS proposals: Don't use API, it's broken - webcrawl instead until it is fixed.
- Switch to hypercorn as the ASGI server, *with* support for multiple workers. You can now run feather-ws with, for example, `--workers 6`. See `Dockerfile`.
- Introduce support for various coins under `BlockheightTask`
- Introduce support for various Reddit communities under `RedditTask`
- Introduced weightvoting whilst validating third-party RPC blockheights - where nodes are filtered based on what other nodes are commonly reporting.
- Current blockheights are fetched from various block explorers and weightvoting is done to eliminate outliers under `BlockheightTask`.
- Don't filter/remove bad nodes from the rpc_nodes list; correctly label them as disabled/bad nodes.
- Multiple Feather instances (each for it's own coin) can now run on one machine, using only one Redis instance, as each coins has it's own Redis database index.
- Configuration options inside `settings.py` can now be controlled via environment variables.
- Better logging through custom log formatting and correct usage of `app.logger.*`
- Fixed a bug where one task could overlap with itself if the previous one did not finish yet. This was particularly noticable inside the `RPCNodeCheckTask` where the high timeout (for Tor nodes) could cause the task to run *longer* than the recurring task interval.
- Introduced a `docker-compose.yml` to combine the Feather container with Redis and Tor containers.
- Blocking IO operations are now done via `aiofiles`
2020-12-22 19:07:24 +01:00

1.1 KiB

feather-ws

Back-end websocket server for Feather wallet.

  • Quart web framework, Py3 asyncio
  • Redis

Coins supported

  • Monero
  • Wownero

See also the environment variables FEATHER_COIN_NAME, FEATHER_COIN_SYMBOL, etc. in settings.py.

Tasks

This websocket server has several scheduled recurring tasks:

  • Fetch latest blockheight from various block explorers
  • Fetch crypto/fiat exchange rates
  • Fetch latest Reddit posts
  • Fetch funding proposals
  • Check status of RPC nodes (data/nodes.json)

When Feather wallet starts up, it will connect to this websocket server and receive the information listed above which is necessary for normal operation.

See fapi.tasks.* for the various tasks.

Development

Requires Python 3.7 and higher.

virtualenv -p /usr/bin/python3 venv
source venv/bin/activate
pip install -r requirements.txt

export FEATHER_DEBUG=true
python run.py

Note that run.py is meant as a development server. For production, use asgi.py with something like hypercorn.

Docker

In production you may run via docker;

docker-compose up

Will bind on http://127.0.0.1:1337. Modify docker-compose.yml if necessary.