proxmox/docs/06-besu/NODE_LIST_RECONCILIATION_COMPLETE.md

# 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):
   ```bash
   ./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.**