Skip to content

docs(x402): list all 10 stablecoins the Celo facilitator settles - #2415

Merged
GigaHierz merged 2 commits into
celo-org:mainfrom
szapelao:szapelao/x402-wfiat-cngn
Oct 30, 2026
Merged

GigaHierz merged 2 commits into
celo-org:mainfrom
szapelao:szapelao/x402-wfiat-cngn

Conversation

@szapelao

Copy link
Copy Markdown
Contributor

The hole, and the fix

The x402 page says the Celo facilitator accepts only USDC and USDT. The live facilitator settles 10 stablecoins: USDC, USDT, and USAT through EIP-3009, and the six Ripio wFIAT stablecoins (wARS, wBRL, wMXN, wCOP, wPEN, wCLP) and cNGN through Permit2.

This PR updates the intro and the stablecoin bullet, replaces the two-row token table with all 10 tokens (transfer method, decimals, EIP-712 extra.name and extra.version), and adds a "Pay with Permit2 tokens" subsection: assetTransferMethod, eip2612GasSponsoring for wFIAT but not cNGN, the exact error 412 permit2_allowance_required, and buyer spend controls.

What this does NOT do / residual risk

  • No code examples were added. The Permit2 settings come from https://x402.celo.org/SKILL.md and the live config, and I did not run a Permit2 payment end-to-end because that needs a funded wallet and an API key.
  • Partner token addresses are not listed, per AGENTS.md. The page links https://x402.celo.org/api/config (paymentAssets) instead.
  • The token list can change; the page points to the live config as the source.
  • Not previewed with mint dev.

Judgement calls

  • Kept the USDC and USDT address rows and added the Permit2 notes as a subsection of the existing "Supported payment tokens" section.
  • Named the issuers (Ripio for wFIAT, WrappedCBDC Limited for cNGN), taken from the Celo Core Co. announcement. Please confirm that wording.

Issues

Refs none.

Stacking / conflicts

Branched off current main. Only build/agents/x402.mdx changes.

Verification evidence

  • npx mint broken-links on this branch: success, no broken links found (exit code 0).
  • Token table compared with https://x402.celo.org/api/config (paymentAssets) on 2026-10-27: all 10 symbols, transfer methods, decimals, and extra names match.
  • Permit2 address checked with eth_getCode on Celo mainnet: code is deployed.

The x402 page said the facilitator accepts only USDC and USDT. It now settles
USDC, USDT and USAT through EIP-3009, and the six Ripio wFIAT stablecoins
(wARS, wBRL, wMXN, wCOP, wPEN, wCLP) and cNGN through Permit2.

Replaces the two-row token table with all 10 tokens, their transfer method,
decimals and EIP-712 domain name and version, and adds a section on the
Permit2 route settings (assetTransferMethod, eip2612GasSponsoring, cNGN
approval, spendControls).

Sources: https://x402.celo.org/api/config (paymentAssets, 2026-10-27) and
https://x402.celo.org/SKILL.md. The Permit2 address was checked with
eth_getCode on Celo mainnet. Partner token addresses are not listed; the page
links the live config instead. No code examples were added.

mint broken-links: success, no broken links found (exit code 0).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@szapelao
szapelao requested a review from a team as a code owner October 27, 2026 17:21
@mintlify

mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 4eec00a.

Approve preview

@GigaHierz GigaHierz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for filling this gap. The token table matches the live paymentAssets config. One change is needed before merge: the page does not use the official wording for USA₮ and USD₮.

  1. Always write USD₮ and USA₮, never "USDT" or "USAT". This applies to the intro paragraph, the "Stablecoin support" bullet and the table's Token column. On-chain, the USD₮ token's symbol() returns USD₮. Keep contract-exact strings such as extra.name (Tether America USD) as they are, because they are EIP-712 domain values.
  2. Describe USA₮ the official way at its first mention: "USA₮, the US Dollar-backed stablecoin issued by Anchorage Digital Bank, N.A., and supported by Tether". Please use it verbatim.
  3. Do not compare USA₮ with USD₮ on regulation or compliance in any follow-up edit.
  4. Where the text describes the wFIAT tokens as regulated, pair it with "fiat-backed".

Not blocking:

  • 412 permit2_allowance_required and the default "$1" buyer cap come from SKILL.md. Please say in the PR whether you ran them.
  • Please confirm the issuer names (Ripio, WrappedCBDC Limited) with the comms owner.
  • feeApplies is false for wARS, wMXN, wPEN and wCLP in the live config. Either document it or note the decision not to.

Write USD₮ and USA₮ in prose and in the Token column, and describe USA₮
the official way at its first mention. EIP-712 extra.name values
(`Tether USD`, `Tether America USD`) stay contract-exact.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@artugrande

Copy link
Copy Markdown
Contributor

@GigaHierz @szapelao I pushed 4eec00a to this branch with the wording changes from the review:

  1. USD₮ and USA₮ everywhere on the page: the intro, the "Stablecoin support" bullet and the Token column, plus four older mentions on the same page (the USD₮ version() note, the dashboard deposit line, the "for USA₮ see" link text and the USDC/USD₮ address table), so no "USDT"/"USAT" is left. The EIP-712 values Tether USD and Tether America USD are unchanged.
  2. USA₮ at its first mention now reads, verbatim: "USA₮, the US Dollar-backed stablecoin issued by Anchorage Digital Bank, N.A., and supported by Tether". To keep it at the end of a clause, the intro now names the Permit2 tokens first and the EIP-3009 tokens second.
  3. No regulation or compliance comparison between USA₮ and USD₮ is on the page.
  4. "Regulated" does not appear on this page, so there was nothing to pair with "fiat-backed".

Not run: mint dev or mint broken-links on the new commit. The change is text only, with no links added or moved.

@szapelao the non-blocking points are still yours: whether you ran 412 permit2_allowance_required and the "$1" cap, confirming the issuer names with comms, and feeApplies for wARS, wMXN, wPEN and wCLP.

@GigaHierz GigaHierz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, the wording fixes are in and the token table still matches the live paymentAssets config. Approving.

Non-blocking follow-ups:

  • feeApplies is false for wARS, wMXN, wPEN and wCLP in the live config and isn't documented yet.
  • Please still confirm the issuer names (Ripio, WrappedCBDC Limited) with the comms owner.

@GigaHierz
GigaHierz merged commit bdc165b into celo-org:main Oct 30, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants