bea1903ac9
Co-authored-by: Cursor <cursoragent@cursor.com>
2.8 KiB
Tezos Token Registry — USDtz and Related Assets
Last Updated: 2026-02-01
Document Version: 1.0
Status: Active Documentation
Overview
This document defines Tezos token metadata for Chain138→Tezos USDtz routing. Targets native Tezos USDtz (USDTz / USDtez) delivery.
USDtz (USDTz / USDtez) — Community Stablecoin
| Field | Value |
|---|---|
| Symbol | USDtz |
| Name | USD Tez (community-operated, collateralized) |
| Token Standard | FA1.2 |
| Decimals | 6 |
| Contract Address (Primary) | KT1T87QbpXEVgkwsNPzz8iRoah3SS3D1MDmh |
| Contract Address (Legacy) | KT1LN4LPSqTMS7Sd2CJw4bbDGR5Mv2t68Fy9 |
| Network | Tezos Mainnet |
| Explorer | https://tzkt.io/KT1T87QbpXEVgkwsNPzz8iRoah3SS3D1MDmh |
| All contracts (Tezos) | https://tzkt.io/contracts — browse/search tokens and contracts on Tezos |
| Provider | Tezos Stable Technologies, Ltd. |
Verification status: Addresses from official USDtz docs and block explorers. Prefer KT1T87QbpXEVgkwsNPzz8iRoah3SS3D1MDmh for routing.
Official Tether USDt (Tezos)
| Field | Value |
|---|---|
| Symbol | USDt |
| Name | Tether USD (official) |
| Token Standard | FA2 |
| Decimals | 6 |
| Contract Address | Verify via TzKT/tzStats for KT1 with symbol USDt |
| Network | Tezos Mainnet |
Intermediary Stablecoins (Tezos-side)
For Route Class B (stablecoin relay), assets arrive via Wrap Protocol or Allbridge before swapping to USDtz.
| Token | Symbol | Contract | Standard | Decimals | Source |
|---|---|---|---|---|---|
| Wrapped USDC | wUSDC | Wrap Protocol (query at app.tzwrap.com) | FA2 | 6 | Wrap |
| Wrapped USDT | wUSDT | Wrap Protocol | FA2 | 6 | Wrap |
| USDC (native) | USDC | Check Plenty/Quipuswap token lists | FA2 | 6 | Allbridge |
| USDT (native) | USDT | Check Plenty/Quipuswap token lists | FA2 | 6 | Allbridge |
Plenty API: GET https://api.plenty.network/config/tokens — returns all tokens with addresses.
Resolve script: Run node scripts/resolve-tezos-tokens-from-plenty.js to fetch wUSDC/wUSDT/USDC/USDT addresses from Plenty and output JSON. Add resolved addresses to ALLOWED_TEZOS_TOKENS in allowlist.config.ts when available.
Tezos DEX Integration
| DEX | API Base | Docs | Swap Quote |
|---|---|---|---|
| Plenty | https://api.plenty.network | https://docs.api.plenty.network | /config/pools/v2, /config/pools/v3 |
| Quipuswap | SDK-based | https://github.com/madfish-solutions/quipuswap-sdk | @quipuswap/sdk |
| SpicySwap | docs.spicyswap.xyz | Granada testnet in docs | Verify mainnet |
References
- TEZOS_USDTZ_INTEGRATION.md — Full integration plan
- CHAIN138_TOKEN_ADDRESSES.md — Chain138 source assets