Faucet API
Base URL: https://rpc.testnet.16ane.net/faucet. The machine-readable contract is the
OpenAPI file.
For a walkthrough, see Get free ANE.
| Request | Answer |
|---|---|
GET /v1/info |
chain_id, faucet_address, and each tier’s drip_wei, cooldown_secs, pow_difficulty, daily_quota |
GET /v1/challenge |
token, difficulty (leading zero bits), expires_at (Unix seconds), algorithm (the rule in one line) |
POST /v1/fund |
{"address", "challenge"?, "nonce"?} → tx_hash, address, amount_wei, tier |
GET /healthz |
status, chain_id, faucet_address, balance_wei |
Amounts are decimal wei strings ("1000000000000000000" is 1 ANE), so nothing loses
precision. POST /v1/fund returns once the transaction is sent; it is mined within a block or two.
Errors
Section titled “Errors”Every error is {"error": "<code>", "message": "...", "retry_after": <secs>?}. Rate limits (429)
also carry a Retry-After header.
| Status | error |
|---|---|
| 400 | invalid_body, invalid_address, pow_required, pow_insufficient, challenge_invalid, challenge_expired, challenge_used |
| 401 | invalid_api_key |
| 429 | cooldown (anonymous), quota_exhausted (API key) |
| 503 | send_failed: the node or wallet is unavailable; limits are not used up |