Add Celo rail: USDC on eip155:42220 via the new x402.celo.org facilitator#463
Merged
Conversation
…elo.org facilitator Celo's facilitator went live at api.x402.celo.org (keyless, advertises exact/eip155:42220 at x402 v2). Wires Celo end to end like Monad: - payments.js: celo network, CELO_FACILITATOR_URL (default api.x402.celo.org), money parser for native Circle USDC 0xcebA9300f2b948710d2653dD7B07f33A8B32118C with the on-chain EIP-712 domain name "USDC" / version "2" (verified via forno.celo.org: name(), version(), decimals, EIP-3009 typehash), drop-if-unset safety so an emptied facilitator URL degrades to "not offered", never a broken 402 - rails.js entry (copy layer -> every derived surface), chain-logos mark (Celo's own square/ring-C favicon path), market-page /celo entry, revenue-live read-config (Alchemy celo-mainnet + forno fallback, celoscan links), server SNAPSHOT_RAIL_LABEL, ledger-chrome STATIC_CHAINS (also fixes /monad missing from that fallback list) - paid-canary pinned Celo leg + drain-burner chain, nine-network copy sweep (README, wiki, ecosystem listings) Local e2e: boot with PAYMENT_NETWORKS=base,celo -> facilitator syncs, 402 offers eip155:42220 with the correct asset + signing domain; /celo, /marketplace, /.well-known/x402, /sell all render the rail. test-rails, test-chain-logos, test-canary-coverage, test-discovery, test-x402-economy green. PAYMENT_NETWORKS on Railway already updated (skip-deploys; this deploy picks it up). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…-pages, static-pages) test-market-pages pinned CHAIN_PAGES at 8 entries; now 9 with the Celo rail, plus a celo fixture (network eip155:42220, testnet-off eip155:11142220, celoscan.io) so the page gets the same per-chain rendering assertions as the rest. test-static-pages gains the /celo page. Both suites green locally. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
MikeyPetrillo
temporarily deployed
to
agent402 / production
July 20, 2026 13:07 — with 
GitHub Actions
Inactive
GitHub Actions
Inactive
…ated offer First live canary against the Celo rail surfaced what the facilitator's docs don't mention: /supported and /verify are keyless, but /settle returns 401 "Missing X-API-Key". A keyless Celo offer therefore verifies fine and bounces every buyer at settlement (never charged, but a dead rail). - CELO_FACILITATOR_KEY env: rides verify/settle/supported as X-API-Key via createAuthHeaders (same pattern as the Stellar bearer) - Offer gate: celo is dropped from the offered networks with a loud warning unless BOTH the facilitator URL and the key are set - Keys are free + self-service (sign a no-gas message at x402.celo.org; confirmed live: with the key /settle returns payload validation, not 401, and auth is not payTo-bound). Key set on Railway (skip-deploys). - CLAUDE.md + wiki Self-Hosting document the key requirement Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
MikeyPetrillo
temporarily deployed
to
agent402 / production
July 20, 2026 13:48 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
MikeyPetrillo
marked this pull request as ready for review
July 20, 2026 13:55
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Celo's x402 facilitator is live (https://x402.celo.org, API at api.x402.celo.org — keyless, advertises exact/eip155:42220 at x402 v2). This wires Celo in as the ninth settlement rail, following the Monad pattern.
Payments
celo(eip155:42220) in EVM_NETWORKS, opt-in via PAYMENT_NETWORKSCELO_FACILITATOR_URLdefaulthttps://api.x402.celo.org0xcebA9300f2b948710d2653dD7B07f33A8B32118C— @x402/evm's registry lacks chain 42220, and the on-chain EIP-712 name is "USDC" (not "USD Coin"; verified on-chain via forno.celo.org: name(), version()=2, decimals=6, EIP-3009 typehash present)Marketplace + surfaces
Testing
PAYMENT_NETWORKS=base,celo: facilitator syncs, 402 offers eip155:42220 with the correct asset + signing domain, /celo + /marketplace + manifest renderRailway
PAYMENT_NETWORKSalready updated (skip-deploys) — this deploy picks it up.🤖 Generated with Claude Code