fbda1b4beb
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
3.8 KiB
Validation Review — Running Nodes vs Docs/Config
Date: 2026-02-08
Purpose: Review for inconsistencies, errors, and incorrect information; validate against running nodes.
1. Validators (1000–1004) — Verified
| Check | Result |
|---|---|
| Hosts | r630-01 (192.168.11.11): 1000, 1001, 1002. ml110 (192.168.11.10): 1003, 1004. ✓ |
| Config path | /etc/besu/config-validator.toml (or /config/config-validator.toml) ✓ |
| permissions-nodes-config-file | /var/lib/besu/permissions/permissions-nodes.toml on all five ✓ |
| File present | permissions-nodes.toml exists in /var/lib/besu/permissions/ on all ✓ |
| static-nodes-file | /var/lib/besu/static-nodes.json ✓ |
Conclusion: Validator permissioning and paths match docs and fix runbook. No errors.
2. Container Inventory (sample)
r630-01 (192.168.11.11): 1000, 1001, 1002 (validators); 1500, 1501, 1502 (sentries); 2101 (besu-rpc-core-1); 2500–2505 (besu-rpc-alltra-1/2/3, besu-rpc-hybx-1/2/3; 2506–2508 destroyed 2026-02-08); Blockscout, NPMplus, DBIS, etc.
ml110 (192.168.11.10): 1003, 1004 (validators); 1503, 1504, 1505–1508 (sentries); 2102 (besu-rpc-core-2); 2301, 2304–2308 (RPC); 2400, 2402, 2403 (ThirdWeb RPC).
2201 (besu-rpc-public-1) is on r630-02 (192.168.11.12) per verify-backend-vms.sh.
3. VMID → IP Inconsistencies Found and Fixed
| Issue | Was | Corrected |
|---|---|---|
| 2500–2502 in BESU_NODES_FILE_REFERENCE | 192.168.11.250–.252, "Core/Perm/Public RPC" | 2500–2502 are ALLTRA RPC at .172–.174 (per NPMPLUS_ALLTRA_HYBX_MASTER_PLAN). Production Chain 138 RPC is 2101→.211, 2201→.221, 2301→.232. |
| Diagram in BESU_NODES_FILE_REFERENCE | RPC layer showed .250, .251, .252 | Updated to "Production RPC: 2101 .211 (core), 2201 .221 (public), 2301 .232 (private)". |
| permissions-nodes.toml comment | "Add .212 (2102) when enodes available" | .212 is already in list. Comment updated to "Add .154 (1504) when enode available". |
4. Source of Truth Summary
| Item | Source of truth |
|---|---|
| IPs / RPC endpoints | config/ip-addresses.conf |
| Node allowlist | config/besu-node-lists/permissions-nodes.toml (TOML; Besu does not use .json for this) |
| Static peers | config/besu-node-lists/static-nodes.json |
| Validators 1000–1002 | r630-01 (192.168.11.11) |
| Validators 1003–1004 | ml110 (192.168.11.10) |
| Production Chain 138 RPC (admin/deploy) | 2101 at 192.168.11.211 (RPC_CORE_1) |
5. Remaining Doc Caveats (no change made)
- Archive docs (e.g. VMID_IP_MAPPING_SYSTEM, BESU_SETUP_COMPLETE) use old IPs or VMID→IP; left as historical.
- RPC_ENDPOINTS_MASTER (and legacy CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE in archive) reference 2501/2502 at .251/.252 in some sections; production public/private are 2201 (.221) and 2301 (.232). Use CLOUDFLARE_ROUTING_MASTER.md and RPC_ENDPOINTS_MASTER for current routing.
- 1504 (192.168.11.154) is not yet in
permissions-nodes.toml/static-nodes.json; comment in repo says add when enode is available.
6. Commands Used to Validate
# List running containers
ssh root@192.168.11.11 "pct list | awk 'NR==1 || \$2==\"running\" {print}'"
ssh root@192.168.11.10 "pct list | awk 'NR==1 || \$2==\"running\" {print}'"
# Validator config and permissions dir
ssh root@192.168.11.11 "pct exec 1000 -- grep -E 'permissions-nodes|static-nodes' /etc/besu/config-validator.toml; pct exec 1000 -- ls -la /var/lib/besu/permissions/"
Summary: Validator config and permissioning match the runbook and running nodes. BESU_NODES_FILE_REFERENCE was updated so 2500–2502 are ALLTRA at .172–.174 and production Chain 138 RPC (2101, 2201, 2301) is clearly the reference for scripts and config.