proxmox/docs/00-meta/NEXT_STEPS_FOR_YOU.md

Your next steps — one place

Last Updated: 2026-03-02
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 (next steps run): run-completable-tasks-from-anywhere.sh — config OK, on-chain 38/38, validation OK, reconcile-env. preflight-chain138-deploy.sh — passed. run-all-next-steps-chain138.sh — preflight passed; TransactionMirror and cUSDT/cUSDC pool already present; all 12 c* already GRU-registered; verification 38/38. validate-config-files.sh — passed. run-e2e-flow-tasks-full-parallel.sh --dry-run — waves E0–E7 listed.

Continue and complete (2026-02-27): Re-ran run-completable-tasks-from-anywhere.sh — all 4 steps passed (config, on-chain 38/38, validation, reconcile-env). Re-ran run-all-operator-tasks-from-lan.sh --skip-backup — dotenv loaded automatically; Blockscout verification completed (W0-1 NPMplus failed off-LAN as expected). Docs: REMAINING_SUMMARY "Continue and complete" section added; TODOS_CONSOLIDATED and NEXT_STEPS_FOR_YOU updated for operator script loading dotenv.

Completed 2026-03-02: Documentation consolidation: MASTER_INDEX.md, README.md, RUNBOOKS_MASTER_INDEX.md created; deprecated content (ALL_IMPROVEMENTS_AND_GAPS_INDEX) marked redirect-only. run-completable-tasks-from-anywhere.sh run: config OK, on-chain 38/38, validation OK, reconcile-env. Preflight and run-all-next-steps-chain138.sh run: preflight passed; mirror/pool already deployed; all 12 c* already registered as GRU; verification 38/38. Next steps index and TODOS_CONSOLIDATED updated.

Completed 2026-02-27: Chain 138 "run all next steps" script added: ./scripts/deployment/run-all-next-steps-chain138.sh (preflight → mirror+pool → register c* as GRU → verify). Docs updated: NEXT_STEPS_INDEX, DEPLOYMENT_ORDER_OF_OPERATIONS, TODOS_CONSOLIDATED, CONTRACT_NEXT_STEPS_LIST.

Completed 2026-03-01: Recommended next steps: run-completable-tasks-from-anywhere.sh (config OK, on-chain 38/38, validation OK, reconcile-env). Progress indicators added (Step 1/4–4/4). E2E flow tasks script: ./scripts/run-e2e-flow-tasks-full-parallel.sh [--dry-run] [--wave E1]. CONTRACT_ADDRESSES_REFERENCE and RECOMMENDATIONS_OPERATOR_CHECKLIST updated to use ADDRESS_MATRIX_AND_STATUS for correlated address matrix.

Completed 2026-02-23: Optional and next steps: run-completable-tasks-from-anywhere.sh run (config OK, on-chain 36/36, run-all-validation --skip-genesis OK, reconcile-env). Shellcheck with --optional now non-fatal (CI and validate pass). Validate via Proxmox SSH: bash scripts/run-via-proxmox-ssh.sh validate [--host IP] runs full shellcheck + genesis validation; jq/shellcheck installed on host when missing. TODOS_CONSOLIDATED and OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST updated.

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
Chain 138 next steps (all in one)	./scripts/deployment/run-all-next-steps-chain138.sh — preflight → mirror+pool (or --skip-mirror) → register c* as GRU → verify. Use --dry-run; set TRANSACTION_MIRROR_ADDRESS if mirror exists. See TRANSACTION_MIRROR_CHAIN138_COLLISION_FIX if CreateCollision.
E2E flows (full parallel)	./scripts/run-e2e-flow-tasks-full-parallel.sh [--dry-run] [--wave E1] — run E2E flow tasks by wave; see TASKS_TO_INCREASE_ALL_E2E_FLOWS.
On-chain address list (no RPC)	./scripts/verify/check-contracts-on-chain-138.sh --dry-run — lists addresses only (no RPC)
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 (reports findings, does not fail); use without --optional to fail on any finding
Validate via Proxmox SSH	bash scripts/run-via-proxmox-ssh.sh validate [--host 192.168.11.10] — full shellcheck + genesis validation on host; installs jq/shellcheck if missing
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)	All done or documented — see REQUIRED_FIXES_UPDATES_GAPS §4 (canonical addresses, AlltraAdapter setBridgeFee, smart accounts env, quote FABRIC_CHAIN_ID, .bak BAK_FILES_DEPRECATION).
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 --verbose to see output; see MAINTENANCE_SCRIPTS_REVIEW.md.
• Lighter option: ./scripts/maintenance/address-all-remaining-502s.sh — backends + NPMplus proxy (if NPM_PASSWORD in .env) + RPC diagnostics; add --run-besu-fix --e2e to fix Besu config and re-run E2E.
• Full runbook: 502_DEEP_DIVE_ROOT_CAUSES_AND_FIXES.md.

Single script (from repo root on LAN; loads dotenv automatically from .env and 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:

  ./scripts/run-all-operator-tasks-from-lan.sh --skip-backup
  

  (Script loads dotenv from .env and smom-dbis-138/.env automatically.) Or run only verify: ./scripts/verify/run-contract-verification-with-proxy.sh after sourcing .env. Or 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_138
  

  Use --dry-run to 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.