Multi-chain testnet faucet CLI - get tokens on Starknet and Ethereum testnets
npm install faucet-terminalGet testnet tokens from your terminal
Starknet Sepolia · Ethereum Sepolia
---
``bash`
npm install -g faucet-terminal
`bashEthereum Sepolia (ETH)
faucet-terminal request 0xYOUR_ADDRESS --network ethereum
faucet-terminal req 0xYOUR_ADDRESS -n eth # short version
Example Output
$ faucet-terminal req 0x742d35Cc6634C0532925a3b844Bc9e7595f8fE21 -n eth faucet terminal
network ethereum
[Verification] What is 5 + 7? 12
Correct!
✔ Challenge received
✔ Challenge solved in 32.1s
✔ Transaction submitted!
────────────────────────────────────────────────────────
amount 0.01 ETH
tx 0x6139cd4b...82e8d55f
https://sepolia.etherscan.io/tx/0x6139cd4b...
────────────────────────────────────────────────────────
✔ Tokens will arrive in ~30 seconds
Supported Networks
| Network | Full Name | Aliases | Tokens |
|:--------|:----------|:--------|:-------|
| Starknet Sepolia |
| sn, sn-sep | STRK (default), ETH |
| Ethereum Sepolia | ethereum | eth, eth-sep | ETH |Commands
$3
`bash
Full command
faucet-terminal request --network [--token ]Short version
faucet-terminal req -n [--token ]Shortest version
faucet-terminal r -n
`Examples:
bash
faucet-terminal request 0x123...abc --network ethereum # ETH on Ethereum
faucet-terminal req 0x123...abc -n eth # same, shorter
faucet-terminal r 0x123...abc -n eth # same, shortestfaucet-terminal request 0x123...abc --network starknet # STRK on Starknet
faucet-terminal req 0x123...abc -n sn # same, shorter
faucet-terminal request 0x123...abc --network starknet --token ETH # ETH on Starknet
faucet-terminal req 0x123...abc -n sn --token ETH # same, shorter
`$3
bash
Full command
faucet-terminal status --network Short version
faucet-terminal s -n
`Examples:
bash
faucet-terminal status 0x123...abc --network ethereum
faucet-terminal s 0x123...abc -n eth
`$3
bash
Full command
faucet-terminal info --network Short version
faucet-terminal i -n
`Examples:
bash
faucet-terminal info --network ethereum
faucet-terminal i -n eth
`$3
bash
Full command
faucet-terminal quotaShort version
faucet-terminal q
`$3
bash
Full command
faucet-terminal limitsShort version
faucet-terminal l
`Options
| Option | Short | Description |
|:-------|:------|:------------|
|
| -n | Network to use (required for most commands) |
| --token | | Token to request: ETH, STRK |
| --json | | Output in JSON format |
| --version | -v | Show version |
| --help | -h | Show help |Rate Limits
`
5 requests/day per IP address
1 request/hour per token type (ETH and STRK tracked separately)
24h cooldown after daily limit reached
How It Works
1. Submit address → Validate format for the network
2. Verification → Answer a simple math question
3. Proof of Work → Solve SHA-256 challenge (~30-60s)
4. Receive tokens → Transaction submitted to blockchain
Error Messages
The CLI provides clear error messages when you hit rate limits:
-
- You requested this token within the last hour
- [DAILY LIMIT] - You've used all 5 daily requests
- [FAUCET LIMIT] - Faucet has temporarily reached its distribution limit
- [LOW BALANCE]` - Faucet balance is too lowMIT
---