useRequestFaucet hook handles the request and returns the transaction details once tokens are sent.
Fund the Active Wallet
The simplest usage funds whichever wallet is currently active. This works well right after wallet creation:Calling
requestFaucetAsync() without a walletId requires an active wallet. If no active wallet is set and no walletId is passed, the hook throws an error.Fund a Specific Wallet
Pass an explicitwalletId to target a particular wallet:
Supported Chains
| Chain | Identifier | Token |
|---|---|---|
| Ethereum Sepolia | ETHEREUM_SEPOLIA | ETH |
The faucet is rate limited to 10 requests per API key per day. Each wallet has a 24-hour cooldown between faucet requests.
Error Handling
The hook surfaces errors through the standarderror field on the mutation result. Common error scenarios:
| Status | Cause |
|---|---|
400 | Invalid request (missing walletId, unsupported chain, or no address) |
403 | Missing or invalid API key |
404 | Wallet not found (also returned when the wallet belongs to a different API key) |
429 | Rate limit exceeded or wallet cooldown active |
500 | Faucet transaction failed |