docs: add release notes for v1 taproot funding script fix
What the developer wrote
Authored by Elle Mouton
docs: add release notes for v1 taproot funding script fix
What changed, and why it matters
This commit only adds release notes describing a prior bug fix. The underlying issue was that private Taproot channels stored in an older format were incorrectly rebuilt as legacy multi-signature addresses when LND restarted. This could cause LND to watch for the wrong transaction type, potentially missing on-chain events for those channels. The commit itself does not change any code, only documentation.
Review the actual code fix in PR #10672 to confirm the bug is fully addressed. Users relying on private Taproot channels should upgrade to the release containing the fix and monitor channels for correct on-chain detection after restart.
Security signals we found
Incorrect script reconstruction for Taproot channels
Chain watch filter may miss relevant on-chain transactions
Private Taproot channels affected since introduction
Read-path bug triggered on restart
Evidence from the diff
The diff adds a release note entry for PR #10672. The described bug affected FundingPKScript when handling v1 gossip channel edges that carried the taproot staging feature bit. On read paths such as ChannelView, which reconstructs the chain watch filter at startup, the funding script was being regenerated as a legacy P2WSH multisig instead of a Taproot script. The commit is documentation-only; the actual fix is in a separate code change not supplied here.
Changed components
docs/release-notes/release-notes-0.21.0.mdFundingPKScriptChannelViewchain watch filter reconstructionprivate Taproot channelsInspect captured patch +8 / −0
diff --git a/docs/release-notes/release-notes-0.21.0.md b/docs/release-notes/release-notes-0.21.0.md
index cb5fa1a..64b1975 100644
--- a/docs/release-notes/release-notes-0.21.0.md
+++ b/docs/release-notes/release-notes-0.21.0.md
@@ -61,6 +61,14 @@
these valid no-reply pings instead of disconnecting peers, restoring
compatibility with implementations that pad `channel_reestablish` messages
with them.
+
+* [Fixed `FundingPKScript` to honor the taproot feature bit on v1 channel
+ edges](https://github.com/lightningnetwork/lnd/pull/10672). Private taproot
+ channels stored as v1 gossip objects with the taproot staging feature bit
+ were having their funding scripts incorrectly reconstructed as legacy P2WSH
+ multisig. This affected read paths such as `ChannelView`, which rebuilds
+ the chain watch filter on restart. This was a pre-existing bug since
+ private taproot channels were first introduced.
# New Features
Why this scored 58/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.