Add full Chain 138 integration: 8 steps, chain spec, app-ethereum config, docs
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
96
docs/CHAIN138_TOKEN_ADDRESSES.md
Normal file
96
docs/CHAIN138_TOKEN_ADDRESSES.md
Normal file
@@ -0,0 +1,96 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user