⚛ x402 Quest

A challenge ladder for agent developers. Learn the x402 payment protocol by actually doing it — every quest below touches the live RAEN fleet (12 services on Base mainnet). Finish quests, get on the leaderboard, win free calls.

Quest 1 — Decode a live 402 challenge EASY · 10 XP

Hit a paid endpoint without paying. The server answers HTTP 402 with a base64-encoded challenge header. Decode it and read the real price and payTo address.

curl -s -D headers.txt -o body.txt -X POST \
  https://sentry-forge-x402.fly.dev/scan \
  -H 'Content-Type: application/json' \
  -d '{"target":"example.com"}'

# headers.txt contains: payment-required: 
echo "" | base64 -d | python -m json.tool

Prove it: send us the decoded accepts[0].payTo and maxAmountRequired. (Hint: payTo ends in ...f72f.)

Quest 2 — Map the fleet from llms.txt EASY · 10 XP

Fetch our llms.txt and count the x402 services listed. Agent-native discovery is the point: your agent should read this file, not this page.

curl -s https://bshelby88.github.io/raen-agent-directory/llms.txt

Prove it: reply with the service count and the cheapest paid endpoint you can find.

Quest 3 — Make the fleet's first real settlement MEDIUM · 50 XP

Pick any service, pay a challenge end-to-end with a real x402 client (USDC on Base). The first settled payment in fleet history is currently 0 — check the live counter at Open Telemetry. Settle it and your wallet's payment shows on that stats page within the hour.

New wallet? Use First Call Free — your first call is rebated to net $0, so the quest costs you nothing.

Quest 4 — Ship an integration in public MEDIUM · 50 XP

Wrap one RAEN service in a tool for your agent framework (LangChain, CrewAI, ElizaOS, MCP client — anything). Use the Agent Kit template. Open a PR or gist and send us the link.

Quest 5 — Beat the Manifest Linter's gauntlet HARD · 100 XP

Build your own x402 service and pass Manifest Linter checks 1–8 on the first run: exact scheme, eip155:8453, valid payTo, reachable endpoint, live 402 challenge that matches the manifest byte-for-byte.

Leaderboard & redemption

Send proof to ops@royalruby.io with subject x402 QUEST <N> (a draft — nothing auto-sends). Verified finishers get listed here with their handle + project link, and their next calls on the fleet are rebated net-$0 via the First Call Free rail.

Current leaderboard: empty — the top spot is open. Everything on this page is verifiable right now.