Files
proxmox/docs/06-besu/NODE_LIST_RECONCILIATION_COMPLETE.md
defiQUG dbd517b279 Sync workspace: config, docs, scripts, CI, operator rules, and submodule pointers.
- Update dbis_core, cross-chain-pmm-lps, explorer-monorepo, metamask-integration, pr-workspace/chains
- Omit embedded publish git dirs and empty placeholders from index

Made-with: Cursor
2026-04-12 06:12:20 -07:00

2.9 KiB

Node List Reconciliation - Complete

Historical note: This file preserves a point-in-time reconciliation completion record. It includes migration-era RPC references and should not be used as the live fleet map.

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.