Skip to content

[codex] Clarify non-USD TIP-20 issuance docs #590

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

Draft
joshitzko wants to merge 2 commits into
base: main
Choose a base branch
from
+6 −0
Draft

[codex] Clarify non-USD TIP-20 issuance docs #590

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fb4389b
Clarify non-USD TIP-20 issuance docs
joshitzko Jun 26, 2026
d498d36
Trim non-USD TIP-20 docs guidance
joshitzko Jun 26, 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
6 changes: 6 additions & 0 deletions src/pages/docs/guide/issuance/create-a-stablecoin.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,12 @@ Tokens can also carry an optional on-chain `logoURI` ([TIP-1026](https://tips.sh
The `currency` field is **immutable** after token creation and affects fee payment eligibility, DEX routing, and quote token pairing. See [Currency Declaration](/docs/protocol/tip20/overview#currency-declaration) for guidelines on choosing the right value. **Only `USD` stablecoins can be used to pay transaction fees on Tempo.**
:::

#### Issuing non-USD stablecoins

Set `currency` to the reference asset the token tracks, not to the token symbol. For fiat-backed stablecoins, use the ISO 4217 code such as `USD`, `EUR`, `BRL`, or `MXN`; do not use `USD` unless 1 token is intended to track 1 US dollar.

The SDK defaults `quoteToken` to [`pathUSD`](/docs/protocol/exchange/quote-tokens#pathusd). If you override it, use an already deployed TIP-20. `USD` tokens must use a `USD` quote token; non-`USD` TIP-20s can be issued with any deployed TIP-20 quote token, but they are not fee tokens and are not supported by native DEX trading today.

<Demo.Container name="Create Form">
<CreateToken stepNumber={1} last />
</Demo.Container>
Expand Down
Loading