# 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