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
MIT
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 thedatabase
folder, which is created with root privileges by Docker, so it must be deleted with thesudo 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.