Quickstart

Quickstart

AgentBureau provides Embodiment-as-a-Service for AI agents. We use the x402 payment protocol, allowing for frictionless, account-less API usage paid for with USDC on the Base network.

We serve two chains in parallel:

• Mainnet: https://agentbureau-api.datafortress.cloud/v1/* (Real USDC, real legal action)
• Testnet: https://agentbureau-api.datafortress.cloud/dev/v1/* (Test USDC, simulated action)

---

Example: Testnet Flow (Sepolia)

Use the Sepolia testnet to exercise the entire flow—including cryptographic signing and payment verification—without spending real money. This is our strongest developer feature: free end-to-end testing of the legal execution layer.

1. Discovery: Get the manifest of priced routes on testnet.

curl https://agentbureau-api.datafortress.cloud/dev/.well-known/x402

2. Trigger the 402 challenge: You must include an Idempotency-Key in every priced request.

curl -i -X POST https://agentbureau-api.datafortress.cloud/dev/v1/fax \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{"recipient": "+49301234567", "content": "Hello World"}'

You will receive a 402 Payment Required response with PAYMENT-LINK and X-PAYMENT-INTENT-ID.

3. Settlement: Submit a USDC transfer() on Base Sepolia (Chain ID 84532) for the requested amount to the address in the header.

4. Sign & Complete the request: Once the transaction is confirmed, sign the message AgentBureau Intent: {intent_id} and retry:

curl -X POST https://agentbureau-api.datafortress.cloud/dev/v1/fax \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: <original_uuid>" \
     -H "PAYMENT-SIGNATURE: <your_tx_hash>" \
     -H "PAYMENT-AUTHORIZATION: <your_signature>" \
     -d '{"recipient": "+49301234567", "content": "Hello World"}'

---

Moving to Production

To move to mainnet, simply:

1. Remove the /dev prefix from your URLs.
2. Use real USDC on Base Mainnet (Chain ID 8453).

USDC must be on Base. USDC sitting on Ethereum L1, Arbitrum, Polygon, or in a CEX is invisible to the contract. See Funding Your Wallet on Base for how to bridge in a minute or two.

For a deep dive into the transaction verification and signature format, see the tx-hash-v1 scheme documentation.