Every captured commit receives deterministic security triage and a separate communication-quality score. Security candidates and broader second-pass signals receive full-patch Ollama analysis.
Message quality measures whether a commit identifies its scope, purpose, rationale, testing, and supporting references. It does not change the security-severity score.
This commit rewrites how a Lightning wallet talks to Esplora block-explorer servers so that many status checks happen in parallel instead of one at a time. It is a performance/refactoring change. There is no direct evidence in the commit t…
Concurrency/timing change in transaction confirmation logicNew inconsistency check preserved when a previously-confirmed tx is reported unconfirmedAdded defensive error path for missing pre-fetched block status
This change stops the Electrum-based transaction sync client from downloading the very transaction that created an output it is watching. Previously, the client could request that transaction from Electrum, even though a transaction can ne…
Avoids unnecessary Electrum transaction.get requests for watched outputsReduces information disclosure to Electrum server about watched outpointsAdds regression test verifying request suppression
This change improves how the Lightning Dev Kit's Electrum and Esplora transaction-sync clients track watched Bitcoin transactions. Previously, the code ignored the script pubkey (the 'address' associated with a transaction) supplied when r…
Previously ignored `script_pubkey` argument in `register_tx` for transaction watchersElectrum script-history queries previously used an arbitrary transaction output, which could be OP_RETURN and therefore unindexed by some Electrum serversNew logic prefers caller-supplied script pubkey and falls back to non-OP_RETURN outputs
This commit changes how LDK stores pending event notifications. It adds serialization support for several event types that previously were not fully saved to disk, and introduces a helper method so the code can decide which events are wort…
Data-loss prevention: previously non-round-trippable event variants are now fully serialized, avoiding accidental event loss when users serialize Event queues themselvesState-consistency hardening: ChannelManager now explicitly skips events that describe non-surviving restart state, preventing replay of stale eventsDefensive assertion: debug builds assert that every persisted event round-trips to Some(event), catching serialization mismatches
This commit only adds documentation comments to two source files. It explains that certain funding-signing events can become stale if the underlying negotiation fails, and that callers may see specific harmless errors as a result. No code …
This commit removes a fixed-version pin for the honggfuzz fuzzing tool in a continuous-integration script. The project now uses the current release of honggfuzz instead of an older pinned version. There is no change to the actual Lightning…
This commit changes the Rust toolchain used in the continuous integration (CI) fuzzing job from a fixed older version (1.75) to the latest stable release. It is purely a build/test infrastructure change to fix a dependency compatibility is…
This commit makes a previously internal helper function public so that outside developers can build dummy-hop tails for blinded payment paths without recreating the logic themselves. It is an API usability change, not a fix for a known sec…
No security-relevant behavior change in the diffAPI visibility broadened from crate-public to publicCLTV expiry overflow check already present and unchanged
This change adds a safety check in a Bitcoin Lightning Network library (LDK). Previously, if the software tried to verify a peer's commitment signature before it had learned the peer's channel parameters, it could crash with a panic. Now i…
Defensive check added on peer-driven code path to prevent panicMissing counterparty_parameters could previously cause panic during commitment transaction constructionChannel closure returned instead of panic
This commit only changes the wording of an error message sent to peers when a commitment transaction fails validation. It replaces the vague phrase 'Failed to validate our commitment' with the clearer 'Received commitment failed validation…
This commit moves the checks that validate a counterparty's signatures on the holder's commitment and HTLC transactions out of the general channel code and into the signer module (InMemorySigner). Previously, these signature checks were do…
Moved signature validation from channel state machine into signer moduleAdded new tests that corrupt signatures and verify rejectionChanged error message from 'Invalid commitment tx signature from peer' / 'Invalid funding_created signature from peer' to 'Failed to validate our commitment'
This change fixes a Lightning channel splicing bug: when two peers temporarily disconnect during a splice, any half-finished signature the other side already sent is now discarded. Before the fix, that stale signature could be reused after…
State-invalidation bug in multi-step protocol (splice negotiation)Stale cryptographic signature not cleared on disconnectPotential reuse of old commitment state after reconnect
This fix prevents a Lightning channel from being accidentally force-closed. During a splice (a way to resize a payment channel), one side's initial signature could be kept in memory after the peers disconnected. If the peers later reconnec…
State inconsistency: in-memory buffered message not cleared on disconnectDuplicate message processing after reconnectionForce-close consequence for active Lightning channel
This commit is a simple rename of a public function from `matches_invoice_signing_pubkey` to `key_can_sign_invoice`, plus matching updates to its documentation, callers, tests, and changelog. No behavior changed. It is not a security fix.
This commit is a simple rename of a function and its documentation from matches_invoice_signing_pubkey to key_can_sign_invoice. No logic, behavior, or security properties changed. It is a follow-up code-review naming cleanup.
This commit adds a new public helper method, Offer::matches_invoice_signed_by (later renamed matches_invoice_signing_pubkey), that lets callers check whether an invoice signing key belongs to the recipient named by a BOLT 12 offer. It also…
Refactors existing BOLT 12 invoice-signing-pubkey validation into a reusable helperAdds public API to bind an invoice signing key to an offer recipientAdds unit tests for issuer-id vs. path-last-hop matching behavior
This commit is a feature enhancement for LDK's internal serialization macros. It allows developers to mark old protocol fields as 'retired' (reserved but no longer used) in more places, so those type numbers cannot be accidentally reused. …
TLV type-number reservation mechanism extended to more macro-generated code pathsPrevents accidental reuse of retired protocol field type numbersAvoids UnknownRequiredFeature decode failures for obsolete even-type fields
This commit is a test-only cleanup in the Lightning Dev Kit (LDK) Rust codebase. It removes low-level byte-level tests for splice failure events and replaces them with a single cross-version test that actually loads a 0.2 node with seriali…
Cross-version serialization compatibility test addedRemoval of byte-level tests that could not detect real 0.2 mismatchesNo production code changes
This commit only adds a code comment explaining an existing quirk: if a revoked old channel transaction contains two identical-looking payment forwards and the other side claims both, the software may only claim one upstream while letting …
Behavioral quirk in revoked-commitment HTLC resolution documentedDuplicate (payment_hash, amount) HTLCs can map to the same upstream sourcePotential missed upstream preimage claim on second identical HTLC
This commit fixes a state-handling bug in Lightning Dev Kit's splicing feature. When a user tries to speed up or replace a pending splice (an 'RBF' attempt) and the older splice transaction unexpectedly gets confirmed on-chain, the softwar…
State-conflict handling between confirmed splice candidate and active RBF negotiationStructured abort propagation through chain-event pathConditional abort based on holder signature progress to avoid unsafe cancellation
Expand any commit for its author, full message, clarity score, changed files, triage signals, analysis, and source link.
Lower-priorityCorrect + update scoring attempts right at the maximum amountsby Matt Corallo · a6964ab9 · Jul 24, 2026 · 1 fileMessage 73 · AdequateInformational 16Details
Commit message · Matt Corallo
Correct + update scoring attempts right at the maximum amounts
While sending a payment at exactly a channel's max or the liquidity upper bound we've calculated is unlikely to work, we shouldn't consider it impossible. Here we fix a few cases where we previously did so.
This isn't really fixing anything, as we only shift the boundary by 1 msat, but it makes the next commit more logical.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 16/100
This commit tweaks how the Lightning payment router estimates whether a payment can fit through a channel. Previously, sending an amount exactly equal to a channel's maximum capacity or estimated liquidity upper bound was treated as impossible (maximum penalty). Now it is treated as merely very unlikely (a large but finite penalty), shifting the boundary by 1 millisatoshi. The commit message explicitly says this is not really fixing anything, just making the next commit more logical. There is no indication this is a security fix or that it can be exploited.
Handle missing splice tx_signatures on reestablish
When reconnecting after one side has received `tx_signatures` for a splice but the peer has not, `channel_reestablish` may need to recover two different pieces of state: the missing `tx_signatures` and a later commitment update generated after quiescence ended locally.
Previously the lost-remote-commitment path discarded any `tx_signatures` prepared while processing the peer's `next_funding` TLV, as we assumed that if a `tx_signatures` is owed, then no pending updates must exist. That left the peer awaiting splice signatures and still treating the channel as quiescent, so the subsequent HTLC commitment update was rejected as a normal update while quiescent.
This was incorrect as the fuzzer highlighted that a new update can be made after the `tx_signatures` exchange (while the counterparty has yet to process the responding `tx_signatures`) and both messages need to be retransmistted after a reconnect.
We fix this by carrying `tx_signatures` through that reestablish branch and making the `tx_signatures/commitment_update` order explicit. Initial splice funding retransmission remains commitment_signed-before-tx_signatures, while post-splice reconnect recovery sends tx_signatures before normal commitment updates so the peer can exit quiescence first.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
signing boundaryfuzzing or regression evidencesigning or wallet path
AI analysis · Moderate 60/100
This commit fixes a bug in LDK's Lightning channel reconnection logic after a splice (a way to resize a channel's on-chain funds). If one peer had already received the splice signatures but the other had not, and then they disconnected and reconnected, the recovering peer could drop its own splice signatures while trying to resend a later commitment update. That left the counterparty still waiting for splice signatures and still treating the channel as 'frozen' (quiescent), so it would reject the normal commitment update. The fix ensures both the missing splice signatures and any later commitment update are retransmitted in the correct order after reconnect.
Preserve the MPP-enabled default for invoice-request response builders so existing OffersMessageFlow callers retain their prior behavior.
Allow callers with single-path requirements to explicitly remove the advertised MPP feature before signing. This controls feature advertisement only; receive-side enforcement remains the caller's responsibility.
Co-Authored-By: HAL 9000
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
signing boundary
AI analysis · Informational 19/100
This commit adds a new option for Lightning invoice creators to explicitly tell payers not to use multi-path payments (MPP) when paying an invoice. It does not change any enforcement rules; it only changes what feature bits are advertised in the invoice. The existing default behavior (MPP allowed) is preserved for current callers.
channelmanager: upgrade best_block_updated log from trace to info
50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 15/100
This commit simply changes one diagnostic log message from the lowest detail level ('trace') to a more visible level ('info'). It does not alter program behavior, fix a bug, or change any security-sensitive logic. It is a routine observability improvement with no security relevance.
AI review queuedChange assign-reviewer authorized integration token to a bot acctby Matt Corallo · f734d1eb · Jul 20, 2026 · 1 fileMessage 81 · StrongInformational 15Details
Commit message · Matt Corallo
Change assign-reviewer authorized integration token to a bot acct
I didn't realize using my own authorized integration token would result in every assignment being listed as coming from me, which is weird so here we swap it for a bot.
Fixes #4804
81/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
Why it was queued
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Informational 15/100
This commit swaps the ID number used by an automated workflow that randomly assigns code reviewers. The old number pointed to a real person's account, so the workflow's assignments appeared to come from that person. The new number points to a dedicated bot account. There is no security vulnerability here—just a cosmetic/accounting cleanup in project automation.
Increase the base and historical-liquidity penalties fivefold. This applies to both the fixed and payment-size parts, so their balance stays the same. The router will now pay more to avoid longer routes and routes the scorer considers less likely to work.
I tested this using the graph and scorer pulled from my ldk-server. The scorer was kept unchanged during the test. Codex randomly assigned 600 different high-degree nodes to the old or new settings, with 300 probes per setting. The test was balanced across 100 rounds and used amounts of 1,000, 10,000, and 30,000 sats. Only one probe ran at a time.
The old settings reached 167/300 targets (55.7%) within 10 seconds. The 5x settings reached 214/300 (71.3%), an improvement of 15.7 percentage points. Results were 69% vs 82% at 1,000 sats, 47% vs 72% at 10,000 sats, and 51% vs 60% at 30,000 sats.
Across the 587 targets where both settings found a route, the quoted fee rose by 2.4 sats on average. These probes used one node and did not settle, so they do not guarantee payment success elsewhere.
90/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode✓ Mentions testing or verification
AI analysis · Informational 21/100
This commit changes default numerical tuning knobs in the Lightning Dev Kit's payment router. It makes the router prefer shorter, more reliable payment paths by increasing several penalty values fivefold. The change is presented as a performance improvement (better routing success rates in tests), not as a security fix. There is no evidence in the commit of a vulnerability, exploit, or security incident.
Pending outbound HTLC details do not identify which payment or inbound HTLC produced them. A payment hash cannot provide that mapping when multiple parts of a multipart payment share both a hash and route.
Expose an optional source enum containing the payment ID for locally initiated HTLCs, the inbound HTLC for normal forwards, or all inbound HTLCs aggregated by a trampoline forward. Derive it from the existing HTLC source for committed and holding-cell HTLCs.
Serialize the source as an optional upgradable TLV so older data remains readable and unknown future source variants degrade to None.
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 20/100
This commit adds extra bookkeeping information to Lightning payment records so users can tell which incoming payment caused each outgoing payment. It is a feature/enhancement change, not a fix for an active security bug. The new data is exposed through existing read-only APIs and serialized in a backward-compatible way, so it does not appear to introduce a vulnerability.
Handle `DNSSECError` messages when attempting DNSSEC resolution
https://github.com/lightning/blips/pull/71 updated the DNSSEC resolution bLIP to include an explicit error message when DNS(SEC) resolution was attempted but failed, allowing for faster fallback to LN-Address (for clients that do) and faster payment failure.
Here we add client-side support for the new message, accepting `DNSSECError` messages and marking payments as failed when all our queries have failed.
Largely writen by an LLM
81/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
AI analysis · Low 29/100
This commit adds support in the Lightning Dev Kit for a new DNSSEC error message type. Previously, if a DNS resolver couldn't resolve a human-readable Lightning address, the client would simply wait and eventually time out. Now, the client can receive an explicit 'DNSSECError' message, track which resolver queries have failed, and fail the payment promptly once all queried resolvers report failure. The change is a protocol improvement rather than a fix for an active vulnerability.
Add infrastructure for handling `DNSSECError` onion messages
https://github.com/lightning/blips/pull/71 updated the DNSSEC resolution bLIP to include an explicit error message when DNS(SEC) resolution was attempted but failed, allowing for faster fallback to LN-Address (for clients that do) and faster payment failure.
Here we simply add the new message framing and empty handlers.
Largely writen by an LLM
81/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
AI analysis · Informational 19/100
This commit adds plumbing for a new Lightning onion message type called DNSSECError. It lets a DNS resolver tell a payer that a name could not be resolved, so the payer can fail or retry faster. The change is mostly new message framing and empty/default handlers; it does not appear to fix an active security bug or introduce a clear vulnerability.
✓ Descriptive subject! No meaningful explanatory body
Why it was queued
second-pass: opaque commit message
AI analysis · Informational 15/100
This commit removes a separate CI build step that tested the project with a special 'taproot' compiler flag. It is a workflow cleanup change, not a code change. There is no indication of a security vulnerability.
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 20/100
This commit raises the limit on how many peers without an active payment channel the software will accept connections from, from 250 to 2500. By itself this is a simple configuration tuning change, not a code fix for a specific bug. It could slightly increase resource consumption and the surface area for denial-of-service attacks, but it does not create a known exploitable vulnerability.
Security candidatePin jobserver to 0.1.34 on pre-1.85 rustcby Matt Corallo · a4641403 · Jul 9, 2026 · 1 fileMessage 45 · ThinInformational 15Details
Commit message · Matt Corallo
Pin jobserver to 0.1.34 on pre-1.85 rustc
45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
access control
AI analysis · Informational 15/100
This commit adjusts the project's continuous integration (CI) test script to pin an older version of a build-time helper crate called `jobserver` when using older Rust compilers. It is a build compatibility fix, not a security patch, and does not change any production code that handles payments, networking, or cryptography.
AI review queuedBump esplora-client to 0.13 to switch from `reqwest` to `bitreq`by Matt Corallo · 5cd499e0 · Jul 9, 2026 · 2 filesMessage 50 · ThinInformational 17Details
Commit message · Matt Corallo
Bump esplora-client to 0.13 to switch from `reqwest` to `bitreq`
...fixing MSRV builds
50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Informational 17/100
This commit updates a dependency used to talk to Esplora blockchain servers from version 0.12 to 0.13, switching the underlying HTTP library from reqwest to bitreq. It also removes two CI workarounds that pinned older versions of idna_adapter and hyper-rustls to keep older Rust compiler (MSRV) builds working. The stated purpose is to fix MSRV builds, not to fix a security vulnerability. There is no direct evidence in the commit or supplied references that this change addresses an exploitable security issue.
Test cross-version serialization of pending splices
Add tests exercising the 0.2/current wire boundary for pending splices: - A current node with a single pending splice (whether or not we contributed to it) is loadable by LDK 0.2. - A current node with a splice under RBF is refused by 0.2 via the even RBF-gate TLV. - A single pending splice written by 0.2 is read by current with no contribution recorded, since 0.2 never tracked one.
The downgrade reload configs enable anchors so 0.2 accepts the current channel type rather than refusing it before the splice state is reached.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
83/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
update trust
AI analysis · Informational 15/100
This commit only adds new test code. It exercises how a newer version of LDK exchanges saved channel data with the older LDK 0.2 release when a channel has a pending splice. There is no change to production logic, no bug fix, and no security patch. It is purely a regression test to confirm that downgrade and upgrade paths behave as designed.
Lower-priorityQueue a splice on a channel with an inherited splice until it locksby Jeffrey Czyz · 1127a38a · Jul 9, 2026 · 2 filesMessage 73 · AdequateLow 33Details
Commit message · Jeffrey Czyz
Queue a splice on a channel with an inherited splice until it locks
A pending splice negotiated before an upgrade from a prior LDK version (e.g. 0.2) comes back without its feerate or our contribution: 0.2 persists neither and drops the odd TLVs that carry them. Without them the inherited splice cannot be RBF'd.
Rather than refuse to splice the channel, leave the RBF feerate floor unset so the new splice is queued and begins as a fresh splice once the inherited splice locks -- the same path taken whenever a contribution cannot replace the pending candidate via RBF, such as on a zero-conf channel.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 33/100
This commit fixes a compatibility edge case when users upgrade from an older version of LDK (0.2) while a channel splice is still pending. The older version did not save enough details about the splice, so after upgrading the software could not safely continue or replace that splice. The fix makes the newer code recognize the missing information and queue a fresh splice instead of refusing or crashing. It is a robustness improvement for cross-version upgrades, not a remotely exploitable vulnerability.
Compute the minimum splice RBF feerate via PendingFunding
splice_channel derived the pending splice's minimum RBF feerate by mapping a standalone helper over the prior round's feerate, shadowing the helper's name with the resulting local. Encapsulate the derivation as PendingFunding::min_rbf_feerate, mirroring the FundingTemplate accessor it feeds, and keep the formula as an associated function for the call sites that derive the prior feerate differently.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 14/100
This commit is a pure code cleanup: it moves a small fee-calculation helper for Lightning splice RBF (replace-by-fee) transactions into a struct method and renames it. The actual arithmetic formula and the places that use it stay exactly the same. There is no change to behavior, no bug fix, and no security issue introduced or fixed.
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
documentation-only discount
AI analysis · Informational 15/100
This commit only adds a changelog text file describing a previously merged feature (PR 4687). It does not change any source code, build scripts, tests, or documentation that affects program behavior. There is no security-relevant change to assess.
A channel may have splice attempts in progress: a contribution we have committed but not yet begun negotiating, one under negotiation with the counterparty, and any negotiated transactions (the original splice and any RBF replacements) waiting on confirmations. This state was only observable through events and the broadcaster's TransactionType::InteractiveFunding, neither of which can be queried on demand.
Add an optional splice_details field to ChannelDetails. Every splice or RBF round on the channel that has not yet locked is reported as a candidate, each carrying our contribution to it (if any) and a status giving the stage it has reached, from a contribution awaiting quiescence, through negotiation, to a signed transaction awaiting confirmations. This also reports the single candidate that has confirmed, with its confirmation progress and whether we have sent splice_locked for it, and the txid of any splice_locked received from the counterparty.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 20/100
This commit adds a new read-only API field that lets users query the status of in-progress channel splice operations on demand. It does not change protocol behavior, permissions, or how funds are handled; it only exposes internal state that was previously visible only through event notifications. There is no indication this introduces a security vulnerability.
With rust-bitcoin `0.32.4` release, verifying a script is a witness program delegates to `Script::witness_version`, This makes adding `Script::is_witness_program` check alongside a witness_version check redundant.
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 19/100
This is a small code cleanup that removes an unnecessary duplicate check when validating Bitcoin output scripts during Lightning channel funding. The old code first asked 'is this a witness program?' and then separately asked 'what is its witness version?' The newer version of the underlying rust-bitcoin library makes the first question redundant, so the patch drops it. There is no functional behavior change intended.
Include per-HTLC amounts in `PaymentForwarded` locators so callers can account for each channel independently when a forward uses multiple incoming or outgoing HTLCs.
AI-assisted-by: OpenAI Codex
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 19/100
This commit adds the HTLC amount (in milli-satoshis) to the data structures LDK uses to locate forwarded payments. It is a feature/enhancement change: callers of the PaymentForwarded event can now see per-HTLC amounts when a forward involves multiple incoming or outgoing HTLCs. There is no security vulnerability in the diff; it only enriches event metadata and updates serialization, tests, and test helpers accordingly.
Lower-priorityCorrect CHANGELOG dates on 0.2.1 and 0.2.2by Matt Corallo · 253018ca · Jul 8, 2026 · 1 fileMessage 45 · ThinInformational 15Details
Commit message · Matt Corallo
Correct CHANGELOG dates on 0.2.1 and 0.2.2
45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
documentation-only discount
AI analysis · Informational 15/100
This commit only fixes two release dates in the project's CHANGELOG.md file, changing the years for versions 0.2.1 and 0.2.2 from 2025 to 2026. There are no code changes, no security fixes, and no functional impact.
Monitor event draining expects BumpTransaction events, which the harness must mine, plus SpendableOutputs and DiscardFunding events, which it intentionally ignores because it does not model an external wallet. Make that whitelist explicit by panicking on any other monitor event instead of silently ignoring it.
80/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
Why it was queued
second-pass: broader security terminology
AI analysis · Informational 18/100
This change only affects an internal fuzz-testing harness, not production code. It makes the test harness crash with a clear error message if it encounters a ChannelMonitor event it doesn't know how to handle, instead of silently ignoring it. This helps fuzz tests catch unexpected behavior but does not create a security vulnerability in real Lightning nodes.
Store splice contributions with their negotiated candidates
PendingFunding tracked our splice contributions in a compact list implicitly aligned to the tail of the negotiated candidates, with the in-flight negotiation round's contribution as the implicit last entry. Every consumer had to re-derive this positional relationship, which is easy to get wrong -- e.g., attributing an in-flight round's contribution to a completed counterparty-only candidate.
Instead, store each candidate's contribution with the candidate itself and give the in-flight round's contribution its own field, making such misattribution unrepresentable. The contributions still form a suffix of the candidates -- once a round includes our contribution, every subsequent round carries it forward (possibly feerate-adjusted) so the splice intention is never lost -- which is now asserted when a round completes.
Serialize this so a single (non-RBF) pending splice stays loadable by LDK 0.2 while RBF is refused loudly. 0.2 predates per-candidate contributions, the in-flight contribution, and the last-negotiated feerate, so writing any of them in an even (required) TLV would make 0.2 refuse even a single splice it can otherwise operate. The legacy TLV 3 therefore carries only the first candidate's funding -- the single-splice view 0.2 reads -- while the full candidate list, the in-flight contribution, and the feerate go in odd TLVs that 0.2 skips. An even gate TLV is written only when there is more than one negotiation round (RBF), so 0.2 loads single splices and refuses RBF, which it cannot operate.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Low 32/100
This commit refactors how a Lightning node keeps track of money it adds during splice and RBF (fee-bump) negotiations. Previously, the node's own contributions were stored in a separate list that had to be manually aligned with negotiated funding candidates, which the commit message says was 'easy to get wrong.' The change bundles each contribution with the candidate it belongs to and adds explicit checks to prevent misattribution. It also carefully preserves backward compatibility so older LDK versions can still load simple single splices but will refuse to load more complex RBF states they cannot safely handle.
Require `htlc_value_satoshis` in [pending] `HTLCUpdate`s
In 0.0.100 we started tracking the amounts being claimed in `OnchainEvent::HTLCUpdate` and then also in `MonitorEvent::HTLCUpdate`'s `HTLCUpdate`. It was always set, but stored as an `Option` to support further downgrade. Because these objects time out after `ANTI_REORG_DELAY` (6) blocks, there's not really much reason to keep supporting backwards compatibility to upgrade with such objects without an amount.
In 0.0.115, we started providing the amount in `PaymentForwarded`. For whatever reason, despite the event only being generated in cases where we had amounts, the field was added as an `Option`.
Still, in 0.0.118 we started generating them from both off-chain and on-chain claims. For off-chain claims it was always set, but for claims which originated from on-chain claims, the amounts came from the `MonitorEvent::HTLCUpdate` and thus were always an `Option`. If we no longer care about `MonitorEvent::HTLCUpdate`'s without a claim amount, we no longer need to worry about `Event::PaymentForwarded` either. Thus, we make it required here as well.
85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
Why it was queued
update trust
AI analysis · Low 25/100
This commit removes the 'Option' wrapper from several HTLC amount fields, making them required instead of optional. It is a cleanup/refactoring change that simplifies the code by assuming the amount is always known. The commit message frames this as removing legacy downgrade support, not as fixing a security bug. There is no direct evidence in the diff of an exploitable vulnerability.
Use a builder for sign_interactive_funding_tx arguments
The signing helper had accumulated several boolean/option parameters beyond the two nodes, so call sites passed opaque positional `false`s and bare `None`s whose meaning was unclear without consulting the signature.
Replace the two overloaded functions with a single `sign_interactive_funding_tx` taking a `SignInteractiveFundingTxArgs` builder, mirroring `PassAlongPathArgs`: `new(initiator, acceptor)` defaults to a first-attempt splice on a confirmed channel with no acceptor contribution, and each non-default behavior is opted into by a named method (`zero_conf`, `with_acceptor_contribution`, `replacing`).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
78/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
signing boundary
AI analysis · Informational 15/100
This commit is a code cleanup inside the project's test suite. It replaces a helper function with several hard-to-read positional arguments (like bare `false` and `None`) with a 'builder' pattern that names each option. This makes the tests easier to read and maintain, but it does not change any production behavior or fix a security bug.