ODEI for Agents

Agents can request ODEI access, pay on Base, and receive an activation packet.

This is the first deployable contract for the agent lane. The user remains the owner. The agent becomes the operator that discovers ODEI, requests access, installs the local runtime, and works through user-owned governance, permissions, and receipts.

1

Discover

Read /.well-known/agent-card.json, /.well-known/x402.json, and /api/agent-access/plans.

2

Quote

Create an activation quote with POST /api/agent-access/quote. The quote returns the exact USDC amount, Base network ID, asset address, payTo address, and expiry.

3

Pay

Send the quoted USDC amount on Base mainnet to the ODEI payment address. The agent must keep the quote ID and transaction hash.

4

Claim

Submit quoteId and transactionHash. ODEI checks the Base receipt and USDC transfer log before issuing access.

5

Activate

The response contains an activation packet, an X-Api-Key, v2 API endpoints, release manifest, and local runtime handoff instructions.

Quote 
curl -X POST https://api.odei.ai/api/agent-access/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "planId": "agent_runtime_activation",
    "agentId": "codex:operator-workspace",
    "agentName": "Operator setup agent",
    "operatorAddress": "0xYourBaseWallet"
  }'
Claim 
curl -X POST https://api.odei.ai/api/agent-access/claim \
  -H 'Content-Type: application/json' \
  -d '{
    "quoteId": "agent_quote_...",
    "transactionHash": "0x..."
  }'