This is a testnet faucet for the BCH network.
Branch: master
Clone or download
Pull request Compare This branch is 5 commits ahead of christroutner:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Added balance. Increased consolidation time to 3 hours Nov 9, 2018
config Fixing docker networking Oct 21, 2018
front-end Updating intended URL path for front end Oct 21, 2018
src Adding unresticted sending of BCH to the faucet, for testing Nov 9, 2018
test Replaced bcrypt with bcryptjs as a dependency Oct 16, 2018
util Fixing serious bug Oct 21, 2018
.editorconfig first commit from fork Oct 16, 2018
.eslintrc.json Fixing utxo consolidation bug seen in dry-run Oct 21, 2018
.npmrc first commit from fork Oct 16, 2018
.travis.yml first commit from fork Oct 16, 2018
Dockerfile Updating repo used in Dockerfile Nov 9, 2018
LICENSE first commit from fork Oct 16, 2018 Minor update to readme Oct 22, 2018
docker-compose.yml Verified network settings. Incorporating Oct 21, 2018
index.js first commit from fork Oct 16, 2018
install-mongo Adding docker-compose to handle mongodb Oct 21, 2018
package.json Updating README Oct 21, 2018
start-production Moving to master to finish debugging docker Oct 21, 2018

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

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-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.