d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4eead3e53fecdb2b7e629bb9f56b22ff92c61d2e
proxmox/docs/00-meta/ALL_TASKS_INCLUDING_OPTIONAL.md
defiQUG 3f76bc9507
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
docs: update master documentation and push to Gitea (2026-03-06) 
- MASTER_INDEX: Last Updated 2026-03-06; status 59/59 contracts; add NEXT_STEPS_LIST, CONTRACT_NEXT_STEPS_LIST
- docs/README, NEXT_STEPS_INDEX, 06-besu/MASTER_INDEX: Last Updated 2026-03-06
- Contract check script: 59 addresses (PMM, vault/reserve, CompliantFiatTokens); canonical CCIP/router
- New docs: EXECUTION_CHECKLIST, NEXT_STEPS_LIST, DOTENV_AUDIT, ADDITIONAL_PATHS, deployer gas runbook, WEMIX_ACQUISITION_TABLED, etc.
- Config: deployer-gas-routes, cro-wemix-swap-routes, routing-registry, token-mapping
- Scripts: check-contracts-on-chain-138, check-pmm-pool-balances-chain138, deployer-gas-auto-route, acquire-cro-and-wemix-gas
- Operator rule: operator-lan-access-check.mdc

Made-with: Cursor
2026-03-06 19:11:25 -08:00

