32 lines
1.8 KiB
Markdown
32 lines
1.8 KiB
Markdown
# 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.
|
|
|
|
## Quick start
|
|
|
|
1. See [docs/01-token-map.md](docs/01-token-map.md) for canonical and cW* token mapping.
|
|
2. See [docs/02-pool-topology.md](docs/02-pool-topology.md) for edge pool design.
|
|
3. See [docs/06-deployment-recipe.md](docs/06-deployment-recipe.md) for step-by-step deployment.
|
|
4. Config: [config/token-map.json](config/token-map.json), [config/pool-matrix.json](config/pool-matrix.json), [config/peg-bands.json](config/peg-bands.json), [config/chains.json](config/chains.json).
|
|
|
|
## Parent repo
|
|
|
|
This repository is intended as a **submodule** of the [proxmox](https://github.com/Order-of-Hospitallers/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:
|
|
|
|
```bash
|
|
git submodule add https://gitea.d-bis.org/d-bis/cross-chain-pmm-lps.git cross-chain-pmm-lps
|
|
```
|