Zcash-faucet: testnet TAZ from your terminal with npx zcash-faucet <address>

Hi everyone :waving_hand:

Getting testnet coins keeps coming up on this forum: hackathon teams, Zecathon projects, “Requesting testnet TAZ!” threads. The web faucets help, but there was no way to get TAZ from a terminal, a script or a CI job. So I built one:

npx zcash-faucet <your-testnet-address>

That’s it. No account, no captcha: your machine mines a short proof-of-work (about 10-60 seconds), and 0.1 TAZ goes to your address as a real shielded testnet transaction.

demo


What it does

  • Every address type: unified (utest1…), Sapling (ztestsapling1…) and transparent (tm…). Mainnet addresses are rejected before anything is sent.
  • Nothing to install: needs Node 24.7+, and the CLI has zero dependencies.
  • 0.1 TAZ per address every 24 hours.
Command What it does
npx zcash-faucet <address> Mine a proof-of-work, get 0.1 TAZ
npx zcash-faucet --status Health, balance, claims left
npx zcash-faucet --donate Address to send leftover TAZ back to
npx zcash-faucet <address> --github Optional: skip mining by approving a GitHub login (no permissions, revoked right after)

Why it shouldn’t die like earlier faucets

  • Memory-hard proof-of-work (Argon2id). Each hash needs 19 MiB of memory, so GPUs and bot farms gain little over a laptop. Every challenge is signed for one address, pays once, and gets harder when claims spike.
  • No IP limits. Limits follow addresses, so a whole classroom on one campus Wi-Fi can claim.
  • Small, capped payouts. 0.1 TAZ per claim plus a daily cap.
  • Visible health. A public status page shows the live balance, and a monitor checks it every 5 minutes and opens a GitHub issue if it’s down or running dry.

It has already had a community security review: v1.1 hardened the GitHub login, and v1.2 made proof-of-work the default so no identity is needed at all. Thanks to everyone who pushed on that.

How it works

The server wraps zcash-devtool, the Zcash team’s developer wallet, talking to a public lightwalletd (testnet.zec.rocks). No full node to babysit. The server is one small Node file using only the standard library.

Status page: https://zcash-faucet.vercel.app

Run your own, or go fully local

  • Regtest mode: run the same server against your own local Zebra + Zaino network. No dependency on anyone’s faucet, including this one.
  • Your own testnet faucet: Docker image plus a one-command deploy, handy if your hackathon wants its own tap with its own limits.

Honest limits

  • It runs on a free hosting tier: after a quiet period, the first request can take a minute or two while the server wakes up.
  • It runs on donated TAZ. If --status shows the reserve getting low, a top-up keeps it alive for everyone.

How you can help

  1. Donate TAZ if you have spare: npx zcash-faucet --donate.
  2. Running a hackathon or workshop? Reply or DM me and I’ll tune the limits for your event.
  3. Try it and tell me what breaks: issues and PRs welcome.

Links

Thanks to the zcash-devtool maintainers and zec.rocks for the infrastructure, and to @Giri-Aayush, whose web faucet set the bar. This is a terminal and CI complement to it, not a replacement.

Happy building!

3 Likes

This looks awesome, @anuna! I’ll have to give this a try! :slight_smile: I love how the website mirrors a terminal and displays the faucet commands as output. Keep up the great work! :shield: :+1:

Thanks a lot! @shieldedonly

1 Like

Looks awesome. When I started the LeekWallet project I struggled getting TAZ and this is a very well intended solution for people trying to test and build with the Zcash stack.

Will be looking forward into tools that easy the dev onboarding process.

:saluting_face:

means a lot sir!
i am planning to work on full dev tooling suite for zcash. will keep everyone updated!
thanks for acknowledging the solution!

1 Like

Thankyou, the faucet was really helpful for fellow builders at webzero free society hackathon Mumbai:) keep building more tools :fire:

2 Likes

it was great to meet u, glad you liked the faucet haha

1 Like

I was looking for something like this, thanks!

1 Like

Update: faucet performing well, 43 community members used it so far
if you want to support the faucet, please send some testnet tokens at

utest1ymhg0safk7cxr2pfygwknmjy304gw0et6430fnxpyjcg9z6f4ep9fvf36axztphnnrnl0neekh2h009jdfuzs4xhr3gftxde267raprwt42a203hxg0udy7e897l4ncc9ea9s0lh80vvdredgvmqac8rtfsvmd04kealacw9dpzcwxl8qnfsww7j9cuqk0d9v25mc5azc2qsvq6r3af

1 Like

Update: if you do not have a testnet wallet u can use a new tool i just made

npx zcash-testnet-wallet just run this and it will create a testnet wallet and fund it with the faucet we already have :)))

1 Like