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
- node ^8.9.4
- npm ^5.7.1
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-cachewill build the Docker container from scratch. If previously used, this will fail without first deleting the
databasefolder, which is created with root privileges by Docker, so it must be deleted with the
sudo rm -rf databasecommand.
docker-compose up -dwill run the server in the background (daemon mode). The server attaches to port 3000 on the host by default.