d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b7eebb87b33ea4af3efe689c5a0469df4a134313
proxmox/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md
defiQUG 0d29343941 chore: update .env.master.example with new deployment scripts and treasury manager parameters; enhance AGENTS.md with GRU reference primacy details 
- Added new deployment script references for Aave quote-push and treasury manager in .env.master.example.
- Updated AGENTS.md to include information on GRU reference primacy versus public PMM mesh execution model.
- Minor updates to various documentation files to reflect changes in policy and operational guidelines.

Made-with: Cursor
2026-04-12 18:20:41 -07:00

16 KiB
Raw Blame History

Liquidity Pools Master Map — ChainID 138 & ALL Mainnet (Alltra)

Last Updated: 2026-03-26
Document Version: 1.2
Status: Reference documentation (live Chain 138 pool state reflected)

Overview

This document maps all private, public, reserve, and stabilization liquidity pools for tokens on:

Chain ChainID Network Name RPC Explorer
Chain 138 138 SMOM-DBIS-138 (DeFi Oracle) https://rpc-core.d-bis.org https://explorer.d-bis.org
ALL Mainnet 651940 Alltra https://mainnet-rpc.alltra.global https://alltra.global

Token Inventories

ChainID 138 — Tokens

Token Symbol Address Decimals Type
Wrapped Ether WETH 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 18 Standard
Wrapped Ether v10 WETH10 0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f 18 Standard
Chainlink LINK 0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03 18 Standard
Compliant USDT cUSDT 0x93E66202A11B1772E55407B32B44e5Cd8eda7f22 6 Stablecoin
Compliant USDC cUSDC 0xf22258f57794CC8E06237084b353Ab30fFfa640b 6 Stablecoin
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, CONTRACT_ADDRESSES_REFERENCE.md

ALL Mainnet (651940) — Tokens

Token Symbol Address Decimals Type
Alltra USD Token AUSDT 0x015B1897Ed5279930bC2Be46F661894d219292A6 18 Stablecoin
AUSDT (alt) USDT 0x66D8Efa0AF63B0e84eb1Dd72bf00f00cd1e2234e 18 Stablecoin
AUSDC USDC 0xa95EeD79f84E6A0151eaEb9d441F9Ffd50e8e881 18 Stablecoin
Wrapped Ether WETH 0x798F6762BB40d6801A593459d08F890603D3979C 18 Wrapped
Wrapped Alltra WALL 0x2da2b8f961F161ab6320acB3377e2e844a3C3ce4 18 Wrapped
Hyper-Dex Exchange HYDX 0x0d9793861AEB9244AD1B34375a83A6730F6AdD38 18 DeFi
HYBX HYBX 0x1839f77eBed7F388c7035f7061B4B8Ef0E72317a 8 DeFi
ChatCoin CHT 0xE59Bb804F4884FcEA183a4A67B1bb04f4a4567bc 8 DeFi
MOOLA AUDA 0x690740f055A41FA7669f5a379Bf71B0cDF353073 18 DeFi

Source: ALL_MAINNET_TOKEN_ADDRESSES.md

ChainID 138 — Liquidity Pool Map

1. Public Liquidity Pools (DODO PMM)

Pool Pair Type DEX Status Notes
cUSDT / cUSDC Public DODO PMM ✅ Funded (live) Pool: 0x9e89bAe009adf128782E19e8341996c596ac40dC; seeded on the canonical official-DVM stack and recalibrated 2026-04-02 with i=1e18, k=0
cUSDT / USDT (official mirror) Public DODO PMM ✅ Funded (live) Pool: 0x866Cb44b59303d8dc5f4F9E3E7A8e8b0bf238d66; seeded on the canonical official-DVM stack and recalibrated 2026-04-02 with i=1e18, k=0
cUSDC / USDC (official mirror) Public DODO PMM ✅ Funded (live) Pool: 0xc39B7D0F40838cbFb54649d327f49a6DAC964062; seeded on the canonical official-DVM stack and recalibrated 2026-04-02 with i=1e18, k=0
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 0x86ADA6Ef91A3B450F89f2b751e93B1b7A3218895; DODOPMMProvider at 0x3f729632E9553EBacCdE2e9b4c8F2B285b014F2e; DODO Vending Machine / adapter at 0xb6D9EF3575bc48De3f011C310DC24d87bEC6087C. Public stable pools above are the current canonical routing set and were rebuilt on 2026-04-02 with i=1e18, k=0 for true 1:1 stable quoting. The XAU pools below remain deployed on the older PMM phase until explicitly migrated. Add liquidity: ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK.md. Pre-deployment steps: 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 §4, DODO_PMM_INTEGRATION.md

