- Added new deployment script references for Aave quote-push and treasury manager in .env.master.example. - Updated AGENTS.md to include information on GRU reference primacy versus public PMM mesh execution model. - Minor updates to various documentation files to reflect changes in policy and operational guidelines. Made-with: Cursor
97 lines
8.3 KiB
Markdown
97 lines
8.3 KiB
Markdown
# Next Steps (ordered)
|
||
|
||
**Last Updated:** 2026-04-04 — Mainnet cW canaries remain scale-gated and the AUSDT corridor is now repo-aligned through Celo. **P1 merged backlog** (platform + chain + HYBX + external + local verification IDs) added to [TODOS_CONSOLIDATED.md](TODOS_CONSOLIDATED.md#p1--merged-backlog-2026-03-30). Local automation: `bash scripts/verify/run-p1-local-verification.sh` (`--with-iru-tests` optional).
|
||
**Context (2026-03-06):** Phase A mint + add-liquidity completed (Pool 1 cUSDT/cUSDC has 2M/2M). Below are remaining steps in recommended order.
|
||
|
||
**Refs:** [TODOS_CONSOLIDATED.md](TODOS_CONSOLIDATED.md), [REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md](../03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md), [TASKS_ROUTING_SWAP_CROSSCHAIN.md](TASKS_ROUTING_SWAP_CROSSCHAIN.md). **Full execution (all + optional, suggested order):** [EXECUTION_CHECKLIST_MULTIPLE_ROUTES_AND_LIQUIDITY.md](EXECUTION_CHECKLIST_MULTIPLE_ROUTES_AND_LIQUIDITY.md).
|
||
|
||
**GRU reference primacy (mesh vs policy):** `bash scripts/verify/check-gru-reference-primacy-integration.sh` — also runs inside `bash scripts/validation/validate-config-files.sh`. Submodule workflow: [SUBMODULE_HYGIENE.md](SUBMODULE_HYGIENE.md) section **cross-chain-pmm-lps**.
|
||
|
||
**Completion check (current baseline):** Full run including optional: completable ✅, validate-config ✅, PMM pool balances ✅ (Pool 1: 2M/2M), preflight ✅, token-aggregation build ✅, on-chain **67/67** (current canonical `check-contracts-on-chain-138.sh` inventory) ✅, unit tests 457 ✅, deployer-gas dry-run ✅, fund-ccip dry-run ✅, E2E flow dry-run ✅, E2E routing ✅ (**37** public domains **Failed: 0** on 2026-03-06; **44** on 2026-03-29 re-check), operator script --skip-backup ✅ (NPMplus RPC + Blockscout verify). **Live 2026-03-30:** [LIVE_VERIFICATION_LOG_2026-03-30.md](LIVE_VERIFICATION_LOG_2026-03-30.md). **Audit (2026-03-06):** [DOTENV_AND_MARKDOWN_AUDIT_GAPS_AND_RECOMMENDATIONS.md](DOTENV_AND_MARKDOWN_AUDIT_GAPS_AND_RECOMMENDATIONS.md) — required dotenv/markdown info, gaps, and recommendations. B.1/B.2 still blocked (need CRO/WEMIX); B.3 blocked (LINK/gas); A2 env set (CHAIN_138_DODO_PMM_INTEGRATION in smom-dbis-138/.env); A3/C3–C8, Phase C, LINK relay, B4/B5 remain pending or optional.
|
||
|
||
---
|
||
|
||
## 1. Bridge coverage (Phase B)
|
||
|
||
| # | Step | Action | Blocked by | Status |
|
||
|---|------|--------|------------|--------|
|
||
| B.1 | **Cronos (25)** | Fund deployer ~15 CRO → set CRONOS_RPC, CCIP_ROUTER_CRONOS, WETH9_CRONOS, WETH10_CRONOS in smom-dbis-138/.env → run `deploy-bridges-config-ready-chains.sh cronos` → `complete-config-ready-chains.sh` | Need CRO (use `./scripts/deployment/acquire-cro-and-wemix-gas.sh` for aggregator links) | ⏳ Blocked |
|
||
| B.2 | **Wemix (1111)** | Fund deployer ~0.4 WEMIX → deploy bridges → complete-config | Need WEMIX (manual/aggregator; see [WEMIX_ACQUISITION_TABLED](../03-deployment/WEMIX_ACQUISITION_TABLED.md)) | ⏳ Blocked |
|
||
| B.3 | **Fund CCIP with LINK** | Top up LINK and gas on 138 + each destination → run `./scripts/deployment/fund-ccip-bridges-with-link.sh` (dry-run first) | Insufficient LINK or gas per lane | ⏳ Blocked (dry-run ✅ 2026-03-06) |
|
||
|
||
---
|
||
|
||
## 2. Same-chain swap & API (routing A2–A3)
|
||
|
||
| # | Step | Action | Status |
|
||
|---|------|--------|--------|
|
||
| A2 | Token-aggregation indexes DODO | Ensure CHAIN_138_DODO_PMM_INTEGRATION is set in token-aggregation env; indexer running so `GET /api/v1/quote` returns DODO quotes. | ✅ Config set (smom-dbis-138/.env); build ✅; run service with env for quotes |
|
||
| A3 | Expose token-aggregation API | Proxy `/api/v1/*` (e.g. explorer.d-bis.org) to token-aggregation, or set GATSBY_SNAP_API_BASE_URL for Snap. Public explorer proxy is now live on `https://explorer.d-bis.org/api/v1/*` and verified with `check-public-report-api.sh`, the Snap API verifier, and GRU preflight on 2026-04-04. | ✅ Live |
|
||
|
||
---
|
||
|
||
## 3. Swap–bridge–swap (C3–C8)
|
||
|
||
| # | Step | Action | Status |
|
||
|---|------|--------|--------|
|
||
| C3 | Bridge quote API | Set BRIDGE_REGISTRY_ADDRESS; optional ENHANCED_SWAP_ROUTER_ADDRESS, DESTINATION_RPC_URL so `POST /api/bridge/quote` returns sourceSwapQuote + destinationSwapQuote. | ⏳ Pending |
|
||
| C4 | Destination DEX for quotes | Wire QuoteService to destination-chain DEX or aggregator API per chain. | ⏳ Pending |
|
||
| C5 | (Optional) SwapBridgeSwapCoordinator | Deploy for one-tx swap → bridge → swap. | ⏳ Optional |
|
||
| C6–C8 | Bridge UI + full-path quote + E2E test | Wire UI to routes/token-mapping; add “Get full path quote” and run E2E test. | ⏳ Pending |
|
||
|
||
---
|
||
|
||
## 4. Phase C — cW* and edge pools
|
||
|
||
| # | Step | Action | Status |
|
||
|---|------|--------|--------|
|
||
| C.1 | cW* token mesh on tracked public EVM chains | [PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK](../03-deployment/PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK.md); keep `deployment-status.json` and `.env` aligned. The currently loaded mesh now includes Celo; only Wemix remains outside the loaded set. | ✅ Done for the currently loaded 10-chain public EVM mesh |
|
||
| C.1a | Mainnet cW corridor scale-readiness gate | Treat `138 cUSDC -> cWUSDC` and `138 cUSDT -> cWUSDT` as canary-proven, not bulk-proven. Re-run 1-token canaries, use `./scripts/deployment/run-cw-remaining-steps.sh --verify` to confirm both `cWUSDC` and `cWUSDT` bridge roles, verify Mainnet `processed(messageId)` on `CW_BRIDGE_MAINNET`, and publish a live config/ABI check for `CW_L1_BRIDGE_CHAIN138` before multi-million sends. | ⏳ Pending |
|
||
| C.2 | Create and fund PMM edge pools | cW*/USDC, cW*/USDT per pool-matrix; populate deployment-status.json. For the live AUSDT corridor, this specifically means deciding and seeding the `cWAUSDT` hub pools on BSC, Polygon, Avalanche, and Celo; Mainnet `cWAUSDT` is still outside the live set. | ⏳ Pending |
|
||
| C.3 | (Optional) Stabilization bot | cross-chain-pmm-lps peg bands. | ⏳ Optional |
|
||
|
||
---
|
||
|
||
## 5. LINK relay & config
|
||
|
||
| # | Step | Action | Status |
|
||
|---|------|--------|--------|
|
||
| V5 | LINK support on Mainnet relay | [RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK](../07-ccip/RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK.md) — Option A or B; set relaySupported for LINK in token-mapping. | ⏳ Pending |
|
||
| B4 | Routing registry + token-mapping | When adding Cronos/Wemix, update config/routing-registry.json and config/token-mapping-multichain.json; run validate-config-files.sh. | ✅ validate-config ✅; update when B.1/B.2 done |
|
||
| B5 | Wemix token addresses | Confirm WETH, USDT, USDC on scan.wemix.com; update token-mapping and WEMIX_TOKEN_VERIFICATION.md. | ⏳ Pending |
|
||
|
||
---
|
||
|
||
## 6. Optional / when needed
|
||
|
||
| # | Step | Action | Status |
|
||
|---|------|--------|--------|
|
||
| E1 | Deployer gas on other chains | `./scripts/deployment/deployer-gas-auto-route.sh` (or --dry-run). | ✅ Script + dry-run verified 2026-03-06 |
|
||
| E2 | CRO / WEMIX manual acquisition | `./scripts/deployment/acquire-cro-and-wemix-gas.sh` for aggregator links. | ✅ Script + config (cro-wemix-swap-routes.json) ready |
|
||
| A4 | Router-v2 venue layer on 138 | Live. Keep `bash scripts/verify/check-chain138-pilot-dex-venues.sh` green after funding, planner, or publication changes. | ✅ Live |
|
||
| A5 | N-hop pathfinding | Add to token-aggregation if needed. | ⏳ Optional |
|
||
| Phase D | XAU, vaults, trustless stack | [PHASE_D_OPTIONAL_CHECKLIST](../03-deployment/PHASE_D_OPTIONAL_CHECKLIST.md). | ⏳ Optional |
|
||
|
||
---
|
||
|
||
## 7. External / third-party
|
||
|
||
| # | Step | Ref |
|
||
|---|------|-----|
|
||
| V6 | Ledger, Trust Wallet, CoinGecko/CMC, on-ramps | ADD_CHAIN138_TO_LEDGER_LIVE, ADD_CHAIN138_TO_TRUST_WALLET, CMC_COINGECKO_SUBMISSION_RUNBOOK. |
|
||
|
||
---
|
||
|
||
## Quick commands
|
||
|
||
| Task | Command |
|
||
|------|---------|
|
||
| Deployer balance (138) | `RPC_URL_138=http://192.168.11.211:8545 ./scripts/deployment/check-deployer-balance-chain138-and-funding-plan.sh` |
|
||
| PMM pool balances | `./scripts/verify/check-pmm-pool-balances-chain138.sh` |
|
||
| Mint + add liquidity (more) | `cd smom-dbis-138 && ./scripts/mint-for-liquidity.sh --add-liquidity` |
|
||
| Cronos bridges (after CRO) | `cd smom-dbis-138 && ./scripts/deployment/deploy-bridges-config-ready-chains.sh cronos` then `./scripts/deployment/complete-config-ready-chains.sh` |
|
||
| Fund CCIP LINK | `./scripts/deployment/fund-ccip-bridges-with-link.sh` |
|
||
| Validate config | `./scripts/validation/validate-config-files.sh` |
|
||
| Completable from anywhere | `./scripts/run-completable-tasks-from-anywhere.sh` |
|
||
| Operator (LAN) | `./scripts/run-all-operator-tasks-from-lan.sh [--skip-backup]` |
|