Skip to content

docs(x402): use EIP-55 checksummed addresses and require them in edited content #2356

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
palango merged 3 commits into from
Oct 6, 2026
Merged

docs(x402): use EIP-55 checksummed addresses and require them in edited content #2356

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
84cc39d
docs(x402): use the EIP-55 checksummed USDC address
palango Oct 2, 2026
fa545b3
docs(agents): require EIP-55 checksummed addresses
palango Oct 2, 2026
7f4a25a
docs(x402): checksum the USDT address and scope the EIP-55 rule to ed…
palango Oct 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,7 @@ The policy, decided for the restructure: **troubleshooting-first.**
- Self-contained: imports shown, env vars named, network stated in a comment. A reader copies one block and it works.
- Bare language tag, no `title=`, no line highlighting. Use `bash` for shell (not `sh`/`shell`), `ts`/`tsx` for TypeScript (not `typescript`), `js`/`jsx` for JavaScript, `solidity`, `json`, `yaml`.
- Every address in a code block or table carries the network name and, for tokens, the decimals: `// Celo mainnet (42220), USDC, 6 decimals`.
- Write new and edited addresses in their EIP-55 checksummed form; get it from `cast to-check-sum-address <address>`. Mixed case with a wrong checksum breaks copied code: ethers throws `bad address checksum` and viem's `isAddress` returns `false`. Do not sweep old pages just to recase addresses; fix the ones on pages you are already editing.
- Prefer `viem` / `wagmi` examples; they support Celo fee-currency transactions natively.
- Testnet is **Celo Sepolia, chain ID 11142220**. Alfajores (44787) is retired — do not reference it.

Expand Down
8 changes: 4 additions & 4 deletions build/agents/x402.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ const routes: RoutesConfig = {
payTo: "0xYourSellerPayoutAddress", // your wallet — receives the USDC
price: {
amount: "10000", // $0.01 — USDC has 6 decimals; always a string
asset: "0xcEBA9300f2b948710d2653dD7B07f33A8B32118C",
asset: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
extra: { name: "USDC", version: "2" }, // EIP-712 domain, must match the token
},
},
Expand Down Expand Up @@ -192,8 +192,8 @@ The Celo facilitator settles **USDC** and **USDT** via EIP-3009 `transferWithAut

| Token | Address | Decimals |
|-------|---------|----------|
| USDC | `0xcEBA9300f2b948710d2653dD7B07f33A8B32118C` | 6 |
| USDT | `0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e` | 6 |
| USDC | `0xcebA9300f2b948710d2653dD7B07f33A8B32118C` | 6 |
| USDT | `0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e` | 6 |

### Celo Configuration

Expand All @@ -207,7 +207,7 @@ const mainnetAccepts = {
payTo: "0xYourSellerPayoutAddress",
price: {
amount: "10000", // $0.01 — USDC has 6 decimals
asset: "0xcEBA9300f2b948710d2653dD7B07f33A8B32118C", // Celo mainnet USDC
asset: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C", // Celo mainnet USDC
extra: { name: "USDC", version: "2" },
},
};
Expand Down
Loading