d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dc8abb06e2bbd33e30803ca59d284ead8ea970c6
proxmox/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md
defiQUG 7ac74f432b chore: sync docs, config schemas, scripts, and meta task alignment 
- Institutional / JVMTM / reserve-provenance / GRU transport + standards JSON
- Validation and verify scripts (Blockscout labels, x402, GRU preflight, P1 local path)
- Wormhole wiring in AGENTS, MCP_SETUP, MASTER_INDEX, 04-configuration README
- Meta docs, integration gaps, live verification log, architecture updates
- CI validate-config workflow updates

Operator/LAN items, submodule working trees, and public token-aggregation edge
routes remain follow-up (see TODOS_CONSOLIDATED P1).

Made-with: Cursor
2026-03-31 22:31:39 -07:00

222 lines
14 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: `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 `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)
---
### 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)
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:
- **[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
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