Skip to main content
Coming soon · not available yet (Phase 5). The agent wallet is not offered to customers yet, as the identity overview says. The reference below describes the planned surface; do not build on it yet, and expect 501 feature_not_configured where it is not enabled. There is no delete: a wallet is retired by sweep.
Every method takes the identity (an idn_… id or its name) as its first argument. Amounts are integer micro-USD (1 USD = 1_000_000). A persona holds at most one live wallet per network. create names the network in its body; every other method takes a trailing { network } selector (or network alongside the list filters) and works on the testnet wallet (eip155:84532) when it is omitted. No method falls back to the other network: a read on a network with no wallet is not_found.
Move funds:
Pay for a paywalled resource — quote has no side effects, pay spends under the wallet’s caps:
Every write draws a new Idempotency-Key, so a plain retry of fund, transfer, sweep or pay moves the money again. On the retry, pass the first call’s key with the same body instead (the trailing { idempotencyKey }), and the retry returns the first attempt’s answer: wallet.pay(identityId, body, {}, { idempotencyKey: payKey }). A short balance is an ApiError with code validation_failed, never insufficient_credits; a deployment without custody answers feature_not_configured. See the Wallet API for statuses, scopes and errors.