From fa4161cf5844719cd96bf51395bb72be0449832d Mon Sep 17 00:00:00 2001 From: defiQUG Date: Fri, 24 Apr 2026 21:52:49 -0700 Subject: [PATCH] docs: codify live public routing coverage and gaps --- config/public-routing-coverage-matrix.json | 116 +++++ .../DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md | 28 +- docs/MASTER_INDEX.md | 6 +- ...IAL_INVENTORY_AND_ROUTING_GAPS_20260424.md | 438 ++++++++++++++++++ scripts/validation/validate-config-files.sh | 48 ++ 5 files changed, 619 insertions(+), 17 deletions(-) create mode 100644 config/public-routing-coverage-matrix.json create mode 100644 reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md diff --git a/config/public-routing-coverage-matrix.json b/config/public-routing-coverage-matrix.json new file mode 100644 index 00000000..d3c3fe6d --- /dev/null +++ b/config/public-routing-coverage-matrix.json @@ -0,0 +1,116 @@ +{ + "schemaVersion": "1.0.0", + "updated": "2026-04-24", + "scope": "Current live Chain 138 ecosystem coverage for public stablecoins, top public assets, and near-term integration priorities.", + "homeChain": { + "chainId": 138, + "network": "DeFi Oracle Meta Mainnet", + "publicExitPrimitive": "WETH", + "publicExitStatus": "live_via_pmm_and_ccip" + }, + "supportedBridgeDestinations": [ + { "chainId": 1, "name": "Ethereum Mainnet", "status": "live" }, + { "chainId": 10, "name": "Optimism", "status": "live" }, + { "chainId": 25, "name": "Cronos", "status": "live" }, + { "chainId": 56, "name": "BSC", "status": "live" }, + { "chainId": 100, "name": "Gnosis", "status": "live" }, + { "chainId": 137, "name": "Polygon", "status": "live" }, + { "chainId": 8453, "name": "Base", "status": "live" }, + { "chainId": 42161, "name": "Arbitrum One", "status": "live" }, + { "chainId": 42220, "name": "Celo", "status": "live" }, + { "chainId": 43114, "name": "Avalanche C-Chain", "status": "live" }, + { "chainId": 651940, "name": "ALL Mainnet", "status": "bridge_live_swap_inventory_pending" }, + { "chainId": 1111, "name": "Wemix", "status": "blocked_selector_not_supported" } + ], + "stablecoinCoverage": [ + { "symbol": "USDT", "reachability": "strong", "mode": "direct_mirror_and_public_evm" }, + { "symbol": "USDC", "reachability": "strong", "mode": "direct_mirror_and_public_evm" }, + { "symbol": "DAI", "reachability": "strong", "mode": "indirect_via_weth_to_ethereum" }, + { "symbol": "USDS", "reachability": "strong", "mode": "indirect_via_weth_to_ethereum" }, + { "symbol": "PYUSD", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "USDe", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "USD1", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "USDG", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "RLUSD", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "USDF", "reachability": "medium", "mode": "destination_dex_dependent" }, + { "symbol": "BUIDL", "reachability": "low", "mode": "institutional_non_dex" }, + { "symbol": "USYC", "reachability": "low", "mode": "institutional_non_dex" }, + { "symbol": "JTRSY", "reachability": "low", "mode": "institutional_non_dex" }, + { "symbol": "XAUT", "reachability": "strong", "mode": "native_gold_family_on_home_chain" }, + { "symbol": "PAXG", "reachability": "medium", "mode": "destination_dex_dependent" } + ], + "topAssetCoverage": [ + { "symbol": "ETH", "reachability": "strong", "mode": "direct_evm" }, + { "symbol": "LINK", "reachability": "strong", "mode": "direct_evm" }, + { "symbol": "AAVE", "reachability": "strong", "mode": "destination_dex_dependent" }, + { "symbol": "UNI", "reachability": "strong", "mode": "destination_dex_dependent" }, + { "symbol": "AVAX", "reachability": "strong", "mode": "destination_dex_dependent" }, + { "symbol": "BNB", "reachability": "strong", "mode": "destination_dex_dependent" }, + { "symbol": "CRO", "reachability": "strong", "mode": "destination_dex_dependent" }, + { "symbol": "BTC", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "SOL", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "TRX", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "XRP", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "ADA", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "XMR", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "ZEC", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "XLM", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "HBAR", "reachability": "weak", "mode": "non_evm_expansion_required" }, + { "symbol": "SUI", "reachability": "weak", "mode": "non_evm_expansion_required" } + ], + "shortIntegrationLeaps": [ + { + "id": "doc-chain138-live-weth-exits", + "title": "Normalize docs around live Chain 138 c* -> WETH exits", + "status": "done_now", + "impact": "high" + }, + { + "id": "publish-destination-route-registry", + "title": "Publish per-chain destination route registry for supported EVM stablecoins and cW* surfaces", + "status": "todo", + "impact": "high" + }, + { + "id": "promote-additional-public-stables", + "title": "Promote PYUSD, USDe, RLUSD, USD1, and USDG into named route-target review", + "status": "todo", + "impact": "high" + }, + { + "id": "canonicalize-allmainnet-swap-surface", + "title": "Commit canonical ALL Mainnet router/factory/pool inventory", + "status": "todo", + "impact": "high" + }, + { + "id": "publish-top50-coverage-matrix", + "title": "Track top public assets by direct, indirect, wrapped-only, or unsupported status", + "status": "done_now", + "impact": "medium" + } + ], + "additionalComponentsRequired": [ + { + "id": "non-evm-bridge-expansion", + "title": "Bridge and swap adapters for BTC, SOL, XRP, ADA, XLM, HBAR, SUI classes", + "status": "future" + }, + { + "id": "wemix-ccip-selector-support", + "title": "Enable Wemix lane by resolving Chain 138 CCIP selector support", + "status": "blocked_external" + }, + { + "id": "route-confidence-api", + "title": "Expose live route confidence in quote/build systems", + "status": "future" + } + ], + "references": { + "ecosystemReport": "reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md", + "routingStatusDoc": "docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md", + "stablecoinRoutesDoc": "docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md", + "allMainnetSurfaceConfig": "config/allmainnet-non-dodo-protocol-surface.json" + } +} diff --git a/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md b/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md index 337dd003..aa247c01 100644 --- a/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md +++ b/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md @@ -2,7 +2,7 @@ > 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 +**Last Updated:** 2026-04-24 **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. **Deployer address (source):** `0x4A666F96fC8764181194447A7dFdb7d471b301C8` @@ -21,13 +21,13 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, | **1** | Ethereum Mainnet | WETH (via CCIP from 138), USDT, USDC, DAI (acquire) | | **651940** | ALL Mainnet (Alltra) | AUSDT, USDC (AUSDC), WETH, WALL (via AlltraAdapter from 138 or acquire) | | **25** | Cronos | USDW, EURW, GBPW, AUDW, JPYW, CHFW, CADW (D-WIN W; mintable if MINTER_ROLE), WETH9, WETH10, LINK | -| **56** | BSC | cWUSDT, cWUSDC (design; deployment-status empty), USDT, USDC (acquire) | -| **100** | Gnosis | cW* (design), xDAI, USDC (acquire) | -| **137** | Polygon | cW* (design), USDT, USDC (acquire) | -| **10** | Optimism | cW* (design), USDT, USDC (acquire) | -| **42161**| Arbitrum One | cW* (design), USDT, USDC (acquire) | -| **8453** | Base | cW* (design), USDT, USDC (acquire) | -| **43114**| Avalanche C-Chain | cW* (design), USDT, USDC (acquire) | +| **56** | BSC | cWUSDT, cWUSDC, other active `cW*`, USDT, USDC | +| **100** | Gnosis | active `cW*`, xDAI, USDC | +| **137** | Polygon | active `cW*`, USDT, USDC | +| **10** | Optimism | active `cW*`, USDT, USDC | +| **42161**| Arbitrum One | active `cW*`, USDT, USDC | +| **8453** | Base | active `cW*`, USDT, USDC | +| **43114**| Avalanche C-Chain | active `cW*`, USDT, USDC | | **42220**| Celo | (CCIP config 2026-03-04); USDC, cEUR (acquire) | | **1111** | Wemix | (pending 0.4 WEMIX); WEMIX, USDT/USDC (acquire) | @@ -76,8 +76,8 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, |----------------------------|----------------------------|--------|--------| | WETH9 | WETH (then DEX) → USDT / USDC / DAI | CCIP WETH9 bridge `0xcacfd227A040002e49e2e01626363071324f820a` → Mainnet → swap via native DEX | ✅ Live (bridge); **requires Mainnet WETH funding of CCIPRelayBridge**; swap via DEX | | WETH10 | Same | CCIP WETH10 bridge `0xe0E93247376aa097dB308B92e6Ba36bA015535D0` → Mainnet → DEX | ✅ Live; **same prerequisite** | -| cUSDT | USDT / USDC / DAI | **No direct bridge.** Swap 138: cUSDT→cUSDC or cUSDT→WETH (no cUSDT→WETH pool documented); or cUSDT→cUSDC then no bridge for cUSDC. **Indirect:** cUSDT→cUSDC (DODO) then no 138→mainnet bridge for compliant stables. Use: **cUSDT/cUSDC → swap to WETH on 138 (no pool today)** then CCIP WETH→mainnet→DEX→USDT/USDC/DAI. | ⚠️ Swap leg on 138 to WETH not documented; bridge leg ✅ | -| cUSDC | USDT / USDC / DAI | Same as cUSDT; need 138 cUSDC→WETH path (not in docs). Then CCIP WETH→mainnet→DEX. | ⚠️ Same | +| cUSDT | USDT / USDC / DAI | **No direct stablecoin bridge.** Use the live 138 PMM route `cUSDT -> WETH`, then CCIP WETH to Mainnet, then destination DEX to `USDT / USDC / DAI`. | ✅ Indirect live route | +| cUSDC | USDT / USDC / DAI | Use the live 138 PMM route `cUSDC -> WETH`, then CCIP WETH to Mainnet, then destination DEX to `USDT / USDC / DAI`. | ✅ Indirect live route | **Mainnet relay:** CCIP messages to chain 1 go via CCIPRelayRouter `0xAd9A228CcEB4cbB612cD165FFB72fE090ff10Afb` and CCIPRelayBridge `0xF9A32F37099c582D28b4dE7Fca6eaC1e5259f939` (releases WETH; **must be funded with Mainnet WETH** — see [CONTRACT_ADDRESSES_REFERENCE](CONTRACT_ADDRESSES_REFERENCE.md)). @@ -87,7 +87,7 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, | From (138, deployer holds) | To (651940 public stable) | Route | Status | |----------------------------|----------------------------|--------|--------| -| Any (cUSDT, cUSDC, WETH, etc.) | AUSDT, USDC (AUSDC) | AlltraAdapter `0x66FEBA2fC9a0B47F26DD4284DAd24F970436B8Dc` (138↔651940) → then DEX on 651940 (still documentation-only; no canonical router/factory/pool inventory committed) | ⚠️ Bridge live; destination swap surface not yet promoted | +| Any (cUSDT, cUSDC, WETH, etc.) | AUSDT, USDC (AUSDC) | AlltraAdapter `0x66FEBA2fC9a0B47F26DD4284DAd24F970436B8Dc` (138↔651940) → then same-chain swap surface on 651940 once canonical router/factory/pool inventory is committed. Current documented non-DODO protocol surface is in `config/allmainnet-non-dodo-protocol-surface.json`. | ⚠️ Bridge live; destination swap surface still inventory-pending | --- @@ -97,7 +97,7 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, |------------|--------------------------------------|--------|--------| | WETH9 / WETH10 | WETH on dest → USDT/USDC via DEX | CCIP WETH9/WETH10 to BSC, Polygon, Arbitrum, Optimism, Avalanche, Cronos, **Celo**, **Gnosis** | ✅ Live (Celo + Gnosis 2026-03-04) | | WETH9 / WETH10 | Wemix USDT/USDC | CCIP when Wemix bridges deployed (deployer needs 0.4 WEMIX) | ⏳ Pending | -| cUSDT / cUSDC | Any dest public stable | No direct bridge for compliant stables; must swap to WETH on 138 then CCIP (see 3.2). | ⚠️ Same as 3.2 | +| cUSDT / cUSDC | Any dest public stable | No direct compliant-stable bridge. Use the live 138 PMM route to `WETH`, then CCIP, then destination DEX or active `cW*` settlement surface. | ✅ Indirect live route on supported EVM destinations | --- @@ -108,7 +108,7 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, | **1** | WETH (after CCIP), USDT, USDC, DAI | USDT, USDC, DAI | Native DEX (Uniswap, etc.) | ✅ Standard | | **651940** | AUSDT, USDC, WETH, WALL | AUSDT, USDC | HYDX / Uniswap (env placeholders) | ✅ DEX present | | **25** | USDW, EURW, … (D-WIN W) | USDW, EURW, etc. | Same-chain swap / DEX | ✅ If DEX exists | -| **56, 100, 137, 10, 42161, 8453, 43114** | cW* (design only; deployment-status empty) | USDT, USDC | cW*/USDC, cW*/USDT edge pools (pool-matrix) | ❌ Pools not deployed | +| **56, 100, 137, 10, 42161, 8453, 43114** | active `cW*` inventory | USDT, USDC | PMM and, on some chains, Uniswap V2-compatible edge pools; use the machine-readable deployment graph and liquidity map for the canonical per-chain truth | ✅ / ⚠️ depends on destination chain and venue | | **42220, 1111** | — | USDC, cEUR / USDT, USDC | Acquire then DEX | ✅ Standard (acquire + DEX) | --- @@ -123,7 +123,7 @@ Tokens the deployer **can hold** as source (mintable to deployer on 138/Cronos, | 138 | WETH10 | 1 | USDT, USDC, DAI | Same; **CCIPRelayBridge must be funded with Mainnet WETH** | ✅ | | 138 | WETH9/10 | 56, 137, 10, 42161, 43114, 25, 100, 42220 | WETH → USDT/USDC via DEX | CCIP → dest → DEX | ✅ | | 138 | Any | 651940 | AUSDT, USDC | AlltraAdapter → 651940 DEX | ✅ | -| 138 | cUSDT, cUSDC | Any | USDT, USDC (any chain) | Swap to WETH on 138 (no c*→WETH pool in docs) + CCIP WETH → dest DEX | ⚠️ Bridge leg ✅; 138 swap leg not documented | +| 138 | cUSDT, cUSDC | Any | USDT, USDC (any chain) | Swap to WETH on 138 using the live PMM layer, then CCIP WETH to destination, then destination DEX or active `cW*` edge pool | ✅ Indirect live route on supported EVM destinations | | Dest (1, 651940, 25, …) | Deployer-held token on that chain | Same | Public stable | Native DEX | ✅ | | Dest (56, 100, 137, …) | cW* | Same | USDT, USDC | cW* edge pools | ❌ Not deployed | diff --git a/docs/MASTER_INDEX.md b/docs/MASTER_INDEX.md index 13ba87ea..05ee32a2 100644 --- a/docs/MASTER_INDEX.md +++ b/docs/MASTER_INDEX.md @@ -101,13 +101,13 @@ |------|-----------------| | **00-meta** (tasks, next steps, phases) | [00-meta/NEXT_STEPS_INDEX.md](00-meta/NEXT_STEPS_INDEX.md), [00-meta/PHASES_AND_TASKS_MASTER.md](00-meta/PHASES_AND_TASKS_MASTER.md) | | **02-architecture** | [02-architecture/](02-architecture/) — **client / division terminology:** [02-architecture/CLIENT_DIVISION_TERMINOLOGY.md](02-architecture/CLIENT_DIVISION_TERMINOLOGY.md); **Public sector + Phoenix catalog baseline:** [02-architecture/PUBLIC_SECTOR_TENANCY_MARKETPLACE_AND_DEPLOYMENT_BASELINE.md](02-architecture/PUBLIC_SECTOR_TENANCY_MARKETPLACE_AND_DEPLOYMENT_BASELINE.md); **non-goals (incl. catalog vs marketing §9):** [02-architecture/NON_GOALS.md](02-architecture/NON_GOALS.md); **DeFi Oracle Meta Mainnet (Chain 138):** [dbis_chain_138_technical_master_plan.md](../dbis_chain_138_technical_master_plan.md), [02-architecture/DBIS_NODE_ROLE_MATRIX.md](02-architecture/DBIS_NODE_ROLE_MATRIX.md), [02-architecture/DBIS_PHASE2_PROXMOX_SOVEREIGNIZATION_ROADMAP.md](02-architecture/DBIS_PHASE2_PROXMOX_SOVEREIGNIZATION_ROADMAP.md) | -| **03-deployment** | [03-deployment/OPERATIONAL_RUNBOOKS.md](03-deployment/OPERATIONAL_RUNBOOKS.md), [03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md](03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md), **Public sector live checklist:** [03-deployment/PUBLIC_SECTOR_LIVE_DEPLOYMENT_CHECKLIST.md](03-deployment/PUBLIC_SECTOR_LIVE_DEPLOYMENT_CHECKLIST.md), **Proxmox VE ops template:** [03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md](03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md) · [`config/proxmox-operational-template.json`](config/proxmox-operational-template.json); **DBIS Phase 1–3:** [03-deployment/PHASE1_DISCOVERY_RUNBOOK.md](03-deployment/PHASE1_DISCOVERY_RUNBOOK.md), [03-deployment/DBIS_PHASE3_E2E_PRODUCTION_SIMULATION_RUNBOOK.md](03-deployment/DBIS_PHASE3_E2E_PRODUCTION_SIMULATION_RUNBOOK.md), [03-deployment/CALIPER_CHAIN138_PERF_HOOK.md](03-deployment/CALIPER_CHAIN138_PERF_HOOK.md), [03-deployment/DBIS_HYPERLEDGER_RUNTIME_STATUS.md](03-deployment/DBIS_HYPERLEDGER_RUNTIME_STATUS.md), [03-deployment/DBIS_PHASES_1_TO_3_PRODUCTION_GATE.md](03-deployment/DBIS_PHASES_1_TO_3_PRODUCTION_GATE.md), **RTGS canonical production checklist and institutional-finance layers:** [03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md](03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md), [03-deployment/DBIS_RTGS_FX_TRANSACTION_CATALOG.md](03-deployment/DBIS_RTGS_FX_TRANSACTION_CATALOG.md), [03-deployment/DBIS_RTGS_DEPOSITORY_AND_CUSTODY_OPERATING_MODEL.md](03-deployment/DBIS_RTGS_DEPOSITORY_AND_CUSTODY_OPERATING_MODEL.md), [03-deployment/DBIS_RTGS_FX_AND_LIQUIDITY_OPERATING_MODEL.md](03-deployment/DBIS_RTGS_FX_AND_LIQUIDITY_OPERATING_MODEL.md), [03-deployment/DBIS_RTGS_CONTROL_PLANE_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_CONTROL_PLANE_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_RTGS_LATER_PHASE_SIDECARS_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_LATER_PHASE_SIDECARS_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_OMNL_INDONESIA_BNI_E2E_INTEGRATION_BLUEPRINT.md](03-deployment/DBIS_OMNL_INDONESIA_BNI_E2E_INTEGRATION_BLUEPRINT.md), [03-deployment/DBIS_RTGS_FIRST_SLICE_ARCHITECTURE.md](03-deployment/DBIS_RTGS_FIRST_SLICE_ARCHITECTURE.md), [03-deployment/DBIS_RTGS_FIRST_SLICE_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_FIRST_SLICE_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_HYBX_SIDECAR_BOUNDARY_MATRIX.md](03-deployment/DBIS_HYBX_SIDECAR_BOUNDARY_MATRIX.md), [03-deployment/DBIS_MOJALOOP_INTEGRATION_STATUS.md](03-deployment/DBIS_MOJALOOP_INTEGRATION_STATUS.md), [03-deployment/DBIS_HYPERLEDGER_IDENTITY_STACK_DECISION.md](03-deployment/DBIS_HYPERLEDGER_IDENTITY_STACK_DECISION.md) | -| **04-configuration** | [04-configuration/README.md](04-configuration/README.md), [04-configuration/ADDITIONAL_PATHS_AND_EXTENSIONS.md](04-configuration/ADDITIONAL_PATHS_AND_EXTENSIONS.md) (paths, registry, token-mapping, LiFi/Jumper); **Universal resource activation (SKR, server funds, infra):** [04-configuration/universal-resource-activation/README.md](04-configuration/universal-resource-activation/README.md), [UNIVERSAL_RESOURCE_WIRING.md](04-configuration/universal-resource-activation/UNIVERSAL_RESOURCE_WIRING.md), `node scripts/validate/validate-universal-resource-activation.mjs`, `GET` Phoenix `/api/v1/universal-resource-activation/manifest`, [`config/universal-resource-activation/manifest.json`](../config/universal-resource-activation/manifest.json); **Chain 138 wallets:** [04-configuration/CHAIN138_WALLET_CONFIG_VALIDATION.md](04-configuration/CHAIN138_WALLET_CONFIG_VALIDATION.md); **Chain 2138 testnet wallets:** [04-configuration/CHAIN2138_WALLET_CONFIG_VALIDATION.md](04-configuration/CHAIN2138_WALLET_CONFIG_VALIDATION.md); **OMNL Indonesia / HYBX-BATCH-001:** [04-configuration/mifos-omnl-central-bank/HYBX_BATCH_001_OPERATOR_CHECKLIST.md](04-configuration/mifos-omnl-central-bank/HYBX_BATCH_001_OPERATOR_CHECKLIST.md), [04-configuration/mifos-omnl-central-bank/INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md](04-configuration/mifos-omnl-central-bank/INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md) | +| **03-deployment** | [03-deployment/OPERATIONAL_RUNBOOKS.md](03-deployment/OPERATIONAL_RUNBOOKS.md), [03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md](03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md), **Public sector live checklist:** [03-deployment/PUBLIC_SECTOR_LIVE_DEPLOYMENT_CHECKLIST.md](03-deployment/PUBLIC_SECTOR_LIVE_DEPLOYMENT_CHECKLIST.md), **Proxmox VE ops template:** [03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md](03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md) · [`config/proxmox-operational-template.json`](config/proxmox-operational-template.json); **DBIS Phase 1–3:** [03-deployment/PHASE1_DISCOVERY_RUNBOOK.md](03-deployment/PHASE1_DISCOVERY_RUNBOOK.md), [03-deployment/DBIS_PHASE3_E2E_PRODUCTION_SIMULATION_RUNBOOK.md](03-deployment/DBIS_PHASE3_E2E_PRODUCTION_SIMULATION_RUNBOOK.md), [03-deployment/CALIPER_CHAIN138_PERF_HOOK.md](03-deployment/CALIPER_CHAIN138_PERF_HOOK.md), [03-deployment/DBIS_HYPERLEDGER_RUNTIME_STATUS.md](03-deployment/DBIS_HYPERLEDGER_RUNTIME_STATUS.md), [03-deployment/DBIS_PHASES_1_TO_3_PRODUCTION_GATE.md](03-deployment/DBIS_PHASES_1_TO_3_PRODUCTION_GATE.md), **RTGS canonical production checklist and institutional-finance layers:** [03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md](03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md), [03-deployment/DBIS_RTGS_MASTER_PLAN_IMPLEMENTATION_TRACKER.md](03-deployment/DBIS_RTGS_MASTER_PLAN_IMPLEMENTATION_TRACKER.md), [03-deployment/DBIS_RTGS_FX_TRANSACTION_CATALOG.md](03-deployment/DBIS_RTGS_FX_TRANSACTION_CATALOG.md), [03-deployment/DBIS_RTGS_DEPOSITORY_AND_CUSTODY_OPERATING_MODEL.md](03-deployment/DBIS_RTGS_DEPOSITORY_AND_CUSTODY_OPERATING_MODEL.md), [03-deployment/DBIS_RTGS_FX_AND_LIQUIDITY_OPERATING_MODEL.md](03-deployment/DBIS_RTGS_FX_AND_LIQUIDITY_OPERATING_MODEL.md), [03-deployment/DBIS_RTGS_CONTROL_PLANE_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_CONTROL_PLANE_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_RTGS_LATER_PHASE_SIDECARS_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_LATER_PHASE_SIDECARS_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_OMNL_INDONESIA_BNI_E2E_INTEGRATION_BLUEPRINT.md](03-deployment/DBIS_OMNL_INDONESIA_BNI_E2E_INTEGRATION_BLUEPRINT.md), [03-deployment/DBIS_RTGS_FIRST_SLICE_ARCHITECTURE.md](03-deployment/DBIS_RTGS_FIRST_SLICE_ARCHITECTURE.md), [03-deployment/DBIS_RTGS_FIRST_SLICE_DEPLOYMENT_CHECKLIST.md](03-deployment/DBIS_RTGS_FIRST_SLICE_DEPLOYMENT_CHECKLIST.md), [03-deployment/DBIS_HYBX_SIDECAR_BOUNDARY_MATRIX.md](03-deployment/DBIS_HYBX_SIDECAR_BOUNDARY_MATRIX.md), [03-deployment/DBIS_MOJALOOP_INTEGRATION_STATUS.md](03-deployment/DBIS_MOJALOOP_INTEGRATION_STATUS.md), [03-deployment/DBIS_HYPERLEDGER_IDENTITY_STACK_DECISION.md](03-deployment/DBIS_HYPERLEDGER_IDENTITY_STACK_DECISION.md) | +| **04-configuration** | [04-configuration/README.md](04-configuration/README.md), [04-configuration/ADDITIONAL_PATHS_AND_EXTENSIONS.md](04-configuration/ADDITIONAL_PATHS_AND_EXTENSIONS.md) (paths, registry, token-mapping, LiFi/Jumper); **Multi-jurisdiction compliance (matrices, charter, playbook):** [04-configuration/compliance-matrices/README.md](04-configuration/compliance-matrices/README.md), [04-configuration/jurisdictions/JURISDICTION_CATALOG.md](04-configuration/jurisdictions/JURISDICTION_CATALOG.md), [`config/jurisdictions/catalog.v1.json`](../config/jurisdictions/catalog.v1.json), [dbis-rail/DBIS_RAIL_JURISDICTION_TRACEABILITY.md](dbis-rail/DBIS_RAIL_JURISDICTION_TRACEABILITY.md); **Universal resource activation (SKR, server funds, infra):** [04-configuration/universal-resource-activation/README.md](04-configuration/universal-resource-activation/README.md), [UNIVERSAL_RESOURCE_WIRING.md](04-configuration/universal-resource-activation/UNIVERSAL_RESOURCE_WIRING.md), `pnpm ura:validate`, `pnpm ura:validate-profiles`, `pnpm ura:merge-manifest`, `pnpm ura:validate-closure` / `URA_STRICT_CLOSURE`, `pnpm ura:smoke`, `node scripts/ura/keccak-resource-ids.mjs`, Phoenix URA routes (manifest, policy-profiles, sidecar-probe), [`config/universal-resource-activation/manifest.json`](../config/universal-resource-activation/manifest.json), [`config/universal-resource-activation/policy-profiles.json`](../config/universal-resource-activation/policy-profiles.json), [manifest-fragments/README.md](../config/universal-resource-activation/manifest-fragments/README.md); **Chain 138 wallets:** [04-configuration/CHAIN138_WALLET_CONFIG_VALIDATION.md](04-configuration/CHAIN138_WALLET_CONFIG_VALIDATION.md); **Chain 2138 testnet wallets:** [04-configuration/CHAIN2138_WALLET_CONFIG_VALIDATION.md](04-configuration/CHAIN2138_WALLET_CONFIG_VALIDATION.md); **OMNL Indonesia / HYBX-BATCH-001:** [04-configuration/mifos-omnl-central-bank/HYBX_BATCH_001_OPERATOR_CHECKLIST.md](04-configuration/mifos-omnl-central-bank/HYBX_BATCH_001_OPERATOR_CHECKLIST.md), [04-configuration/mifos-omnl-central-bank/INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md](04-configuration/mifos-omnl-central-bank/INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md) | | **Phoenix / Sankofa deploy handoff** | [04-configuration/PHOENIX_SANKOFA_OPERATOR_HANDOFF.md](04-configuration/PHOENIX_SANKOFA_OPERATOR_HANDOFF.md) — live CTs, env locations, secret split, rotate/reload/verify commands | | **06-besu** | [06-besu/MASTER_INDEX.md](06-besu/MASTER_INDEX.md) | | **Testnet (2138)** | [testnet/DEFI_ORACLE_META_TESTNET_2138_RUNBOOK.md](testnet/DEFI_ORACLE_META_TESTNET_2138_RUNBOOK.md), [testnet/TESTNET_DEPLOYMENT.md](testnet/TESTNET_DEPLOYMENT.md) | | **07-ccip** | [07-ccip/](07-ccip/), [00-meta/CW_BRIDGE_TASK_LIST.md](00-meta/CW_BRIDGE_TASK_LIST.md) | -| **11-references** | [11-references/ADDRESS_MATRIX_AND_STATUS.md](11-references/ADDRESS_MATRIX_AND_STATUS.md), [11-references/CONTRACT_ADDRESSES_REFERENCE.md](11-references/CONTRACT_ADDRESSES_REFERENCE.md), [11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md](11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md) (all contracts by deployer wallet, network, verified/not), [11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md](11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md) (tokens, bridges, DODO/Uniswap LPs, full route map), [11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md](11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md) (deployer→public stablecoin routes), [11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md](11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md) (routes where bridge pre-fund not required), [11-references/CCIP_138_DESTINATION_RECEIVER_BY_CHAIN_AND_TOKEN.md](11-references/CCIP_138_DESTINATION_RECEIVER_BY_CHAIN_AND_TOKEN.md) (per-chain per-token: mint vs receive+forward vs release), [11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md](11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md) (dotenv and config files with contract deployments), [11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md](11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md) (Explorer /tokens vs repo token lists), [11-references/NON_EVM_NETWORK_HEALTH_AND_LANE_STATUS.md](11-references/NON_EVM_NETWORK_HEALTH_AND_LANE_STATUS.md) (public Solana/Tron/XRPL health vs Chain 138 lane closure), [11-references/COMPLETE_CREDENTIAL_EIDAS_PROGRAM_REPOS.md](11-references/COMPLETE_CREDENTIAL_EIDAS_PROGRAM_REPOS.md) (Complete Credential / eIDAS connector repo authority + manifest), [11-references/HARDWARE_INVENTORY_MASTER.md](11-references/HARDWARE_INVENTORY_MASTER.md), [11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md](11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md), [11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md](11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md) | +| **11-references** | [11-references/ADDRESS_MATRIX_AND_STATUS.md](11-references/ADDRESS_MATRIX_AND_STATUS.md), [11-references/CONTRACT_ADDRESSES_REFERENCE.md](11-references/CONTRACT_ADDRESSES_REFERENCE.md), [11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md](11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md) (all contracts by deployer wallet, network, verified/not), [11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md](11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md) (tokens, bridges, DODO/Uniswap LPs, full route map), [11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md](11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md) (deployer→public stablecoin routes), [11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md](11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md) (routes where bridge pre-fund not required), [11-references/CCIP_138_DESTINATION_RECEIVER_BY_CHAIN_AND_TOKEN.md](11-references/CCIP_138_DESTINATION_RECEIVER_BY_CHAIN_AND_TOKEN.md) (per-chain per-token: mint vs receive+forward vs release), [11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md](11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md) (dotenv and config files with contract deployments), [11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md](11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md) (Explorer /tokens vs repo token lists), [11-references/NON_EVM_NETWORK_HEALTH_AND_LANE_STATUS.md](11-references/NON_EVM_NETWORK_HEALTH_AND_LANE_STATUS.md) (public Solana/Tron/XRPL health vs Chain 138 lane closure), [11-references/COMPLETE_CREDENTIAL_EIDAS_PROGRAM_REPOS.md](11-references/COMPLETE_CREDENTIAL_EIDAS_PROGRAM_REPOS.md) (Complete Credential / eIDAS connector repo authority + manifest), [11-references/HARDWARE_INVENTORY_MASTER.md](11-references/HARDWARE_INVENTORY_MASTER.md), [11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md](11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md), [11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md](11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md), [../reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md](../reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md) (live ecosystem financial inventory and routing-gap report), [`../config/public-routing-coverage-matrix.json`](../config/public-routing-coverage-matrix.json) (machine-readable stablecoin/top-asset coverage, short leaps, and component gaps) | | **Hardware / 13-node** | [11-references/HARDWARE_INVENTORY_MASTER.md](11-references/HARDWARE_INVENTORY_MASTER.md) (R630×13, R750×3, 7920×2, UDM Pro×2, XG×2), [02-architecture/R630_13_NODE_DOD_HA_MASTER_PLAN.md](02-architecture/R630_13_NODE_DOD_HA_MASTER_PLAN.md), [11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md](11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md), [11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md](11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md) | | **Runbooks** | [03-deployment/OPERATIONAL_RUNBOOKS.md](03-deployment/OPERATIONAL_RUNBOOKS.md) | diff --git a/reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md b/reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md new file mode 100644 index 00000000..922dd233 --- /dev/null +++ b/reports/status/LIVE_ECOSYSTEM_FINANCIAL_INVENTORY_AND_ROUTING_GAPS_20260424.md @@ -0,0 +1,438 @@ +# Live Ecosystem Financial Inventory, Public Routing Potential, and Gap Map + +**Date:** 2026-04-24 +**Scope:** Current live Chain 138 ecosystem, public-network routing potential, top stablecoin / top-50 token reachability, and recommended next integration leaps. +**Method:** Repo-backed live inventory and routing docs cross-checked with current CoinGecko market-cap and stablecoin rankings accessed on 2026-04-24. + +--- + +## 1. Executive Summary + +The current ecosystem is materially stronger than several older narrative docs imply. + +- **Chain 138 is a live compliant-asset home chain** with USD, fiat, gold, and gas/bridge primitives. +- **Chain 138 now has live `asset -> WETH` PMM routes** for the compliant USD, fiat, and gold stack. +- **Public routing is live across major EVM rails** via CCIP WETH to Ethereum, BSC, Polygon, Optimism, Arbitrum, Avalanche, Cronos, Gnosis, and Celo. +- **ALL Mainnet / Alltra is bridge-live**, but its same-chain canonical swap surface is still under-documented. +- **Wemix remains scaffold-only**, because the current Chain 138 CCIP router still rejects the Wemix selector. +- **Stablecoin reachability is strong** for USDT, USDC, DAI, and USDS through Ethereum and other live EVM destinations. +- **Top-50 token reachability is good for EVM-native assets and weak for non-EVM majors** such as BTC, SOL, XRP, ADA, XMR, and SUI. + +The biggest correction versus older route docs is simple: + +> The repo’s current live liquidity graph now supports compliant `c* -> WETH` exits on Chain 138, which means many compliant fiat and gold assets can now reach public EVM stablecoins and tokens through a short, live path. + +--- + +## 2. Live Financial Inventory + +### 2.1 Chain 138 canonical assets + +Core assets on Chain 138: + +- `WETH` +- `WETH10` +- `LINK` + +Compliant USD and bridge-adjacent assets: + +- `cUSDT` +- `cUSDC` +- `cAUSDT` + +Compliant fiat set: + +- `cEURC` +- `cEURT` +- `cGBPC` +- `cGBPT` +- `cAUDC` +- `cJPYC` +- `cCHFC` +- `cCADC` + +Compliant gold: + +- `cXAUC` +- `cXAUT` + +Primary source: +- [DEPLOYED_CONTRACTS_UNIFIED_EXTENDED.md](/home/intlc/projects/proxmox/reports/inventory/DEPLOYED_CONTRACTS_UNIFIED_EXTENDED.md) + +Supporting source: +- [TOKEN_CATEGORIES_CANONICAL.md](/home/intlc/projects/proxmox/docs/11-references/TOKEN_CATEGORIES_CANONICAL.md) + +### 2.2 Chain 138 live routing core + +Canonical live routing contracts: + +- `DODOPMMIntegration`: `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` +- `DODOPMMProvider`: `0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381` + +Primary source: +- [DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md](/home/intlc/projects/proxmox/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md) + +### 2.3 Chain 138 live liquidity surface + +The current canonical liquidity map shows **28 live pools** on Chain 138, including: + +- `cUSDT / cUSDC` +- `cUSDT / USDT` +- `cUSDC / USDC` +- compliant fiat to `cUSDC` +- gold to `cUSDC` +- paired compliant fiat variants +- paired gold variants +- direct compliant `-> WETH` routes + +Important live public-exit PMM routes: + +- `cUSDT / WETH` +- `cUSDC / WETH` +- `cEURC / WETH` +- `cEURT / WETH` +- `cGBPC / WETH` +- `cGBPT / WETH` +- `cAUDC / WETH` +- `cJPYC / WETH` +- `cCHFC / WETH` +- `cCADC / WETH` +- `cXAUC / WETH` +- `cXAUT / WETH` + +Primary source: +- [LIQUIDITY_POOLS_MASTER_MAP.md](/home/intlc/projects/proxmox/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md) + +### 2.4 Public-network settlement surface + +Bridge-live public destination set: + +- Ethereum `1` +- BSC `56` +- Polygon `137` +- Optimism `10` +- Arbitrum `42161` +- Avalanche `43114` +- Cronos `25` +- Gnosis `100` +- Celo `42220` +- ALL Mainnet / Alltra `651940` + +Blocked or not yet promoted: + +- Wemix `1111` + +Primary source: +- [DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md](/home/intlc/projects/proxmox/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md) + +### 2.5 Public wrapped inventory + +The public-chain wrapped family is live across the active EVM set and includes: + +- `cWUSDT` +- `cWUSDC` +- `cWEURC` +- `cWEURT` +- `cWGBPC` +- `cWGBPT` +- `cWAUDC` +- `cWJPYC` +- `cWCHFC` +- `cWCADC` +- `cWXAUC` +- `cWXAUT` + +This is paired with gas-family wrappers and a mixed PMM / UniswapV2 deployment surface on public chains. + +Primary source: +- [TOKEN_CATEGORIES_CANONICAL.md](/home/intlc/projects/proxmox/docs/11-references/TOKEN_CATEGORIES_CANONICAL.md) +- [LIQUIDITY_POOLS_MASTER_MAP.md](/home/intlc/projects/proxmox/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md) + +--- + +## 3. Routeability Model + +### 3.1 Strongly live route pattern + +The core live route pattern is: + +`Chain 138 asset -> Chain 138 WETH -> CCIP / Alltra -> public destination -> destination DEX or cW* pool` + +That means routeability now depends less on direct stablecoin bridges and more on: + +- availability of a live `asset -> WETH` PMM on Chain 138 +- bridge-live status for the destination chain +- destination-chain DEX or cW* settlement surface + +### 3.2 Routeability tiers + +#### Tier A: direct same-chain or immediately bridgeable + +- `WETH` +- `WETH10` +- `cUSDT` +- `cUSDC` +- `cEURC` +- `cEURT` +- `cGBPC` +- `cGBPT` +- `cAUDC` +- `cJPYC` +- `cCHFC` +- `cCADC` +- `cXAUC` +- `cXAUT` + +#### Tier B: strong public-EVM routing potential + +These are not home-chain native on 138, but are practically reachable through live bridge and destination DEX surfaces: + +- `USDT` +- `USDC` +- `DAI` +- `USDS` +- EVM-native majors such as `ETH`, `LINK`, `AAVE`, `UNI`, `AVAX`, `BNB`, `CRO` + +#### Tier C: plausible but not canonically committed as named targets + +- `PYUSD` +- `USDe` +- `USD1` +- `USDG` +- `RLUSD` +- `USDF` +- other ERC-20 style public-chain assets on supported EVM rails + +#### Tier D: weak or non-live in current stack + +- `BTC` +- `SOL` +- `TRX` +- `XRP` +- `ADA` +- `XMR` +- `ZEC` +- `XLM` +- `HBAR` +- `SUI` +- other non-EVM or unsupported-native majors + +--- + +## 4. Stablecoin Coverage + +### 4.1 Current market-cap context + +Using CoinGecko’s stablecoin category page accessed on **2026-04-24**, the stablecoin category market cap is about **$316B**, led by: + +- `USDT` +- `USDC` +- `USDS` +- `DAI` +- `USD1` +- `USDe` +- `PYUSD` +- `USDG` +- `RLUSD` + +Source: +- https://www.coingecko.com/en/categories/stablecoins + +### 4.2 Stablecoin reachability map + +| Stablecoin | Current reachability from Chain 138 | Basis | +| --- | --- | --- | +| `USDT` | Strong | direct mirror liquidity on 138 plus public-chain USDT settlement | +| `USDC` | Strong | direct mirror liquidity on 138 plus public-chain USDC settlement | +| `DAI` | Strong | live Ethereum bridge path via WETH, then DEX | +| `USDS` | Strong | live Ethereum bridge path via WETH, then DEX | +| `PYUSD` | Medium | likely reachable on Ethereum/Base; not canonically listed as a named route target | +| `USDe` | Medium | likely reachable on Ethereum; not canonically listed as a named route target | +| `USD1` | Medium | likely reachable on Ethereum; not canonically listed as a named route target | +| `USDG` | Medium | likely reachable on supported EVM rails; not canonically committed | +| `RLUSD` | Medium | likely reachable on Ethereum/EVM venues; not canonically committed | +| `USDF` | Medium | likely reachable on supported EVM rails; not canonically committed | +| `BUIDL`, `USYC`, `JTRSY` | Low / institutional-only | not a normal public DEX target class | +| `XAUT` | Strong | native gold family already present on Chain 138 through `cXAUT` | +| `PAXG` | Medium | likely reachable through Ethereum, but not a named canonical route target | + +--- + +## 5. Top-50 Token Reachability + +### 5.1 Current market-cap context + +Using CoinGecko’s market-cap leaderboard accessed on **2026-04-24**, the top-50 includes Bitcoin, Ethereum, Tether, XRP, BNB, USDC, Solana, TRON, Dogecoin, Cardano, Chainlink, Avalanche, Cronos, Uniswap, Aave, and others, along with some treasury/RWA-style entries. + +Source: +- https://www.coingecko.com/ + +### 5.2 Top-50 routing classification + +#### Strongly reachable now + +- `ETH` +- `LINK` +- `USDT` +- `USDC` +- `DAI` +- `AVAX` +- `CRO` +- `UNI` +- `AAVE` +- `BNB` + +#### Reachable in practice, but not yet first-class documented targets + +- `SHIB` +- `PEPE` +- `NEAR` only if using wrapped/EVM exposure, not native settlement +- `TON` only if using wrapped/EVM exposure, not native settlement +- `BCH` only if using wrapped/EVM exposure, not native settlement +- many ERC-20 assets on Ethereum, Arbitrum, Optimism, Polygon, Base, BSC, Avalanche, Cronos, Gnosis, or Celo + +#### Weak / non-live in current architecture + +- `BTC` +- `SOL` +- `TRX` +- `XRP` +- `ADA` +- `XMR` +- `ZEC` +- `XLM` +- `HBAR` +- `SUI` + +These require either non-EVM bridges, wrapped canonical inventory beyond the current stack, or entirely new destination integration components. + +--- + +## 6. Gap Mapping + +### 6.1 Gap class A: documentation lag + +These are mostly already-live capabilities that older docs understate or fail to surface clearly. + +| Gap | Current reality | Impact | +| --- | --- | --- | +| 138 `c* -> WETH` exits understated | live PMM routes exist for compliant USD, fiat, and gold | public-route potential is higher than older docs imply | +| Stablecoin route doc still says no documented `c* -> WETH` | liquidity map proves otherwise | planning may be too conservative | +| ALL Mainnet same-chain surface is described as pending | bridge is live, but swap surface still lacks canonical inventory | operators may underuse Alltra routes | + +### 6.2 Gap class B: short integration leaps + +These are the best next moves because they do not require a new blockchain architecture, only a modest integration step. + +| Leap | Why it matters | Difficulty | +| --- | --- | --- | +| promote named route support for `PYUSD`, `USDe`, `RLUSD`, `USD1`, `USDG` | converts likely reachability into explicit supported routes | short | +| add explicit destination DEX route tables per live chain | removes ambiguity in “reachable in principle” cases | short | +| update stable-route docs to reflect live `c* -> WETH` paths | aligns planning and execution docs | short | +| publish destination-chain route confidence per asset family | makes operator quotes more predictable | short | +| canonicalize ALL Mainnet pool/router/factory inventory | turns `bridge_live_swap_inventory_pending` into first-class routing | short-to-medium | + +### 6.3 Gap class C: additional components needed + +These require a new integration layer or materially new destination infrastructure. + +| Component needed | Why | +| --- | --- | +| non-EVM bridge rails for BTC/SOL/XRP/ADA/XLM/HBAR/SUI class assets | current stack is EVM-centric | +| native non-EVM swap adapters | current routing engine is built around EVM PMM / DEX patterns | +| canonical Alltra same-chain DEX inventory and live venue map | bridge exists, swap surface still lacks canonical publication | +| live Wemix selector support in Chain 138 CCIP router | current router blocks proof transfer | +| explicit top-50 asset coverage registry | current docs are token-family rich but top-asset-support poor | + +--- + +## 7. Recommended Integration Leaps + +### 7.1 Highest-value short leaps + +1. **Correct the canonical route docs** + - Update the stablecoin/public-route docs so they explicitly recognize the live Chain 138 `c* -> WETH` PMM layer. + +2. **Publish a destination route registry** + - For each live destination chain, record: + - native public stables + - named DEX path + - cW* path + - confidence level + +3. **Promote public stablecoins beyond the current base four** + - Make `PYUSD`, `USDe`, `RLUSD`, `USD1`, and `USDG` explicit route targets where destination-chain liquidity already supports them. + +4. **Canonicalize ALL Mainnet** + - Move 651940 from “bridge-live but swap-inventory pending” to a first-class route surface with named pools and routers. + +5. **Add a top-50 coverage matrix** + - Track each current top-50 asset as: + - direct + - indirect + - wrapped-only + - not supported + +### 7.2 Recommended additional components + +1. **Non-EVM expansion pack** + - Build or adopt bridge and swap adapters for: + - Bitcoin-family access + - Solana + - XRP Ledger + - Cardano + - Stellar + - Hedera + - Sui + +2. **Route-confidence API surface** + - Add machine-readable “route confidence” outputs to quote/build systems so operator-facing tools can distinguish: + - live confirmed + - live but destination-DEX-dependent + - scaffold-only + - blocked + +3. **Top stablecoin and top asset auto-crosscheck** + - Add a recurring validation that compares: + - current market-cap leaders + - current internal coverage + - missing supported destinations + +--- + +## 8. Final Assessment + +The ecosystem is no longer just a closed compliant-asset island. + +It is now best understood as: + +- a **live compliant home chain** +- with **broad internal PMM liquidity** +- with **working WETH-based public exits** +- with **active cW* public-chain inventory** +- with **strong stablecoin access on supported EVM rails** +- but still **missing first-class support for major non-EVM public assets** + +The highest-return immediate work is not inventing a new bridge stack. It is: + +- documenting the now-live `c* -> WETH` reality, +- promoting additional public stablecoin targets into named supported routes, +- and canonicalizing ALL Mainnet’s same-chain liquidity surface. + +--- + +## 9. Sources + +Repo-backed sources: + +- [DEPLOYED_CONTRACTS_UNIFIED_EXTENDED.md](/home/intlc/projects/proxmox/reports/inventory/DEPLOYED_CONTRACTS_UNIFIED_EXTENDED.md) +- [DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md](/home/intlc/projects/proxmox/docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md) +- [LIQUIDITY_POOLS_MASTER_MAP.md](/home/intlc/projects/proxmox/docs/11-references/LIQUIDITY_POOLS_MASTER_MAP.md) +- [DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md](/home/intlc/projects/proxmox/docs/11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md) +- [TOKEN_CATEGORIES_CANONICAL.md](/home/intlc/projects/proxmox/docs/11-references/TOKEN_CATEGORIES_CANONICAL.md) +- [ALL_MAINNET_ROUTING_ENGINE.md](/home/intlc/projects/proxmox/docs/11-references/ALL_MAINNET_ROUTING_ENGINE.md) + +External market-cap references accessed on 2026-04-24: + +- CoinGecko market-cap leaderboard: https://www.coingecko.com/ +- CoinGecko stablecoin category: https://www.coingecko.com/en/categories/stablecoins diff --git a/scripts/validation/validate-config-files.sh b/scripts/validation/validate-config-files.sh index 00b3457b..35350876 100755 --- a/scripts/validation/validate-config-files.sh +++ b/scripts/validation/validate-config-files.sh @@ -3,6 +3,8 @@ # Recommendation: docs/10-best-practices/IMPLEMENTATION_CHECKLIST.md (Configuration validation) # Usage: ./scripts/validation/validate-config-files.sh [--dry-run] # --dry-run Print what would be validated and exit 0 (no file checks). +# Optional: URA_STRICT_CLOSURE=1 — after URA manifest/profile checks, fail if pilot placeholders +# or open reconciliation remain (see scripts/ura/validate-manifest-closure.mjs). set -euo pipefail @@ -91,6 +93,26 @@ else fi fi fi + if [[ -f "$PROJECT_ROOT/config/public-routing-coverage-matrix.json" ]]; then + log_ok "Found: config/public-routing-coverage-matrix.json" + if command -v jq &>/dev/null; then + if jq -e ' + (.schemaVersion | type == "string") + and (.supportedBridgeDestinations | type == "array") + and (.stablecoinCoverage | type == "array") + and (.topAssetCoverage | type == "array") + and (.shortIntegrationLeaps | type == "array") + and (.additionalComponentsRequired | type == "array") + ' "$PROJECT_ROOT/config/public-routing-coverage-matrix.json" &>/dev/null; then + log_ok "public-routing-coverage-matrix.json: structure valid" + else + log_err "public-routing-coverage-matrix.json: invalid structure" + ERRORS=$((ERRORS + 1)) + fi + fi + else + log_warn "Optional config/public-routing-coverage-matrix.json missing; skipping" + fi [[ -f "$PROJECT_ROOT/config/smart-contracts-master.json" ]] && log_ok "Found: config/smart-contracts-master.json" || true # Token lists (Uniswap format): validate structure if present for list in token-lists/lists/dbis-138.tokenlist.json token-lists/lists/cronos.tokenlist.json token-lists/lists/all-mainnet.tokenlist.json; do @@ -149,6 +171,32 @@ else log_err "Missing config/universal-resource-activation/manifest.json" ERRORS=$((ERRORS + 1)) fi + # URA policy profile registry (must match manifest policyProfileRefs and resource.policyProfileId) + if [[ -f "$PROJECT_ROOT/config/universal-resource-activation/policy-profiles.json" ]]; then + log_ok "Found: config/universal-resource-activation/policy-profiles.json" + if command -v node &>/dev/null && [[ -f "$PROJECT_ROOT/scripts/validate/validate-ura-policy-profiles.mjs" ]]; then + if node "$PROJECT_ROOT/scripts/validate/validate-ura-policy-profiles.mjs"; then + log_ok "universal-resource-activation: policy profile registry validation passed" + else + log_err "universal-resource-activation: policy-profiles.json or manifest profile refs failed validation" + ERRORS=$((ERRORS + 1)) + fi + else + log_warn "Node or validate-ura-policy-profiles.mjs missing; skipping URA profile registry validation" + fi + else + log_warn "Optional config/universal-resource-activation/policy-profiles.json missing; skipping" + fi + # Optional production gate: URA_STRICT_CLOSURE=1 fails if pilots/TBD/open reconciliation remain + if [[ "${URA_STRICT_CLOSURE:-}" == "1" ]] && [[ -f "$PROJECT_ROOT/scripts/ura/validate-manifest-closure.mjs" ]]; then + log_info "URA_STRICT_CLOSURE=1: running URA manifest closure gate…" + if node "$PROJECT_ROOT/scripts/ura/validate-manifest-closure.mjs" --strict; then + log_ok "universal-resource-activation: strict closure validation passed" + else + log_err "universal-resource-activation: strict closure failed (see URA_PILOT_CLOSURE_RUNBOOK.md)" + ERRORS=$((ERRORS + 1)) + fi + fi # Phoenix deploy targets (used by phoenix-deploy-api POST /api/deploy) if [[ -f "$PROJECT_ROOT/phoenix-deploy-api/deploy-targets.json" ]]; then log_ok "Found: phoenix-deploy-api/deploy-targets.json"