d-bis/proxmox
4
0
Fork 0
Code Issues 1 Pull Requests 9 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

230 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](CHAIN138_TOKEN_ADDRESSES.md), [CONTRACT_ADDRESSES_REFERENCE.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](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](../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)
---
### 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](../VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md) §5, [CONTRACT_DEPLOYMENT_RUNBOOK.md](../03-deployment/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](../../smom-dbis-138/docs/integration/RESERVE_BACKING_MECHANISM.md), [VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.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](DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md), [ADDRESS_MATRIX_AND_STATUS.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](../../smom-dbis-138/services/token-aggregation/src/config/dex-factories.ts), [ALL_MAINNET_TOKEN_ADDRESSES.md](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](../04-configuration/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](../../cross-chain-pmm-lps/README.md)** — Submodule overview and quick start
- **[cross-chain-pmm-lps/docs/06-deployment-recipe.md](../../cross-chain-pmm-lps/docs/06-deployment-recipe.md)** — Step-by-step deployment
- **[cross-chain-pmm-lps/config/](../../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](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](../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](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](POOLS_AND_NETWORKS_FULL_DESIGN.md) | **Full design:** every pool and network (61 pools, 6 networks). |
| [POOL_ACCESS_DASHBOARD_API_MCP.md](POOL_ACCESS_DASHBOARD_API_MCP.md) | Whether pools are accessible via standard DODO dashboard, API, and MCP. |
| [GAPS_FILLED_2026-02-27.md](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](CHAIN138_TOKEN_ADDRESSES.md) | Token list Chain 138 |
| [ALL_MAINNET_TOKEN_ADDRESSES.md](ALL_MAINNET_TOKEN_ADDRESSES.md) | Token list ALL Mainnet |
| [VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md](../VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md) | Pool architecture, capital buckets |
| [DODO_PMM_INTEGRATION.md](../../smom-dbis-138/docs/integration/DODO_PMM_INTEGRATION.md) | DODO pool creation |
| [DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md](DEX_AND_CROSS_CHAIN_CONTRACTS_NEEDED.md) | Deployed vs needed |
| [CONTRACT_DEPLOYMENT_RUNBOOK.md](../03-deployment/CONTRACT_DEPLOYMENT_RUNBOOK.md) | Deployment steps |
| [config/smart-contracts-master.json](../../config/smart-contracts-master.json) | Contract addresses |
| [dex-factories.ts](../../smom-dbis-138/services/token-aggregation/src/config/dex-factories.ts) | DEX config per chain |
| [cross-chain-pmm-lps/](../../cross-chain-pmm-lps/README.md) | Public-chain cW* edge pools + stabilization bot (token map, pool matrix, peg bands, deployment) |
Reference in New Issue View Git Blame Copy Permalink