docs: references, network, besu, CCIP, troubleshooting, archive, quick ref
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled

Made-with: Cursor
This commit is contained in:
defiQUG
2026-03-27 18:50:28 -07:00
parent dedb55e05c
commit cc6d0705da
32 changed files with 161 additions and 111 deletions

View File

@@ -1,7 +1,7 @@
# Address Matrix and Status — Correlated Reference
**Last Updated:** 2026-03-04
**Purpose:** Single correlated matrix of all existing contract, token, and pool addresses with deployment status. **On-chain verification (2026-03-04):** DODOPMMIntegration at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` returns canonical cUSDT/cUSDC per [EXPLORER_TOKEN_LIST_CROSSCHECK](EXPLORER_TOKEN_LIST_CROSSCHECK.md) §8.
**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.
---
@@ -37,10 +37,11 @@
| 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 | ✅ | Compliant |
| cXAUT | Tether XAU (Compliant) | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | ✅ | Compliant |
| | Tether USDT (official, Chain 138) | `0x15DF1D5BFDD8Aa4b380445D4e3E9B38d34283619` | | ✅ | Reference / mainnet-style |
| XAU | Gold (anchor) | — | | | Not deployed |
| 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
@@ -57,6 +58,8 @@
| 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)
@@ -105,11 +108,18 @@
| Contract / pool | Address | Status | Notes |
|-----------------|---------|--------|-------|
| DODOPMMIntegration | `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` | ✅ | Mock DVM; canonical cUSDT/cUSDC verified on-chain 2026-03-04 (EXPLORER_TOKEN_LIST_CROSSCHECK §8) |
| DODOPMMProvider | `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` | ✅ | Pools registered |
| Pool cUSDT/cUSDC | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | ✅ | Created |
| Pool cUSDT/USDT | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` | ✅ | Created |
| Pool cUSDC/USDC | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` | ✅ | Created |
| 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 |
@@ -128,12 +138,12 @@
| Category | Count | Status summary |
|----------|-------|-----------------|
| Tokens | 16 live (cUSDT, cUSDC, cEURC, cEURT, cGBPC, cGBPT, cAUDC, cJPYC, cCHFC, cCADC, cXAUC, cXAUT, WETH, WETH10, LINK, ETH-USD); 1 not deployed (XAU) | ✅ See §1.1 |
| 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, 3 pools | ✅ Created; add liquidity to pools |
| 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)
@@ -183,11 +193,17 @@ Bridges (CCIPWETH9 / CCIPWETH10) and LINK funding per runbook. Addresses in `smo
| Env variable (Chain 138) | Canonical address |
|--------------------------|-------------------|
| DODO_PMM_INTEGRATION_ADDRESS | `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` |
| DODO_PMM_PROVIDER_ADDRESS | `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` |
| POOL_CUSDTCUSDC | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` |
| POOL_CUSDTUSDT | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` |
| POOL_CUSDCUSDC | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` |
| 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` |
@@ -201,9 +217,9 @@ Bridges (CCIPWETH9 / CCIPWETH10) and LINK funding per runbook. Addresses in `smo
| Category | Deployed | Not deployed | Pending / deprecated |
|----------|----------|--------------|----------------------|
| Tokens | 5 | 2 (XAU, cEURT) | 0 |
| Tokens | 18+ | 0 | 0 |
| Core / CCIP / governance / vault / reserve | 35+ | 0 | 0 |
| PMM integration + provider + pools | 5 | 1 (EnhancedSwapRouter), 1 (LiquidityPoolETH) | 0 |
| PMM integration + provider + pools | 12+ | 1 (EnhancedSwapRouter), 1 (LiquidityPoolETH) | 0 |
| Deprecated | 0 | 0 | 1 (old CCIPWETH9Bridge) |
| TransactionMirror | — | — | 1 (set in .env) |