Note the mempool policy requirements of zero-fee commitment channels
What the developer wrote
Authored by Leo Nash
Note the mempool policy requirements of zero-fee commitment channels
What changed, and why it matters
This commit only adds a documentation comment explaining that a new type of Lightning channel (zero-fee commitment channels) needs specific Bitcoin network relay support to work properly during force-closes. No code behavior changed, so there is no security vulnerability in the patch itself.
No security action required. Treat as a normal documentation update.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff is a pure documentation addition in lightning/src/util/config.rs on the negotiate_anchors_zero_fee_htlc_tx field. It notes that zero-fee commitment channel force-close transactions require relay of TRUC (BIP 431), P2A outputs, and Ephemeral Dust, currently only supported by Bitcoin Core v29+. There are no logic, API, or cryptographic changes.
Changed components
lightning/src/util/config.rs documentationInspect captured patch +5 / −0
diff --git a/lightning/src/util/config.rs b/lightning/src/util/config.rs
index 500c0b7..dd1aaa4 100644
--- a/lightning/src/util/config.rs
+++ b/lightning/src/util/config.rs
@@ -213,6 +213,11 @@ pub struct ChannelHandshakeConfig {
/// back to a `anchors_zero_fee_htlc` (if [`Self::negotiate_anchors_zero_fee_htlc_tx`]
/// is set) or `static_remote_key` channel.
///
+ /// For a force-close transaction to reach miners and get confirmed,
+ /// zero-fee commitment channels require a path from your Bitcoin node to miners that
+ /// relays TRUC transactions (BIP 431), P2A outputs, and Ephemeral Dust. Currently, only
+ /// nodes running Bitcoin Core v29 and above relay transactions with these features.
+ ///
/// Default value: `false` (This value is likely to change to `true` in the future.)
///
/// [TRUC]: (https://bitcoinops.org/en/topics/version-3-transaction-relay/)
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.