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 makes on-chain 'MonitorEvent' notifications durable and replay-safe. Previously, if a node crashed after a ChannelMonitor persisted a block update but before the ChannelManager processed the resulting event, the event could be …
Durability/atomicity fix for async persistence: prevents lost MonitorEvents across crashesNew ack-based event lifecycle with random event IDsArchival gating on unacknowledged events to avoid losing preimage/timeout information
This commit refactors how LDK nodes claim incoming Lightning payments. It replaces a separate 'claim with known custom TLVs' method with an options struct passed to the normal claim call, and fixes two edge cases in payment attribution dat…
API change: claim_funds now takes ClaimFundsOptions, consolidating TLV-known behavior into one pathFailure-packet length bound added to prevent oversized onion error messagesIncoming failure packet truncated at 32 KiB before processing
This change fixes a wallet bookkeeping problem in rust-lightning's built-in coin-selection wrappers. Previously, when a splice attempt failed or coin selection errored after picking UTXOs, those UTXOs stayed marked as 'reserved' in memory …
Resource exhaustion / denial-of-service via permanent in-memory UTXO reservationIncorrect state tracking in coin-selection wrapperNew API method required for correct lifecycle management (release_utxos)
This commit fixes a bug in the wallet's coin-selection code. When the wallet picked UTXOs to spend, it locked them immediately so they couldn't be reused. But if a later step—fetching the change address or the previous transaction—failed, …
Resource lock leak on error pathUTXO lock state inconsistency between selection and confirmationDenial-of-service/funds-unavailability risk from persistent UTXO locks
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 fixes a design flaw in LDK's built-in wallet helper where coins selected for a splice-in (or other unclaimed funding) were permanently reserved in memory if the transaction was abandoned. Over repeated failed splices, all spend…
Denial-of-service via UTXO exhaustion from repeated failed splice negotiationsRisk of inability to broadcast fee-bumping/claim transactions due to lack of available UTXOsNew API surface (release_utxos) introduced to mitigate resource leak
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.
The following types have methods for returning contributed inputs and outputs: - FundingNegotiationContext - InteractiveTxConstructor - InteractiveTxSigningSession - ConstructedTransaction
Having iterators for these can avoid allocations, which is useful for filtering contributed input and outputs when producing DiscardFunding events.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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 15/100
This commit is a straightforward internal code cleanup in the Lightning Dev Kit's transaction-building code. It replaces a few methods that always built full lists of contributed inputs and outputs with new iterator methods that let callers decide when to build those lists. There is no change to security logic, no bug fix, and no externally visible behavior change.
RecipientOnionFields::secret_only requires an amount now, but when do_abandon_splice_quiescent_action_on_shutdown was introduced it was based on an earlier commit.
This is a tiny fix to a single test file so the project compiles after a recent API change. A helper function called secret_only now requires a payment amount to be passed alongside the payment secret. The test was written against the older version of that helper and broke when both changes landed together. There is no indication this affects real user funds, live code paths, or network security.
Lower-priorityAdd a `Path::total_cltv_expiry_delta` accessorby Matt Corallo · 5ce6e42b · Feb 24, 2026 · 2 filesMessage 45 · ThinInformational 15Details
Commit message · Matt Corallo
Add a `Path::total_cltv_expiry_delta` accessor
45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 15/100
This commit adds a small public helper method that sums up the time-lock delays across all hops in a Lightning payment path. It also adds an internal consistency check to make sure the computed total matches what the code uses when building an onion packet. There is no security fix here—this is a routine code-quality and API-convenience change.
Lower-priorityValidate CLTV somewhat in `Route::debug_assert_route_meets_params`by Matt Corallo · 54be6eff · Feb 24, 2026 · 3 filesMessage 73 · AdequateLow 36Details
Commit message · Matt Corallo
Validate CLTV somewhat in `Route::debug_assert_route_meets_params`
Now that we've cleaned up trampoline CLTV building and added `Path::total_cltv_expiry_delta`, we can use both to do some basic validation of CLTV values on blinded tails in `Route::debug_assert_route_meets_params`
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
defensive validation
AI analysis · Low 36/100
This commit adds extra sanity checks inside a Lightning payment routing library to catch cases where time-lock (CLTV) values on payment paths are internally inconsistent. The checks live in a debug-only assertion helper, so they do not change normal runtime behavior; they mainly help developers detect bugs during testing. The patch also fixes one unit test that previously relied on an unrealistic CLTV value and adjusts how the first-hop CLTV is computed when building onion payloads for trampoline/blinded routes.
Lower-priorityFix trampoline onion encoding to match doc-declared CLTV rulesby Matt Corallo · 4867c309 · Feb 24, 2026 · 5 filesMessage 85 · StrongModerate 59Details
Commit message · Matt Corallo
Fix trampoline onion encoding to match doc-declared CLTV rules
The docs for `RouteHop::cltv_expiry_delta` claim that it includes any trampoline hops, but the way we actually implemented onion building it did not.
Because the docs described a simpler and more backwards-compatible API, we update the onion-building logic to match rather than updating the docs.
85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Moderate 59/100
This commit fixes a mismatch between the documented behavior and the actual code for building trampoline payment onions in the Lightning Dev Kit. The documentation said that a route hop's time-lock delta already includes any trampoline hops, but the onion-building code was not doing that. The fix changes the code to match the documented (and simpler, more backwards-compatible) behavior. In practical terms, before the fix, trampoline payments could have been constructed with incorrect CLTV (time-lock) values, which could cause payment failures or, in edge cases, affect safety margins for time-locked refunds.
Lower-priorityClarify CLTV value selection in the first blinded hop marginallyby Matt Corallo · ec8580b0 · Feb 24, 2026 · 1 fileMessage 50 · ThinInformational 23Details
Commit message · Matt Corallo
Clarify CLTV value selection in the first blinded hop marginally
50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 23/100
This is a one-line code change in how the first hop of a blinded (private) Lightning payment path calculates its expiry deadline. The change switches from using the current accumulated CLTV value to using the starting HTLC offset when computing the final expiry for the first blinded hop. The commit title says it only 'marginally clarifies' the value selection, suggesting it is a minor correctness or readability fix rather than a serious security bug. There is no vendor statement that this is security-relevant, and no independent researcher is credited.
Lower-priorityRename `starting_htlc_offset` `cur_block_height` in onion buildingby Matt Corallo · e39437db · Feb 24, 2026 · 1 fileMessage 73 · AdequateInformational 15Details
Commit message · Matt Corallo
Rename `starting_htlc_offset` `cur_block_height` in onion building
Now that we are consistently using the `RouteHop::cltv_expiry_delta` as the last hop's starting CLTV rather than summing trampoline hops, `starting_htlc_offset` is a bit confusing - its actually always the current block height. Thus, here we rename it.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 15/100
This commit is a simple variable rename in the code that builds Lightning payment onion payloads. The old name `starting_htlc_offset` was misleading because the value is actually the current block height, so it was renamed to `cur_block_height`. No behavior changed.
Lower-priorityUse HTLC CLTV instead of onion CLTV values for payment claim timerby Matt Corallo · 37e75e7a · Feb 24, 2026 · 2 filesMessage 73 · AdequateLow 44Details
Commit message · Matt Corallo
Use HTLC CLTV instead of onion CLTV values for payment claim timer
When we receive an HTLC as a part of a claim, we validate that the CLTV on the HTLC is >= the CLTV that the sender requested we receive, but then we use the CLTV value that the sender requested we receive as the deadline to claim the HTLC anyway.
This isn't generally all that interesting (they're always the same unless the previous-hop node gave us "free CLTV"), but for trampoline payments where we're both a trampoline hop and the blinded intro point and the recipient, it means we end up allowing ourselves less claim time than we actually have.
Instead, here, we just use the actual HTLC CLTV deadline.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
defensive validation
AI analysis · Low 44/100
This commit fixes a subtle timing bug in how Lightning payment deadlines are recorded. When a node receives a payment, it was writing down the deadline the sender asked it to honor rather than the actual deadline attached to the incoming payment. Normally those two numbers are the same, but in a special 'trampoline' routing case a node can end up giving itself less time than it really has to claim funds. The fix makes the node use the real deadline from the incoming payment instead.
Lower-prioritychanmon_consistency: assert claimed payments result in PaymentSentby Joost Jager · 58018e0c · Feb 24, 2026 · 1 fileMessage 73 · AdequateInformational 12Details
Commit message · Joost Jager
chanmon_consistency: assert claimed payments result in PaymentSent
Add an invariant to the settlement phase: every payment that a receiver claimed (via claim_funds) must result in a PaymentSent event at the sender. This catches bugs where a claimed payment's preimage fails to propagate back to the sender.
To support this, change resolved_payments from Vec<PaymentId> to HashMap<PaymentId, Option<PaymentHash>>, storing Some(hash) for PaymentSent and None for PaymentFailed/probes.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 12/100
This commit only adds a new safety check inside an internal fuzz test harness. It does not change production code, user-facing behavior, or network protocol handling. The change makes the test suite verify that when a payment is claimed by a receiver, the sender eventually receives a matching 'payment sent' confirmation. It is a test-quality improvement, not a security fix or vulnerability.
Abandon pending quiescent action upon shutdown initiation
Otherwise, now that we no longer have the awaiting quiescence state flag, we may end up sending `stfu` for a channel we intend to close.
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 37/100
This change fixes a state-handling bug in the Lightning Dev Kit where a channel that is about to be closed could still try to enter a 'quiet' negotiation phase used for splicing (modifying a channel's funds). After a recent refactor removed an 'awaiting quiescence' flag, the code could send a 'stfu' (stop, wait) message for a channel the user actually wants to shut down. The patch makes shutdown cleanly abandon any pending splice/quiescent action and notify the user with a SpliceFailed event. It is a protocol-correctness and user-experience fix rather than a direct funds-loss vulnerability.
With the introduction of `QuiescentAction`, the flag has essentially become duplicate state, so we opt to remove it in favor of just checking whether we have a pending `FundedChannel::quiescent_action`. Since the quiescent flags are never persisted, we can simply remove it and update the other flags, freeing up a bit for future use.
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 27/100
This commit is a code cleanup in a Lightning network implementation. It removes a duplicate internal flag used to track whether a channel is trying to become quiet (quiescent) for operations like splicing. The same information is now tracked by checking whether a pending 'QuiescentAction' exists. The change frees up a bit in the channel state flags for future use and simplifies state management. It does not appear to fix a known security vulnerability, but any change to state-machine logic in payment channel code carries some risk of introducing subtle bugs.
In 15b04b5, we fixed a case in `FundedChannel::try_send_stfu` where we'd send `stfu` unnecessarily for a new splice while one is already pending. The same case also existed in `FundedChannel::send_stfu`, but was not fixed. There's no good reason for both of these methods to exist, so we merge them into one as `FundedChannel::try_send_stfu`. We also add a test that reproduces the `FundedChannel::send_stfu` issue to ensure it's fixed and does not regress.
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
Why it was queued
merge-commit duplicate discount
AI analysis · Low 37/100
This commit fixes a bug in the Lightning Dev Kit where a node could send a 'stop the flow and update' (stfu) message too early during a channel splice. If a splice was already pending and a new one was requested, the old code path could send stfu prematurely, potentially causing the splice protocol to get out of sync with the peer. The fix merges two similar code paths into one and adds a regression test.
Lower-priorityRename to StaticInvoice::held_htlc_available_pathsby Valentine Wallace · 42ca4b79 · Feb 23, 2026 · 3 filesMessage 75 · AdequateInformational 15Details
Commit message · Valentine Wallace
Rename to StaticInvoice::held_htlc_available_paths
Otherwise, Bolt12Invoice::message_paths and StaticInvoice::message_paths would have the same name but return completely different kinds of paths, which is inconsistent.
This commit is a simple rename of a field and method from `message_paths` to `held_htlc_available_paths` in the code that handles a specific type of Lightning invoice (a 'static invoice'). The change was made because two different invoice types had methods with the same name that returned different kinds of paths, which was confusing for developers. There is no functional change to how the software behaves, and no security issue is present in the commit.
Security candidateClean up fuzz crate: use panic=abort, add stdin_fuzz support, remove dylibby Joost Jager · 69e2d8cf · Feb 23, 2026 · 75 filesMessage 95 · StrongInformational 15Details
Commit message · Joost Jager
Clean up fuzz crate: use panic=abort, add stdin_fuzz support, remove dylib
This commit makes three related changes to the fuzz infrastructure:
1. Set panic=abort on both dev and release profiles, and remove the dylib crate type (keeping rlib and staticlib). The dylib crate type was added in e28fd78e6 (2019) for a C-callable harness that was never implemented. Removing dylib is what enables panic=abort, since Rust forces panic=unwind on dylib crates. staticlib is retained as it is compatible with panic=abort.
2. Add stdin_fuzz support: a new Stdout logger, updated target template so that stdin_fuzz calls _test() with Stdout logging, and updated README with usage instructions. This allows reproducing crashes via piped input, useful for git bisect and AI-assisted debugging.
3. Update all fuzzer frontends (AFL, honggfuzz, libfuzzer, stdin_fuzz) to call the _test() functions directly instead of going through the _run() C wrappers.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
95/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode✓ Mentions testing or verification
Why it was queued
fuzzing or regression evidencesigning or wallet pathboot or update pathauthentication pathparser or protocol path
AI analysis · Informational 15/100
This commit is a routine cleanup of the project's fuzz-testing infrastructure. It changes how fuzz tests are compiled and run, adds a new way to feed test input via standard input, and removes an unused dynamic-library build mode. There is no indication it fixes or introduces a security vulnerability in the actual Lightning library code.
AI review queuedDelete `TxBuilder::subtract_non_htlc_outputs`by Leo Nash · 75d4a6bf · Feb 23, 2026 · 2 filesMessage 70 · AdequateInformational 12Details
Commit message · Leo Nash
Delete `TxBuilder::subtract_non_htlc_outputs`
We make temporary use of the raw `tx_builder::saturating_sub_anchor_outputs` function in `get_available_balances_for_scope`. This ok because we move most of the `get_available_balances_for_scope` function to the `TxBuilder::get_channel_stats` call in an upcoming commit.
Again, no functional change is introduced in this commit.
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Informational 12/100
This commit is a straightforward internal code cleanup in the Lightning Dev Kit's Rust implementation. It removes a helper method called subtract_non_htlc_outputs from a trait and replaces its uses with direct calls to a similar helper function. The commit message explicitly states there is no functional change, and the diff shows the new helper behaves identically to the removed method. There is no indication this fixes or introduces a security issue.
AI review queuedDelete `TxBuilder::commit_tx_fee_sat`by Leo Nash · a4bf94a4 · Feb 23, 2026 · 2 filesMessage 58 · ThinLow 27Details
Commit message · Leo Nash
Delete `TxBuilder::commit_tx_fee_sat`
Move calls to `TxBuilder::commit_tx_fee_sat` in `new_for_inbound_channel` and `new_for_outbound_channel` to `ChannelContext::get_next_{*}_commitment_stats`, and set the parameters such that the exact same behavior is maintained.
We also replace calls to `TxBuilder::commit_tx_fee_sat` in `get_pending_htlc_stats`, `next_local_commit_tx_fee_msat`, and `next_remote_commit_tx_fee_msat` with `chan_utils::commit_tx_fee_sat`. All three functions get deleted in an upcoming commit, so we accept this temporary use of the `chan_utils::commit_tx_fee_sat` function.
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Low 27/100
This commit is a code cleanup in the Lightning Dev Kit's rust-lightning project. It removes a helper method called `commit_tx_fee_sat` from a transaction-building trait and moves the fee-checking logic into a more central place when opening channels. The goal is to keep the same behavior while simplifying the code. There is no direct evidence in the commit that this fixes a security vulnerability.
AI review queuedIntroduce `TxBuilder::get_channel_stats`by Leo Nash · 4760f868 · Feb 23, 2026 · 2 filesMessage 58 · ThinInformational 13Details
Commit message · Leo Nash
Introduce `TxBuilder::get_channel_stats`
This commit moves the previous `TxBuilder::get_next_commitment_stats` method to a private function, and then calls this function in `TxBuilder::get_channel_stats`.
Similar to the previous `TxBuilder::get_next_commitment_stats` method, `TxBuilder::get_channel_stats` fails if any party cannot afford the HTLCs outbound from said party, and the anchors if they are the funder.
Aside from the API changes on `TxBuilder`, there are no functional changes in this commit.
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Informational 13/100
This commit is a straightforward internal code reorganization in the Lightning Dev Kit's transaction-building code. It renames and restructures a method so that a new wrapper, `get_channel_stats`, returns the same underlying commitment statistics inside a new container struct. The commit message explicitly states there are no functional changes beyond the API rename, and the diff shows only mechanical renames and field-access adjustments (e.g., `stats.nondust_htlc_count` becomes `stats.commitment_stats.nondust_htlc_count`). There is no indication of a security fix, vulnerability, or behavior change.
Lower-prioritySimplify calculation of the biggest HTLC value that can be sent nextby Leo Nash · d2e2fbde · Feb 23, 2026 · 1 fileMessage 50 · ThinInformational 11Details
Commit message · Leo Nash
Simplify calculation of the biggest HTLC value that can be sent next
This commit has no functional changes.
50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 11/100
This is a small code cleanup in the Lightning payment channel logic. The developer rewrote how the maximum next HTLC (payment) amount is calculated, using simpler arithmetic and removing a debug assertion. The commit message explicitly states there are no functional changes, and the diff appears to preserve the same end result while making the code easier to read.
Lower-priorityAdd total-MPP-value storage in pending paymentsby Matt Corallo · 541723fb · Feb 20, 2026 · 1 fileMessage 68 · AdequateLow 43Details
Commit message · Matt Corallo
Add total-MPP-value storage in pending payments
In some uses of LDK we need the ability to send HTLCs for only a portion of some larger MPP payment. This allows payers to make single payments which spend funds from multiple wallets, which may be important for ecash wallets holding funds in multiple mints or graduated wallets which hold funds across a trusted wallet and a self-custodial wallet.
In the previous commits we moved the total-MPP-value we set in onions from being manually passed through onion-building to passing it via `RecipientOnionFields`. This introduced a subtle bug, though - payments which are retried will get a fresh `RecipientOnionFields` built from the data in `PendingOutboundPayment::Retryable`, losing any custom total-MPP-value settings and causing retries to fail.
Here we fix this by storing the total-MPP-value directly in `PendingOutboundPayment::Retryable`.
68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 43/100
This commit fixes a bug where retrying a multi-part Lightning payment could fail because the original 'total payment amount' setting stored in the onion was lost and replaced with a default value. The fix stores that onion total directly in the pending payment record so retries preserve it. There is no direct evidence this is exploitable by an attacker; it appears to be a reliability/functional bug for legitimate users, especially those splitting payments across multiple wallets.
Security candidateInclude MPP payment amount in `RecipientOnionFields`by Matt Corallo · abf258a6 · Feb 20, 2026 · 29 filesMessage 95 · StrongLow 36Details
Commit message · Matt Corallo
Include MPP payment amount in `RecipientOnionFields`
In some uses of LDK we need the ability to send HTLCs for only a portion of some larger MPP payment. This allows payers to make single payments which spend funds from multiple wallets, which may be important for ecash wallets holding funds in multiple mints or graduated wallets which hold funds across a trusted wallet and a self-custodial wallet.
In order to allow for this, we need to separate the concept of the payment amount from the onion MPP amount. Here we start this process by adding a `total_mpp_amount_msat` field to `RecipientOnionFields` (which is the appropriate place for a field describing something in the recipient onion).
We currently always assert that it is equal to the existing fields, but will relax this in the coming commit(s).
We also start including a payment preimage on probe attempts, which appears to have been the intent of the code, but which did not work correctly.
The bulk of the test updates were done by Claude.
95/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode✓ Mentions testing or verification
Why it was queued
signing or wallet pathboot or update path
AI analysis · Low 36/100
This commit is a preparatory refactor in LDK's payment-sending code. It adds a new `total_mpp_amount_msat` field to `RecipientOnionFields` so that, in future commits, a payer can send an HTLC that is only one part of a larger multi-part payment. For now the new field is always required and is asserted to match the existing payment amount, so behavior is unchanged. The commit also fixes a small related bug where probe payments were not including a payment preimage as intended. There is no immediate security vulnerability here; it is a feature-building change with a minor bug fix.
Lower-priorityAdd a pending changelog entry to note new backwards incompatby Matt Corallo · 372168d1 · Feb 20, 2026 · 1 fileMessage 50 · ThinInformational 15Details
Commit message · Matt Corallo
Add a pending changelog entry to note new backwards incompat
50/100 · ThinMessage clarity
✓ Specific, 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 note warning users that two newly introduced payment options will prevent downgrading to version 0.2 while a payment is in progress. There is no code change, no bug fix, and no security issue in the commit itself.
Lower-priorityReplace existing MPP-total args with `RecipientOnionFields`by Matt Corallo · d9495081 · Feb 20, 2026 · 11 filesMessage 73 · AdequateLow 34Details
Commit message · Matt Corallo
Replace existing MPP-total args with `RecipientOnionFields`
In some uses of LDK we need the ability to send HTLCs for only a portion of some larger MPP payment. This allows payers to make single payments which spend funds from multiple wallets, which may be important for ecash wallets holding funds in multiple mints or graduated wallets which hold funds across a trusted wallet and a self-custodial wallet.
In the previous commit we added a new field to `RecipientOnionFields` to describe the total value of an MPP payment. Here we start using this field when building onions, dropping existing arguments to onion-building methods.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 34/100
This commit is a code cleanup and feature-enabling refactor in the Lightning Dev Kit (LDK). It moves the total amount for multi-path payments (MPP) out of individual function arguments and into a structured object called `RecipientOnionFields`. This makes it possible for future callers to send partial payments that add up to a larger total, which is useful for wallets that hold funds in multiple places. The commit itself does not appear to fix a known bug or vulnerability; it is preparation for a new capability.
Lower-priorityAllow BOLT 11 payments to be a part of a larger MPP paymentby Matt Corallo · e395cb10 · Feb 20, 2026 · 4 filesMessage 83 · StrongInformational 23Details
Commit message · Matt Corallo
Allow BOLT 11 payments to be a part of a larger MPP payment
In some uses of LDK we need the ability to send HTLCs for only a portion of some larger MPP payment. This allows payers to make single payments which spend funds from multiple wallets, which may be important for ecash wallets holding funds in multiple mints or graduated wallets which hold funds across a trusted wallet and a self-custodial wallet.
In the previous few commits we added support for making these kinds of payments when using the payment methods which explicitly accepted a `RecipientOnionFields`. Here we also add support for such payments made via the `pay_for_bolt11_invoice` method, utilizing the new `OptionalBolt11PaymentParams` to hide the parameter from most calls.
Test mostly by Claude
83/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Informational 23/100
This commit adds a new, optional feature to the Lightning Dev Kit (LDK) that lets multiple wallets or devices team up to pay a single Lightning invoice. Each participating wallet can pay just part of the total, and the merchant's node sees the combined payment as one normal multi-path payment. It is a deliberate feature addition, not a bug fix, and the code includes validation to prevent obvious misuse such as paying less than promised.
Lower-priorityDrop `total_msat` from individual `ClaimableHTLC`sby Matt Corallo · a28e7e63 · Feb 20, 2026 · 1 fileMessage 73 · AdequateLow 27Details
Commit message · Matt Corallo
Drop `total_msat` from individual `ClaimableHTLC`s
Now that we have `total_mpp_amount_msat` in the now-required `RecipientOnionFields` in `ClaimablePayment`s, the `total_msat` field in `ClaimableHTLC` is redundant. Given it was already awkward that we stored it in *each` `ClaimableHTLC` despite it being required to match in all of them, its good to drop it.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 27/100
This commit removes a redundant copy of the expected total payment amount from each individual HTLC record in LDK's channel manager. The expected total is now stored once per payment in the required 'RecipientOnionFields' structure. The change also tightens serialization/deserialization checks so that all HTLCs in a multi-part payment must agree on the total amount. It appears to be a code-cleanup and hardening change rather than a fix for an active vulnerability, though it removes a potential source of inconsistency that could have led to incorrect payment handling.
AI review queuedRequire `RecipientOnionFields` in the claimable HTLC pipelineby Matt Corallo · ed107760 · Feb 20, 2026 · 1 fileMessage 73 · AdequateLow 26Details
Commit message · Matt Corallo
Require `RecipientOnionFields` in the claimable HTLC pipeline
We added `RecipientOnionFields` in the `ClaimablePayment`/`ClaimingPayment` structs in 0.0.115/0.0.124, always writing them for new HTLCs. As of 0.1, we do not support upgrading from 0.0.123 or earlier with pending HTLCs to forward or claim. Thus, we already don't support upgrading in cases where no `RecipientOnionFields` is set and we can thus go ahead and mark it as non-`Option`al.
Further, there's some super ancient upgrade logic in `ChannelManager` deserialization we can remove at the same time.
73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
second-pass: broader security terminology
AI analysis · Low 26/100
This commit removes old backward-compatibility code in a Lightning network node library. It now requires a newer data field (RecipientOnionFields) when handling incoming payments and refuses to load very old saved state. The change is a cleanup that tightens data handling but does not by itself create a new security vulnerability.