<!-- HISTORICAL: This document is a historical audit and is kept for reference only. -->
# VMID Reference Audit Report

**Generated**: $(date)  
**New VMID Allocation**: Sovereign-scale mapping (1000-8999)  
**Previous Allocation**: Various (106-117, 1100-4700)

## New VMID Mapping

| Category | Old Range | New Range | Count | Notes |
|----------|-----------|-----------|-------|-------|
| **Besu Validators** | 106-110, 1100-1104 | 1000-1004 | 5 | Initial, 1000-1499 available (500 VMIDs) |
| **Besu Sentries** | 111-114, 1110-1113 | 1500-1503 | 4 | Initial, 1500-2499 available (1000 VMIDs) |
| **Besu RPC** | 115-117, 1120-1122 | 2500-2502 | 3 | Initial, 2500-3499 available (1000 VMIDs) |
| **Besu Archive/Telemetry** | - | 3500+ | - | 3500-4299 (800 VMIDs) |
| **Besu Reserved** | - | 4300+ | - | 4300-4999 (700 VMIDs) |
| **Blockscout** | 2000, 250 | 5000 | 1 | 5000-5099 available (100 VMIDs) |
| **Cacti** | 2400, 261 | 5200 | 1 | 5200-5299 available (100 VMIDs) |
| **Chainlink CCIP** | 3200 | 5400+ | 1+ | 5400-5599 available (200 VMIDs) |
| **Fabric** | 4500, 262 | 6000 | 1 | 6000-6099 available (100 VMIDs) |
| **Firefly** | 4700, 260 | 6200 | 1 | 6200-6299 available (100 VMIDs) |
| **Indy** | 8000, 263 | 8000 | 1 | 8000-8999 available (1000 VMIDs) |

## Files Requiring Updates

### Critical Scripts (Must Update)

1. **Configuration Files**
   - `smom-dbis-138-proxmox/config/proxmox.conf` ✅ Updated
   - `smom-dbis-138-proxmox/config/network.conf` ⚠️ Check for IP mappings

2. **Deployment Scripts**
   - `smom-dbis-138-proxmox/scripts/deployment/deploy-besu-nodes.sh`
   - `smom-dbis-138-proxmox/scripts/deployment/deploy-validated-set.sh`
   - `smom-dbis-138-proxmox/scripts/copy-besu-config.sh`
   - `smom-dbis-138-proxmox/scripts/copy-besu-config-with-nodes.sh`

3. **Network Scripts**
   - `smom-dbis-138-proxmox/scripts/network/bootstrap-network.sh`
   - `smom-dbis-138-proxmox/scripts/network/update-static-nodes.sh`

4. **Validation Scripts**
   - `smom-dbis-138-proxmox/scripts/validation/validate-deployment-comprehensive.sh`
   - `smom-dbis-138-proxmox/scripts/validation/validate-validator-set.sh`

5. **Utility Scripts**
   - `scripts/besu_balances_106_117.js` (rename to besu_balances.js)
   - `scripts/fix-enodes-final.py`
   - `scripts/fix-enode-config.py`
   - `scripts/besu-deploy-allowlist.sh`
   - `scripts/besu-verify-peers.sh`

### Documentation Files (Update Examples)

1. **Action Plans**
   - `ACTION_PLAN_NOW.md`
   - `docs/NEXT_STEPS_COMPLETE.md`
   - `docs/NEXT_STEPS_COMPREHENSIVE.md`

2. **Reference Documentation**
   - `docs/BESU_NODES_FILE_REFERENCE.md`
   - `docs/VALIDATED_SET_QUICK_REFERENCE.md`
   - `docs/VMID_ALLOCATION.md`
   - `docs/BESU_SETUP_COMPLETE.md`

3. **Deployment Guides**
   - `docs/VALIDATED_SET_DEPLOYMENT_GUIDE.md`
   - `docs/RUN_DEPLOYMENT.md`

4. **Troubleshooting**
   - `docs/TROUBLESHOOTING_FAQ.md`

5. **Quick Reference Cards**
   - `QUICK_START_VALIDATED_SET.md`
   - `NEXT_STEPS_QUICK_REFERENCE.md`

### Monitoring Scripts

1. `scripts/monitoring/simple-alert.sh`
2. `scripts/monitoring/setup-health-check-cron.sh`
3. `scripts/monitoring/prometheus-besu-config.yml`

### Management Scripts

1. `scripts/secure-validator-keys.sh`
2. `scripts/backup/backup-configs.sh`
3. `scripts/manage/snapshot-before-change.sh`
4. `scripts/manage/deploy-multi-node.sh`
5. `scripts/manage/expand-storage.sh`
6. `scripts/manage/migrate-container.sh`

## Update Priority

### Priority 1 (Critical - Must Update Before Deployment)
- Configuration files
- Deployment scripts
- Network/bootstrap scripts
- Validation scripts

### Priority 2 (High - Update Before Testing)
- Utility scripts
- Monitoring scripts
- Management scripts

### Priority 3 (Medium - Update Documentation)
- All documentation files
- Quick reference cards
- Troubleshooting guides

## Quick Update Commands

### Find All References
```bash
cd /home/intlc/projects/proxmox
grep -r "\b\(106\|107\|108\|109\|110\|111\|112\|113\|114\|115\|116\|117\|1100\|1110\|1120\|1130\|1140\|2000\|2400\|3200\|4500\|4700\)\b" \
    --include="*.sh" --include="*.js" --include="*.py" --include="*.md" \
    smom-dbis-138-proxmox/ scripts/ docs/ | grep -v ".git"
```

### Update Pattern Mapping

| Old Pattern | New Pattern | Notes |
|------------|-------------|-------|
| `106-110` | `1000-1004` | Validators |
| `111-114` | `1500-1503` | Sentries |
| `115-117` | `2500-2502` | RPC |
| `1100-1104` | `1000-1004` | Validators (if already updated) |
| `1110-1113` | `1500-1503` | Sentries (if already updated) |
| `1120-1122` | `2500-2502` | RPC (if already updated) |
| `2000` | `5000` | Blockscout |
| `2400` | `5200` | Cacti |
| `3200` | `5400` | CCIP |
| `4500` | `6000` | Fabric |
| `4700` | `6200` | Firefly |

## Next Steps

1. ✅ Update `config/proxmox.conf` with new ranges
2. ⏳ Update all deployment scripts
3. ⏳ Update all utility scripts
4. ⏳ Update all documentation
5. ⏳ Test configuration loading
6. ⏳ Run dry-run deployment
7. ⏳ Execute deployment

