Files
proxmox/docs/11-references/TOKEN_CATEGORIES_CANONICAL.md

134 lines
7.5 KiB
Markdown
Raw Normal View History

# Token Categories — Canonical Reference
**Last Updated:** 2026-02-28
**Status:** Authoritative list of token categories for Chain 138, ALL Mainnet, compliant wrapped (cW*), and D-WIN W tokens.
---
## 1. Canonical 138 Compliant
Tokens native to or deployed on **ChainID 138** (DeFi Oracle Meta Mainnet): native gas token plus wrapped and compliant M1 tokens.
| Symbol | Description | Chain 138 address / status |
|--------|-------------|----------------------------|
| **Native ETH** | Gas token | — |
| **WETH** | Wrapped Ether | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` |
| **WETH10** | Wrapped Ether v10 | `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f` |
| **LINK** | Chainlink Token | `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03` |
| **cUSDT** | Compliant Tether USD | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` |
| **cUSDC** | Compliant USD Coin | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` |
| **cEURT** | Compliant Tether EUR | Deploy / env; see canonical-tokens.ts |
| **cEURC** | Compliant Euro Coin | Deploy / env; see canonical-tokens.ts |
| **cGBPT** | Compliant Tether GBP | Deploy / env |
| **cGBPC** | Compliant Pound Sterling | Deploy / env |
| **cAUDT** | Compliant Tether AUD | Deploy / env |
| **cAUDC** | Compliant Australian Dollar | Deploy / env |
| **cJPYT** | Compliant Tether JPY | Deploy / env |
| **cJPYC** | Compliant Japanese Yen | Deploy / env |
| **cCHFT** | Compliant Tether CHF | Deploy / env |
| **cCHFC** | Compliant Swiss Franc | Deploy / env |
| **cCADT** | Compliant Tether CAD | Deploy / env |
| **cCADC** | Compliant Canadian Dollar (Coin) | Deploy / env |
| **cAUSDT** | Compliant Alltra/USD T | Deploy / env (e.g. ALL Mainnet bridge) |
**Source of addresses:** [CHAIN138_TOKEN_ADDRESSES](CHAIN138_TOKEN_ADDRESSES.md), [canonical-tokens.ts](../../smom-dbis-138/services/token-aggregation/src/config/canonical-tokens.ts) (FALLBACK_ADDRESSES + env).
---
## 2. ALL Mainnet (Alltra)
Tokens on **ChainID 651940** (ALL Mainnet / Alltra): native gas token and ecosystem tokens.
| Symbol | Description | Chain 651940 address |
|--------|-------------|------------------------|
| **Native** | Gas token | — |
| **AUSDT** | Alltra USD Token | `0x015B1897Ed5279930bC2Be46F661894d219292A6` |
| **USDT** | AUSDT (alt) | `0x66D8Efa0AF63B0e84eb1Dd72bf00f00cd1e2234e` |
| **USDC** | AUSDC | `0xa95EeD79f84E6A0151eaEb9d441F9Ffd50e8e881` |
| **WETH** | Wrapped Ether | `0x798F6762BB40d6801A593459d08F890603D3979C` |
| **WALL** | Wrapped Alltra | `0x2da2b8f961F161ab6320acB3377e2e844a3C3ce4` |
| **ACADT** | Alltra CAD (Tether-style) | Deploy / env |
**Source:** [DEPLOYED_COINS_TOKENS_AND_NETWORKS](DEPLOYED_COINS_TOKENS_AND_NETWORKS.md).
---
## 3. Compliant Wrapped Tokens for Public Blockchains (cW*)
Bridged representations of Canonical 138 Compliant tokens on **public chains** (Ethereum, BSC, Polygon, etc.). Naming: **cW** + currency/type (e.g. cWUSDT = wrapped compliant USDT on public chain).
| Symbol | Description |
|--------|-------------|
| **cWUSDT** | Wrapped cUSDT (public chain) |
| **cWEURT** | Wrapped cEURT |
| **cWGBPT** | Wrapped cGBPT |
| **cWAUDT** | Wrapped cAUDT |
| **cWJPYT** | Wrapped cJPYT |
| **cWCHFT** | Wrapped cCHFT |
| **cWCADT** | Wrapped cCADT |
| **cWUSDC** | Wrapped cUSDC |
| **cWEURC** | Wrapped cEURC |
| **cWGBPC** | Wrapped cGBPC |
| **cWAUDC** | Wrapped cAUDC |
| **cWJPYC** | Wrapped cJPYC |
| **cWCHFC** | Wrapped cCHFC |
| **cWCADC** | Wrapped cCADC |
| **cWUSDW** | Wrapped USDW (D-WIN W) |
| **cWEURW** | Wrapped EURW |
| **cWGBPW** | Wrapped GBPW |
| **cWAUDW** | Wrapped AUDW |
| **cWJPYW** | Wrapped JPYW |
| **cWCHFW** | Wrapped CHFW |
| **cWCADW** | Wrapped CADW |
**Context:** M1 tokens on Chain 138 (cUSDT, cUSDC, cEURT, cEURC, etc.) are bridged to public chains as **cW*** wrappers. The intended public-chain stabilization model uses single-sided PMM edge pools (cW* / USDC, cW* / USDT) plus a bot-driven mesh **when deployed**; broader edge-pool rollout is still partial. See [cross-chain-pmm-lps](../../cross-chain-pmm-lps/README.md), [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md) § Public-chain cW* stabilization.
---
## 4. D-WIN W Tokens
**ISO-4217 W** tokens (D-WIN W): multi-currency W tokens deployed e.g. on Cronos (Chain 25) and optionally Chain 138 / 651940.
| Symbol | Description | Cronos (25) address |
|--------|-------------|----------------------|
| **USDW** | USD W Token | `0x948690147D2e50ffe50C5d38C14125aD6a9FA036` |
| **EURW** | EUR W Token | `0x58a8D8F78F1B65c06dAd7542eC46b299629A60dd` |
| **GBPW** | GBP W Token | `0xFb4B6Cc81211F7d886950158294A44C312abCA29` |
| **AUDW** | AUD W Token | `0xf9f5D0ACD71C76F9476F10B3F3d3E201F0883C68` |
| **JPYW** | JPY W Token | `0xeE17bB0322383fecCA2784fbE2d4CD7d02b1905B` |
| **CHFW** | CHF W Token | `0xc9750828124D4c10e7a6f4B655cA8487bD3842EB` |
| **CADW** | CAD W Token | `0x328Cd365Bb35524297E68ED28c6fF2C9557d1363` |
**Source:** [DEPLOYED_COINS_TOKENS_AND_NETWORKS](DEPLOYED_COINS_TOKENS_AND_NETWORKS.md) § Chain 25, [canonical-tokens.ts](../../smom-dbis-138/services/token-aggregation/src/config/canonical-tokens.ts) (FALLBACK_ADDRESSES).
---
## Summary table
| Category | Scope | Examples |
|----------|--------|----------|
| **1. Canonical 138 Compliant** | Chain 138 native + WETH, WETH10, LINK, cUSDT, cUSDC, cEURT, cEURC, cGBPT, cGBPC, cAUDT, cAUDC, cJPYT, cJPYC, cCHFT, cCHFC, cCADT, cCADC, cAUSDT | ETH, WETH, cUSDT, cUSDC |
| **2. ALL Mainnet (Alltra)** | Chain 651940 | Native, AUSDT, USDT, USDC, WETH, WALL, ACADT |
| **3. Compliant Wrapped (cW*)** | Public chains (bridged from 138) | cWUSDT, cWUSDC, cWEURT, cWEURC, cWUSDW, … |
| **4. D-WIN W Tokens** | Cronos (25) / 138 / 651940 | USDW, EURW, GBPW, AUDW, JPYW, CHFW, CADW |
---
## Gaps and alignment notes
- **canonical-tokens.ts:** Defines **cEURC**, **cEURT**, **cGBPC**, **cGBPT**, **cAUDC**, **cJPYC**, **cCHFC**, **cCADC** (no **cAUDT**, **cJPYT**, **cCHFT**, **cCADT**, **cAUSDT** in the base list). Category 1 uses both T (Tether-style) and C (Coin-style): **cCADT** and **cCADC** for CAD; D-WIN is **CADW**; wrapped are **cWCADT**, **cWCADC**, **cWCADW**; Alltra is **ACADT**. **cAUSDT** is referenced in ISO4217 and tests but not in CANONICAL_TOKENS; add when Alltra/bridge compliant token is defined.
- **FALLBACK_ADDRESSES** (canonical-tokens.ts): Only **cUSDC**, **cUSDT**, and the seven **D-WIN W** tokens (Cronos) have hardcoded addresses. All other Category 1 tokens rely on env (e.g. `cEURT_ADDRESS_138`).
- **CHAIN138_TOKEN_ADDRESSES.md:** Lists only the five deployed tokens (WETH, WETH10, LINK, cUSDT, cUSDC). For the full Category 1 list and status, see this document.
- **list-deployer-tokens-all-networks.sh:** Reports only tokens with known addresses (Chain 138: the five above + USDT official). When cEURT, cEURC, etc. are deployed, add their addresses to the script or source from a single config.
---
## References
- [CHAIN138_TOKEN_ADDRESSES](CHAIN138_TOKEN_ADDRESSES.md) — Chain 138 contract addresses (deployed subset)
- [DEPLOYED_COINS_TOKENS_AND_NETWORKS](DEPLOYED_COINS_TOKENS_AND_NETWORKS.md) — Networks and tokens by chain
- [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md) — cW* edge pools and stabilization
- [canonical-tokens.ts](../../smom-dbis-138/services/token-aggregation/src/config/canonical-tokens.ts) — Token-aggregation canonical list and addresses
- [ISO4217_COMPLIANT_TOKEN_MATRIX](../04-configuration/ISO4217_COMPLIANT_TOKEN_MATRIX.md) — Naming (c* / cW*)
- [TOKEN_CONTRACT_DEPLOYMENTS_REMAINING](TOKEN_CONTRACT_DEPLOYMENTS_REMAINING.md) — Remaining token contract deployments by category and chain