bea1903ac9
Co-authored-by: Cursor <cursoragent@cursor.com>
7.6 KiB
Your next steps — one place
Last Updated: 2026-02-20
Purpose: Single list of what you need to do next (no infra/automation). Everything else the repo can do has been completed or documented.
Completed 2026-02-20: Documentation consolidation and root cleanup (NEXT_STEPS_INDEX, DOCUMENTATION_CONSOLIDATION_PLAN; 00-meta Batch 4+5 archived; root status/temp files → docs/archive/root-cleanup-20260220; fix-wsl-ip.sh → scripts/). run-completable-tasks-from-anywhere.sh run: config validation OK, on-chain 45/45, run-all-validation --skip-genesis OK, reconcile-env --print.
Completed 2026-02-12: run-completable-tasks-from-anywhere.sh run successfully (config validation, on-chain check 36/36, validation, reconcile-env). app-ethereum README updated with BOLOS_SDK note. See REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md § Completed in this pass.
Completed 2026-02-13: Token mapping (138↔Mainnet): config/token-mapping.json, relay config, TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md, runbook for LINK support, CI validation. When adding tokens, update token-mapping.json and optionally CHAIN138_TOKEN_ADDRESSES.
Completed 2026-02-16: run-completable-tasks passed; config validation OK; on-chain check 46/49; forge test (smom-dbis-138) passed; token lists updated (cronos, avalanche, arbitrum, canonical-tokens); COMPLETION_RUN_20260216.md.
1. Submit Ledger Live request — ✅ Done
The Ledger Live integration request for Chain 138 (Defi Oracle Meta Mainnet) has been submitted (Tally form). Await Ledger’s response and follow their process (agreement + integration steps).
Full guide: docs/04-configuration/ADD_CHAIN138_TO_LEDGER_LIVE.md
2. Steps you can complete now (no LAN/VPN needed)
These can be run from your current machine (dev, WSL, CI) without Proxmox or Ledger.
| Step | Command / action |
|---|---|
| Run all “from anywhere” checks | ./scripts/run-completable-tasks-from-anywhere.sh — config validation, on-chain check (SKIP_EXIT=1 if RPC unreachable), run-all-validation --skip-genesis, reconcile-env --print |
| On-chain address list (no RPC) | ./scripts/verify/check-contracts-on-chain-138.sh --dry-run — lists 36 addresses only |
| Config validation | ./scripts/validation/validate-config-files.sh or ... --dry-run (print only) |
| Bridge deploy dry-run | ./scripts/deploy-and-configure-weth9-bridge-chain138.sh --dry-run (no keys/network) |
| Shellcheck (optional) | bash scripts/verify/run-shellcheck.sh --optional — lint scripts; use without --optional to fix issues if shellcheck installed |
| CCIP checklist (dry) | bash scripts/ccip/ccip-deploy-checklist.sh — validates env and prints deploy order (no deploy) |
| Tests | cd smom-dbis-138 && forge test (e2e/integration subset if full suite slow); cd alltra-lifi-settlement && forge test && npm run test:e2e -- --forceExit |
| Quick wins (code) | Add progress indicators to scripts; add --dry-run to scripts that lack it; extend config validation (see IMPLEMENTATION_CHECKLIST) |
| Placeholders (code) | canonical addresses in token-aggregation; AlltraAdapter fee (AlltraAdapter.sol); smart accounts kit placeholders; quote service Fabric chainId 999; .bak deprecation — see REQUIRED_FIXES_UPDATES_GAPS |
| API keys | Sign up at URLs in reports/API_KEYS_REQUIRED.md; add any new keys to .env |
Reference: REMAINING_WORK_DETAILED_STEPS.md § “Can Be Accomplished Now”.
3. When you have LAN/VPN and secrets (SSH to Proxmox + .env)
Full list: STEPS_FROM_PROXMOX_OR_LAN_WITH_SECRETS.md — contract deploy, Blockscout verify, backup, VM/container creation, bridge ops, security, tests.
Fix E2E 502s (from LAN): If public domains (dbis-admin, secure, dbis-api, RPC endpoints) return 502, run from a host on the same LAN as NPMplus and Proxmox:
- Recommended (all-in-one):
./scripts/maintenance/run-all-maintenance-via-proxmox-ssh.sh --e2e— makes RPC CTs writable, fixes 2101 JNA, installs Besu on 2500–2505, runs address-all-502s, then E2E. Use--verboseto see output; see MAINTENANCE_SCRIPTS_REVIEW.md. - Lighter option:
./scripts/maintenance/address-all-remaining-502s.sh— backends + NPMplus proxy (ifNPM_PASSWORDin .env) + RPC diagnostics; add--run-besu-fix --e2eto fix Besu config and re-run E2E. - Full runbook: 502_DEEP_DIVE_ROOT_CAUSES_AND_FIXES.md.
Single script (from repo root on LAN with smom-dbis-138/.env):
./scripts/run-all-operator-tasks-from-lan.sh --dry-run— print steps./scripts/run-all-operator-tasks-from-lan.sh— backup + Blockscout verify./scripts/run-all-operator-tasks-from-lan.sh --deploy— + deploy contracts (phased + TransactionMirror if needed)./scripts/run-all-operator-tasks-from-lan.sh --create-vms— + create DBIS Core 6 containers on Proxmox./scripts/run-all-operator-tasks-from-lan.sh --deploy --create-vms— all of the above
VM creation (capacity/HA): PROXMOX_VM_CREATION_RUNBOOK.md.
4. When you have LAN only (optional, no deploy)
-
Blockscout verification: From a host that can reach Blockscout (e.g. LAN), run:
source smom-dbis-138/.env 2>/dev/null; ./scripts/verify/run-contract-verification-with-proxy.shOr verify each contract manually at https://explorer.d-bis.org/address/
#verify-contract. -
On-chain contract check: Re-run when you add new contracts (or to confirm from LAN):
./scripts/verify/check-contracts-on-chain-138.sh # uses RPC_URL_138Use
--dry-runto list addresses only (no RPC):
./scripts/verify/check-contracts-on-chain-138.sh --dry-run
5. Everything else
- Full list — remaining components, tasks, and all recommendations: REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md — wallets, Ledger gaps, contracts/operator, MetaMask/CoinGecko, code placeholders, and recommendations to implement.
- Recommendations operator checklist (R1–R24): RECOMMENDATIONS_OPERATOR_CHECKLIST.md — verification, security, deployment, runbooks, testing, config; use when deploying or operating.
- Breakdown with answers: REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md — for each remaining item: what it is, prerequisites, who does it, exact steps to complete, and where to update when done.
- Contract / deployment next steps: CONTRACT_NEXT_STEPS_LIST — operator items and optional tasks.
- Master next steps (phases, waves, TODOs): NEXT_STEPS_MASTER.md.
- Ledger issues and workarounds: LEDGER_CHAIN138_ISSUES_AND_WORKAROUNDS.md.
Summary: Ledger form submitted ✅. §2 lists steps you can complete now (no LAN). §3 is the full set when you have SSH to Proxmox and .env (deploy, verify, backup, create VMs). §4–5 are optional or when you have LAN only / everything else.