Files
proxmox/docs/00-meta/NEXT_STEPS_LIST.md
defiQUG 0d29343941 chore: update .env.master.example with new deployment scripts and treasury manager parameters; enhance AGENTS.md with GRU reference primacy details
- 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
2026-04-12 18:20:41 -07:00

97 lines
8.3 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.
# 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/C3C8, 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 A2A3)
| # | 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. Swapbridgeswap (C3C8)
| # | 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 |
| C6C8 | 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]` |