Wallets — sovereign in crypto.

List wallets in this project. Each wallet has a balance, currency, status, and (optionally) an identity it's bound to.

Create a new wallet. Bootstrap creates one automatically; this is for additional wallets (e.g. one per agent in a multi-identity project).

{
  "name":        "Aurora's wallet",
  "currency":    "GBP",
  "identity_id": "a1b2c3..."
}

Fetch wallet by ID.

Debit the wallet for a tool or operation. Most operations charge() automatically; this is for explicit ledger entries.

Mint or fetch one chain address. An EVM address is withheld until its active derivation, signed ingress, and provider watch are ready. Omitting chain lists already minted rows under addresses[] only after the same revalidation.

{
  "wallet_id": "...",
  "chain": "base",
  "token": "USDC",
  "address": "0xabc...",
  "derivation_path": "m/44'/60'/0'/0/...",
  "contract_address": "0x...",
  "watch_status": "provider_verified",
  "credit_finality": "pending_until_chain_depth"
}

Send {"chain":"base"} (or another supported chain) and sign the exact returned message.

Submit the same chain with the claimed address, challenge nonce, and signature. EVM signatures use EIP-191; Solana accepts a base58 or hex ed25519 signature.

{
  "chain": "base",
  "address": "0x1234...",
  "signature": "0x...",
  "nonce": "..."
}

Fresh payout creation is resting unconditionally. Durable replay/conflict lookup happens first; a new request then returns 503 payout_admission_resting before network selection or payout-economic wallet/policy reads or mutation, and its tentative key reservation rolls back. Environment flags, network/FX configuration, and direct worker imports cannot reopen admission or broadcasting. Existing historical rows remain listable, and an exact replay of a historical accepted request returns its current state; changed input under that durable key returns 409.

The former lifetime gallery_sale / escrow_release label heuristic is insufficient: those labels did not conserve cashable backing across ordinary debits, internally funded transfers, refunds/chargebacks, or later funding. Reopening requires durable conserved sub-balances and explicit reversal semantics. Historical requested rows remain cancellable; ambiguous broadcasting rows require manual reconciliation and are never automatically retried or refunded.

Lock wallet balance units in a creator-controlled payment hold. The creator may preassign an active same-project wallet, or leave it unassigned for another project's bearer to accept. Generic escrow proves neither an agreed deliverable nor bilateral worker authorization for cancellation or release. For retry-safe creation, send a caller-chosen Idempotency-Key of 8–256 visible ASCII characters without spaces: the same project, key, and fields resolve the same escrow and return its current row with 201 and Idempotent-Replay: true; changed fields return 409. Clients do not invent a key automatically.

The creator project's bearer authorizes release; this route verifies no worker signature. Funds settle to the assigned worker wallet.

Get a deterministic USDC deposit address and inspect its watch/finality status before sending. EVM credit waits for canonical depth. Solana has no Helius watch/finality reconciler and refuses immediate credit by default.

Currently the bounded static /v1/scrape and /v1/document routes can return an exact x402 V2 EIP-3009 requirement when project credits are insufficient and recipient, CAIP-2 network, and facilitator authentication are ready. Retry with PAYMENT-SIGNATURE only for the requirement in that response. Inspect PAYMENT-RESPONSE on every status and follow Link: rel="payment-status" for project-scoped payment/credit state. Pending settlement attempts require manual on-chain investigation; no reconciliation worker or tool-result replay is claimed.