336 lines
16 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.
# All Tasks to Complete (Including Optional)
**Last Updated:** 2026-03-06
**Purpose:** Single list of every task (required and optional) from TODOS_CONSOLIDATED, REQUIRED_FIXES_GAPS_AND_DEPLOYMENTS_LIST, ADDITIONAL_RECOMMENDATIONS_TABLE, REMAINING_DEPLOYMENTS, and E2E flow docs.
**Quick run (from anywhere):** `./scripts/run-completable-tasks-from-anywhere.sh`
**Operator (LAN):** `./scripts/run-all-operator-tasks-from-lan.sh [--deploy]`
---
## 1. Verified remaining (blocking / high impact)
| # | Task | Status | Notes |
|---|------|--------|--------|
| V1 | Token-aggregation build | ✅ Done | Re-verified 2026-03-06. |
| V2 | **Add liquidity (Chain 138 PMM)** | ⏳ Blocked | Deployer WETH/cUSDT/cUSDC = 0. Mint/fund per TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER, then AddLiquidityPMMPoolsChain138. |
| V3 | RPC 2101 read-only | ⚠️ If needed | Run make-rpc-vmids-writable + health-check only when host I/O errors occur. |
| V4 | Wemix / Gnosis / Celo / Cronos CCIP | 🔄 Partial | Celo + Gnosis done. Wemix tabled (need 0.4 WEMIX). Cronos: set CRONOS_RPC, run deploy-bridges cronos. |
| V5 | LINK relay, E2E 502s, operator run | 🔄 Partial | E2E 502s ✅; Operator run ✅. LINK support runbook ⏳ Pending. |
| V6 | External (Ledger, Trust, CoinGecko/CMC, on-ramps) | ⏳ Pending | Third-party submissions. |
---
## 2. Pre-deploy (before any Chain 138 deploy)
| # | Task | Command / doc |
|---|------|----------------|
| 0a | Check deployer gas (Chain 138) | `RPC_URL_138=http://192.168.11.211:8545 ./scripts/deployment/check-deployer-balance-chain138-and-funding-plan.sh` |
| 0a2 | Deployer gas auto-route (optional) | `./scripts/deployment/deployer-gas-auto-route.sh`; acquire CRO/WEMIX: `./scripts/deployment/acquire-cro-and-wemix-gas.sh` |
| 0b | Core RPC = IP:port in smom-dbis-138/.env | `RPC_URL_138=http://192.168.11.211:8545` (not FQDN). |
| 0c | Test all contracts before deploy | `./scripts/deployment/test-all-contracts-before-deploy.sh` (or `--no-match "Fork|Mainnet|Integration|e2e"`) |
| 0 | Preflight (RPC, dotenv, nonce) | `./scripts/deployment/preflight-chain138-deploy.sh [--cost]` |
---
## 3. High priority
| # | Task | Ref |
|---|------|-----|
| 1 | Wemix (1111) token addresses: confirm WETH, USDT, USDC on scan.wemix.com; update token-mapping and WEMIX_TOKEN_VERIFICATION.md | validate-config-files.sh |
| 2 | Gnosis, Cronos, Celo, Wemix CCIP bridges: per chain set RPC, CCIP Router, LINK, WETH9/WETH10; DeployWETHBridges; add 138↔chain; fund LINK | CONFIG_READY_CHAINS_COMPLETION_RUNBOOK |
---
## 4. Medium priority
| # | Task | Ref |
|---|------|-----|
| 3 | LINK support on Mainnet relay (Option A or B); implement, deploy, fund LINK; set relaySupported for LINK | RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK |
| 4 | Run "from anywhere" checks periodically | `./scripts/run-completable-tasks-from-anywhere.sh` |
| 5 | Placeholders (code): canonical addresses, AlltraAdapter setBridgeFee, smart accounts kit, quote FABRIC_CHAIN_ID, .bak | REQUIRED_FIXES_UPDATES_GAPS |
| 6 | API keys: sign up per reports/API_KEYS_REQUIRED.md; add to .env | reports/API_KEYS_REQUIRED.md |
---
## 5. When you have LAN / Proxmox + secrets
| # | Task | Command / doc |
|---|------|----------------|
| 7 | Blockscout verification | `./scripts/run-all-operator-tasks-from-lan.sh` or `./scripts/verify/run-contract-verification-with-proxy.sh` |
| 8 | Fix E2E 502s (if recur) | `./scripts/maintenance/address-all-remaining-502s.sh [--e2e]` |
| 9 | Operator tasks script (backup, verify, deploy) | `./scripts/run-all-operator-tasks-from-lan.sh [--deploy] [--create-vms]` |
| 10 | sendCrossChain (real) | `bash scripts/bridge/run-send-cross-chain.sh 0.01` (PRIVATE_KEY + LINK ready) |
| 11 | NPMplus backup | `bash scripts/verify/backup-npmplus.sh` (NPM_PASSWORD in .env) |
| 12 | Mint tokens to deployer for liquidity/bridges | TOKENS_AND_NETWORKS_MINTABLE_TO_DEPLOYER |
| — | NPMplus API unreachable | `./scripts/maintenance/fix-npmplus-services-via-proxmox-ssh.sh` |
| — | E2E from LAN (no DNS) | E2E_DNS_FROM_LAN_RUNBOOK; `E2E_USE_SYSTEM_RESOLVER=1 ./scripts/verify/verify-end-to-end-routing.sh` |
---
## 6. Phase A — Hub liquidity (Chain 138)
| Step | Task | Ref |
|------|------|-----|
| A.1 | Mint cUSDT and cUSDC to deployer | `cd smom-dbis-138 && ./scripts/mint-for-liquidity.sh` |
| A.2 | Add liquidity to PMM pools (cUSDT/cUSDC first) | ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK; `mint-for-liquidity.sh --add-liquidity` |
| A.3 | **(Optional)** Mint other c* (cEURC, cEURT, cGBP*, etc.) for future pools | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §1 |
---
## 7. Phase B — Bridge coverage (all 13 chains)
| Step | Task | Ref |
|------|------|-----|
| B.1 | Celo (42220): CCIP bridges deployed ✅; ensure destinations + LINK funded | complete-config-ready-chains.sh |
| B.2a | **Cronos (25):** Fund deployer ~15 CRO; set CRONOS_RPC, CCIP_ROUTER_CRONOS; deploy bridges; complete-config | acquire-cro-and-wemix-gas.sh; deploy-bridges-config-ready-chains.sh cronos |
| B.2b | **Wemix (1111):** Fund deployer ~0.4 WEMIX (manual/aggregator); deploy bridges; complete-config | WEMIX_ACQUISITION_TABLED; deploy-bridges-config-ready-chains.sh wemix |
| B.3 | Fund all CCIP bridges with LINK | `./scripts/deployment/fund-ccip-bridges-with-link.sh` |
| B.4 | **(Optional)** LINK support on Mainnet relay | RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK |
---
## 8. Phase C — Public-chain cW* and edge pools
| Step | Task | Ref |
|------|------|-----|
| C.1 | Deploy or bridge cW* tokens per chain (1, 56, 137, 10, 42161, 8453, 43114, 100, 25, 42220, 1111) | PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK |
| C.2 | Create and fund PMM edge pools (cW*/USDC, cW*/USDT) per pool-matrix | PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK |
| C.3 | **(Optional)** Stabilization bot / peg bands for cW* | cross-chain-pmm-lps |
---
## 9. Phase D — Optional (extended coverage)
| Step | Task | Ref |
|------|------|-----|
| D.1 | XAU token + XAU-anchored pools (138) | PHASE_D_OPTIONAL_CHECKLIST |
| D.2 | Vault ac* / vdc* / sdc* for new base tokens | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §5 |
| D.3 | ALL Mainnet: ACADT/ACADC when Alltra adds CAD; D-WIN W on 138/651940 | PHASE_D_OPTIONAL_CHECKLIST |
| D.4 | Mainnet trustless stack: LiquidityPoolETH, InboxETH, BondManager | OPTIONAL_DEPLOYMENTS_START_HERE §C |
---
## 10. Token deployments (remaining)
| # | Task | Ref |
|---|------|-----|
| T1 | DeployCompliantFiatTokens (cEURC, cEURT, cGBP*, etc.) | ✅ Done 2026-02-27 |
| T2 | **(Optional)** cCADT: uncomment in DeployCompliantFiatTokens.s.sol | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §1.2 |
| T3 | cAUSDT: deploy or env when Alltra compliant USD defined | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §1.3 |
| T4 | ACADT (651940) when Alltra adds CAD token | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §2 |
| T5 | cW* on public chains + PMM edge pools per pool-matrix | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §3 |
| T6 | **(Optional)** D-WIN W on 138/651940 | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §4 |
| T7 | Vault ac*/vdc*/sdc* for new base tokens (after DeployCompliantFiatTokens) | TOKEN_CONTRACT_DEPLOYMENTS_REMAINING §5 |
---
## 11. Low priority / planned
| # | Task | Ref |
|---|------|-----|
| 12 | AddressMapper on other chains (DeployAddressMapperOtherChain; set mapper in smart-contracts-master) | OPTIONAL_DEPLOYMENTS_START_HERE §A |
| 13 | DODO PMM liquidity on 138: add liquidity and document (pools already deployed) | ADD_LIQUIDITY_PMM_CHAIN138_RUNBOOK |
| 14 | Mainnet trustless stack: Lockbox138 + InboxETH, BondManager, LiquidityPoolETH; fund liquidity | OPTIONAL_DEPLOYMENTS_START_HERE §C |
---
## 12. External / third-party
| # | Task | Doc |
|---|------|-----|
| 15 | Ledger: await Tally response; sign agreement and integrate | ADD_CHAIN138_TO_LEDGER_LIVE |
| 16 | Trust Wallet: open PR to trustwallet/wallet-core with Chain 138 | ADD_CHAIN138_TO_TRUST_WALLET |
| 17 | Consensys: outreach for Swaps/Bridge | CONSENSYS_OUTREACH_PACKAGE |
| 18 | CoinGecko/CMC: submit Chain 138 and tokens | CMC_COINGECKO_SUBMISSION_RUNBOOK |
| — | Chainlist / on-ramps | pr-ready/README; REPOSITORIES_AND_PRS_CHAIN138 |
---
## 13. Tezos / Etherlink (when scoped)
| # | Task | Ref |
|---|------|-----|
| 19 | Verify Etherlink (42793) on CCIP; record selector/Router/fee or "custom relay only" | TEZOS_CCIP_REMAINING_ITEMS |
| 20 | Verify Jumper and LiFi for 138, 651940, 42793, Tezos; update support matrix | TEZOS_CCIP_REMAINING_ITEMS |
| 21 | InitializeRegistry, DeployAllAdapters; Etherlink receiver; Tezos L1 and Etherlink relay services | TEZOS_CCIP_REMAINING_ITEMS |
---
## 14. Deployment / infrastructure phases (optional)
| Phase | Tasks | Status |
|-------|--------|--------|
| Phase 1 — VLAN | UDM Pro VLAN; VLAN-aware bridge; migrate services to VLANs | ⏳ Pending |
| Phase 2 — Observability | Monitoring stack; Grafana via Cloudflare Access; alerts | ⏳ Pending |
| Phase 3 — CCIP fleet | CCIP Ops/Admin; commit/execute/RMN nodes; NAT pools | ⏳ Pending |
| Phase 4 — Sovereign tenants | Sovereign VLANs; tenant isolation; access control | ⏳ Pending |
---
## 15. Security & codebase
| # | Task | Ref |
|---|------|-----|
| 22 | Security audits: smom VLT-024, ISO-024; bridge BRG-VLT, BRG-ISO | TODO_TASK_LIST_MASTER §5 |
| 23 | dbis_core: ~1186 TS errors (deferred) | TODO_TASK_LIST_MASTER §8 |
| 24 | **(Optional)** Paymaster when sources ready | SMART_ACCOUNTS_DEPLOYMENT_NOTE |
---
## 16. E2E flow waves (TASKS_TO_INCREASE_ALL_E2E_FLOWS)
| Wave | Tasks | Run |
|------|--------|-----|
| E0 | X1, X6, X7, A1 — RPC writable, TransactionMirror, deployer funded, Core RPC | Op |
| E1 | A2, A3, A4 — PMM pools create, register, add liquidity (138) | run-pmm-full-parity Phase 1 |
| E2 | B1, B2 — CCIP config and fund bridges | complete-config-ready-chains.sh; fund-ccip-bridges-with-link.sh |
| E3 | A5, B4, B5, C3, X8 — token-aggregation env, bridge routes, token mapping, quote API, token list | Code/Op |
| E4 | X2, X3, X4, X5 — Blockscout verify, E2E routing, explorer E2E, token-aggregation health | Op/LAN |
| E5 | X10, X11, X12 — cUSDT/cUSDC and PMM on L2s; token-aggregation new chains | run-pmm-full-parity Phase 2 |
| E6 | B6, B7, C5, C6, C7 — Bridge UI, test bridge, destination DEX, full path quote UI, E2E test | Code/Op |
| E7 | X13, X14 — Update PMM_DEX_ROUTING_STATUS; runbooks | Doc |
Script: `./scripts/run-e2e-flow-tasks-full-parallel.sh [--dry-run]`
---
## 17. Flow A (swap on 138) — individual tasks
| # | Task | Type |
|---|------|------|
| A1 | Core RPC writable and reachable | Op |
| A2 | Verify or create three PMM pools on 138 | Op/Auto |
| A3 | Register pools with DODOPMMProvider | Op |
| A4 | Add liquidity to all three PMM pools | Op |
| A5 | Token-aggregation indexes DODO on 138 | Op/Code |
| A6 | Expose token-aggregation API for dApps/Snap | Op |
| A7 | **(Optional)** Deploy EnhancedSwapRouter on 138 | Op |
| A8 | **(Optional)** N-hop quote/pathfinding in token-aggregation | Code |
---
## 18. Flow B (bridge) — individual tasks
| # | Task | Type |
|---|------|------|
| B1 | CCIP bridges on 138 configured and funded | Op |
| B2 | Bridge destination config (138 ↔ Gnosis/Cronos/Celo/Wemix) | Op |
| B3 | Relay (138→Mainnet) operational if using relay path | Op |
| B4 | Token-aggregation GET /api/v1/bridge/routes returns Chain 138 bridges | Code/Op |
| B5 | Token mapping API for 138↔destination | Code/Op |
| B6 | Frontend: wire Bridge UI to routes + token mapping | Code |
| B7 | Test 138→dest and dest→138 with small amounts | Op |
---
## 19. Flow C (swap–bridge–swap) — individual tasks
| # | Task | Type |
|---|------|------|
| C1 | Complete Flow A (liquidity and quote on 138) | — |
| C2 | Complete Flow B (bridge configured and funded) | — |
| C3 | POST /api/bridge/quote returns sourceSwapQuote and destinationSwapQuote | Code/Op |
| C4 | **(Optional)** Deploy SwapBridgeSwapCoordinator on-chain | Op |
| C5 | Destination-chain DEX/aggregator for destinationSwapQuote | Code/Op |
| C6 | Frontend: "Get full path quote" and execute | Code |
| C7 | E2E test: swap 138 → bridge → swap destination | Op/Auto |
---
## 20. Cross-cutting (X1–X14)
| # | Task | Type |
|---|------|------|
| X1 | RPC 2101 writable and healthy | Op |
| X2 | On-chain contract verification (Blockscout) | Op |
| X3 | E2E routing (DNS + HTTPS + RPC) | Auto |
| X4 | Explorer E2E (homepage, API, SPA) | Auto |
| X5 | Token-aggregation health and DB | Op |
| X6 | TransactionMirror deployed and funded | Op |
| X7 | Deployer funded (138 and dest chains) | Op |
| X8 | Token list updated and validated | Code/Op |
| X10–X14 | L2 pools, bridge UI, runbooks | Op/Code/Doc |
---
## 21. Operator checklist (R1–R24)
- R1: Verify every deployed contract on Blockscout after each deployment
- R2: Keep CONTRACT_ADDRESSES_REFERENCE and ADDRESS_MATRIX_AND_STATUS updated
- R3: Run check-contracts-on-chain-138.sh; fix MISSING/EMPTY
- R4: Use canonical CCIPWETH9Bridge; do not use deprecated
- R5: Never commit .env or private keys; rotate if exposed
- R6–R7: API keys in .env; restrict deployer and RPC admin
- R8–R9: Set RPC_URL_138; use GAS_PRICE on Chain 138
- R10–R11: Phased core deploy order; manage nonce if tx stuck
- R12–R15: Keep runbooks in sync; document addresses; single deploy→verify script
- R16–R19: Env per environment; monitor bridge/oracle; Blockscout up; run forge test before deploy
- R20–R24: NatSpec on public functions; NPMplus order; document blocks; progress/dry-run/validation; token-mapping single source
**Full list:** RECOMMENDATIONS_OPERATOR_CHECKLIST.md
---
## 22. Proxmox / code quality / doc (recommendations 1–91)
- **Proxmox 1–35:** .env permissions, validator keys, SSH key-only, firewall 8006, VLANs, metrics, backup, runbooks, retry/timeout, logging, CI/CD, progress indicators, config validation, etc.
- **Code 36–43:** Shebang, set -euo pipefail, script header, shellcheck, shfmt, shared lib.
- **Doc 44–47, 68–74:** Consolidation, accuracy, quick reference, decision trees, glossary.
- **Security 48–52:** Secret audit, input validation, RBAC.
- **Config/testing 53–67:** Config templates, env standardization, test coverage, CI tests, health.
- **Infrastructure 75–81:** VLAN, observability, CCIP fleet, sovereign tenants, Besu containers.
- **Codebase 82–91:** Security audits, dbis_core TS, canonical env, AlltraAdapter, smart accounts, .bak.
**Ref:** ADDITIONAL_RECOMMENDATIONS_TABLE §10–16; 10-best-practices/RECOMMENDATIONS_AND_SUGGESTIONS.
---
## 23. Maintenance (ongoing)
| Task | Frequency |
|------|-----------|
| Monitor explorer sync / RPC health (e.g. VMID 2201) | Daily |
| Check config API uptime | Weekly |
| Review explorer logs | Weekly |
| Update token list | As needed |
| Fix E2E 502s when domains 502 | As needed — address-all-remaining-502s.sh |
Cron: `schedule-daily-weekly-cron.sh --install`; NPMplus: `schedule-npmplus-backup-cron.sh --install`.
---
## 24. Required fixes (if blocking)
| Item | Action |
|------|--------|
| RPC 2101 read-only | make-rpc-vmids-writable-via-ssh.sh then health-check-rpc-2101.sh |
| Stuck transactions / nonce | clear-all-transaction-pools.sh; wait ~60s; use GAS_PRICE_138 if needed |
| Token-aggregation build | ✅ Fixed 2026-03-03 |
---
## 25. Gaps (config / env / ops)
- Core RPC = IP:port in smom-dbis-138/.env
- Deployer gas (138): ≥ ~0.006 ETH (recommended 1–2 ETH)
- Env: PRIVATE_KEY, RPC_URL_138; for PMM: DODO_PMM_INTEGRATION_ADDRESS, pool addresses
- POOL_MANAGER_ROLE on DODOPMMIntegration
- TRANSACTION_MIRROR_ADDRESS after deploy
- Wemix token addresses; canonical CUSDC/CUSDT in env; CCIPWETH9Bridge canonical only
- Token-aggregation DB: create DB, migrations, DATABASE_URL, restart
- Nginx proxy order (VMID 5000): location /api/v1/ before /api/
**Ref:** REQUIRED_FIXES_GAPS_AND_DEPLOYMENTS_LIST §2.
---
## References
- [TODOS_CONSOLIDATED.md](TODOS_CONSOLIDATED.md) — main checklist
- [OPERATOR_READY_CHECKLIST.md](OPERATOR_READY_CHECKLIST.md) — copy-paste commands
- [REQUIRED_FIXES_GAPS_AND_DEPLOYMENTS_LIST.md](REQUIRED_FIXES_GAPS_AND_DEPLOYMENTS_LIST.md) — fixes and gaps
- [ADDITIONAL_RECOMMENDATIONS_TABLE.md](ADDITIONAL_RECOMMENDATIONS_TABLE.md) — full recommendations
- [REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md](../03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md) — Phases A–D
- [TASKS_TO_INCREASE_ALL_E2E_FLOWS.md](TASKS_TO_INCREASE_ALL_E2E_FLOWS.md) — E2E waves and flows A/B/C
Reference in New Issue View Git Blame Copy Permalink