Files
proxmox/docs/06-besu/NODE_LIST_RECONCILIATION_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- 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>
2026-02-12 15:46:57 -08:00

2.7 KiB

Node List Reconciliation - Complete

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


Date: 2025-01-18
Status: RECONCILIATION COMPLETE


Analysis Results

Current State (Before Fix)

File Contents: 15 enodes

  • Valid: 7 (validators 100-104, RPC 2101, 2401)
  • Old/Migrated: 8 (221, 232-238 from old migration)
  • Missing: 15 expected nodes not present

Issues Identified

  1. Old/Migrated Nodes (8 entries):

    • 192.168.11.221 (old 2201)
    • 192.168.11.232-238 (old 2301, 2303-2308)
    • Status: These VMIDs don't exist - removed from migration
  2. Missing Nodes (15 entries):

    • Sentries: 1500-1503 (4 nodes)
    • RPC: 2400, 2402, 2500-2508 (11 nodes - some may be stopped)

Actions Taken

Step 1: Removed Old/Migrated Entries

Filtered out enodes with IPs from non-existent VMIDs:

  • Removed 192.168.11.221 (old 2201)
  • Removed 192.168.11.232-238 (old 2301, 2303-2308)

Result: Cleaned file contains only valid current nodes.

Step 2: Kept Valid Entries

Kept enodes for current valid nodes:

  • Validators: 100-104 (5 nodes)
  • RPC: 2101, 2401 (2 nodes)

Step 3: Synchronized Files

Updated:

  • static-nodes.json - Cleaned and updated
  • permissioned-nodes.json - Synchronized with static-nodes.json

Final File Status

static-nodes.json

Contents: 7 enodes (all valid)

Included:

  • 5 Validator nodes (100-104)
  • 2 RPC nodes (2101, 2401)

Removed:

  • 8 old/migrated entries (221, 232-238)

Missing (expected but not present - will need enodes when nodes are running):

  • ⏸️ 4 Sentry nodes (1500-1503)
  • ⏸️ 11 RPC nodes (2400, 2402, 2500-2508 - some stopped)

permissioned-nodes.json

Status: Synchronized - Identical to static-nodes.json


Reconciliation Summary

Removed: 8 old/migrated entries
Kept: 7 valid current entries
Cleaned: No duplicates, no errors
Synchronized: Both files match

Result: Clean, accurate node list with only current valid entries that match actual VMID configuration.


Next Steps (Optional)

To complete the node list with all expected nodes:

  1. Collect Sentry Enodes (when running):

    ./scripts/besu/collect-all-node-enodes.sh
    
  2. Collect RPC Enodes (from running nodes):

    • Query nodes via admin_nodeInfo RPC
    • Add enodes to both files
  3. Add Stopped Nodes (when started):

    • Collect enodes when nodes come online
    • Update both files

Status: FILES RECONCILED, CLEANED, AND SYNCHRONIZED

Current node list is accurate and consistent with actual VMID configuration.