2. Private Stabilization Pools (XAU-anchored)

Pool Pair Type Registry Status Notes
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 at 0xb27057B27db09e8Df353AF722c299f200519882A; Stabilizer.sol (Phase 3); DeployPrivatePoolRegistryAndPools.s.sol.

Env: XAU_ADDRESS_138, cEURT_ADDRESS_138, DODOPMM_INTEGRATION_ADDRESS — all required for pool creation.

Source: VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md §5, CONTRACT_DEPLOYMENT_RUNBOOK.md § Private stabilization pools

3. Reserve Pools / Vault Backing

Component Type Address Status Backed Tokens
ReserveSystem Reserve 0x607e97cD626f209facfE48c1464815DDE15B5093 ✅ Deployed —
ReserveTokenIntegration Reserve 0x34B73e6EDFd9f85a7c25EeD31dcB13aB6E969b96 ✅ Deployed —
StablecoinReserveVault Reserve — ❌ Not on Chain 138 cUSDT, cUSDC
Bridge_Vault Vault 0x31884f84555210FFB36a19D2471b8eBc7372d0A8 ✅ Deployed —

StablecoinReserveVault (1:1 backing): Designed for Ethereum Mainnet; locks official USDT/USDC, mints cUSDT/cUSDC 1:1. Chain 138 compliant tokens receive backing via cross-chain flows.

Reserve sizing (doc): Reserve ≥ PeakMinuteOutflow × T; 3–5× safety factor.
Source: RESERVE_BACKING_MECHANISM.md, VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md §7

4. Bridge Liquidity Pool (Trustless)

Component Type Address Status Asset Types
LiquidityPoolETH Bridge LP — ❌ Placeholder ETH, WETH

Purpose: Liquidity for trustless bridge (InboxETH, BondManager, ChallengeManager). Holds ETH/WETH for cross-chain releases.

Config: LIQUIDITY_POOL_ADDRESS in .env — placeholder 0x0.
Related: Lockbox138 0xFce6f50B312B3D936Ea9693C5C9531CF92a3324c (deployed); full trustless stack not deployed.

Source: DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md, ADDRESS_MATRIX_AND_STATUS.md

5. Vault / XAU Triangulation (Conceptual)

Component Address Role
XAU Oracle 0xf23E1eDa304082ab7a81531dFE6020E6105e77A8 ETH/XAU price for vault valuations
Ledger 0x67b3831dc64C14FB9352B2a45C6Dd69b3C86B7af XAU-denominated accounting
VaultFactory 0xB2Ac70f35A81481B005067ed6567a5043BA32336 Vault creation

Not liquidity pools per se; they support XAU triangulation for private mesh parity (TokenA → XAU → TokenB).

ALL Mainnet (651940) — Liquidity Pool Map

1. Public DEX Pools

Pool Type DEX Status Config / Notes
Uniswap V2 — ⚠️ Env-based CHAIN_651940_UNISWAP_V2_FACTORY, _ROUTER, _START_BLOCK
Uniswap V3 — ⚠️ Env-based CHAIN_651940_UNISWAP_V3_FACTORY, _ROUTER, _START_BLOCK
DODO PMM — ⚠️ Env-based CHAIN_651940_DODO_POOL_MANAGER, _DODO_VENDING_MACHINE

HYDX (Hyper-Dex Exchange) token exists (0x0d9793861AEB9244AD1B34375a83A6730F6AdD38) — indicates a DEX on ALL Mainnet. No pool addresses or factory addresses are documented in this repo.

Source: dex-factories.ts, ALL_MAINNET_TOKEN_ADDRESSES.md

2. Reserve / Stabilization Pools (ALL Mainnet)

Type Status Notes
Reserve ❌ Not documented No ReserveSystem or StablecoinReserveVault equivalent in docs
Stabilization ❌ Not documented No PrivatePoolRegistry or XAU mesh on 651940
Bridge liquidity — AlltraAdapter (0x66FEBA2fC9a0B47F26DD4284DAd24F970436B8Dc on Chain 138) bridges 138 ↔ 651940; no on-chain LP contract listed

Public-chain cW* stabilization (edge pools + bot)

