BCH Testnet Faucet

The code in this repository creates a minimalistic testnet faucet, used to distribute testnet coins to developers who need them.

The faucet is composed of a minimalist font end single page app (SPA) using jQuery. The back end is a Koa API server based on this koa2 boilerplate. The BCH wallet functionality is implemented by BITBOX, and the testnet donations come from Bitcoin.com.

This application expects a wallet.json file in the root directory. This contains the mnemonic seed required to access the funds the faucet will distribute. You can generate a wallet using this BITBOX example

Requirements

• node ^8.9.4
• npm ^5.7.1

License

MIT

Docker

This server requires a Mongo database, so it uses Docker Compose to run in production. This tutorial shows how to setup Docker. This tutorial shows how to setup Docker Compose. Here are some commands to build and run this application with Docker Compose:

• docker-compose build --no-cache will build the Docker container from scratch. If previously used, this will fail without first deleting the database folder, which is created with root privileges by Docker, so it must be deleted with the sudo rm -rf database command.

• docker-compose up -d will run the server in the background (daemon mode). The server attaches to port 3000 on the host by default.