4ebf2d7902
Add optional Cosmos/Engine-X/act-runner templates, CWUSDC/EI-matrix tooling, non-EVM route planner in multi-chain-execution (tests passing), token list and extraction updates, and documentation (MetaMask matrix, GRU/CWUSDC packets). Ignore institutional evidence tarballs/sha256 under reports/status. Validated with: bash scripts/verify/run-all-validation.sh --skip-genesis Co-authored-by: Cursor <cursoragent@cursor.com>
2.3 KiB
EI matrix — mainnet cWUSDC mint pipeline
Purpose: Mint Ethereum mainnet cWUSDC (CWUSDC_MAINNET, default 0x2de5F116bFcE3d0f922d9C8351e0c5Fc24b9284a) directly to every address in config/pmm-soak-wallet-grid.json (EI matrix), without bridging from Chain 138.
Treasury semantics: The 33 × 33 × 6 grid (6 534 wallets) is the canonical sovereign-nation treasury address set for the Elemental Imperium model—each cell’s Ethereum address is the designated on-chain treasury for that routing cell (see semanticModel in config/pmm-soak-wallet-grid.json). Nation↔cell attribution and reserve governance are layered via config/elemental-imperium-network-registry.json and optional overlays; scripts operate on addresses regardless of label assignment.
Entry point (recommended):
./scripts/deployment/pipeline-ei-matrix-mint-cwusdc.sh --dry-run --mint-raw 10000000
./scripts/deployment/pipeline-ei-matrix-mint-cwusdc.sh --mint-raw 10000000
Pass extra flags to the mint script after --:
./scripts/deployment/pipeline-ei-matrix-mint-cwusdc.sh --dry-run --total-mint-raw 72000000000000 --spread-pct 15 -- --offset 0 --limit 100
Resume after partial run:
./scripts/deployment/continue-mint-cwusdc-ei-matrix-wallets.sh --mint-raw 10000000
(progress file: reports/status/ei-matrix-cwusdc-mint-last-idx.txt)
Modes:
| Flag | Meaning |
|---|---|
--mint-raw R |
Same raw amount (6 decimals) minted to each wallet in the slice. |
--total-mint-raw B |
Total minted across the slice equals B; per-wallet amounts use ±--spread-pct jitter then renormalize (default spread 15). |
Requirements:
PRIVATE_KEYwithmint(address,uint256)authority on the token (typicallyMINTER_ROLEonCompliantWrappedToken-stylecWUSDC).ETHEREUM_MAINNET_RPC(orRPC_URL_1) and ETH for gas.- On-chain reserve / policy on the token must allow mints (otherwise transactions revert).
Not in scope: Minting c* on Chain 138 and bridging to mainnet as cWUSDC — use bridge / Engine X runbooks separately (docs/03-deployment/DBIS_ENGINE_X_RECIPIENT_PROOF_RUNBOOK.md, docs/07-ccip/).
Artifacts: reports/status/ei-matrix-cwusdc-mint-*.json manifests, ei-matrix-cwusdc-mint-failures.log, flock ei-matrix-cwusdc-mint.lock (one live mint job).