cc6d0705da
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Made-with: Cursor
11 KiB
11 KiB
PMM Liquidity Pools & DEX/DeFi Routing — Full System Status
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-03-26)
- DODOPMMIntegration is deployed on Chain 138 at
0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d. The corrected canonical stack now has 104 desired-state pools aligned. - DODOPMMProvider is deployed at
0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381with 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.
- Optional items completed (2026-02-27 / 2026-03-01): DeployCompliantFiatTokens (10 tokens on 138); Blockscout verification run; MCP allowlist-138 (
ai-mcp-pmm-controller/config/allowlist-138.json); add-liquidity runbook (ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK); token-aggregation canonical fallbacks for cEURC/cEURT/cGBP*/cAUDC/cJPYC/cCHFC/cCADC/cXAU*; ENV_EXAMPLE_CONTENT + CREATE2_FACTORY_ADDRESS; E2E routing verification run.
1. Architecture Overview
1.1 Designed routing layers
| 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) | 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) |
1.2 Routing logic (EnhancedSwapRouter / Liquidity Engine)
- Size-based: Small (<$10k) → Uniswap V3 / Dodoex; Medium ($10k–$100k) → Dodoex → Balancer → Uniswap V3; Large (>$100k) → Dodoex → Curve → Balancer.
- Slippage-based: Low → prefer Dodoex (PMM); medium → Balancer; high → Curve.
- Liquidity-based: High → Uniswap V3; medium → Dodoex; low → Curve.
Reference: smom-dbis-138/docs/bridge/trustless/integration/ENHANCED_ROUTING.md, LIQUIDITY_ENGINE.md.
2. Deployment Status (Chain 138 & Related)
2.1 PMM / DEX (Chain 138)
| Component | Status | Address / Notes |
|---|---|---|
| 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. |
| 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. |
Doc note: LIQUIDITY_POOLS_MASTER_MAP.md and ADDRESS_MATRIX_AND_STATUS.md list pool and DODOPMMProvider addresses. DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED reflects DODOPMMIntegration deployed and pools created.
2.2 Token-aggregation & orchestration
| Component | Status | Notes |
|---|---|---|
| Token-aggregation service | Implemented & runnable | Indexes UniswapV2/V3 and DODO when CHAIN_138_DODO_PMM_INTEGRATION is set (set in smom-dbis-138/.env). Single-hop quote only; no N-hop pathfinding. |
| Orchestration QuoteService | Implemented | POST /api/bridge/quote with optional source/destination swap quotes; requires bridge registry and optional EnhancedSwapRouter addresses. |
| Liquidity Engine (backend) | Implemented | Depends on EnhancedSwapRouter being deployed; not usable for routing until router is live. |
2.3 Swap–bridge–swap & trustless stack
| Component | Status | Notes |
|---|---|---|
| SwapBridgeSwapCoordinator | Script exists; not in CONTRACT_ADDRESSES_REFERENCE | Deploy via DeploySwapBridgeSwapCoordinator.s.sol when swap+bridge+swap flow is needed. |
| Lockbox138 | Deployed | 0xFce6f50B312B3D936Ea9693C5C9531CF92a3324c |
| InboxETH, BondManager, ChallengeManager, LiquidityPoolETH | Not deployed (full trustless stack) | Optional; see DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md §3.3. |
2.4 Cross-chain cW* PMM mesh (public chains)
| Component | Status | Notes |
|---|---|---|
| cross-chain-pmm-lps | Design & tooling ready | Token map, pool topology, peg bands, simulation model, deployment recipe, safe inventory sizing. Not deployed: edge pools and bot v1/v2 are not documented as live. |
3. Multihop / routing capability summary
| Capability | Available? | Where |
|---|---|---|
| Single-hop quote (API) | Yes | GET /api/v1/quote (best direct pool for tokenIn/tokenOut) |
| Multi-provider choice (one leg) | No (router not deployed) | EnhancedSwapRouter would provide WETH↔stable across Uniswap/Dodo/Balancer/Curve/1inch |
| N-hop path (A→B→C on one chain) | No | No graph-based multi-hop swap API or on-chain pathfinder |
| Swap–bridge–swap (cross-chain) | Yes (orchestration) | QuoteService; on-chain coordinator deployable when needed |
| DODO PMM on-chain swaps | Yes | Pools created; DODOPMMProvider deployed; use getQuote/executeSwap or DODOPMMIntegration swap functions. |
4. Full system “ready and in use” — summary
| Area | Ready? | In use? |
|---|---|---|
| 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. |
| Liquidity Engine (decision logic) | No | Depends on EnhancedSwapRouter. |
| Cross-chain cW PMM mesh* | No | Design/simulation only; edge pools and bots not deployed. |
Conclusion: PMM liquidity and DODOPMMProvider routing are deployed and in use on Chain 138. What is in place:
- Live: DODOPMMIntegration (Mock DVM), three PMM pools created, DODOPMMProvider deployed with pools registered, token-aggregation service, bridge/orchestration quote API.
- Remaining: Add liquidity to pools as needed; deploy EnhancedSwapRouter when Uniswap/Balancer pools exist on 138.
- Optional / later: Full trustless stack (LiquidityPoolETH, etc.), cross-chain cW* edge pools and bots.
5. Next steps to make PMM routing usable
Full ordered steps: See PRE_DEPLOYMENT_CHECKLIST.md. Run Phase 1 + Phase 2 in parallel: NEXT_STEPS_PMM_FULL_PARITY_AND_ALL_POOLS.md — use ./scripts/deployment/run-pmm-full-parity-all-phases.sh from smom-dbis-138/.
- Create PMM pools (Chain 138): Run
CreateCUSDTCUSDCPool.s.sol,CreateCUSDTUSDTPool.s.sol,CreateCUSDCUSDCPool.s.sol(or./scripts/deployment/create-all-pmm-pools-chain138.sh), ordeploy-transaction-mirror-and-pmm-pool-after-txpool-clear.shfor mirror + cUSDT/cUSDC only; ensure POOL_MANAGER_ROLE and nonce/RPC are correct. - Add liquidity to created pools via
forge script script/dex/AddLiquidityPMMPoolsChain138.s.sol:AddLiquidityPMMPoolsChain138(setADD_LIQUIDITY_BASE_AMOUNT,ADD_LIQUIDITY_QUOTE_AMOUNTin .env) or calladdLiquidity(pool, baseAmount, quoteAmount)on DODOPMMIntegration. - Deploy DODOPMMProvider via
script/liquidity/DeployDODOPMMProvider.s.sol, then register pools withregisterPool(tokenIn, tokenOut, pool). - Optionally deploy EnhancedSwapRouter when Uniswap/Balancer quoter/poolId are configured for 138.
- Update docs: Add pool and DODOPMMProvider addresses to LIQUIDITY_POOLS_MASTER_MAP and CONTRACT_ADDRESSES_REFERENCE once created.
6. References
| Doc | Purpose |
|---|---|
| DEX_AND_AGGREGATORS_CHAIN138_EXPLAINER.md | Explainer: Using DEX and aggregators with Chain 138 tokens; routing for DEXs; API and flows. |
| PRE_DEPLOYMENT_CHECKLIST.md | Pre-deployment: component status and ordered steps (pools, DODOPMMProvider, verification). |
| LIQUIDITY_POOLS_MASTER_MAP.md | Pool map 138 & 651940; update when pools created |
| STATUS_AND_TOKEN_ROUTING.md | Token-aggregation API and routing layers |
| DODO_PMM_INTEGRATION.md | Pool creation and swap usage |
| DODO_PMM_NEXT_STEPS.md | Create-all-dodo-pools, SwapBridgeSwapCoordinator, bridge quote API |
| CONTRACT_DEPLOYMENT_RUNBOOK.md | EnhancedSwapRouter & DODOPMMProvider config |
| LIQUIDITY_POOL_CONTROLS_RUNBOOK.md | DODO and trustless pool controls |
| cross-chain-pmm-lps/README.md | cW* mesh and deployment recipe |