From 2b9e1790c7882efb80e8c5fb839d92cf1c4eaf3c Mon Sep 17 00:00:00 2001 From: "Ankita Virani (ankita.eth)" <139675749+codebyankita@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:03:23 +0700 Subject: [PATCH] docs: clarify that V5Bootnodes should reference Execution Layer nodes only The previous comment in bootnodes.go implied that the hardcoded discv5 bootnodes were Consensus Layer (CL) nodes. This caused confusion since Geth is an Execution Layer (EL) client and should not reference CL bootnodes (e.g., Teku, Prysm, Lighthouse, Nimbus). This change updates the documentation comment above V5Bootnodes to clearly state: - These bootnodes are used for Execution Layer peer discovery only. - Consensus Layer bootnodes should not be hardcoded here. - The list should only contain EL bootnodes in enr:// or enode:// format. This improves clarity for developers and contributors reviewing or updating the node discovery configuration in the future. --- params/bootnodes.go | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/params/bootnodes.go b/params/bootnodes.go index 28e3395540..41103ef672 100644 --- a/params/bootnodes.go +++ b/params/bootnodes.go @@ -56,6 +56,15 @@ var SepoliaBootnodes = []string{ "enode://9e9492e2e8836114cc75f5b929784f4f46c324ad01daf87d956f98b3b6c5fcba95524d6e5cf9861dc96a2c8a171ea7105bb554a197455058de185fa870970c7c@138.68.123.152:30303", // sepolia-bootnode-1-ams3 } + +// V5Bootnodes lists discv5 bootnodes for the Ethereum Execution Layer (EL). +// These nodes are used by Geth for peer discovery on the EL network only. +// Do NOT include Consensus Layer (CL) bootnodes (e.g., Teku, Prysm, Lighthouse, Nimbus). +// Execution Layer (EL) clients such as Geth use `enode://` or `enr:` addresses +// for discovering other EL peers. Consensus Layer (CL) bootnodes are unrelated +// and should not be hardcoded here. CL nodes are used by beacon chain clients +// for validator and consensus communications. + var V5Bootnodes = []string{ // Teku team's bootnode "enr:-KG4QMOEswP62yzDjSwWS4YEjtTZ5PO6r65CPqYBkgTTkrpaedQ8uEUo1uMALtJIvb2w_WWEVmg5yt1UAuK1ftxUU7QDhGV0aDKQu6TalgMAAAD__________4JpZIJ2NIJpcIQEnfA2iXNlY3AyNTZrMaEDfol8oLr6XJ7FsdAYE7lpJhKMls4G_v6qQOGKJUWGb_uDdGNwgiMog3VkcIIjKA", // # 4.157.240.54 | azure-us-east-virginia