Files
proxmox/docs/gru-m1/README.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

68 lines
3.6 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.
# 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 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-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 |