React / Node zcash faucet

This is a simple zcash faucet (currently configured to run on testnet, you can change the port in rpc.js for mainnet). You can set it up on any machine running a zcashd fullnode relatively simply.

Prerequisites

• A server running ubuntu (I use a large AWS instance)
• Node 12+. https://github.com/nvm-sh/nvm - Install this per its instructions, then

nvm install v12
nvm use v12

Zcash config

Sync a Zcash node. Edit ~/.zcash/zcash.conf and make sure you have the following configuration:

addnode=mainnet.z.cash
addnode=testnet.z.cash
rpcuser=username
rpcpassword=yourpassword
server=1
listen=1
testnet=1
rpcport=18232
rpcbind=127.0.0.1

Environment configuration:

In faucet-send-server/, create a .env file. The faucet uses a few things, but the most important is your Zcash RPC creds - these authenticate with your full node.

ZCASH_RPC_CREDS=<rpcuser>:<yourpassword>
MASTER_ZADDR=ztestsapling.... (The zaddr that funds faucet payments)
PUSHER_APP_ID=111111111
PUSHER_KEY=4e1xxxxxxxxxxxxa1
PUSHER_SECRET=3d2xxxxxxxxxxxxxx // Pusher notif provider creds - used for delivering txid back to user

app_id = "1126204"
key = "4e18f1b8741914d03145"
secret = "3d2e94c5b0a7d3af6e76"
cluster = "us2"

in faucet-send-server/ run npm i, npm run server (or better, use pm2 to run the server) start the node api. It has two roles: Rate limiting and middle-manning Zcash RPC requests. It has a sqlite db that it uses to count requests and handle rate limiting.

in faucet-react/ run npm run build to build the react app.

Nginx Configuration

You can wire the apps together via nginx thusly:

server {
  server_name faucet.zecpages.com;
  root /home/ubuntu/zcash-faucet/faucet-react/build;
  index index.html;
  location / {
    try_files /maintenance.html $uri $uri/ =404;
  }

  location /api/ {
    proxy_set_header  X-Forwarded-For $remote_addr;
    proxy_set_header  X-Real-IP  $remote_addr;
    proxy_set_header  Host       $http_host;
    proxy_pass http://127.0.0.1:5000/;
  }
}

In this way https traffic to urls matching /api/ is routed to our node app on port 5000. Since the faucet only does one thing, that's not super helpful in this case, but it's super extensible and this node server rpc middleman thing seems to be a road travelled by many greats

Everything else in my nginx conf is just certbot boilerplate.

Assuming your server has http/https open and configured... you should be set to fly and faucet out some coinage. Nice!

Light Wallet

If you can't/don't want to run a full node, check out faucet-send-server/helpers/lightwallet.js for some example helper functions using zecwallet-cli and child processes. You'll also have to add your own zecwallet-cli inside faucet-send-server/ for this to work. There's an example implementation on the light-faucet branch.