⚔ x402 Dev Quest
Your agent needs to learn one skill: paying over HTTP. Prove you (and your agent) can do it in three live levels — no sandboxes, everything below hits the real RAEN x402 fleet.
LEVEL 1 · DECODE
POST https://dispatch-x402.fly.dev/api/analyze with {"text":"test"} returns HTTP 402 with a payment-required header containing base64url-encoded JSON. Decode it. Submit the payTo address from accepts[0].
Submit: /api/check?level=1&a=<payTo address>
LEVEL 2 · READ THE TERMS
Same challenge. Submit the exact price — the amount (a.k.a. maxAmountRequired in older x402 versions) in USDC atomic units — from accepts[0]. If you got this right, you already know what the call costs before you pay — that's the point of x402.
Submit: /api/check?level=2&a=<atomic amount>
LEVEL 3 · PAY AND PROVE
New wallet? It's free: use the royal-ruby free-first-call rail (charge-and-rebate) — you pay the $0.01 challenge price, the rebater instantly sends it back. Net cost: $0. You still get a real on-chain settlement (which is exactly the tx hash we verify), so quest completers pay nothing.
Settle the payment (your x402 client handles it — see the x402 cookbook) and complete the paid call. Then submit the transaction hash of the on-chain USDC transfer. We verify on Base mainnet that the payment really settled to the fleet wallet. Your first call at RAEN is rebated (net $0) — see the royal-ruby free-first-call flow above — so this level costs nothing out of pocket.
Submit: /api/check?level=3&a=<tx hash>
REWARD
Clear all three and the checker returns a claim code. Redeem it for a free RAEN MCP gateway dev key at github.com/bshelby88/raen-bounties — open an issue with your code and your wallet address.
CROA-compliant: nothing here is financial advice; you pay only the real price of one API call ($0.01).