bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
78 lines
2.8 KiB
Markdown
78 lines
2.8 KiB
Markdown
# 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](TEZOS_USDTZ_INTEGRATION.md) — Full integration plan
|
|
- [CHAIN138_TOKEN_ADDRESSES.md](CHAIN138_TOKEN_ADDRESSES.md) — Chain138 source assets
|