Files
proxmox/docs/gru-m1/README.md

70 lines
4.0 KiB
Markdown
Raw Normal View History

# GRU M1 Listing & Validation
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
## Overview
This folder contains the **GRU M1 Master Implementation Plan** and supporting documents for launching and validating **GRU M1 compliant settlement instruments** (cUSDC, cUSDT, cEURC, etc.) and their public listings on **CoinMarketCap (CMC)** and **CoinGecko (CG)**.
---
## Documents
| Document | Description |
| -------- | ----------- |
| [GRU_M1_MASTER_IMPLEMENTATION_PLAN.md](GRU_M1_MASTER_IMPLEMENTATION_PLAN.md) | End-to-end implementation, testing, and dry-run framework (6 phases) |
| [GRU_M1_REAL_DATA_DOMINANCE_ADDENDUM.md](GRU_M1_REAL_DATA_DOMINANCE_ADDENDUM.md) | Real-data dominance simulation (Section VII) and peg stress-test worksheet (Section VIIIIX) |
| [PEG_STRESS_TEST_WORKSHEET.md](PEG_STRESS_TEST_WORKSHEET.md) | Per-instrument peg stress-test template for dry-runs and audits |
---
## Quick Links
### Runbooks & Procedures
* [GRU M1 Listing Dry-Run Runbook](../runbooks/GRU_M1_LISTING_DRY_RUN_RUNBOOK.md) — Step-by-step dry-run procedures
* [GRU M1 Listing Validation](../compliance/GRU_M1_LISTING_VALIDATION.md) — Acceptance gates and validation criteria
### Configuration & Submission
* [CoinGecko Submission Guide](../04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md) — cUSDC, cUSDT submission templates
* [CMC & CoinGecko Reporting](../../smom-dbis-138/services/token-aggregation/docs/CMC_COINGECKO_REPORTING.md) — Token aggregation report API
* [GRU c* V2 Standards Matrix and Implementation Plan](../04-configuration/GRU_C_STAR_V2_STANDARDS_MATRIX_AND_IMPLEMENTATION_PLAN.md) — Canonical `c* V2` standards, x402 readiness, wrapper/vault boundaries, GRU facet mapping, and phased migration plan
* [GRU Standards Profile](../04-configuration/GRU_STANDARDS_PROFILE.md) — Machine-readable standards profile for x402, base-token EIPs/ERCs, mirrored `cW*` transport, and the broader ISO-4217-plus asset scope
* [GRU Storage, Governance, and Supervision Standard](../04-configuration/GRU_STORAGE_GOVERNANCE_AND_SUPERVISION_STANDARD.md) — Required metadata, jurisdiction review, and upgrade-notice rules for `c*`, `cW*`, and related governed assets
* [GRU FX Currency Onboarding Checklist](../04-configuration/GRU_FX_CURRENCY_ONBOARDING_CHECKLIST.md) — Required end-to-end steps to create, attach, and activate a new FX `c*` instrument inside the GRU ecosystem
* [`config/gru-standards-profile.json`](../../config/gru-standards-profile.json) — Machine-readable standards source for GRU monetary assets, payment profiles, and transport methodology
* [`config/gru-governance-supervision-profile.json`](../../config/gru-governance-supervision-profile.json) — Machine-readable storage namespace, supervision, and jurisdiction-review profile
* [`config/gru-iso4217-currency-manifest.json`](../../config/gru-iso4217-currency-manifest.json) — Machine-readable supported-currency manifest for `c*` / `cW*`, deployment state, transport activation, and x402 readiness
### References
* [Chain 138 Token Addresses](../11-references/CHAIN138_TOKEN_ADDRESSES.md) — cUSDC, cUSDT contract addresses
* [ISO-20022 E-Money Runbook](../runbooks/MULTI_CHAIN_EXECUTION_ISO20022_EMONEY.md) — GRU-M1 base money requirements
---
## Scripts
| Script | Description |
| ------ | ----------- |
| [scripts/gru-m1/dominance-simulation.sh](../../scripts/gru-m1/dominance-simulation.sh) | Run Top-25 dominance simulation (S0S5) |
| [scripts/gru-m1/check-ciso-supply.sh](../../scripts/gru-m1/check-ciso-supply.sh) | On-chain supply reconciliation for cUSDC/cUSDT |
---
## Terminology
| Term | Meaning |
| ---- | ------- |
| **cISO(C/T)** | Compliant fiat-referenced token: `c` + ISO-4217 currency + Coin (`C`) or Token (`T`) |
| **cUSDC** | Compliant USD Coin |
| **cUSDT** | Compliant USD Token |
| **cEURC** | Compliant EUR Coin |
| **GRU M1** | GRU base money layer; externally represented as stablecoin / fiat-pegged |
| **cW*** | Public-network mirrored transport form of canonical Chain 138 GRU M1 |