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

**URL:** <https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647>\
**Category:** Zcash Apps\
**Created:** [October 31, 2026, 9:12am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647 "2026-10-31T09:12:18Z")\
**Posts on this page:** 17\
**Page:** 1

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [October 31, 2026, 9:12am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/1 "2026-10-31T09:12:18Z")

</div>

![cover](https://global.discourse-cdn.com/zcash/original/3X/4/9/49957324f2b6beed51690114ec1ddfa9587092e1.jpeg)

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:

```bash
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](https://global.discourse-cdn.com/zcash/original/3X/8/f/8fed7d7abe982946b66550f4ef3ac5ca319a2bfe.gif)

* * *

## 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) |

 ![cli-help](https://global.discourse-cdn.com/zcash/original/3X/0/8/0815aafa59e96ced531b992e528309b34ed8fc2a.png)

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

 ![architecture](https://global.discourse-cdn.com/zcash/original/3X/7/8/783c84cef6bfdbc464910da0491c7927f192dc63.png)

The server wraps [zcash-devtool](https://github.com/zcash/zcash-devtool), the Zcash team’s developer wallet, talking to a public lightwalletd ([testnet.zec.rocks](https://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](https://zcash-faucet.vercel.app)

 ![status-page](https://global.discourse-cdn.com/zcash/original/3X/f/c/fc49f74dcee8273d6c17a03861a81d2960dacb8d.png)

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

- **Code (MIT):** [GitHub - anukulpandey/zcash-faucet: Zcash testnet coins (TAZ) from your terminal: npx zcash-faucet \<address\> · GitHub](https://github.com/anukulpandey/zcash-faucet)
- **npm:** [https://www.npmjs.com/package/zcash-faucet](https://www.npmjs.com/package/zcash-faucet)
- **Status:** [https://zcash-faucet.vercel.app](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!

---

<div class="post-metadata">

**Author:** ![shieldedonly](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/shieldedonly/32/43931_2.png) [@shieldedonly](https://forum.zcashcommunity.com/u/shieldedonly)\
**Post date:** [October 31, 2026, 11:48am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/2 "2026-10-31T11:48:02Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [October 31, 2026, 11:55am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/3 "2026-10-31T11:55:21Z")

</div>

Thanks a lot! @shieldedonly

---

<div class="post-metadata">

**Author:** ![0xoucan](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/0xoucan/32/49962_2.png) [@0xoucan](https://forum.zcashcommunity.com/u/0xoucan)\
**Post date:** [October 31, 2026, 2:44pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/4 "2026-10-31T14:44:35Z")

</div>

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.

🫡

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [October 31, 2026, 2:56pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/5 "2026-10-31T14:56:02Z")

</div>

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!

---

<div class="post-metadata">

**Author:** ![laksh](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/laksh/32/50856_2.png) [@laksh](https://forum.zcashcommunity.com/u/laksh)\
**Post date:** [November 4, 2026, 1:41pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/6 "2026-11-04T13:41:56Z")

</div>

![IMG_20261104_190435720_MF_PORTRAIT](https://global.discourse-cdn.com/zcash/original/3X/4/e/4e708bc9808e6838267d7b59552fe66072a7408a.jpeg)

 ![IMG_20261104_190521009_MF_PORTRAIT](https://global.discourse-cdn.com/zcash/original/3X/1/b/1b8e5fd807604f02a9bf8e9b4d62cc78423c08b9.jpeg)

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

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 4, 2026, 2:27pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/7 "2026-11-04T14:27:25Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![laurel](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/laurel/32/50426_2.png) [@laurel](https://forum.zcashcommunity.com/u/laurel)\
**Post date:** [November 5, 2026, 1:51am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/8 "2026-11-05T01:51:17Z")

</div>

I was looking for something like this, thanks!

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 5, 2026, 11:50am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/9 "2026-11-05T11:50:42Z")

</div>

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`

 ![Screenshot 2026-11-05 at 5.18.58 PM](https://global.discourse-cdn.com/zcash/original/3X/2/8/28204ba6234e381bf87a2a10f63419fe51b55955.jpeg)

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 7, 2026, 4:25pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/10 "2026-11-07T16:25:02Z")

</div>

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 :)))

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 13, 2026, 3:24pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/11 "2026-11-13T15:24:19Z")

</div>

Update: in just 13 days , zcash faucet has been used 73 times.  
Looks like the faucet is working fine 🙂

