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

241 lines
14 KiB
Markdown
Raw Normal View History

# Address Matrix and Status — Correlated Reference
**Last Updated:** 2026-03-26
**Purpose:** Single correlated matrix of all existing contract, token, and pool addresses with deployment status. **On-chain verification (2026-03-26):** corrected Chain 138 PMM stack verified at `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` and `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`; desired-state inventory is fully reconciled with `104` existing pools and `104` aligned routes.
**Sources:** CONTRACT_ADDRESSES_REFERENCE, CHAIN138_TOKEN_ADDRESSES, LIQUIDITY_POOLS_MASTER_MAP, DEPLOYED_COINS_TOKENS_AND_NETWORKS, env examples, PRE_DEPLOYMENT_CHECKLIST.
---
## Status legend
| Symbol | Meaning |
|--------|---------|
| ✅ | Deployed / Created / Live |
| ❌ | Not deployed / Not created |
| ⏳ | Pending (script run or set in .env from deploy output) |
| ⛔ | Deprecated — do not use |
| — | N/A or placeholder |
---
## 1. Chain 138 — Full address matrix
### 1.1 Tokens (ERC20 / Genesis)
| Symbol | Name | Address | Decimals | Status | Notes |
|--------|------|---------|----------|--------|-------|
| WETH | Wrapped Ether | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | 18 | ✅ | Genesis |
| WETH10 | Wrapped Ether v10 | `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f` | 18 | ✅ | Genesis |
| LINK | Chainlink Token | `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03` | 18 | ✅ | CCIP fees |
| cUSDT | Compliant Tether USD | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` | 6 | ✅ | Compliant stablecoin |
| cUSDC | Compliant USD Coin | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` | 6 | ✅ | Compliant stablecoin |
| cEURC | Euro Coin (Compliant) | `0x8085961F9cF02b4d800A3c6d386D31da4B34266a` | 6 | ✅ | Compliant stablecoin |
| cEURT | Tether EUR (Compliant) | `0xdf4b71c61E5912712C1Bdd451416B9aC26949d72` | 6 | ✅ | Compliant stablecoin |
| cGBPC | Pound Sterling (Compliant) | `0x003960f16D9d34F2e98d62723B6721Fb92074aD2` | 6 | ✅ | Compliant stablecoin |
| cGBPT | Tether GBP (Compliant) | `0x350f54e4D23795f86A9c03988c7135357CCaD97c` | 6 | ✅ | Compliant stablecoin |
| cAUDC | Australian Dollar (Compliant) | `0xD51482e567c03899eecE3CAe8a058161FD56069D` | 6 | ✅ | Compliant stablecoin |
| cJPYC | Japanese Yen (Compliant) | `0xEe269e1226a334182aace90056EE4ee5Cc8A6770` | 6 | ✅ | Compliant stablecoin |
| cCHFC | Swiss Franc (Compliant) | `0x873990849DDa5117d7C644f0aF24370797C03885` | 6 | ✅ | Compliant stablecoin |
| cCADC | Canadian Dollar (Compliant) | `0x54dBd40cF05e15906A2C21f600937e96787f5679` | 6 | ✅ | Compliant stablecoin |
| cXAUC | Gold (Compliant) | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | ✅ | XAU: **1 token = 1 troy oz Au** |
| cXAUT | Tether XAU (Compliant) | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | ✅ | XAU: **1 token = 1 troy oz Au** |
| USDT | Tether USD (Official Mirror) | `0x004b63A7B5b0E06f6bB6adb4a5F9f590BF3182D1` | 6 | ✅ | Local quote-side mirror used by funded PMM pool |
| USDC | USD Coin (Official Mirror) | `0x71D6687F38b93CCad569Fa6352c876eea967201b` | 6 | ✅ | Local quote-side mirror used by funded PMM pool |
| XAU | Gold (anchor) | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | ✅ | Represented on Chain 138 by cXAUC |
### 1.2 Core / registry / vault
| Contract | Address | Status | Notes |
|----------|---------|--------|-------|
| ComplianceRegistry | `0xbc54fe2b6fda157c59d59826bcfdbcc654ec9ea1` | ✅ | |
| TokenFactory | `0xEBFb5C60dE5f7C4baae180CA328D3BB39E1a5133` | ✅ | |
| TokenRegistry | `0x91Efe92229dbf7C5B38D422621300956B55870Fa` | ✅ | |
| BridgeVault | `0x31884f84555210FFB36a19D2471b8eBc7372d0A8` | ✅ | |
| FeeCollector | `0xF78246eB94c6CB14018E507E60661314E5f4C53f` | ✅ | |
| DebtRegistry | `0x95BC4A997c0670d5DAC64d55cDf3769B53B63C28` | ✅ | |
| PolicyManager | `0x0C4FD27018130A00762a802f91a72D6a64a60F14` | ✅ | |
| TokenImplementation | `0x0059e237973179146237aB49f1322E8197c22b21` | ✅ | |
| Price Feed Keeper | `0xD3AD6831aacB5386B8A25BB8D8176a6C8a026f04` | ✅ | |
| Multicall / Oracle Aggregator | `0x99b3511a2d315a497c8112c1fdd8d508d4b1e506` | ✅ | Confirm which contract at slot |
| Oracle Proxy | `0x3304b747e565a97ec8ac220b0b6a1f6ffdb837e6` | ✅ | MetaMask price feed |
| OraclePriceFeed (keeper) | `0x8918eE0819fD687f4eb3e8b9B7D0ef7557493cfa` | ✅ | `ORACLE_PRICE_FEED`; ReserveSystem + PriceFeedKeeper |
| WETH MockPriceFeed (keeper) | `0x3e8725b8De386feF3eFE5678c92eA6aDB41992B2` | ✅ | `CHAIN138_WETH_MOCK_PRICE_FEED`; sync: `smom-dbis-138/scripts/reserve/sync-weth-mock-price.sh` |
### 1.3 CCIP / bridge (Chain 138)
| Contract | Address | Status | Notes |
|----------|---------|--------|-------|
| CCIP Router | `0x42DAb7b888Dd382bD5Adcf9E038dBF1fD03b4817` | ✅ | |
| CCIP Sender | `0x105F8A15b819948a89153505762444Ee9f324684` | ✅ | |
| CCIPWETH9Bridge | `0xcacfd227A040002e49e2e01626363071324f820a` | ✅ | Use for sendCrossChain |
| CCIPWETH10Bridge | `0xe0E93247376aa097dB308B92e6Ba36bA015535D0` | ✅ | |
| CCIPWETH9Bridge (old) | `0x89dd12025bfCD38A168455A44B400e913ED33BE2` | ⛔ | Deprecated |
### 1.4 Governance / phased core / deterministic
| Contract | Address | Status | Notes |
|----------|---------|--------|-------|
| UniversalAssetRegistry (proxy) | `0xAEE4b7fBe82E1F8295951584CBc772b8BBD68575` | ✅ | Phased core |
| GovernanceController (proxy) | `0xA6891D5229f2181a34D4FF1B515c3Aa37dd90E0e` | ✅ | Phased core |
| UniversalCCIPBridge (proxy) | `0xCd42e8eD79Dc50599535d1de48d3dAFa0BE156F8` | ✅ | Phased core |
| BridgeOrchestrator (proxy) | `0x89aB428c437f23bAB9781ff8Db8D3848e27EeD6c` | ✅ | Phased core |
| CREATE2Factory | `0x750E4a8adCe9f0e67A420aBE91342DC64Eb90825` | ✅ | |
| UniversalAssetRegistry (deterministic) | `0xC98602aa574F565b5478E8816BCab03C9De0870f` | ✅ | |
| UniversalCCIPBridge (deterministic) | `0x532DE218b94993446Be30eC894442f911499f6a3` | ✅ | |
| MirrorRegistry | `0x6427F9739e6B6c3dDb4E94fEfeBcdF35549549d8` | ✅ | |
| AlltraAdapter | `0x66FEBA2fC9a0B47F26DD4284DAd24F970436B8Dc` | ✅ | |
### 1.5 Channels / mirror / trustless / reserve / vault
| Contract | Address | Status | Notes |
|----------|---------|--------|-------|
| PaymentChannelManager | `0x302aF72966aFd21C599051277a48DAa7f01a5f54` | ✅ | |
| GenericStateChannelManager | `0xe5e3bB424c8a0259FDE23F0A58F7e36f73B90aBd` | ✅ | |
| AddressMapper | `0x439Fcb2d2ab2f890DCcAE50461Fa7d978F9Ffe1A` | ✅ | |
| MirrorManager | `0x6eD905A30c552a6e003061A38FD52A5A427beE56` | ✅ | |
| Lockbox138 | `0xFce6f50B312B3D936Ea9693C5C9531CF92a3324c` | ✅ | Trustless |
| MerchantSettlementRegistry | `0x16D9A2cB94A0b92721D93db4A6Cd8023D3338800` | ✅ | |
| WithdrawalEscrow | `0xe77cb26eA300e2f5304b461b0EC94c8AD6A7E46D` | ✅ | |
| ReserveSystem | `0x607e97cD626f209facfE48c1464815DDE15B5093` | ✅ | |
| ReserveTokenIntegration | `0x34B73e6EDFd9f85a7c25EeD31dcB13aB6E969b96` | ✅ | |
| RegulatedEntityRegistry | `0xEA4C892D6c1253797c5D95a05BF3863363080b4B` | ✅ | Vault |
| VaultFactory | `0xB2Ac70f35A81481B005067ed6567a5043BA32336` | ✅ | Vault |
| Ledger | `0x67b3831dc64C14FB9352B2a45C6Dd69b3C86B7af` | ✅ | Vault |
| Liquidation | `0x3aCdbCB749d6037a02F0ef6ea2E5Fb89D31fAB72` | ✅ | Vault |
| XAU Oracle | `0xf23E1eDa304082ab7a81531dFE6020E6105e77A8` | ✅ | Vault |
### 1.6 DODO PMM / liquidity (Chain 138)
| Contract / pool | Address | Status | Notes |
|-----------------|---------|--------|-------|
| DODOPMMIntegration | `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` | ✅ | Corrected canonical integration; full JSON desired-state reconciled |
| DODOPMMProvider | `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` | ✅ | Corrected canonical provider; 104 aligned routes |
| PrivatePoolRegistry | `0xb27057B27db09e8Df353AF722c299f200519882A` | ✅ | Live private XAU pool registry |
| Pool cUSDT/cUSDC | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | ✅ | Funded live |
| Pool cUSDT/USDT (official mirror) | `0x6fc60DEDc92a2047062294488539992710b99D71` | ✅ | Intended funded canonical pool; integration/provider mapping must be repointed if still on older empty pool |
| Pool cUSDC/USDC (official mirror) | `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` | ✅ | Canonical corrected-stack pool |
| Pool cUSDT/cXAUC (public) | `0x1AA55E2001E5651349AfF5A63FD7A7Ae44f0F1b0` | ✅ | Funded live |
| Pool cUSDC/cXAUC (public) | `0xEA9Ac6357CaCB42a83b9082B870610363B177cBa` | ✅ | Funded live |
| Pool cEURT/cXAUC (public) | `0xbA99bc1eAAC164569d5AcA96C806934DDaF970Cf` | ✅ | Funded live |
| Pool cUSDT/cXAUC (private) | `0x94316511621430423a2cff0C036902BAB4aA70c2` | ✅ | Funded live |
| Pool cUSDC/cXAUC (private) | `0x7867D58567948e5b9908F1057055Ee4440de0851` | ✅ | Funded live |
| Pool cEURT/cXAUC (private) | `0x505403093826D494983A93b43Aa0B8601078A44e` | ✅ | Funded live |
| LiquidityPoolETH (trustless) | — | ❌ | Placeholder 0x0 |
| EnhancedSwapRouter | — | ❌ | Not deployed |
### 1.7 TransactionMirror / deployer
| Item | Address | Status | Notes |
|------|---------|--------|-------|
| TransactionMirror | `0x7131F887DBEEb2e44c1Ed267D2A68b5b83285afc` | ✅ | Deployed 2026-02-27; set TRANSACTION_MIRROR_ADDRESS in .env |
| Deployer / Admin | `0x4A666F96fC8764181194447A7dFdb7d471b301C8` | ✅ | EOA |
---
## 2. Multi-chain matrix (by chain)
### 2.1 Chain 138 (primary)
| Category | Count | Status summary |
|----------|-------|-----------------|
| Tokens | 18+ live including official mirror USDT/USDC and XAU represented by cXAUC/cXAUT | ✅ See §1.1 |
| Core / registry | 11+ | ✅ All deployed |
| CCIP / bridge | 4 (1 deprecated) | ✅ Use 0x971c… WETH9 bridge |
| Governance / deterministic | 9 | ✅ All deployed |
| Channels / mirror / reserve / vault | 14+ | ✅ All deployed |
| PMM / pools | 1 integration, 1 provider, 1 private registry, 104 aligned pools | ✅ Corrected full mesh and edge pool desired state live |
| TransactionMirror | 1 | ✅ `0x7131F887DBEEb2e44c1Ed267D2A68b5b83285afc` |
### 2.2 Ethereum Mainnet (1)
| Item | Address / value | Status |
|------|------------------|--------|
| CCIPRelayRouter | `0xAd9A228CcEB4cbB612cD165FFB72fE090ff10Afb` | ✅ |
| CCIPRelayBridge | `0xF9A32F37099c582D28b4dE7Fca6eaC1e5259f939` | ✅ |
| WETH | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | ✅ |
| USDT | `0xdAC17F958D2ee523a2206206994597C13D831ec7` | ✅ |
| USDC | `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` | ✅ |
### 2.3 ALL Mainnet (651940)
| Symbol | Address | Status |
|--------|---------|--------|
| AUSDT | `0x015B1897Ed5279930bC2Be46F661894d219292A6` | ✅ |
| USDT (alt) | `0x66D8Efa0AF63B0e84eb1Dd72bf00f00cd1e2234e` | ✅ |
| USDC (AUSDC) | `0xa95EeD79f84E6A0151eaEb9d441F9Ffd50e8e881` | ✅ |
| WETH | `0x798F6762BB40d6801A593459d08F890603D3979C` | ✅ |
| WALL | `0x2da2b8f961F161ab6320acB3377e2e844a3C3ce4` | ✅ |
| HYDX | `0x0d9793861AEB9244AD1B34375a83A6730F6AdD38` | ✅ |
### 2.4 Cronos (25) — ISO4217 W tokens
| Symbol | Address | Status |
|--------|---------|--------|
| WETH9 | `0x99B3511A2d315A497C8112C1fdd8D508d4B1E506` | ✅ |
| WETH10 | `0x3304b747E565a97ec8AC220b0B6A1f6ffDB837e6` | ✅ |
| LINK | `0x8c80A01F461f297Df7F9DA3A4f740D7297C8Ac85` | ✅ |
| USDW / EURW / GBPW / AUDW / JPYW / CHFW / CADW | (see DEPLOYED_COINS_TOKENS_AND_NETWORKS) | ✅ |
### 2.5 CCIP config-ready chains (Gnosis, Celo, Wemix, Cronos)
Bridges (CCIPWETH9 / CCIPWETH10) and LINK funding per runbook. Addresses in `smom-dbis-138/.env` and [ENV_CONFIG_READY_CHAINS.example](../../smom-dbis-138/docs/deployment/ENV_CONFIG_READY_CHAINS.example). Status: deploy bridges → run `complete-config-ready-chains.sh` → fund with LINK.
| Chain | Chain ID | CCIP bridges | Status |
|-------|----------|---------------|--------|
| Gnosis | 100 | CCIPWETH9_BRIDGE_GNOSIS, CCIPWETH10_BRIDGE_GNOSIS | Set in .env after deploy |
| Celo | 42220 | CCIPWETH9_BRIDGE_CELO, CCIPWETH10_BRIDGE_CELO | Set in .env after deploy |
| Wemix | 1111 | CCIPWETH9_BRIDGE_WEMIX, CCIPWETH10_BRIDGE_WEMIX | Set in .env after deploy |
| Cronos | 25 | CCIPWETH9_BRIDGE_CRONOS, CCIPWETH10_BRIDGE_CRONOS | Set in .env after deploy |
---
## 3. Env / config correlation
| Env variable (Chain 138) | Canonical address |
|--------------------------|-------------------|
| DODO_PMM_INTEGRATION_ADDRESS | `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` |
| DODO_PMM_PROVIDER_ADDRESS | `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` |
| PRIVATE_POOL_REGISTRY | `0xb27057B27db09e8Df353AF722c299f200519882A` |
| POOL_CUSDTCUSDC | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` |
| POOL_CUSDTUSDT | `0x6fc60DEDc92a2047062294488539992710b99D71` |
| POOL_CUSDCUSDC | `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` |
| POOL_CUSDT_XAU_PUBLIC | `0x1AA55E2001E5651349AfF5A63FD7A7Ae44f0F1b0` |
| POOL_CUSDC_XAU_PUBLIC | `0xEA9Ac6357CaCB42a83b9082B870610363B177cBa` |
| POOL_CEURT_XAU_PUBLIC | `0xbA99bc1eAAC164569d5AcA96C806934DDaF970Cf` |
| OFFICIAL_USDT_ADDRESS | `0x004b63A7B5b0E06f6bB6adb4a5F9f590BF3182D1` |
| OFFICIAL_USDC_ADDRESS | `0x71D6687F38b93CCad569Fa6352c876eea967201b` |
| CCIPWETH9_BRIDGE_CHAIN138 | `0xcacfd227A040002e49e2e01626363071324f820a` |
| CCIPWETH10_BRIDGE_CHAIN138 | `0xe0E93247376aa097dB308B92e6Ba36bA015535D0` |
| LINK_TOKEN | `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03` |
| COMPLIANT_USDT_ADDRESS / cUSDT | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` |
| COMPLIANT_USDC_ADDRESS / cUSDC | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` |
| TRANSACTION_MIRROR_ADDRESS | ⏳ From deploy script output |
---
## 4. Summary counts (Chain 138)
| Category | Deployed | Not deployed | Pending / deprecated |
|----------|----------|--------------|----------------------|
| Tokens | 18+ | 0 | 0 |
| Core / CCIP / governance / vault / reserve | 35+ | 0 | 0 |
| PMM integration + provider + pools | 12+ | 1 (EnhancedSwapRouter), 1 (LiquidityPoolETH) | 0 |
| Deprecated | 0 | 0 | 1 (old CCIPWETH9Bridge) |
| TransactionMirror | — | — | 1 (set in .env) |
---
## 5. References
| Document | Purpose |
|----------|---------|
| [CONTRACT_ADDRESSES_REFERENCE.md](CONTRACT_ADDRESSES_REFERENCE.md) | Full contract list and canonical .env |
| [CHAIN138_TOKEN_ADDRESSES.md](CHAIN138_TOKEN_ADDRESSES.md) | Tokens on Chain 138 |
| [LIQUIDITY_POOLS_MASTER_MAP.md](LIQUIDITY_POOLS_MASTER_MAP.md) | Pools (138 + ALL Mainnet) |
| [DEPLOYED_COINS_TOKENS_AND_NETWORKS.md](DEPLOYED_COINS_TOKENS_AND_NETWORKS.md) | Networks and tokens by chain |
| [PRE_DEPLOYMENT_CHECKLIST.md](../03-deployment/PRE_DEPLOYMENT_CHECKLIST.md) | PMM / pool / provider status |
| [config/smart-contracts-master.json](../../config/smart-contracts-master.json) | Machine-readable single source (when present) |
**Explorer (Chain 138):** https://explorer.d-bis.org
**Verification script:** `./scripts/verify/check-contracts-on-chain-138.sh`