Hi everyone ![]()
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.

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
--statusshows the reserve getting low, a top-up keeps it alive for everyone.
How you can help
- Donate TAZ if you have spare:
npx zcash-faucet --donate. - Running a hackathon or workshop? Reply or DM me and I’ll tune the limits for your event.
- Try it and tell me what breaks: issues and PRs welcome.
Links
- Code (MIT): GitHub - anukulpandey/zcash-faucet: Zcash testnet coins (TAZ) from your terminal: npx zcash-faucet <address> · GitHub
- npm: https://www.npmjs.com/package/zcash-faucet
- Status: https://zcash-faucet.vercel.app
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!






