Files
LedgerLive/docs/CHAIN138_TOKEN_ADDRESSES.md
Devin becba35854 docs: Chain 138 alignment audit + deprecate stale token-addresses master
- Add CHAIN138_ALIGNMENT_AUDIT_2026-04-18.md: drift report covering 67 unique
  Chain-138 addresses from 7 canonical sources, cross-checked against on-chain
  state at https://rpc-core.d-bis.org (chainId 0x8a / 138).
- Add docs/data/chain138-alignment.json: structured findings for downstream tooling.
- Banner CHAIN138_TOKEN_ADDRESSES.md as DEPRECATED (only 5 of 15+ tokens, 0 of 43
  infrastructure contracts).

Findings highlights:
- 64 of 67 referenced addresses are live on-chain; 3 ghosts (in allowlist only).
- 61 deployed contracts are missing from CHAIN138_TOKEN_ADDRESSES.md.
- WETH9 genesis slot (0xC02aaA39...Cc2) is a non-ERC20 shim (decimals=0); real
  WETH9 is at 0x3304b747...E6 per smom/docs/ADDRESS_MAPPING.md.
- WETH10 at canonical 0xf4BB2e28...A9F works (18 decimals, 'Wrapped Ether v10').
- 15 compliant fiat/metal tokens (cEURC, cGBPC, cAUDC, cJPYC, cCHFC, cCADC,
  cXAUC, cXAUT, cEURT, cGBPT, plus non-compliant-wrapper USDT/USDC) all live on-chain,
  all absent from CHAIN138_TOKEN_ADDRESSES.md.

Recommended follow-ups listed in the audit doc.
2026-04-18 23:49:35 +00:00

108 lines
4.2 KiB
Markdown

> ⚠️ **DEPRECATED 2026-04-18** — this file documents only 5 of the 15+ ERC20 tokens and 0 of the 43 infrastructure contracts actually deployed on Chain 138. For the current source of truth see:
>
> - `smom-dbis-138/config/address-inventory.chain138.json` (43 infra contracts, last updated 2026-03-27)
> - `smom-dbis-138/config/runtime-env.chain138.json` (canonical runtime env surface, 2026-03-27)
> - `smom-dbis-138/services/token-aggregation/src/config/canonical-tokens.ts` (15 Chain-138 tokens)
> - `LedgerLive/docs/CHAIN138_ALIGNMENT_AUDIT_2026-04-18.md` (this repo — full drift report, generated from on-chain state + 7 canonical sources)
>
> The values below are still correct for the listed tokens, but the set is incomplete. Do not add new references against this file; use the inventory JSON instead.
---
# Token Contract Addresses - ChainID 138
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
**Network**: ChainID 138 (SMOM-DBIS-138)
**RPC Endpoint** (admin/deployment): `http://192.168.11.211:8545` (RPC_CORE_1) or `https://rpc-core.d-bis.org`
**Explorer**: https://explorer.d-bis.org
**Last Updated**: 2025-12-24
---
## 📋 ERC20 Token Contracts
### Standard Tokens
| Token | Symbol | Address | Decimals | Status | Notes |
|-------|--------|---------|----------|--------|-------|
| **Wrapped Ether** | WETH | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | 18 | ✅ Pre-deployed | Pre-deployed in Genesis |
| **Wrapped Ether v10** | WETH10 | `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f` | 18 | ✅ Pre-deployed | Pre-deployed in Genesis |
| **Chainlink Token** | LINK | `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03` | 18 | ✅ Deployed | Used for CCIP fees |
### Compliant Stablecoins
| Token | Symbol | Address | Decimals | Status | Notes |
|-------|--------|---------|----------|--------|-------|
| **Tether USD (Compliant)** | cUSDT | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` | 6 | ✅ Deployed | Compliant USDT token |
| **USD Coin (Compliant)** | cUSDC | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` | 6 | ✅ Deployed | Compliant USDC token |
---
## 🔗 Token Registry
The tokens can be tracked through the TokenRegistry contract:
| Contract | Address | Purpose |
|----------|---------|---------|
| **TokenRegistry** | `0x91Efe92229dbf7C5B38D422621300956B55870Fa` | Centralized registry for all tokens on ChainID 138 |
---
## 📊 Summary
### Total Token Contracts: 5
1. **WETH** - `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
2. **WETH10** - `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f`
3. **LINK** - `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03`
4. **CompliantUSDT (cUSDT)** - `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22`
5. **CompliantUSDC (cUSDC)** - `0xf22258f57794CC8E06237084b353Ab30fFfa640b`
---
## 📝 Notes
1. **WETH9 and WETH10** were pre-deployed in the genesis block
2. **LINK token** is used for CCIP (Cross-Chain Interoperability Protocol) fees
3. **Compliant stablecoins** (cUSDT, cUSDC) include regulatory compliance features
4. All addresses are checksummed and verified on-chain
5. Token list maintained at: `token-lists/lists/dbis-138.tokenlist.json`
---
## 🔍 Verification
To verify a token contract on-chain:
```bash
# Check contract code
cast code <TOKEN_ADDRESS> --rpc-url http://192.168.11.211:8545
# Check token details (name, symbol, decimals)
cast call <TOKEN_ADDRESS> "name()" --rpc-url http://192.168.11.211:8545
cast call <TOKEN_ADDRESS> "symbol()" --rpc-url http://192.168.11.211:8545
cast call <TOKEN_ADDRESS> "decimals()" --rpc-url http://192.168.11.211:8545
```
---
## Token alignment
| Source | File |
|--------|------|
| Token list | `token-lists/lists/dbis-138.tokenlist.json` |
| Canonical | `smom-dbis-138/services/token-aggregation/src/config/canonical-tokens.ts` (FALLBACK_ADDRESSES) |
| Allowlist | `dbis_core/src/core/defi/tezos-usdtz/allowlist.config.ts` (ALLOWED_CHAIN138_TOKENS) |
---
**References:**
- Token List: `token-lists/lists/dbis-138.tokenlist.json`
- Deployment Docs: `explorer-monorepo/docs/DEPLOYMENT_COMPLETE_CHAINID_138.md`
- Contract Reference: [CONTRACT_ADDRESSES_REFERENCE.md](CONTRACT_ADDRESSES_REFERENCE.md), [CONTRACT_INVENTORY_AND_VERIFICATION.md](CONTRACT_INVENTORY_AND_VERIFICATION.md)