proxmox/docs/06-besu/MASTER_INDEX.md

Besu Documentation Index

Last Updated: 2026-04-25
Document Version: 2.0
Status: Active Documentation — canonical entry point for Chain 138 Besu topology, configuration, audit, and runtime-health references.

This directory index replaces an older integration-deliverables placeholder that was too easy to mistake for live Besu guidance.

Start Here

Need	Canonical source
Live Besu fleet topology, host placement, class policy, and generated-config coverage	BESU_NODE_CONFIGURATION_MAP_20260424.md
VMID/IP/FQDN inventory for the same fleet	../04-configuration/ALL_VMIDS_ENDPOINTS.md
RPC endpoints, domains, and public/private role split	../04-configuration/RPC_ENDPOINTS_MASTER.md
Proxmox host model, peering summary, and deployment gates	../03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md
Machine-readable host and fleet template	../../config/proxmox-operational-template.json

Live Audit And Health

Need	Tool
Cluster-wide canonical Besu inventory	bash scripts/verify/check-cluster-besu-inventory.sh --json
Template vs live Proxmox audit	bash scripts/verify/audit-proxmox-operational-template.sh
Besu enode/IP validation	bash scripts/verify/verify-besu-enodes-and-ips.sh
Blockchain health and validator activity	bash scripts/monitoring/monitor-blockchain-health.sh

Configuration Sources

Need	Source
Base class templates	smom-dbis-138/config/*.toml
Promoted per-node generated configs	config/generated-node-configs/
Static nodes and permissioning	config/besu-node-lists/

Guardrails

• Treat BESU_NODE_CONFIGURATION_MAP_20260424.md as the human-readable Besu root.
• Treat generated per-node TOMLs in config/generated-node-configs/ as closer to runtime truth than generic class placeholders.
• Treat historical migration notes and destroyed-node references in older docs as audit context only, not current deployment input.
• Do not reuse base templates with placeholder p2p-host="0.0.0.0" as production advertised-host configs without per-node substitution.