Quickstart

AgentChain verifies agent actions and produces permanent cryptographic receipts on Base. Every verified action is attested on-chain via EAS and pinned to IPFS — giving you a tamper-proof audit trail. This quickstart uses the REST API directly — no SDK required.

Step 1 — Get an API Key

Your API key: ac_live_xxxxxxxxxxxxxxxxxxxx

Testnet only. All activity runs on Base Sepolia (chain ID 84532). No real funds are involved.

Step 2 — Fund Your Wallet

Call the faucet to mint MockUSDC to your wallet and pre-fund the payment gate:

curl -X POST https://api.agentchain.xyz/api/v1/faucet/usdc \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYOUR_WALLET_ADDRESS", "amount": 10}'

const res = await fetch('https://api.agentchain.xyz/api/v1/faucet/usdc', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.AGENTCHAIN_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ wallet: '0xYOUR_WALLET_ADDRESS', amount: 10 }),
});

const { paymentAddressTxHash, devWalletTxHash, creditsAdded } = await res.json();

import requests

resp = requests.post(
  'https://api.agentchain.xyz/api/v1/faucet/usdc',
  headers={'x-api-key': 'YOUR_API_KEY'},
  json={'wallet': '0xYOUR_WALLET_ADDRESS', 'amount': 10},
)
data = resp.json()

Field	What it is
`devWalletTxHash`	MockUSDC minted to your wallet
`paymentAddressTxHash`	MockUSDC minted to the payment gate on your behalf
`creditsAdded`	Off-chain credits loaded (default: 10)
`instructions`	Pre-built `X-402-Payment` header value — copy this for Step 3

Rate limit: 1 faucet call per wallet per 24 hours (100 USDC max).

Step 3 — Submit an Action for Verification

Pass the paymentAddressTxHash from Step 2 as the X-402-Payment header. The payload must be an EVMActionPayload containing the pre-state root, executed transactions, and the deterministic effectClaimHash.

# Build the payment header
PAYMENT_HEADER=$(echo -n '{
  "txHash": "0xYOUR_PAYMENT_TX_HASH",
  "payer": "0xYOUR_WALLET_ADDRESS",
  "amount": "10000000",
  "chainId": 84532
}' | base64)

curl -X POST https://api.agentchain.xyz/api/v1/tasks/submit \
  -H "x-api-key: YOUR_API_KEY" \
  -H "X-402-Payment: $PAYMENT_HEADER" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "evm_action",
    "payload": {
      "preStateRootRaw": "0x4b71...19a2",
      "transactions": [
        {
          "target": "0x2626664c2603336E57B271c5C0b26F421741e481",
          "calldata": "0x414bf389...",
          "value": "0",
          "slippageBps": 50
        }
      ],
      "effectClaimHash": "0x88c3...def1"
    }
  }'

const paymentHeader = Buffer.from(JSON.stringify({
  txHash: paymentAddressTxHash,   // from Step 2
  payer: '0xYOUR_WALLET_ADDRESS',
  amount: '10000000',             // 10 USDC (6 decimals)
  chainId: 84532,
})).toString('base64');

const task = await fetch('https://api.agentchain.xyz/api/v1/tasks/submit', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.AGENTCHAIN_API_KEY!,
    'X-402-Payment': paymentHeader,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    taskType: 'evm_action',
    payload: {
      preStateRootRaw: "0x4b71...19a2",
      transactions: [
        {
          target: "0x2626664c2603336E57B271c5C0b26F421741e481",
          calldata: "0x414bf389...",
          value: "0",
          slippageBps: 50
        }
      ],
      effectClaimHash: "0x88c3...def1"
    }
  }),
});

const receipt = await task.json();

Step 4 — Read the Verification Receipt

Every task returns a TaskReceipt immediately. Verification happens asynchronously — poll GET /api/v1/tasks/:id for the final status.

curl https://api.agentchain.xyz/api/v1/tasks/YOUR_TASK_ID \
  -H "x-api-key: YOUR_API_KEY"

const result = await fetch(
  `https://api.agentchain.xyz/api/v1/tasks/${taskId}`,
  { headers: { 'x-api-key': process.env.AGENTCHAIN_API_KEY! } },
);
const {
  status,
  verificationStatus,
  verificationProof,
  verificationBasescanUrl,
  attestationUid,
  easscanUrl,
  ipfsCid,
} = await result.json();

Completed response:

{
  "id": "cm4x7abc123",
  "status": "completed",
  "verificationStatus": "VERIFIED",
  "verificationResult": {
    "stateMatch": true,
    "policyCompliant": true,
    "violationCode": 0
  },
  "verificationProof": "0xabc123...",
  "verificationBasescanUrl": "https://sepolia.basescan.org/tx/0xabc123...",
  "attestationUid": "0xdef456...",
  "easscanUrl": "https://base-sepolia.easscan.org/attestation/view/0xdef456...",
  "ipfsCid": "bafybeif...",
  "latencyMs": 2340
}

Field	What it proves
`verificationProof`	On-chain tx hash — the verification result anchored to TaskMarket
`verificationBasescanUrl`	Direct link to the verification transaction on BaseScan
`attestationUid`	Permanent EAS attestation UID (bytes32) — queryable forever
`easscanUrl`	Public link to view the attestation on EAS Scan
`ipfsCid`	Task context + result pinned to IPFS via the PRIOR protocol

Step 5 — Look Up Attestations

Query all EAS attestations for a task:

curl https://api.agentchain.xyz/api/v1/attestations/YOUR_TASK_ID

{
  "taskId": "cm4x7abc123",
  "count": 1,
  "attestations": [
    {
      "attestationUid": "0xdef456...",
      "schemaType": "ACTION_RECEIPT",
      "status": "VERIFIED",
      "stateMatch": true,
      "policyCompliant": true,
      "toolId": "CANONICAL_MATCH",
      "easscanUrl": "https://base-sepolia.easscan.org/attestation/view/0xdef456..."
    }
  ]
}

What Just Happened?

Every step is auditable. The attestationUid is your permanent, tamper-proof receipt.

Next Steps

Architecture

Understand the full action → policy → verification → settlement pipeline.

Action Verification

How AgentChain verifies EVM state transitions deterministically.

Approval Queue

Configure human-in-the-loop governance for high-value actions.

Guardrails

Rate limits, spend caps, and the emergency kill switch.

Attestations

How EAS Omni-Stamps work and how to query them.

API Reference

Full task submission schema, response types, and all endpoints.

Getting Started

Core Protocol

Infrastructure

Step 1 — Get an API Key

Step 2 — Fund Your Wallet

Step 3 — Submit an Action for Verification

Step 4 — Read the Verification Receipt

Step 5 — Look Up Attestations

What Just Happened?

Next Steps

Architecture

Action Verification

Approval Queue

Guardrails

Attestations

API Reference

​Step 1 — Get an API Key

​Step 2 — Fund Your Wallet

​Step 3 — Submit an Action for Verification

​Step 4 — Read the Verification Receipt

​Step 5 — Look Up Attestations

​What Just Happened?

​Next Steps

Architecture

Action Verification

Approval Queue

Guardrails

Attestations

API Reference

Step 1 — Get an API Key

Step 2 — Fund Your Wallet

Step 3 — Submit an Action for Verification

Step 4 — Read the Verification Receipt

Step 5 — Look Up Attestations

What Just Happened?

Next Steps