GRU policy: treat this mesh as execution capacity around reference-anchored FX and reserve rules, not standalone shadow FX — GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md.

M1 tokens on Chain 138 (cUSDT, cUSDC, cAUSDT, cEURC, cEURT, cUSDW) are bridged to public chains as cW* wrappers (cWUSDT, cWUSDC, etc.). The intended public-chain stabilization model uses single-sided PMM edge pools (cW* / USDC, cW* / USDT, etc.) plus a bot-driven stabilization mesh when those components are deployed. Specs, pool matrix, peg bands, and deployment recipe:

Current repo reality: cross-chain-pmm-lps/config/deployment-status.json records cW token addresses on the supported public EVM chains and now includes the first live Mainnet DODO PMM cW pools: cWUSDT/USDC, cWUSDC/USDC, cWUSDT/USDT, cWUSDC/USDT, cWUSDT/cWUSDC (0xe944b7Cb012A0820c07f54D51e92f0e1C74168DB, one vault, both swap directions), and the first six non-USD Wave 1 rows cWEURC/USDC (0x0bC750F9c6DbDcd76B205695A356491b1B9ef098), cWGBPC/USDC (0x5488042dF882893a3e7074453E2005CaDE4101b0), cWAUDC/USDC (0x6c1bD4F43c5f330E50B61DE81066dA7C61a9b5b4), cWCADC/USDC (0xE0F35b5736FDd0a2F4B618621b0A08F8D8A3f92A), cWJPYC/USDC (0x8A4187dF0A8FE855cC53A4F7B2D8346588Ee9794), and cWCHFC/USDC (0x776Ca556deD3245984F504F4bef8Eeec55C50190). The repo still does not currently assert any live public cW* Balancer, Curve, Uniswap, or 1inch venues, and the broader multi-chain cW* mesh remains incomplete. Avalanche still has the proven cUSDT -> cWUSDT mint corridor, but not a documented same-chain cW* / stable pool there.

Design gap closed: cross-chain-pmm-lps/config/pool-matrix.json now covers the full GRU Wave 1 wrapped set (cWEURC, cWEURT, cWGBPC, cWGBPT, cWAUDC, cWJPYC, cWCHFC, cWCADC, cWXAUC, cWXAUT) across the tracked public EVM chain set. The remaining work is now operator deployment and funding, not missing design coverage.

  • cross-chain-pmm-lps/README.md — Submodule overview and quick start
  • cross-chain-pmm-lps/docs/06-deployment-recipe.md — Step-by-step deployment
  • cross-chain-pmm-lps/config/ — token-map.json, pool-matrix.json, peg-bands.json, chains.json
  • bash scripts/verify/check-cw-public-pool-status.sh — quick repo-state proof that cW tokens may exist while public-chain cW pools remain undeployed
  • bash scripts/verify/check-gru-v2-deployment-queue.sh — operator-grade queue for Wave 1 transport + first-tier public cW pool rollout

See SUBMODULE_RELATIONSHIP_MAP.md for submodule status.

Summary Matrix

Category Chain 138 ALL Mainnet (651940)
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

Deployment Roadmap (Chain 138)

From VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md:

  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
  6. Phase 6: Flash loan containment (TWAP, N-block sustain, per-block cap)

References

Document Purpose
DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md Status + full route map: deployed tokens/coins and bridges per network, DODO/Uniswap LPs, routing to and from all chains.
POOLS_AND_NETWORKS_FULL_DESIGN.md Full design: every pool and network (61 pools, 6 networks).
POOL_ACCESS_DASHBOARD_API_MCP.md Whether pools are accessible via standard DODO dashboard, API, and MCP.
GAPS_FILLED_2026-02-27.md Summary of gaps filled (API cW* chains, MCP mock_dvm, pool-matrix 11 chains, docs).
CHAIN138_TOKEN_ADDRESSES.md Token list Chain 138
ALL_MAINNET_TOKEN_ADDRESSES.md Token list ALL Mainnet
VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md Pool architecture, capital buckets
DODO_PMM_INTEGRATION.md DODO pool creation
DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md Deployed vs needed
CONTRACT_DEPLOYMENT_RUNBOOK.md Deployment steps
config/smart-contracts-master.json Contract addresses
dex-factories.ts DEX config per chain
cross-chain-pmm-lps/ Public-chain cW* edge pools + stabilization bot (token map, pool matrix, peg bands, deployment)
Reference in New Issue View Git Blame Copy Permalink