cW M1 PMM Stabilization Mesh

Implementation-grade blueprint for the home-minted M1 suite on ChainID 138, bridged as cW* wrappers onto public chains, and stabilized via a bot-managed single-sided PMM mesh that trades against native stables on each public chain.

Purpose

• Token map: Canonical M1 on 138 (cUSDT, cUSDC, cAUSDT, cEURC, cEURT, cUSDW, WETH9/10, ETH); bridged cW* representations on public chains; anchor stables per chain.
• Pool topology: Single-sided PMM edge pools per chain (cW* / HUB or multi-quote).
• Bot-driven mesh: Deviation watcher, inventory re-centering, cross-pool routing, bridge-aware throttling; peg bands; oracles; mesh reflexivity controls.

GRU policy integration (reference primacy): this mesh is an execution and capacity layer for agreed peg bands and oracles — not an independent FX discovery layer for GRU/XDR. Parent canonical: docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md.

Quick start

1. See docs/01-token-map.md for canonical and cW* token mapping.
2. See docs/02-pool-topology.md for edge pool design.
3. See docs/06-deployment-recipe.md for step-by-step deployment.
4. Config: config/token-map.json, config/pool-matrix.json, config/peg-bands.json, config/chains.json.
5. Simulation: Two-layer model (design vs deployed graph), routing supergraph, PMM edge function, and scenario-based sim: docs/08-simulation-model.md. First-pass params: config/simulation-params.json, docs/09-simulation-params-sheet.md. Deployment-realistic sim: fill config/deployment-status.json. Hub stable pools (cW*/USDC, cW*/USDT) live in pmmPools[]. Volatile cWUSD* vs TRUU (mainnet) use anchorAddresses.TRUU plus pmmPoolsVolatile[] (runbook docs/03-deployment/MAINNET_PMM_TRUU_CWUSD_PEG_AND_BOT_RUNBOOK.md §11; parent scripts deploy-mainnet-pmm-cw-truu-pool.sh, add-mainnet-truu-pmm-topup.sh).
6. Behavioral stability: What to simulate first, three metrics in economic terms, where it can break: docs/10-behavioral-stability-analysis.md. Safe inventory sizing (closed-form I_T^* per chain): docs/11-safe-inventory-sizing.md.
7. Tools: scripts/size-inventory.cjs — regenerate I_T^*, D_0 from params (single command, deterministic; see scripts/README.md). scripts/validate-deployment-status.cjs — CI validation for deployment-status (phase 1 tokens when bridge=true; pool role/fee/k/tokens).
8. Sim scorecard: Simulator output contract and pass/fail gates: docs/12-sim-scorecard.md, config/scorecard-schema.json. Bridge edge with optional latency risk ρ(Δt): docs/08-simulation-model.md §2.
9. Scenario contract: Formal scenario input schema and three Phase 0 scenarios: config/scenario-schema.json, config/scenarios/. Routing exposure controls: config/routing-controls.json (maxTradeSize, cooldown, minImprovementBps, publicRoutingEnabled). Real sim (PR#1): node scripts/run-scenario.cjs hub_only_11 — graph from configs, PMM state, path enumeration + waterfilling, real scorecard (drain half-life, path concentration, capture, churn); see spec/13-minimal-router-sim.md.
10. USD-wrapper support lane: Gas-budgeted micro-trade policy for cWUSDC / cWUSDT and a runnable scenario: docs/15-gas-budgeted-micro-trade-support.md, config/scenarios/micro_support_usd_wrappers_1_56_137.json.
11. Capital efficiency risk simulation: Simulation-only Monte Carlo overlay for treasury allocation, leverage, peg pressure, volatility throttles, liquidation probability, and parameter optimization: docs/16-capital-efficiency-risk-simulation.md, docs/17-capital-efficiency-contract-blueprint-gate.md, docs/18-capital-efficiency-risk-dashboard-and-runbook.md, docs/19-capital-efficiency-external-approval-evidence.md, config/capital-efficiency-policy.json, config/treasury-liquidity-commitments.json, stress scenarios under config/scenarios/, and CI-style validation via node scripts/validate-capital-efficiency.cjs.

Parent repo

This repository is intended as a submodule of the proxmox infrastructure repo. Canonical token addresses for Chain 138 and multi-chain mapping are in the parent:

• Parent: config/token-mapping-multichain.json, docs/11-references/CHAIN138_TOKEN_ADDRESSES.md
• This repo extends with cW* contract addresses per public chain and stabilization mesh config.

Adding as submodule (parent repo)

From the proxmox repo root:

git submodule add https://gitea.d-bis.org/d-bis/cross-chain-pmm-lps.git cross-chain-pmm-lps