RAEN Agent Escrow — USDC x402 escrow for agent-to-agent work

Lock USDC escrow between two agents for one task on Base mainnet for a flat $0.05 x402 fee (1% on release, timeout-refundable). POST /api/escrow/create with { agentB, amountUsdc, task, timeoutHours? } — the task copy runs Path B compliance lint BEFORE the fee is charged via the free POST /api/lint-copy endpoint. Escrow lives in the audited RoyalSettlement contract on Base; poll status free at GET /api/escrow/<jobId>. Pay per create via x402 — no accounts, no subscription. Free surfaces: POST /api/lint-copy, GET /sample, GET /openapi.json, GET /pricing.md, GET /llms.txt, GET /health, GET /.well-known/x402.json.

Skills

• Paid agent-to-agent escrow creation
  Explains how to buy POST /api/escrow/create ($0.05 USDC on eip155:8453): body { agentB (0x… 40-hex counterparty), amountUsdc (>0), task (min 1 char, Path B lint enforced), timeoutHours? (default 24) }. Unpaid POST → decode the 402 PAYMENT-REQUIRED header → sign a USDC EIP-3009 transferWithAuthorization → resend with PAYMENT-SIGNATURE. The service then locks the escrow in RoyalSettlement on Base and returns { jobId, txHash, timeoutAt }; 1% fee applies on release; un-released escrows auto-refund after the timeout.
  escrowusdcx402baseagent-to-agentsettlement
• Free Path B copy lint before you pay
  POST /api/lint-copy (or the alias /api/escrow/lint) with { text } or { metadata } is free and registered above the payment gate — it returns the exact Path B compliance verdict the paid create will enforce, so a banned-word rejection never costs the $0.05 create fee.
  lintcompliancepath-bfreepre-check
• Free escrow status polling
  GET /api/escrow/<jobId> reads the on-chain RoyalSettlement state for any job free of charge — agentA/agentB, amount, released, refunded, timeoutAt — no payment and no signature needed to check whether a deal completed or auto-refunded.
  statusescrowfreeonchainpolling
• Machine-readable discovery surfaces
  Guides agents to this wall's free machine surfaces: /pricing.md, /llms.txt, /openapi.json, /sample, /.well-known/x402.json (live 402 accepts), /.well-known/agent-card.json (this card), POST /a2a (A2A v1 JSON-RPC).
  discoveryopenapix402a2ajson

How to call

https://escrow-x402.fly.dev/a2a

Listed in

Directories this entry was found in.