sample-lnd.conf: document neutrino header import options
What the developer wrote
Authored by Olaoluwa Osuntokun
sample-lnd.conf: document neutrino header import options
Add commented examples for the new neutrino.blockheaderssource and
neutrino.filterheaderssource options, showing both URL-based import
from block-dn.org and local file path usage.
What changed, and why it matters
This commit only updates the example configuration file (sample-lnd.conf) with documentation comments. It adds explanations and commented-out examples for two existing Neutrino options that let users import Bitcoin block and filter headers from a URL or local file to speed up initial synchronization. No code behavior is changed, and the options themselves are not new in this commit.
No security action needed. This is a documentation update. If reviewing the related feature, ensure header import sources are validated and fetched over HTTPS where applicable, but that is outside the scope of this commit.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff is a documentation-only change to sample-lnd.conf. It updates a user-agent version comment and adds a comment block describing neutrino.blockheaderssource and neutrino.filterheaderssource, including examples using https://block-dn.org and local file paths. There are no functional code changes, no default value changes, and no logic modifications.
Changed components
sample-lnd.confInspect captured patch +20 / −1
diff --git a/sample-lnd.conf b/sample-lnd.conf
index 933f76a..c4c9592 100644
--- a/sample-lnd.conf
+++ b/sample-lnd.conf
@@ -902,7 +902,7 @@
; neutrino.useragentname=neutrino
; Used to help identify ourselves to other bitcoin peers.
-; neutrino.useragentversion=0.16.2
+; neutrino.useragentversion=0.17.1
; The amount of time to wait before giving up on a transaction broadcast attempt.
; Default:
@@ -921,6 +921,25 @@
; Neutrino is used.
; neutrino.validatechannels=false
+; Headers import for fast initial sync. When configured, neutrino imports block
+; and filter headers from the specified sources before falling back to P2P sync.
+; Both block and filter header sources must be specified together. Sources can
+; be local file paths or HTTP(S) URLs.
+;
+; For mainnet, the block-dn.org service provides pre-built header files.
+; The end_block parameter must be divisible by 100,000 and should be the highest
+; such value below the current chain tip.
+; Default:
+; neutrino.blockheaderssource=
+; Default:
+; neutrino.filterheaderssource=
+; URL example:
+; neutrino.blockheaderssource=https://block-dn.org/headers/import/900000
+; neutrino.filterheaderssource=https://block-dn.org/filter-headers/import/900000
+; File path example:
+; neutrino.blockheaderssource=/path/to/block_headers.bin
+; neutrino.filterheaderssource=/path/to/filter_headers.bin
+
[autopilot]
; If the autopilot agent should be active or not. The autopilot agent will
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.