Skip to content

docs(b20): explain how stablecoins from different issuers interoperate - #2133

Open
youssefea wants to merge 1 commit into
masterfrom
docs/devrel-859-b20-stablecoin-interoperability-across-i
Open

youssefea wants to merge 1 commit into
masterfrom
docs/devrel-859-b20-stablecoin-interoperability-across-i

Conversation

@youssefea

Copy link
Copy Markdown
Contributor

What changed? Why?

Adds an "Integrate Stablecoins From Other Issuers" section to docs/get-started/issue-stablecoins.mdx. It explains what B20 stablecoins from different issuers have in common (the ERC-20 surface and currency()) and what stays specific to each token: its transfer policies, how shared Policy Registry lists work, the fact that B20 has no conversion function, and the fact that redemption happens with each token's own issuer.

This closes Base Knowledge Base gap gap-20261006-b20-stablecoin-interoperability-across-issuers: "How do independently issued B20 stablecoins (e.g. from different banks) interoperate on Base for transfers, conversion, and redemption, given each issuer has its own policies?"

Notes to reviewers

This PR replaces the part of #2093 that covered this gap. Compared with #2093, it drops the guidance to convert "through an onchain swap or a venue" and the claim that code "works for any other" issuer's token. The section does not recommend any conversion venue or promise any redemption model across issuers.

Primary sources, each a page already on master:

  • Shared ERC-20 surface: docs/specifications/b20/introduction.mdx (line 68), docs/specifications/b20/concepts/token-types.mdx
  • currency(): docs/specifications/b20/reference/interfaces/ib20-stablecoin/index.mdx
  • Each token's policies cover the sender, receiver, and executor; isAuthorized; many tokens can share one policy: docs/specifications/b20/concepts/policies.mdx (§1, §2.1, §3.2), docs/build-on-base/issue-stablecoins/restrict-who-can-hold.mdx
  • Redemption means the holder returns tokens and the issuer burns them: docs/build-on-base/issue-stablecoins/burn-supply.mdx

Needs SME confirmation: the B20 spec owners should confirm two statements before merge:

  1. "B20 does not define a function that converts one issuer's stablecoin into another's."
  2. "B20 does not define redemption of one issuer's token by another issuer."

Both are based on the interface reference, which lists no such function. If an endorsed model for conversion or redemption between issuers exists, the owners should say whether it should be documented here.

How has it been tested?

  • node scripts/lint-mdx.js --files-from=<changed file list>: 0 errors, 0 warnings.
  • node scripts/validate-docs-structure.js: fails with 2 errors about the /upgrades/denim/eip-8130 redirect. Those errors are already on master and this PR does not cause them.
  • Checked that every internal link resolves to an existing .mdx file.

Screenshots

N/A (text-only change)

Generated with Toshi

@mintlify

mintlify Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
base 🟢 Ready View Preview Oct 14, 2026, 1:57 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@linear

linear Bot commented Oct 14, 2026

Copy link
Copy Markdown

DEVREL-859

This branch was successfully deployed

1 active deployment
staging - docs — fc955234 Deployed Oct 14, 2026 by mintlify[bot]
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.

2 participants