Skip to main content

Module faucet

Module faucet 

Source
Expand description

Testnet faucet client. Wraps the public Tempo moderato faucet at POST https://docs.tempo.xyz/api/faucet, which returns {"data": [{tx...}]} with one entry per token dispensed (gas token + USDC).

Dev / staging only. Production agents never hit a faucet — the owning human funds the wallet manually at https://wallet.tempo.xyz before the agent posts or settles. Callers must gate on network before calling in; this module does not self-gate because it has no network context of its own.

Scope is narrow on purpose — we POST, parse enough to surface tx hashes to the caller, and return. Balance polling is the caller’s concern (am-c74 is the beads ticket tracking the polling side).

Structs§

FaucetDrop
Summary of one faucet dispense — what token was dropped and the broadcast tx hash, if the faucet surfaced one.

Enums§

FaucetError

Constants§

TEMPO_TESTNET_FAUCET_URL

Functions§

request_testnet_funds
POST to the Tempo moderato faucet for address and return a summary per dispensed token. The faucet response shape varies (gas token + USDC come back as separate entries), so we keep the return loose.