# GRU M1 Scripts

Scripts for GRU M1 dominance simulation and supply verification.

## Scripts

### dominance-simulation.sh

Simulates how GRU M1 supply (S0–S5) affects BTC/ETH/Stablecoin dominance using CoinGecko global data.

**Usage:**
```bash
./dominance-simulation.sh                    # Output to stdout
./dominance-simulation.sh reports/gru-m1/dominance-$(date +%Y%m%d).md  # Save report
```

**Env fallback (if CoinGecko unavailable):**
- `GRU_M1_TOTAL_MARKET_CAP` — Total crypto market cap (USD)
- `GRU_M1_BTC_DOMINANCE` — BTC dominance %
- `GRU_M1_ETH_DOMINANCE` — ETH dominance %
- `GRU_M1_STABLECOIN_DOM` — Stablecoin dominance %

### check-ciso-supply.sh

Verifies cUSDC and cUSDT `totalSupply()` on Chain 138. Optionally compares to expected values for supply reconciliation.

**Usage:**
```bash
./check-ciso-supply.sh
```

**Env:**
- `CHAIN_138_RPC_URL` — RPC URL (default: https://rpc-http-pub.d-bis.org)
- `CUSDC_EXPECTED` — Expected cUSDC supply (raw units, 6 decimals)
- `CUSDT_EXPECTED` — Expected cUSDT supply (raw units, 6 decimals)

If `*_EXPECTED` not set, only reports on-chain supply (no pass/fail).

## Dependencies

- **dominance-simulation.sh:** `curl`, `jq`, `awk`
- **check-ciso-supply.sh:** `curl`, `awk`

## Related Documentation

- [docs/gru-m1/](../../docs/gru-m1/)
- [GRU M1 Listing Dry-Run Runbook](../../docs/runbooks/GRU_M1_LISTING_DRY_RUN_RUNBOOK.md)