From cc6d0705dabd31f8044c109ce0ff7b0478dd2a27 Mon Sep 17 00:00:00 2001 From: defiQUG Date: Fri, 27 Mar 2026 18:50:28 -0700 Subject: [PATCH] docs: references, network, besu, CCIP, troubleshooting, archive, quick ref Made-with: Cursor --- .../CHAIN138_QUICK_START.md | 4 +- .../05-network/CENTRAL_NGINX_ROUTING_SETUP.md | 3 +- .../CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md | 1 - ...CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md | 2 +- docs/06-besu/VALIDATOR_TXPOOL_FIX_STATUS.md | 6 +- .../OPTIONAL_DEPLOYMENTS_START_HERE.md | 2 +- .../RPC_2500_TROUBLESHOOTING.md | 2 +- .../ADDRESS_MATRIX_AND_STATUS.md | 56 ++++++++++++------- .../ALL_MAINNET_ROUTING_ENGINE.md | 2 +- ...CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md | 2 +- .../CONFIGURATION_FILE_INVENTORY.md | 2 +- .../CONTRACT_ADDRESSES_REFERENCE.md | 13 +++-- ...D_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md | 32 +++++++---- ...RACTS_INVENTORY_AND_VERIFICATION_STATUS.md | 12 ++-- .../DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md | 8 ++- .../DEPLOYER_WALLET_FUNDING_PLAN_PMM_POOLS.md | 8 ++- .../DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md | 4 +- .../EXPLORER_TOKEN_LIST_CROSSCHECK.md | 10 +++- .../LIQUIDITY_POOLS_MASTER_MAP.md | 44 ++++++++------- .../MINT_C_AND_CW_ON_ALL_NETWORKS.md | 6 +- .../NETWORK_CONFIGURATION_MASTER.md | 1 + .../PLACEHOLDER_IMPLEMENTATIONS.md | 2 +- docs/11-references/PMM_DEX_ROUTING_STATUS.md | 19 ++++--- .../POOL_ACCESS_DASHBOARD_API_MCP.md | 4 +- .../ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md | 4 +- .../SUBMODULE_RELATIONSHIP_MAP.md | 2 +- ...OKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER.md | 4 +- docs/12-quick-reference/QUICK_REFERENCE.md | 2 +- .../completion/IP_ADDRESS_REVIEW_COMPLETE.md | 2 +- .../INFRASTRUCTURE_REVIEW_QUICK_REFERENCE.md | 2 +- ...VM_INVENTORY_REVIEW_AND_RECOMMENDATIONS.md | 2 +- ...N_COORDINATION_WITH_TRANSCRIPT_540AE663.md | 9 ++- 32 files changed, 161 insertions(+), 111 deletions(-) diff --git a/docs/01-getting-started/CHAIN138_QUICK_START.md b/docs/01-getting-started/CHAIN138_QUICK_START.md index 8597ceb..0230f5c 100644 --- a/docs/01-getting-started/CHAIN138_QUICK_START.md +++ b/docs/01-getting-started/CHAIN138_QUICK_START.md @@ -152,8 +152,8 @@ pct exec -- chmod 644 /var/lib/besu/permissions/permissioned-nodes.json ## πŸ“– Full Documentation -- **Complete Guide:** [CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md) -- **Summary:** [CHAIN138_CONFIGURATION_SUMMARY.md](../archive/configuration/CHAIN138_CONFIGURATION_SUMMARY.md) +- **Complete guide:** [CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md) +- **Wallet / env validation:** [CHAIN138_WALLET_CONFIG_VALIDATION.md](../04-configuration/CHAIN138_WALLET_CONFIG_VALIDATION.md) --- diff --git a/docs/05-network/CENTRAL_NGINX_ROUTING_SETUP.md b/docs/05-network/CENTRAL_NGINX_ROUTING_SETUP.md index 0ae7238..7cd4942 100644 --- a/docs/05-network/CENTRAL_NGINX_ROUTING_SETUP.md +++ b/docs/05-network/CENTRAL_NGINX_ROUTING_SETUP.md @@ -2,5 +2,4 @@ **Status:** Archived 2026-02-08. Public routing now uses **NPMplus** (VMID 10233 at 192.168.11.167), not VMID 105. -- **Current reference:** [CLOUDFLARE_ROUTING_MASTER.md](CLOUDFLARE_ROUTING_MASTER.md), [RPC_ENDPOINTS_MASTER.md](../04-configuration/RPC_ENDPOINTS_MASTER.md) -- **Archived copy:** [../archive/05-network-superseded/CENTRAL_NGINX_ROUTING_SETUP.md](../archive/05-network-superseded/CENTRAL_NGINX_ROUTING_SETUP.md) (historical reference only) +- **Current reference:** [CLOUDFLARE_ROUTING_MASTER.md](CLOUDFLARE_ROUTING_MASTER.md), [RPC_ENDPOINTS_MASTER.md](../04-configuration/RPC_ENDPOINTS_MASTER.md), [NPMPLUS_QUICK_REF.md](../04-configuration/NPMPLUS_QUICK_REF.md) diff --git a/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md b/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md index b5da002..d2cb2e8 100644 --- a/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md +++ b/docs/05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md @@ -3,4 +3,3 @@ **Status:** Archived 2026-02-08. Superseded by current edge routing (Fastly/direct to NPMplus). - **Current reference:** [CLOUDFLARE_ROUTING_MASTER.md](CLOUDFLARE_ROUTING_MASTER.md) -- **Archived copy:** [../archive/05-network-superseded/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md](../archive/05-network-superseded/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md) (historical only) diff --git a/docs/06-besu/CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md b/docs/06-besu/CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md index 87eaecd..134d803 100644 --- a/docs/06-besu/CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md +++ b/docs/06-besu/CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md @@ -216,7 +216,7 @@ ssh root@192.168.11.10 "pct exec 1003 -- cat /etc/besu/genesis.json | jq '.confi ## πŸ“š Related Documentation - [Validator TX-Pool Fix Status](VALIDATOR_TXPOOL_FIX_STATUS.md) -- [Bridge Quick Start](../archive/root-cleanup-20260220/BRIDGE_QUICK_START.md) +- [OPTIONAL_DEPLOYMENTS_START_HERE.md](../07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md) Β· [BRIDGE_TESTING_GUIDE.md](../07-ccip/BRIDGE_TESTING_GUIDE.md) - [Master Permissioned Nodes](../../config/master-permissioned-nodes.json) --- diff --git a/docs/06-besu/VALIDATOR_TXPOOL_FIX_STATUS.md b/docs/06-besu/VALIDATOR_TXPOOL_FIX_STATUS.md index 81b29a3..5ca977b 100644 --- a/docs/06-besu/VALIDATOR_TXPOOL_FIX_STATUS.md +++ b/docs/06-besu/VALIDATOR_TXPOOL_FIX_STATUS.md @@ -225,9 +225,9 @@ export PRIVATE_KEY="0x..." ## πŸ“ Related Documentation -- [Bridge Ready to Use](../archive/root-status-reports/BRIDGE_READY_TO_USE.md) -- [Bridge Final Status](../archive/root-status-reports/BRIDGE_FINAL_STATUS.md) -- [Validator TX-Pool Fix Complete](../archive/root-status-reports/VALIDATOR_TXPOOL_FIX_COMPLETE.md) +- [CCIP_BRIDGE_MAINNET_CONNECTION.md](../07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md) +- [BRIDGE_TESTING_GUIDE.md](../07-ccip/BRIDGE_TESTING_GUIDE.md) +- [CONTRACT_ADDRESSES_REFERENCE.md](../11-references/CONTRACT_ADDRESSES_REFERENCE.md) - [Bridge Implementation Review](../../smom-dbis-138/docs/BRIDGE_IMPLEMENTATION_REVIEW.md) --- diff --git a/docs/07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md b/docs/07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md index 7598fd2..443a335 100644 --- a/docs/07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md +++ b/docs/07-ccip/OPTIONAL_DEPLOYMENTS_START_HERE.md @@ -214,4 +214,4 @@ Phases: 1=Deterministic core, 2=Vault, 3=Reserve, 4=Keeper, 5a/5b=Channels, 6=Tr **Master completion plan (all incomplete + missing items):** [COMPLETION_MASTER_PLAN](../00-meta/COMPLETION_MASTER_PLAN.md). -**Completion status (2026-02-15):** [COMPLETION_STATUS_20260215](../archive/00-meta-pruned/COMPLETION_STATUS_20260215.md) β€” what was done, actionable one-step fixes, operator commands. +**Current operator steps:** [../00-meta/OPERATOR_READY_CHECKLIST.md](../00-meta/OPERATOR_READY_CHECKLIST.md), [../00-meta/NEXT_STEPS_OPERATOR.md](../00-meta/NEXT_STEPS_OPERATOR.md), [../04-configuration/FIXES_PREPARED.md](../04-configuration/FIXES_PREPARED.md). diff --git a/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md b/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md index 6a8ffc1..b0ca4c4 100644 --- a/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md +++ b/docs/09-troubleshooting/RPC_2500_TROUBLESHOOTING.md @@ -421,7 +421,7 @@ After troubleshooting, verify: - [Besu Configuration Guide](/docs/01-getting-started/README.md) - [RPC Node Types Architecture](../05-network/RPC_NODE_TYPES_ARCHITECTURE.md) - [Network Troubleshooting](TROUBLESHOOTING_FAQ.md) -- [Besu Configuration Issues](../archive/BESU_CONFIGURATION_ISSUE.md) +- [BESU_CONFIGURATION_GUIDE.md](../04-configuration/BESU_CONFIGURATION_GUIDE.md) Β· [CHAIN138_BESU_CONFIGURATION.md](../06-besu/CHAIN138_BESU_CONFIGURATION.md) --- diff --git a/docs/11-references/ADDRESS_MATRIX_AND_STATUS.md b/docs/11-references/ADDRESS_MATRIX_AND_STATUS.md index 58a9407..eb9afd8 100644 --- a/docs/11-references/ADDRESS_MATRIX_AND_STATUS.md +++ b/docs/11-references/ADDRESS_MATRIX_AND_STATUS.md @@ -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) | diff --git a/docs/11-references/ALL_MAINNET_ROUTING_ENGINE.md b/docs/11-references/ALL_MAINNET_ROUTING_ENGINE.md index cb4cc43..b93e115 100644 --- a/docs/11-references/ALL_MAINNET_ROUTING_ENGINE.md +++ b/docs/11-references/ALL_MAINNET_ROUTING_ENGINE.md @@ -52,4 +52,4 @@ The Transaction Router + Policy Engine maps chain labels to IDs: ## Related Docs - [TEZOS_NETWORK_CONFIG_ENV_MATRIX](../07-ccip/TEZOS_NETWORK_CONFIG_ENV_MATRIX.md) β€” RPC and bridge env vars -- [ALL_MAINNET_MASTER_DOCUMENTATION](../archive/root-cleanup-20260220/ALL_MAINNET_MASTER_DOCUMENTATION.md) β€” Full ALL Mainnet integration +- [ALL_MAINNET_TOKEN_ADDRESSES.md](ALL_MAINNET_TOKEN_ADDRESSES.md) β€” token addresses; [MASTER_INDEX.md](../MASTER_INDEX.md) β€” doc index; [11-references/CROSS_CHECK_SUMMARY_CCIP_9_CHAINS_AND_MAINNET.md](CROSS_CHECK_SUMMARY_CCIP_9_CHAINS_AND_MAINNET.md) β€” CCIP / Mainnet cross-check diff --git a/docs/11-references/CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md b/docs/11-references/CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md index bab8145..ebed8f9 100644 --- a/docs/11-references/CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md +++ b/docs/11-references/CHAINS_AND_PROTOCOLS_BRIDGE_INTEGRATION.md @@ -133,7 +133,7 @@ Ledger Live and other clients can discover ChainID 138 RPCs via Chainlist. - **RPC:** `https://138.rpc.thirdweb.com`, `https://defi-oracle-meta.rpc.thirdweb.com` - **Explorer:** https://blockscout.defi-oracle.io -**References:** [THIRDWEB_BRIDGE_CHAIN138_SUPPORTED.md](../archive/historical/THIRDWEB_BRIDGE_CHAIN138_SUPPORTED.md) +**References:** [CCIP_BRIDGE_MAINNET_CONNECTION.md](../07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md) Β· [CROSS_CHECK_SUMMARY_CCIP_9_CHAINS_AND_MAINNET.md](CROSS_CHECK_SUMMARY_CCIP_9_CHAINS_AND_MAINNET.md) Β· [ADDRESS_MATRIX_AND_STATUS.md](ADDRESS_MATRIX_AND_STATUS.md) --- diff --git a/docs/11-references/CONFIGURATION_FILE_INVENTORY.md b/docs/11-references/CONFIGURATION_FILE_INVENTORY.md index ff44d82..5d478b3 100644 --- a/docs/11-references/CONFIGURATION_FILE_INVENTORY.md +++ b/docs/11-references/CONFIGURATION_FILE_INVENTORY.md @@ -136,7 +136,7 @@ nano - **[ENV_STANDARDIZATION.md](../04-configuration/ENV_STANDARDIZATION.md)** - Environment variable standards - **[MCP_SETUP.md](../04-configuration/MCP_SETUP.md)** - MCP configuration guide -- **[COMPREHENSIVE_PROJECT_REVIEW.md](../archive/00-meta-pruned/COMPREHENSIVE_PROJECT_REVIEW.md)** - Project review +- **[MASTER_INDEX.md](../MASTER_INDEX.md)** β€” documentation entry point; **[config/ip-addresses.conf](../../config/ip-addresses.conf)** β€” LAN IP variables --- diff --git a/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md b/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md index dc3ab5a..bacc465 100644 --- a/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md +++ b/docs/11-references/CONTRACT_ADDRESSES_REFERENCE.md @@ -1,8 +1,8 @@ # Contract Addresses Reference - ChainID 138 -**Last Updated:** 2026-03-04 -**Document Version:** 1.4 -**Status:** Active Documentation. DODOPMMIntegration token addresses verified on-chain 2026-03-04 β€” see EXPLORER_TOKEN_LIST_CROSSCHECK Β§8. +**Last Updated:** 2026-03-26 +**Document Version:** 1.5 +**Status:** Active documentation. Use the corrected canonical Chain 138 PMM stack: `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`, `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`. --- @@ -89,13 +89,14 @@ Contracts deployed after chain initialization: | **MirrorRegistry** | `0x6427F9739e6B6c3dDb4E94fEfeBcdF35549549d8` | Merkle commitment roots for mirroring | | **AlltraAdapter** | `0x66FEBA2fC9a0B47F26DD4284DAd24F970436B8Dc` | Bridge adapter for ALL Mainnet (651940) | -### TransactionMirror & DODO pool (Chain 138) +### TransactionMirror & DODO PMM stack (Chain 138) | Contract | Address | Status / Notes | |----------|---------|----------------| -| **DODOPMMIntegration** | `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` | βœ… Deployed; **on-chain verified 2026-03-04:** `compliantUSDT()` = canonical cUSDT, `compliantUSDC()` = canonical cUSDC. See [EXPLORER_TOKEN_LIST_CROSSCHECK](EXPLORER_TOKEN_LIST_CROSSCHECK.md) Β§8. | +| **DODOPMMIntegration** | `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` | βœ… Canonical corrected stack; desired-state sync reconciled on 2026-03-26. | +| **DODOPMMProvider** | `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` | βœ… Canonical corrected stack; 104/104 desired-state routes aligned on 2026-03-26. | | **TransactionMirror** | `0x7131F887DBEEb2e44c1Ed267D2A68b5b83285afc` (Chain 138; deployed 2026-02-27) | Set `TRANSACTION_MIRROR_ADDRESS` in `smom-dbis-138/.env`. Deploy: `./scripts/deployment/deploy-transaction-mirror-and-pmm-pool-after-txpool-clear.sh`. | -| **DODO cUSDT/cUSDC pool** | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | βœ… Created (deploy-transaction-mirror-and-pmm-pool-after-txpool-clear.sh). See [REQUIRED_FIXES_AND_DEPLOYMENTS_STATUS](../03-deployment/REQUIRED_FIXES_AND_DEPLOYMENTS_STATUS.md). | +| **DODO cUSDT/cUSDC pool** | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | βœ… Live on canonical corrected stack. See [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md). | ### Deployer / Admin (Chain 138) diff --git a/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md b/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md index 25137da..43dd84d 100644 --- a/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md +++ b/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md @@ -1,6 +1,6 @@ # Deployed Tokens, Bridges, DODO/Uniswap LPs β€” Status & Complete Routing Map -**Last Updated:** 2026-03-04 +**Last Updated:** 2026-03-26 **Purpose:** Single reference for (1) deployed tokens/coins and bridges per destination network, (2) DODO and Uniswap LPs with addresses, and (3) a complete mapping of all possible routes for routing **to** and **from** each chain. --- @@ -10,10 +10,10 @@ | Area | Status | Notes | |------|--------|-------| | **Chain 138 tokens** | βœ… Live | cUSDT, cUSDC, WETH, WETH10, LINK; 10 more compliant tokens deployable (cEURC, cEURT, cGBP*, cAUD*, cJPY*, cCHF*, cCAD*, cAUSDT). | -| **Chain 138 DODO PMM** | βœ… Live | DODOPMMIntegration + 3 pools (cUSDT/cUSDC usable; cUSDT/USDT, cUSDC/USDC use mainnet addresses β†’ no liquidity on 138). DODOPMMProvider deployed; routing cUSDT↔cUSDC live. | +| **Chain 138 DODO PMM** | βœ… Live | DODOPMMIntegration + 6 public pools are live on Chain 138: stable pairs plus the three public XAU pools. Official mirror `USDT/USDC` pools were corrected and funded locally. DODOPMMProvider remains deployed; routing cUSDT↔cUSDC and the live local direct/ XAU paths are active. | | **Chain 138 β†’ destination bridges** | βœ… CCIP + Alltra | CCIP WETH9/WETH10 to Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Cronos, **Celo + Gnosis (2026-03-04)**. Gnosis: 0x4ab39b5BaB7b463435209A9039bd40Cf241F5a82 (WETH9), 0xC15ACdBAC59B3C7Cb4Ea4B3D58334A4b143B4b44 (WETH10). AlltraAdapter 138↔651940. Wemix pending (need 0.4 WEMIX). | | **Destination tokens (cW\*)** | ⚠️ Design / partial | cWUSDT, cWUSDC deployed on 9 chains (1, 25, 56, 137, 100, 43114, 8453, 42161, 10); cWEURC and others partial. Addresses in .env; **deployment-status.json** empty (design-only). | -| **Destination DODO/Uniswap LPs** | ❌ Not deployed | cross-chain-pmm-lps **pool-matrix** defines cW*/USDC, cW*/USDT per chain; **deployment-status.json** has no pool addresses. Public-chain edge pools and bot not live. | +| **Destination DODO/Uniswap LPs** | ⚠️ Partial graph / pools not live | cross-chain-pmm-lps **pool-matrix** defines cW*/USDC, cW*/USDT per chain; **deployment-status.json** now records deployed cW* token addresses and bridge availability, but PMM pool addresses are still empty. Public-chain edge pools and bot not live. | | **Uniswap on 138** | ❌ | No Uniswap V2/V3 factory on Chain 138. | | **Uniswap on ALL Mainnet (651940)** | ⚠️ Env placeholders | HYDX DEX present; Uniswap V2/V3 and DODO env vars in dex-factories; no pool addresses in repo. | @@ -89,12 +89,19 @@ | Pool pair | Pool address | Base token | Quote token | Status | Routing | |-----------|--------------|------------|-------------|--------|---------| -| cUSDT / cUSDC | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | cUSDT | cUSDC | βœ… Created; liquidity addible | **To:** cUSDTβ†’cUSDC. **From:** cUSDCβ†’cUSDT. | -| cUSDT / USDT (official) | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` | cUSDT | USDT (mainnet addr) | βœ… Created | Not used on 138 (official USDT has no code on 138). | -| cUSDC / USDC (official) | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` | cUSDC | USDC (mainnet addr) | βœ… Created | Not used on 138 (official USDC has no code on 138). | +| cUSDT / cUSDC | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | cUSDT | cUSDC | βœ… Funded (live) | `10,000,000 / 10,000,000` reserves on the corrected live PMM integration. | +| cUSDT / USDT (official mirror) | `0x6fc60DEDc92a2047062294488539992710b99D71` | cUSDT | USDT | βœ… Funded (live) | Uses Chain 138 `USDT` mirror `0x004b63A7B5b0E06f6bB6adb4a5F9f590BF3182D1`; `10,000,000 / 10,000,000` reserves. | +| cUSDC / USDC (official mirror) | `0x0309178ae30302D83c76d6Dd402a684eF3160eec` | cUSDC | USDC | βœ… Funded (live) | Uses Chain 138 `USDC` mirror `0x71D6687F38b93CCad569Fa6352c876eea967201b`; `10,000,000 / 10,000,000` reserves. | +| cUSDT / cXAUC | `0x1AA55E2001E5651349AfF5A63FD7A7Ae44f0F1b0` | cUSDT | cXAUC | βœ… Funded (live) | Public XAU pool; reserves `2,666,965 / 519.477`. | +| cUSDC / cXAUC | `0xEA9Ac6357CaCB42a83b9082B870610363B177cBa` | cUSDC | cXAUC | βœ… Funded (live) | Public XAU pool; reserves `1,000,000 / 194.782554`. | +| cEURT / cXAUC | `0xbA99bc1eAAC164569d5AcA96C806934DDaF970Cf` | cEURT | cXAUC | βœ… Funded (live) | Public XAU pool; reserves `1,000,000 / 225.577676`. | -- **DODOPMMIntegration:** `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (Mock DVM). -- **DODOPMMProvider:** `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` (all pools registered). +- **DODOPMMIntegration:** `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`. +- **DODOPMMProvider:** `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` (104/104 desired-state routes aligned). +- **PrivatePoolRegistry:** `0xb27057B27db09e8Df353AF722c299f200519882A` with live XAU pools: + - `cUSDT / cXAUC`: `0x94316511621430423a2cff0C036902BAB4aA70c2` + - `cUSDC / cXAUC`: `0x7867D58567948e5b9908F1057055Ee4440de0851` + - `cEURT / cXAUC`: `0x505403093826D494983A93b43Aa0B8601078A44e` - **Uniswap on 138:** None (no factory documented). **MCP allowlist (Chain 138):** [ai-mcp-pmm-controller/config/allowlist-138.json](../../ai-mcp-pmm-controller/config/allowlist-138.json) β€” lists the three pools; `get_pool_state`, `identify_pool_interface`, quote/add/remove liquidity. @@ -127,8 +134,11 @@ |------------|----------|--------|--------| | cUSDT | cUSDC | DODOPMMIntegration / DODOPMMProvider β†’ pool cUSDT/cUSDC | βœ… | | cUSDC | cUSDT | Same pool | βœ… | -| cUSDT | USDT (official) | Pool exists; **not usable on 138** (no official USDT contract on 138) | β€” | -| cUSDC | USDC (official) | Pool exists; **not usable on 138** (no official USDC contract on 138) | β€” | +| cUSDT | USDT (official mirror) | DODOPMMIntegration / pool `0x6fc60DEDc92a2047062294488539992710b99D71` | βœ… | +| cUSDC | USDC (official mirror) | DODOPMMIntegration / pool `0x0309178ae30302D83c76d6Dd402a684eF3160eec` | βœ… | +| cUSDT | cXAUC | DODOPMMIntegration / pool `0x1AA55E2001E5651349AfF5A63FD7A7Ae44f0F1b0` | βœ… | +| cUSDC | cXAUC | DODOPMMIntegration / pool `0xEA9Ac6357CaCB42a83b9082B870610363B177cBa` | βœ… | +| cEURT | cXAUC | DODOPMMIntegration / pool `0xbA99bc1eAAC164569d5AcA96C806934DDaF970Cf` | βœ… | ### 5.2 Cross-chain routing (138 β†’ destination) @@ -169,7 +179,7 @@ | Chain ID | Name | Tokens deployed | Bridge from 138 | Bridge to 138 | DODO/Uniswap LPs | |----------|------|------------------|------------------|---------------|-------------------| -| 138 | DeFi Oracle | cUSDT, cUSDC, WETH, WETH10, LINK | β€” | β€” | DODO: 3 pools (1 usable: cUSDT/cUSDC) | +| 138 | DeFi Oracle | cUSDT, cUSDC, cEURT, cXAUC, cXAUT, WETH, WETH10, LINK, official mirrors | β€” | β€” | DODO: 6 public pools live + 3 private XAU pools live | | 1 | Ethereum | WETH, USDT, USDC, DAI | βœ… CCIP WETH9/10 | βœ… CCIP relay | Native DEX; cW* design | | 651940 | ALL Mainnet | AUSDT, USDC, WETH, WALL | βœ… AlltraAdapter | βœ… AlltraAdapter | Env placeholders; HYDX | | 25 | Cronos | USDW, EURW, …; cW* | βœ… CCIP | βœ… CCIP | cW* design only | diff --git a/docs/11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md b/docs/11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md index e725f62..bd43912 100644 --- a/docs/11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md +++ b/docs/11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md @@ -1,5 +1,7 @@ # Deployer Wallet β€” Complete Contract List by Network and Verification Status +> Historical note (2026-03-26): this inventory includes superseded PMM-address snapshots from earlier verification passes. The current canonical Chain 138 PMM stack is `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` and `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`. + **Last Updated:** 2026-02-27 **Deployer address:** `0x4A666F96fC8764181194447A7dFdb7d471b301C8` **Purpose:** Single list of all contracts deployed by (or attributed to) the deployer wallet, the network each is on, and whether each is **verified** on the chain’s explorer (Blockscout for Chain 138). @@ -110,11 +112,11 @@ Explorer: https://explorer.d-bis.org | Contract | Address | Deployed by | Verified | |----------|---------|-------------|----------| -| DODOPMMIntegration | `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` | Deployer | Unknown | -| DODOPMMProvider | `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` | Deployer | Unknown | -| Pool cUSDT/cUSDC | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | Deployer | Unknown | -| Pool cUSDT/USDT | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` | Deployer | Unknown | -| Pool cUSDC/USDC | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` | Deployer | Unknown | +| DODOPMMIntegration | `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` | Deployer | Unknown | +| DODOPMMProvider | `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` | Deployer | Unknown | +| Pool cUSDT/cUSDC | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | Deployer | Unknown | +| Pool cUSDT/USDT | `0x6fc60DEDc92a2047062294488539992710b99D71` | Deployer | Unknown | +| Pool cUSDC/USDC | `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` | Deployer | Unknown | ### TransactionMirror diff --git a/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md b/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md index 6040f40..69a164e 100644 --- a/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md +++ b/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md @@ -1,5 +1,7 @@ # Routes: Deployer Wallet β†’ Public-Network Stablecoins +> Historical note (2026-03-26): this route map originally captured a pre-correction PMM phase. The current canonical Chain 138 PMM stack is `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` and `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`. + **Last Updated:** 2026-03-04 **Purpose:** Single reference for **all possible routes** from the deployer wallet as **source** (minted/held tokens on all blockchains) **to** public-network stablecoins (USDT, USDC, DAI, AUSDT, etc.) on each chain. Uses Master Documentation and verifiable sources only. @@ -57,10 +59,10 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, | From (deployer holds) | To (public stable on 138) | Route | Status | |------------------------|----------------------------|--------|--------| -| cUSDT | cUSDC | DODOPMMIntegration / pool `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | βœ… Live | +| cUSDT | cUSDC | DODOPMMIntegration / pool `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | βœ… Live | | cUSDC | cUSDT | Same pool | βœ… Live | -| cUSDT | β€œUSDT (official)” | Pool `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` exists; **not usable** β€” no official USDT contract on 138 | β€” | -| cUSDC | β€œUSDC (official)” | Pool `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` exists; **not usable** β€” no official USDC on 138 | β€” | +| cUSDT | β€œUSDT (official)” | Pool `0x6fc60DEDc92a2047062294488539992710b99D71` is the funded intended canonical route; official USDT mirror is deployed on 138 | βœ… Live | +| cUSDC | β€œUSDC (official)” | Pool `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` exists; official USDC mirror is deployed on 138 | βœ… Live | **Note:** On 138 the only β€œpublic” stablecoin destinations that exist are cUSDT and cUSDC. There is no native USDT/USDC contract on 138. diff --git a/docs/11-references/DEPLOYER_WALLET_FUNDING_PLAN_PMM_POOLS.md b/docs/11-references/DEPLOYER_WALLET_FUNDING_PLAN_PMM_POOLS.md index 3536f64..941f135 100644 --- a/docs/11-references/DEPLOYER_WALLET_FUNDING_PLAN_PMM_POOLS.md +++ b/docs/11-references/DEPLOYER_WALLET_FUNDING_PLAN_PMM_POOLS.md @@ -1,5 +1,7 @@ # Deployer Wallet β€” Chain 138 Balances, Funding Plan (PMM Pools), and Tokens on All Networks +> Historical note (2026-03-26): this plan began on the earlier PMM stack. Use the canonical corrected pool addresses below and cross-check [LIQUIDITY_POOLS_MASTER_MAP.md](LIQUIDITY_POOLS_MASTER_MAP.md) before funding. + **Last Updated:** 2026-02-28 **Purpose:** Check deployer balances on ChainID 138, use **half** of balances for PMM liquidity pool funding; list all coins/tokens deployed by or associated with the deployer address on all networks. @@ -43,9 +45,9 @@ The script: | Pool | Base | Quote | Pool address | |------|------|--------|--------------| -| cUSDT / cUSDC | cUSDT | cUSDC | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | -| cUSDT / USDT | cUSDT | USDT (official) | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` | -| cUSDC / USDC | cUSDC | USDC (official) | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` | +| cUSDT / cUSDC | cUSDT | cUSDC | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | +| cUSDT / USDT | cUSDT | USDT (official) | `0x6fc60DEDc92a2047062294488539992710b99D71` | +| cUSDC / USDC | cUSDC | USDC (official) | `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` | **Allocation (half of deployer balances):** diff --git a/docs/11-references/DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md b/docs/11-references/DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md index 89993a3..0e5d57e 100644 --- a/docs/11-references/DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md +++ b/docs/11-references/DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md @@ -19,7 +19,7 @@ ## 2. Currently Deployed (Relevant to DEX / Routing / Cross-Chain) -- **Chain 138:** CCIP bridges (CCIPWETH9/10), UniversalCCIPBridge, BridgeOrchestrator, AlltraAdapter, Lockbox138 (trustless), PaymentChannelManager, GenericStateChannelManager, AddressMapper, MirrorManager, Vault/Reserve system, MerchantSettlementRegistry, WithdrawalEscrow, phased core, CREATE2 deterministic set, **DODOPMMIntegration** (`0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D`, Mock DVM β€” pools not yet created). See [CONTRACT_ADDRESSES_REFERENCE](CONTRACT_ADDRESSES_REFERENCE.md) and [ADDRESS_MATRIX_AND_STATUS](ADDRESS_MATRIX_AND_STATUS.md). +- **Chain 138:** CCIP bridges (CCIPWETH9/10), UniversalCCIPBridge, BridgeOrchestrator, AlltraAdapter, Lockbox138 (trustless), PaymentChannelManager, GenericStateChannelManager, AddressMapper, MirrorManager, Vault/Reserve system, MerchantSettlementRegistry, WithdrawalEscrow, phased core, CREATE2 deterministic set, **DODOPMMIntegration** (`0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`) and **DODOPMMProvider** (`0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`) with corrected desired-state mesh aligned. See [CONTRACT_ADDRESSES_REFERENCE](CONTRACT_ADDRESSES_REFERENCE.md) and [ADDRESS_MATRIX_AND_STATUS](ADDRESS_MATRIX_AND_STATUS.md). - **alltra-lifi-settlement:** MerchantSettlementRegistry, WithdrawalEscrow (Chain 138). --- @@ -30,7 +30,7 @@ | Item | Location | Status | What’s needed | |------|----------|--------|----------------| -| **DODOPMMIntegration** | `smom-dbis-138/contracts/dex/DODOPMMIntegration.sol` | **Deployed** (Chain 138: `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D`, Mock DVM) | Create pools via `createCUSDTCUSDCPool`, `createCUSDTUSDTPool`, `createCUSDCUSDCPool`; add liquidity. See [PMM_DEX_ROUTING_STATUS](PMM_DEX_ROUTING_STATUS.md), [DODO_PMM_INTEGRATION](../../smom-dbis-138/docs/integration/DODO_PMM_INTEGRATION.md). | +| **DODOPMMIntegration** | `smom-dbis-138/contracts/dex/DODOPMMIntegration.sol` | **Deployed** (Chain 138: `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`) | Corrected canonical integration with desired-state JSON sync path. See [PMM_DEX_ROUTING_STATUS](PMM_DEX_ROUTING_STATUS.md), [DODO_PMM_INTEGRATION](../../smom-dbis-138/docs/integration/DODO_PMM_INTEGRATION.md). | | **DODOPMMProvider** | `smom-dbis-138/contracts/liquidity/providers/DODOPMMProvider.sol` | Placeholder | Implement oracle-driven `optimizePoolParameters` (or document flow); complete when DODO is integrated. See [NOT_CHANGED_BY_DESIGN_ACTIONABLE_STEPS](../00-meta/NOT_CHANGED_BY_DESIGN_ACTIONABLE_STEPS.md) Β§3. | | **Test** | `test/dex/DODOPMMIntegration.t.sol.bak` | Renamed to .bak | Restore/fix and re-enable when DODO integration is active (mockCall ambiguity was reason for .bak). | diff --git a/docs/11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md b/docs/11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md index e6edae6..0d71dce 100644 --- a/docs/11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md +++ b/docs/11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md @@ -140,6 +140,10 @@ Use this table to align token lists and docs with the Explorer (Blockscout) and | cXAUC | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | | cXAUT | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | +### 5.1 XAU tokens β€” unit of account (canonical) + +**cXAUC** and **cXAUT** use ISO code `XAU` on `CompliantFiatToken`. **Policy:** **1 full token = 1 troy ounce** of fine gold (`10^6` base units = 1 oz with 6 decimals). Minting, pools, and reporting must not treat these as dollar-stablecoin face value; USD notional is **spot price Γ— troy ounces**. See `CompliantFiatToken.sol` NatSpec and `smom-dbis-138/docs/tokenization/TOKEN_SCOPE_GRU.md`. + --- ## 6. Related Files @@ -159,11 +163,11 @@ Use this table to align token lists and docs with the Explorer (Blockscout) and | Source | cUSDT/cUSDC pool | cUSDT/USDT pool | cUSDC/USDC pool | |--------|------------------|-----------------|----------------| -| **ai-mcp-pmm-controller/config/allowlist-138.json** | `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | `0xa3Ee6091696B28e5497b6F491fA1e99047250c59` | `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5` | +| **ai-mcp-pmm-controller/config/allowlist-138.json** | `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | `0x6fc60DEDc92a2047062294488539992710b99D71` | `0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263` | | **LIQUIDITY_POOLS_MASTER_MAP.md** | Same | Same | Same | | **DEPLOYER_CONTRACTS_INVENTORY / ADDRESS_MATRIX** | Same | Same | Same | -**Result:** Pool addresses are consistent across allowlist, docs, and deployer inventory. `cross-chain-pmm-lps/config/deployment-status.json` does not list Chain 138 pools (it tracks cW* edge pools on other chains); Chain 138 PMM state is in allowlist and docs. +**Result:** Pool addresses should treat `0x6fc60DEDc92a2047062294488539992710b99D71` as the intended funded canonical `cUSDT/USDT` pool. `cross-chain-pmm-lps/config/deployment-status.json` does not list Chain 138 pools (it tracks cW* edge pools on other chains); Chain 138 PMM state is in allowlist and docs. --- @@ -173,7 +177,7 @@ Use this table to align token lists and docs with the Explorer (Blockscout) and | Check | Result | |-------|--------| -| **Contract** | DODOPMMIntegration at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (Chain 138) | +| **Contract** | DODOPMMIntegration at `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` (Chain 138) | | **Method** | `eth_call` to `compliantUSDT()` and `compliantUSDC()` (RPC: `http://192.168.11.211:8545`) | | **compliantUSDT()** | `0x93e66202a11b1772e55407b32b44e5cd8eda7f22` β€” matches Β§5 canonical cUSDT | | **compliantUSDC()** | `0xf22258f57794cc8e06237084b353ab30fffa640b` β€” matches Β§5 canonical cUSDC | diff --git a/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md b/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md index 4ba085c..6ce01b0 100644 --- a/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md +++ b/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md @@ -1,8 +1,8 @@ # Liquidity Pools Master Map β€” ChainID 138 & ALL Mainnet (Alltra) -**Last Updated:** 2026-02-28 -**Document Version:** 1.1 -**Status:** Reference documentation (designed vs deployed) +**Last Updated:** 2026-03-26 +**Document Version:** 1.2 +**Status:** Reference documentation (live Chain 138 pool state reflected) --- @@ -28,9 +28,11 @@ This document maps all **private**, **public**, **reserve**, and **stabilization | Chainlink | LINK | `0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03` | 18 | Standard | | Compliant USDT | cUSDT | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` | 6 | Stablecoin | | Compliant USDC | cUSDC | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` | 6 | Stablecoin | -| Tether USDT (Chain 138) | β€” | `0x15DF1D5BFDD8Aa4b380445D4e3E9B38d34283619` | β€” | Stablecoin | -| XAU (Gold) | XAU | **Not deployed** | β€” | Anchor (planned) | -| cEURT | cEURT | **Not deployed** | β€” | Stablecoin (planned) | +| Tether USD (Official Mirror) | USDT | `0x004b63A7B5b0E06f6bB6adb4a5F9f590BF3182D1` | 6 | Stablecoin | +| USD Coin (Official Mirror) | USDC | `0x71D6687F38b93CCad569Fa6352c876eea967201b` | 6 | Stablecoin | +| Gold (Compliant) | cXAUC | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | XAU anchor | +| Tether Gold (Compliant) | cXAUT | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | XAU anchor | +| Tether EUR (Compliant) | cEURT | `0xdf4b71c61E5912712C1Bdd451416B9aC26949d72` | 6 | Stablecoin | **Source:** [CHAIN138_TOKEN_ADDRESSES.md](CHAIN138_TOKEN_ADDRESSES.md), [CONTRACT_ADDRESSES_REFERENCE.md](CONTRACT_ADDRESSES_REFERENCE.md) @@ -60,16 +62,16 @@ This document maps all **private**, **public**, **reserve**, and **stabilization | Pool Pair | Type | DEX | Status | Notes | |-----------|------|-----|--------|-------| -| cUSDT / cUSDC | Public | DODO PMM | βœ… **Created** | Pool: `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8`; script: `CreateCUSDTCUSDCPool.s.sol` or `create-all-pmm-pools-chain138.sh` | -| cUSDT / USDT (official) | Public | DODO PMM | βœ… **Created** | Pool: `0xa3Ee6091696B28e5497b6F491fA1e99047250c59`; script: `CreateCUSDTUSDTPool.s.sol` | -| cUSDC / USDC (official) | Public | DODO PMM | βœ… **Created** | Pool: `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5`; script: `CreateCUSDCUSDCPool.s.sol` | -| cUSDT / XAU | Public | DODO PMM | ❌ **Not deployed** | Requires XAU token (not on chain) | -| cUSDC / XAU | Public | DODO PMM | ❌ **Not deployed** | Requires XAU token | -| cEURT / XAU | Public | DODO PMM | ❌ **Not deployed** | Requires XAU (not on chain); cEURT deployed | +| cUSDT / cUSDC | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0xff8d3b8fDF7B112759F076B69f4271D4209C0849`; seeded `10,000,000 / 10,000,000` | +| cUSDT / USDT (official mirror) | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0x6fc60DEDc92a2047062294488539992710b99D71`; seeded `10,000,000 / 10,000,000` | +| cUSDC / USDC (official mirror) | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0x0309178ae30302D83c76d6Dd402a684eF3160eec`; seeded `10,000,000 / 10,000,000` | +| cUSDT / XAU (cXAUC) | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0x1AA55E2001E5651349AfF5A63FD7A7Ae44f0F1b0`; reserves `2,666,965 cUSDT / 519.477 cXAUC` | +| cUSDC / XAU (cXAUC) | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0xEA9Ac6357CaCB42a83b9082B870610363B177cBa`; reserves `1,000,000 cUSDC / 194.782554 cXAUC` | +| cEURT / XAU (cXAUC) | Public | DODO PMM | βœ… **Funded (live)** | Pool: `0xbA99bc1eAAC164569d5AcA96C806934DDaF970Cf`; reserves `1,000,000 cEURT / 225.577676 cXAUC` | **Purpose:** User routing, price discovery, flash loan access. **Not** primary stabilization. -**Contracts:** `DODOPMMIntegration.sol` at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (Mock DVM); all three pools created. **DODOPMMProvider** deployed at `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0`; pools registered via `RegisterDODOPools.s.sol`. **Full mesh:** [PMM_FULL_MESH_AND_PUBLIC_SINGLE_SIDED_PLAN.md](../03-deployment/PMM_FULL_MESH_AND_PUBLIC_SINGLE_SIDED_PLAN.md) and `create-pmm-full-mesh-chain138.sh` (all c* vs c* + optional c* vs official). **Add liquidity:** [ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md](../03-deployment/ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md). **Pre-deployment steps:** [PRE_DEPLOYMENT_CHECKLIST.md](../03-deployment/PRE_DEPLOYMENT_CHECKLIST.md). +**Contracts:** `DODOPMMIntegration.sol` at `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`; **DODOPMMProvider** at `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`; public stable and public XAU pools are live and funded. **Full mesh:** [PMM_FULL_MESH_AND_PUBLIC_SINGLE_SIDED_PLAN.md](../03-deployment/PMM_FULL_MESH_AND_PUBLIC_SINGLE_SIDED_PLAN.md) and `create-pmm-full-mesh-chain138.sh` (all c* vs c* + optional c* vs official). **Add liquidity:** [ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md](../03-deployment/ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md). **Pre-deployment steps:** [PRE_DEPLOYMENT_CHECKLIST.md](../03-deployment/PRE_DEPLOYMENT_CHECKLIST.md). **Config:** `CHAIN_138_DODO_PMM_INTEGRATION` set in .env; `CHAIN_138_DODO_POOL_MANAGER`, `CHAIN_138_DODO_VENDING_MACHINE` (optional). **Source:** [VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md](../VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md) Β§4, [DODO_PMM_INTEGRATION.md](../../smom-dbis-138/docs/integration/DODO_PMM_INTEGRATION.md) @@ -80,13 +82,13 @@ This document maps all **private**, **public**, **reserve**, and **stabilization | Pool Pair | Type | Registry | Status | Notes | |-----------|------|----------|--------|-------| -| cUSDT ↔ XAU | Private | PrivatePoolRegistry | ❌ **Not deployed** | Requires DODOPMMIntegration + XAU | -| cUSDC ↔ XAU | Private | PrivatePoolRegistry | ❌ **Not deployed** | Same | -| cEURT ↔ XAU | Private | PrivatePoolRegistry | ❌ **Not deployed** | Requires cEURT + XAU | +| cUSDT ↔ XAU (cXAUC) | Private | PrivatePoolRegistry | βœ… **Funded (live)** | Pool: `0x94316511621430423a2cff0C036902BAB4aA70c2`; reserves `2,666,965 cUSDT / 519.477 cXAUC` | +| cUSDC ↔ XAU (cXAUC) | Private | PrivatePoolRegistry | βœ… **Funded (live)** | Pool: `0x7867D58567948e5b9908F1057055Ee4440de0851`; reserves `1,000,000 cUSDC / 194.782554 cXAUC` | +| cEURT ↔ XAU (cXAUC) | Private | PrivatePoolRegistry | βœ… **Funded (live)** | Pool: `0x505403093826D494983A93b43Aa0B8601078A44e`; reserves `1,000,000 cEURT / 225.577676 cXAUC` | **Purpose:** Stabilizer-only swaps for peg rebalancing. Triangular arbitrage: TokenA ↔ XAU ↔ TokenB. -**Contracts:** `PrivatePoolRegistry.sol` (exists); `Stabilizer.sol` (Phase 3); `DeployPrivatePoolRegistryAndPools.s.sol`. +**Contracts:** `PrivatePoolRegistry.sol` at `0xb27057B27db09e8Df353AF722c299f200519882A`; `Stabilizer.sol` (Phase 3); `DeployPrivatePoolRegistryAndPools.s.sol`. **Env:** `XAU_ADDRESS_138`, `cEURT_ADDRESS_138`, `DODOPMM_INTEGRATION_ADDRESS` β€” all required for pool creation. @@ -179,8 +181,8 @@ See [SUBMODULE_RELATIONSHIP_MAP.md](SUBMODULE_RELATIONSHIP_MAP.md) for submodule | Category | Chain 138 | ALL Mainnet (651940) | |----------|-----------|----------------------| -| **Public DEX pools** | DODO PMM: integration deployed (Mock DVM); pools not created | Uniswap V2/V3, DODO (env placeholders); HYDX DEX present, pools undisclosed | -| **Private stabilization** | XAU-anchored (designed; XAU/cEURT not deployed) | Not documented | +| **Public DEX pools** | DODO PMM: stable + XAU pools live and funded | Uniswap V2/V3, DODO (env placeholders); HYDX DEX present, pools undisclosed | +| **Private stabilization** | XAU-anchored private pools live and funded | Not documented | | **Reserve / vault** | ReserveSystem, ReserveTokenIntegration βœ… | Not documented | | **Bridge liquidity** | LiquidityPoolETH (placeholder) | Not documented | | **Vault / XAU** | XAU Oracle, Ledger βœ… | Not applicable | @@ -191,8 +193,8 @@ See [SUBMODULE_RELATIONSHIP_MAP.md](SUBMODULE_RELATIONSHIP_MAP.md) for submodule From [VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md](../VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md): -1. **Phase 1:** Deploy public DODO PMM pools (cUSDT/cUSDC, then cUSDT/XAU, cUSDC/XAU, cEURT/XAU when XAU/cEURT exist) -2. **Phase 2:** Deploy private XAU-anchored stabilization pools (PrivatePoolRegistry + DODO pools) +1. **Phase 1:** Deploy public DODO PMM pools (completed for cUSDT/cUSDC, official mirrors, and the three public XAU pools) +2. **Phase 2:** Deploy private XAU-anchored stabilization pools (completed for cUSDT, cUSDC, and cEURT against cXAUC) 3. **Phase 3:** Deploy Stabilizer contract (`checkDeviation` β†’ `executePrivateSwap`) 4. **Phase 4:** Cross-chain arbitrage engine (138 ↔ Alltra) 5. **Phase 5:** Stress testing diff --git a/docs/11-references/MINT_C_AND_CW_ON_ALL_NETWORKS.md b/docs/11-references/MINT_C_AND_CW_ON_ALL_NETWORKS.md index 887cc15..d239dce 100644 --- a/docs/11-references/MINT_C_AND_CW_ON_ALL_NETWORKS.md +++ b/docs/11-references/MINT_C_AND_CW_ON_ALL_NETWORKS.md @@ -20,7 +20,11 @@ All 12 c* are already deployed; deployer is owner. Mint with cast or scripts. **Script (cUSDT/cUSDC only):** `smom-dbis-138/scripts/mint-for-liquidity.sh` -**Script (all 12 c*):** `smom-dbis-138/scripts/mint-all-c-star-138.sh [amount_human]` β€” mints cUSDT, cUSDC, cEURC, cEURT, cGBPC, cGBPT, cAUDC, cJPYC, cCHFC, cCADC, cXAUC, cXAUT to deployer (default 1M each). +**Script (all 12 c*):** `smom-dbis-138/scripts/mint-all-c-star-138.sh [amount_human]` β€” mints cUSDT, cUSDC, cEURC, cEURT, cGBPC, cGBPT, cAUDC, cJPYC, cCHFC, cCADC, cXAUC, cXAUT to deployer (default 1M each). **cXAUC/cXAUT:** `amount_human` is **troy ounces** (1 token = 1 troy oz Au), not dollars. + +**Script (cXAUC/cXAUT only, troy oz):** `smom-dbis-138/scripts/mint-xau-chain138.sh [--cxauc-only|--cxaut-only]` β€” uses decimal ounces β†’ 6-decimal base units; optional `MINT_TO=0x…`, `DRY_RUN=1`. + +**Reconcile deployer (burn all + remint from USD peg):** `smom-dbis-138/scripts/reconcile-xau-deployer-chain138.sh` β€” env: `RETARGET_USD`, `RETARGET_MODE` (`split` | `each`), `XAU_SPOT_USD`, or `TROY_OZ_CXAUC` + `TROY_OZ_CXAUT`; `DRY_RUN=1` to preview. **Cast (per token):** ```bash diff --git a/docs/11-references/NETWORK_CONFIGURATION_MASTER.md b/docs/11-references/NETWORK_CONFIGURATION_MASTER.md index d6053e9..2a3d383 100644 --- a/docs/11-references/NETWORK_CONFIGURATION_MASTER.md +++ b/docs/11-references/NETWORK_CONFIGURATION_MASTER.md @@ -99,6 +99,7 @@ These IPs are **fixed and permanent**. Scripts and configs must use these values - **Range:** 192.168.11.120 - 192.168.11.159 - **Purpose:** DBIS Core services - **VMIDs:** 10120, 10130, 10150-10151 +- **10120 dbis-redis:** live/static IP **192.168.11.125** (`DBIS_REDIS_IP` in `config/ip-addresses.conf`); older docs may still say .120. ### RPC Nodes & Phoenix Vault (192.168.11.200-243) - **Range:** 192.168.11.200 - 192.168.11.243 (excl. 192.168.11.170-212 reserved for CCIP interim) diff --git a/docs/11-references/PLACEHOLDER_IMPLEMENTATIONS.md b/docs/11-references/PLACEHOLDER_IMPLEMENTATIONS.md index c1ab6e6..382a592 100644 --- a/docs/11-references/PLACEHOLDER_IMPLEMENTATIONS.md +++ b/docs/11-references/PLACEHOLDER_IMPLEMENTATIONS.md @@ -199,7 +199,7 @@ ## Related Documents -- **[COMPREHENSIVE_PROJECT_REVIEW.md](../archive/00-meta-pruned/COMPREHENSIVE_PROJECT_REVIEW.md)** - Project review +- **[MASTER_INDEX.md](../MASTER_INDEX.md)** β€” documentation entry point; **[TODOS_CONSOLIDATED.md](../00-meta/TODOS_CONSOLIDATED.md)** β€” open work - **[the-order Documentation](../../the-order/)** - the-order service documentation --- diff --git a/docs/11-references/PMM_DEX_ROUTING_STATUS.md b/docs/11-references/PMM_DEX_ROUTING_STATUS.md index 2f05561..8d9d9d5 100644 --- a/docs/11-references/PMM_DEX_ROUTING_STATUS.md +++ b/docs/11-references/PMM_DEX_ROUTING_STATUS.md @@ -1,14 +1,15 @@ # PMM Liquidity Pools & DEX/DeFi Routing β€” Full System Status -**Last Updated:** 2026-02-28 +**Last Updated:** 2026-03-26 **Purpose:** Single reference for DEX/DeFi and PMM liquidity pool routing β€” what is designed, deployed, and in use. --- -## Executive summary (updated 2026-02-28) +## Executive summary (updated 2026-03-26) -- **DODOPMMIntegration** is **deployed** on Chain 138 at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (Mock DVM). **All three PMM pools are created:** cUSDT/cUSDC (`0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8`), cUSDT/USDT (`0xa3Ee6091696B28e5497b6F491fA1e99047250c59`), cUSDC/USDC (`0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5`). On-chain PMM swaps are available via DODOPMMIntegration and DODOPMMProvider. -- **DODOPMMProvider** is **deployed** at `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` with all three pools registered (see [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md), [ADDRESS_MATRIX_AND_STATUS](ADDRESS_MATRIX_AND_STATUS.md)). +- **DODOPMMIntegration** is **deployed** on Chain 138 at `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`. The corrected canonical stack now has **104 desired-state pools aligned**. +- **DODOPMMProvider** is **deployed** at `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` with **104/104 provider routes aligned** to the integration. +- **Live funded public pools** are: cUSDT/cUSDC (`0xff8d3b8fDF7B112759F076B69f4271D4209C0849`), cUSDT/USDT (`0x6fc60DEDc92a2047062294488539992710b99D71`), cUSDC/USDC (`0x9f74Be42725f2Aa072a9E0CdCce0E7203C510263`), cUSDT/cXAUC (`0x94316511621430423a2cff0C036902BAB4aA70c2`), cUSDC/cXAUC (`0x7867D58567948e5b9908F1057055Ee4440de0851`), cEURT/cXAUC (`0x505403093826D494983A93b43Aa0B8601078A44e`). - **EnhancedSwapRouter** is **not deployed**; multi-provider DEX routing (Uniswap/Balancer/Curve/1inch) is not live. - **Token-aggregation** service is implemented and runnable (single-hop quotes; can index DODO pools). **Bridge quote API** (swap+bridge+swap) is implemented. - **Full system status:** PMM liquidity and DODOPMMProvider routing are **deployed and in use** on Chain 138. Remaining: add liquidity to pools as needed; optionally deploy EnhancedSwapRouter when other DEX pools exist on 138. @@ -23,7 +24,7 @@ | Layer | Description | Components | |-------|-------------|------------| | **On-chain multi-provider** | Size-based routing across DEXs for one leg (e.g. WETH↔stable) | EnhancedSwapRouter (Uniswap V3, Dodoex PMM, Balancer, Curve, 1inch) | -| **PMM pools (Chain 138)** | cUSDT/cUSDC and cUSDT↔USDT, cUSDC↔USDC via DODO-style PMM | DODOPMMIntegration, DODOPMMProvider | +| **PMM pools (Chain 138)** | Desired-state full mesh with live funded public stable/XAU pools | DODOPMMIntegration, DODOPMMProvider | | **Token-aggregation API** | Single-hop quotes, pool indexing, reports | token-aggregation service (UniswapV2/V3 + DODO from DODOPMMIntegration) | | **Swap–bridge–swap** | Cross-chain: swap (source) β†’ bridge β†’ swap (destination) | SwapBridgeSwapCoordinator (on-chain), orchestration QuoteService (`POST /api/bridge/quote`) | | **Public-chain cW* mesh** | cW* wrappers on public chains, single-sided PMM edge pools, bot-driven peg | cross-chain-pmm-lps (specs, simulation, deployment recipe) | @@ -44,9 +45,9 @@ | Component | Status | Address / Notes | |-----------|--------|------------------| -| **DODOPMMIntegration** | Deployed | `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` β€” uses **Mock DVM** (MockDVMFactory/MockDVMPool); not official DODO AMM. | -| **PMM pools (cUSDT/cUSDC, cUSDT/USDT, cUSDC/USDC)** | **Created** | cUSDT/cUSDC: `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8`; cUSDT/USDT: `0xa3Ee6091696B28e5497b6F491fA1e99047250c59`; cUSDC/USDC: `0x90bd9Bf18Daa26Af3e814ea224032d015db58Ea5`. See [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md). | -| **DODOPMMProvider** | **Deployed** | `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0`; all three pools registered via `RegisterDODOPools.s.sol`. | +| **DODOPMMIntegration** | Deployed | `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` β€” corrected canonical integration. | +| **PMM pools (desired-state)** | **104 aligned** | Full desired-state JSON reconciled; live funded public pools are listed in [LIQUIDITY_POOLS_MASTER_MAP](LIQUIDITY_POOLS_MASTER_MAP.md). | +| **DODOPMMProvider** | **Deployed** | `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`; 104/104 routes aligned to the corrected integration. | | **EnhancedSwapRouter** | Not deployed | Deploy when Uniswap/Balancer pools exist on 138; configure quoter and Balancer poolId. | | **LiquidityPoolETH** (trustless bridge) | Placeholder | Not deployed; config uses `0x0`. | @@ -92,7 +93,7 @@ | Area | Ready? | In use? | |------|--------|--------| -| **PMM liquidity pools (Chain 138)** | **Yes** | DODOPMMIntegration + three pools created; DODOPMMProvider deployed and registered; on-chain swaps available (liquidity may still need to be added). | +| **PMM liquidity pools (Chain 138)** | **Yes** | Corrected canonical stack deployed; 104 desired-state pools aligned; live funded public stable/XAU pools available. | | **DEX routing (EnhancedSwapRouter)** | No | Contract not deployed; no Uniswap/Balancer pools on 138. | | **Token-aggregation API** | Yes | Service can run; single-hop quotes; can index DODO pools once DODOPMMIntegration has pools. | | **Bridge quote (swap+bridge+swap)** | Partial | QuoteService implemented; coordinator and router optional; not full E2E flow. | diff --git a/docs/11-references/POOL_ACCESS_DASHBOARD_API_MCP.md b/docs/11-references/POOL_ACCESS_DASHBOARD_API_MCP.md index ff1c940..738cb89 100644 --- a/docs/11-references/POOL_ACCESS_DASHBOARD_API_MCP.md +++ b/docs/11-references/POOL_ACCESS_DASHBOARD_API_MCP.md @@ -10,7 +10,7 @@ | Access method | Chain 138 pools | cW* edge pools (5 public chains) | Requirement | |---------------|------------------|-----------------------------------|-------------| | **Standard DODO dashboard** | ❌ No | ⚠️ Only if real DODO + chain supported | 138 uses Mock DVM; dashboard does not support custom chain 138. | -| **API (token-aggregation)** | βœ… Yes | βœ… Yes (when env set) | Chain 138: set `CHAIN_138_DODO_PMM_INTEGRATION`. cW* chains 1, 10, 56, 100, 137: added to dex-factories and chains.ts; set `CHAIN_*_DODO_PMM_INTEGRATION` or `CHAIN_*_DODO_POOL_MANAGER` and run indexer for those chains. | +| **API (token-aggregation)** | βœ… Yes | βœ… Yes (when env set) | Chain 138: set `CHAIN_138_DODO_PMM_INTEGRATION=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d`. cW* chains 1, 10, 56, 100, 137: added to dex-factories and chains.ts; set `CHAIN_*_DODO_PMM_INTEGRATION` or `CHAIN_*_DODO_POOL_MANAGER` and run indexer for those chains. | | **MCP (ai-mcp-pmm-controller)** | βœ… Yes (after allowlist) | ⚠️ Per-chain + allowlist | Chain 138: MockDVMPool now has getOraclePrice, _K_, _LP_FEE_RATE_ so dodo_pmm_v2_like profile works; add each pool to allowlist and set RPC to 138. Other chains: one MCP instance per chain + allowlist. | **Not all pools can be accessed by all three today.** Below is what works, what’s missing, and what to change. @@ -37,7 +37,7 @@ | Pool scope | Accessible? | Requirement | |------------|-------------|-------------| -| **Chain 138** | βœ… **Yes** | Set `CHAIN_138_DODO_PMM_INTEGRATION=0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (and RPC) in the service env. The pool indexer uses `getAllPools()`, then `getPoolConfig`, `getPoolReserves`, `getPoolPriceOrOracle` per pool. Once pools exist and the indexer runs, they appear in `/api/v1/tokens`, `/api/v1/pools`, `/api/v1/quote`, and report endpoints. | +| **Chain 138** | βœ… **Yes** | Set `CHAIN_138_DODO_PMM_INTEGRATION=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` (and RPC) in the service env. The pool indexer uses `getAllPools()`, then `getPoolConfig`, `getPoolReserves`, `getPoolPriceOrOracle` per pool. Once pools exist and the indexer runs, they appear in `/api/v1/tokens`, `/api/v1/pools`, `/api/v1/quote`, and report endpoints. | | **ALL Mainnet (651940)** | ⚠️ **If configured** | Set `CHAIN_651940_DODO_POOL_MANAGER` (and optional `dodoPmmIntegration`) in dex-factories / env. Today no DODO pool list is documented for 651940. | | **cW* edge (chains 1, 10, 56, 100, 137)** | βœ… **Yes** (when env set) | `dex-factories.ts` and `chains.ts` now include chainIds 1, 10, 56, 100, 137. Set `CHAIN_*_DODO_PMM_INTEGRATION` or `CHAIN_*_DODO_POOL_MANAGER` (and `CHAIN_*_RPC_URL`) so the indexer can index DODO/pools on those chains. | diff --git a/docs/11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md b/docs/11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md index a3b68fa..907f09d 100644 --- a/docs/11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md +++ b/docs/11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md @@ -1,5 +1,7 @@ # Routes: No Pre-Funded Bridge Required +> Historical note (2026-03-26): verify live PMM pool addresses against [LIQUIDITY_POOLS_MASTER_MAP.md](LIQUIDITY_POOLS_MASTER_MAP.md). Earlier route examples may reference a superseded PMM stack. + **Last Updated:** 2026-03-04 **Purpose:** Routes from the deployer wallet (or any user) to public-network stablecoins (or between tokens) where **pre-funding a destination bridge is not required**. These use **lock-mint** (source locks, destination mints), **same-chain** (no bridge), or **DEX-only** flows. For routes that *do* require bridge pre-funding (e.g. 138 β†’ Mainnet WETH), see [DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES](DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md). @@ -27,7 +29,7 @@ No bridge is used; no pre-fund requirement. | From (chain) | To (same chain) | Mechanism | Status | |--------------|-----------------|------------|--------| -| **138 cUSDT** | 138 cUSDC | DODOPMMIntegration / pool `0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8` | βœ… Live | +| **138 cUSDT** | 138 cUSDC | DODOPMMIntegration / pool `0xff8d3b8fDF7B112759F076B69f4271D4209C0849` | βœ… Live | | **138 cUSDC** | 138 cUSDT | Same pool | βœ… Live | | **Any chain** | Same chain public stable | Native DEX (Uniswap, etc.) β€” deployer or user holds token on that chain, swaps on DEX | βœ… Standard | diff --git a/docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md b/docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md index 1a758a2..ae2e134 100644 --- a/docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md +++ b/docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md @@ -185,7 +185,7 @@ git commit -m "Update arromis-monorepo submodules" - **[.gitmodules](../../.gitmodules)** - Git submodule configuration (repo root) - **[PROJECT_STRUCTURE.md](../../PROJECT_STRUCTURE.md)** - Project and directory structure -- **[COMPREHENSIVE_PROJECT_REVIEW.md](../archive/00-meta-pruned/COMPREHENSIVE_PROJECT_REVIEW.md)** - Project review +- **[MASTER_INDEX.md](../MASTER_INDEX.md)** β€” documentation entry point; **[DOCUMENTATION_CONSOLIDATION_PLAN.md](../00-meta/DOCUMENTATION_CONSOLIDATION_PLAN.md)** β€” consolidation scope --- diff --git a/docs/11-references/TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER.md b/docs/11-references/TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER.md index dcf4adb..18d50cd 100644 --- a/docs/11-references/TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER.md +++ b/docs/11-references/TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER.md @@ -37,8 +37,8 @@ On **Chain 138**, the deployer is **owner** of all compliant token contracts dep | **cJPYC** | `0xEe269e1226a334182aace90056EE4ee5Cc8A6770` | 6 | Future pools / bridge | | **cCHFC** | `0x873990849DDa5117d7C644f0aF24370797C03885` | 6 | Future pools / bridge | | **cCADC** | `0x54dBd40cF05e15906A2C21f600937e96787f5679` | 6 | Future pools / bridge | -| **cXAUC** | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | Future pools / bridge | -| **cXAUT** | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | Future pools / bridge | +| **cXAUC** | `0x290E52a8819A4fbD0714E517225429aA2B70EC6b` | 6 | **1 token = 1 troy oz Au** (not USD face); pools / bridge | +| **cXAUT** | `0x94e408E26c6FD8F4ee00b54dF19082FDA07dC96E` | 6 | **1 token = 1 troy oz Au** (not USD face); pools / bridge | **Decimals:** All use 6 decimals. Amount in base units = amount Γ— 10^6 (e.g. 1_000_000 = 1 token). diff --git a/docs/12-quick-reference/QUICK_REFERENCE.md b/docs/12-quick-reference/QUICK_REFERENCE.md index 77932f9..9df21dc 100644 --- a/docs/12-quick-reference/QUICK_REFERENCE.md +++ b/docs/12-quick-reference/QUICK_REFERENCE.md @@ -13,7 +13,7 @@ | Execution order (Wave 0β†’1β†’2β†’3) | [FULL_PARALLEL_EXECUTION_ORDER.md](../00-meta/FULL_PARALLEL_EXECUTION_ORDER.md) | | Wave 1 task status | [WAVE1_COMPLETION_SUMMARY.md](../00-meta/WAVE1_COMPLETION_SUMMARY.md) | | Wave 2/3 operator checklist | [WAVE2_WAVE3_OPERATOR_CHECKLIST.md](../00-meta/WAVE2_WAVE3_OPERATOR_CHECKLIST.md) | -| Run log | [FULL_PARALLEL_RUN_LOG.md](../archive/00-meta-pruned/FULL_PARALLEL_RUN_LOG.md) (archived) | +| Validation / verification | `./scripts/validation/validate-config-files.sh` Β· `./scripts/verify/run-all-validation.sh` Β· [WAVE1_COMPLETION_SUMMARY.md](../00-meta/WAVE1_COMPLETION_SUMMARY.md) | | Full verification | `bash scripts/verify/run-full-verification.sh` | | E2E routing only | `bash scripts/verify/verify-end-to-end-routing.sh --profile=public` | diff --git a/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md b/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md index da87825..fab9b6a 100644 --- a/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md +++ b/docs/archive/completion/IP_ADDRESS_REVIEW_COMPLETE.md @@ -136,7 +136,7 @@ This document provides a complete review of all IP address assignments across: |------|------------|----------|--------|--------------|-------| | 10100 | 192.168.11.105 | dbis-postgres-primary | βœ… Running | ml110 | βœ… Moved from .100 | | 10101 | 192.168.11.106 | dbis-postgres-replica-1 | βœ… Running | ml110 | βœ… Moved from .101 | -| 10120 | 192.168.11.120 | dbis-redis | βœ… Running | ml110 | βœ… No conflict | +| 10120 | 192.168.11.125 | dbis-redis | βœ… Running | ml110 | βœ… No conflict | | 10130 | 192.168.11.130 | dbis-frontend | βœ… Running | ml110 | βœ… No conflict | | 10150 | 192.168.11.155 | dbis-api-primary | βœ… Running | ml110 | βœ… Moved from .150 | | 10151 | 192.168.11.156 | dbis-api-secondary | βœ… Running | ml110 | βœ… Moved from .151 | diff --git a/docs/archive/historical/INFRASTRUCTURE_REVIEW_QUICK_REFERENCE.md b/docs/archive/historical/INFRASTRUCTURE_REVIEW_QUICK_REFERENCE.md index 7c262be..e28f44b 100644 --- a/docs/archive/historical/INFRASTRUCTURE_REVIEW_QUICK_REFERENCE.md +++ b/docs/archive/historical/INFRASTRUCTURE_REVIEW_QUICK_REFERENCE.md @@ -80,7 +80,7 @@ Remove duplicates: - 2502: Besu RPC-3 (192.168.11.252) ⭐ - 10100: DBIS PostgreSQL Primary (192.168.11.100) - 10101: DBIS PostgreSQL Replica (192.168.11.101) -- 10120: DBIS Redis (192.168.11.120) +- 10120: DBIS Redis (192.168.11.125) - 10130: DBIS Frontend (192.168.11.130) ⭐ - 10150: DBIS API Primary (192.168.11.150) ⭐ - 10151: DBIS API Secondary (192.168.11.151) ⭐ diff --git a/docs/archive/root-status-reports/VM_INVENTORY_REVIEW_AND_RECOMMENDATIONS.md b/docs/archive/root-status-reports/VM_INVENTORY_REVIEW_AND_RECOMMENDATIONS.md index be736af..6b85b70 100644 --- a/docs/archive/root-status-reports/VM_INVENTORY_REVIEW_AND_RECOMMENDATIONS.md +++ b/docs/archive/root-status-reports/VM_INVENTORY_REVIEW_AND_RECOMMENDATIONS.md @@ -59,7 +59,7 @@ | **10092** | **order-mcp-legal** | **βœ… Running** | **192.168.11.37** | **❌ Missing from documentation** | | 10100 | dbis-postgres-primary | βœ… Running | 192.168.11.105 | βœ… Documented | | 10101 | dbis-postgres-replica-1 | βœ… Running | 192.168.11.106 | βœ… Documented | -| 10120 | dbis-redis | βœ… Running | 192.168.11.120 | βœ… Documented | +| 10120 | dbis-redis | βœ… Running | 192.168.11.125 | βœ… Documented | | 10130 | dbis-frontend | βœ… Running | 192.168.11.130 | βœ… Documented | | 10150 | dbis-api-primary | βœ… Running | 192.168.11.155 | βœ… Documented | | 10151 | dbis-api-secondary | βœ… Running | 192.168.11.156 | βœ… Documented | diff --git a/docs/dbis-rail/IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md b/docs/dbis-rail/IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md index 5a44a6b..c6ad9b2 100644 --- a/docs/dbis-rail/IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md +++ b/docs/dbis-rail/IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md @@ -8,6 +8,11 @@ **Transcript reference:** `agent-transcripts/540ae663-7cb4-44f3-bc48-4a1d3ea44d54` (PMM/DEX, tokens, GRU, cW*, deployments). +> Historical note: the PMM addresses recorded in the original transcript are now superseded by the corrected canonical Chain 138 stack: +> `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` +> `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` +> Use current canonical references for live operations; keep the transcript addresses only as historical record. + --- ## 1. What Was Completed in Transcript 540ae663 @@ -16,9 +21,9 @@ | Item | Status | Notes | |------|--------|------| -| DODOPMMIntegration | Deployed | Mock DVM at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` | +| DODOPMMIntegration | Deployed | Historical transcript deployment at `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (superseded by corrected canonical stack) | | Three PMM pools | Created | cUSDT/cUSDC, cUSDT/USDT, cUSDC/USDC (addresses in LIQUIDITY_POOLS_MASTER_MAP) | -| DODOPMMProvider | Deployed | `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0`; pools registered | +| DODOPMMProvider | Deployed | Historical transcript deployment at `0x8EF6657D2a86c569F6ffc337EE6b4260Bd2e59d0` (superseded by corrected canonical stack) | | TransactionMirror | Deployed | Multiple deploys in transcript; use address from CONTRACT_ADDRESSES_REFERENCE / .env | | Add-liquidity runbook | Added | [ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK](../03-deployment/ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md) | | MCP allowlist-138 | Added | `ai-mcp-pmm-controller/config/allowlist-138.json` |