need more Testnet TAZ, please donate or send on this address

utest1ymhg0safk7cxr2pfygwknmjy304gw0et6430fnxpyjcg9z6f4ep9fvf36axztphnnrnl0neekh2h009jdfuzs4xhr3gftxde267raprwt42a203hxg0udy7e897l4ncc9ea9s0lh80vvdredgvmqac8rtfsvmd04kealacw9dpzcwxl8qnfsww7j9cuqk0d9v25mc5azc2qsvq6r3af

@dismad

 ![Screenshot 2026-11-13 at 8.51.42 PM](https://global.discourse-cdn.com/zcash/original/3X/a/c/acef9e4cef1ce0fdd89e8d54830ae839c9593710.png)

---

<div class="post-metadata">

**Author:** ![dismad](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/dismad/32/18432_2.png) [@dismad](https://forum.zcashcommunity.com/u/dismad)\
**Post date:** [November 13, 2026, 3:35pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/12 "2026-11-13T15:35:09Z")

</div>

> [@anuna](#):
>
> utest1ymhg0safk7cxr2pfygwknmjy304gw0et6430fnxpyjcg9z6f4ep9fvf36axztphnnrnl0neekh2h009jdfuzs4xhr3gftxde267raprwt42a203hxg0udy7e897l4ncc9ea9s0lh80vvdredgvmqac8rtfsvmd04kealacw9dpzcwxl8qnfsww7j9cuqk0d9v25mc5azc2qsvq6r3af

sent! `4e58772d110623477061c7f1ce1931bf0afde50bbb7af5108740ad2e95b58110`

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 13, 2026, 3:45pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/13 "2026-11-13T15:45:28Z")

</div>

yes received! thank’s a lot  
filled faucet for ~620 claims

thanks again

---

<div class="post-metadata">

**Author:** ![laksh](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/laksh/32/50856_2.png) [@laksh](https://forum.zcashcommunity.com/u/laksh)\
**Post date:** [November 15, 2026, 10:40pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/14 "2026-11-15T22:40:21Z")

</div>

@anuna faucet working well. just a small feedback: can you update the Zcash graphic, the current Z is not following the branding. thankyou

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 16, 2026, 5:06am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/15 "2026-11-16T05:06:07Z")

</div>

yes sure mate, will incorporate that. thanks :))

---

<div class="post-metadata">

**Author:** ![anuna](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/anuna/32/49995_2.png) [@anuna](https://forum.zcashcommunity.com/u/anuna)\
**Post date:** [November 17, 2026, 10:18am UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/16 "2026-11-17T10:18:37Z")

</div>

![Screenshot 2026-11-17 at 3.46.19 PM](https://global.discourse-cdn.com/zcash/original/3X/e/f/ef35aa24435afb1da0283f6319cd12ed0bd4ff1b.png)  
17 days done and 105 drips  
good progress ig :))

 ![Screenshot 2026-11-17 at 3.48.13 PM](https://global.discourse-cdn.com/zcash/original/3X/b/1/b1efbd85c25449d2b2380027636cd79627c4c824.png)

weekly downloads on npm

---

<div class="post-metadata">

**Author:** ![Phantom](https://sea2.discourse-cdn.com/zcash/user_avatar/forum.zcashcommunity.com/phantom/32/50724_2.png) [@Phantom](https://forum.zcashcommunity.com/u/Phantom)\
**Post date:** [November 17, 2026, 6:57pm UTC](https://forum.zcashcommunity.com/t/zcash-faucet-testnet-taz-from-your-terminal-with-npx-zcash-faucet-address/58647/17 "2026-11-17T18:57:23Z")

</div>

Nice work on this. The CLI fills a real gap for workshops and CI.

Going by the README, a few things would make it easier to use from scripts and CI jobs:

1. A `--json` flag that prints the result (txid, amount, address, network) as one object, so a pipeline can read the txid without parsing the coloured output.
2. Documented exit codes that separate the failure cases: rate limited for this address, reserve running low, server waking up or unreachable, invalid address. A CI job would retry the cold start but fail fast on the others.
3. An optional `--wait` that polls lightwalletd until the transaction is mined, so the next step of a test doesn’t start before the funds have arrived.

A small one too: the README’s example output still says funds arrive after about 1 block (75s). Testnet is on NU7 with 25s blocks now, so that line may need updating, and the CLI message too if it prints the same text.
