LDK
← All projectsLightning Dev Kit

rust-lightning

Composable Rust libraries for building Lightning wallets, nodes, and services.

BitcoinCryptographic librariesLightning NetworkNormal
Repository coverage

1665 commits in the local evidence base

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.

252security candidates228second-pass queue1525AI analyses
82commits · 30 days
181commits · 60 days
555commits · 180 days
1254commits · 365 days
Backfill bands
Aug 5 → Feb 6819 seen18 candidatesComplete
Feb 6 → Jun 6468 seen16 candidatesComplete
Jun 6 → Jul 6128 seen8 candidatesComplete
Jul 6 → Aug 561 seen3 candidatesComplete
Commit communication

Does the history explain itself?

Message quality measures whether a commit identifies its scope, purpose, rationale, testing, and supporting references. It does not change the security-severity score.

70/100 average clarity
473Strong · 80–100
836Adequate · 60–79
294Thin · 40–59
62Opaque · 0–39
3security candidates with opaque commit messaging
Read the scoring rubric →
Developer activity

Who is changing the project?

Public Git author strings; identities are not independently verified.

DeveloperCommitsCandidatesAnalyzedHigh riskMessage avg.
Elias Rohrer15315153667
Matt Corallo43553371574
Jeffrey Czyz19545182169
Wilmer Paulino15945155169
Leo Nash11613116162
Valentine Wallace14511138169
Vincenzo Palazzo11311183
Joost Jager16224162069
elnosh391333058
auto-pr-bot2478087
shaavan22622069
Carla Kirk-Cohen78366068
Analysis record

Published AI watches

Last scanned 3 minutes ago

Moderate 55 AI analysisMessage 76 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Persistent `MonitorEvent`s' (#4491)

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
9a324e72by wpaulino+467−45912 files
No security note in commit
Low 47 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Fix payment attribution edge cases and simplify claiming' (#5021)

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
ee7c61c2by Matt Corallo+256−17322 files
No security note in commit
Low 47 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'release utxos from failed splices' (#4973)

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)
7220a6fdby jkczyz+295−383 files
No security note in commit
Low 49 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Restore `Wallet` UTXO locks when coin selection fails afterwards

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
81afd9caby elnosh+146−331 file
No security note in commit
Informational 19 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'tx-sync: Parallelize esplora status queries' (#4913)

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
c303f515by Matt Corallo+140−371 file
No security note in commit
Low 30 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Skip Electrum creator transaction downloads' (#4992)

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
c36e50cbby Matt Corallo+142−02 files
No security note in commit
Low 44 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Use preferred sPK of watched txn in electrum, not rand ones' (#4867)

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
bfe5ca89by tnull+52−243 files
No security note in commit
Low 33 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Serialize transient Event variants; move persist decision into ChannelManager' (#4791)

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
a0d4632eby Matt Corallo+694−818 files
No security note in commit
Informational 15 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Document that funding signing events can go stale' (#4960)

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 …

26eecf2dby Matt Corallo+15−02 files
No security note in commit
Moderate 58 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Add `Wallet::release_utxos` to free UTXOs from abandoned transactions

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
52ab13fdby elnosh+148−43 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 100 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Drop the honggfuzz version pin from the CI fuzz job

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…

4a1635efby auto-pr-bot+1−51 file
No security note in commit
Informational 15 AI analysisMessage 86 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Run the CI fuzz job on the stable toolchain

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…

21c4ed2bby auto-pr-bot+3−32 files
No security note in commit
Informational 19 AI analysisMessage 91 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Expose the dummy-hop tail constructor publicly

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
c5443353by auto-pr-bot+14−71 file
No security note in commit
Moderate 54 AI analysisMessage 100 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Fail commitment sig verification without counterparty params

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
de7ecc2fby auto-pr-bot+24−01 file
Vendor flagged security relevance
Informational 15 AI analysisMessage 100 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Clarify the commitment validation failure message

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…

3284a006by auto-pr-bot+11−114 files
No security note in commit
Moderate 61 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Move holder commit sig checks to `InMemorySigner`' (#4885)

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'
83f5ba55by Matt Corallo+626−31024 files
No security note in commit
Low 42 AI analysisMessage 86 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Drop stale splice signature on disconnect' (#4954)

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
c9a77251by Matt Corallo+22−12 files
No security note in commit
Moderate 58 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Drop stale splice signature on disconnect

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
71405b4bby Wilmer Paulino+22−12 files
Vendor flagged security relevance
Informational 20 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'offers: rename matches_invoice_signing_pubkey to key_can_sign_invoice' (#4942)

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.

a476cf92by Matt Corallo+13−133 files
No security note in commit
Informational 15 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

offers: rename matches_invoice_signing_pubkey to key_can_sign_invoice

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.

388187caby Vincenzo Palazzo+13−133 files
No security note in commit
Repository ledger

Explore captured commits

Expand any commit for its author, full message, clarity score, changed files, triage signals, analysis, and source link.

Lower-priorityAllow acceptor contribution to RBF splice via tx_init_rbfby Jeffrey Czyz · d8081559 · Mar 12, 2026 · 4 filesMessage 73 · AdequateLow 46Details
Commit message · Jeffrey Czyz

Allow acceptor contribution to RBF splice via tx_init_rbf

Previously, the tx_init_rbf acceptor always contributed zero to the RBF
transaction. This is incorrect when both parties try to RBF
simultaneously and one loses the quiescence tie-breaker — the loser
becomes the acceptor but still has a pending QuiescentAction::Splice
with inputs/outputs that should be included in the RBF transaction.

Consume the acceptor's QuiescentAction in the tx_init_rbf handler, just
as is already done in the splice_init handler, and report the
contribution in the TxAckRbf response.

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 46/100

This commit fixes a bug in Lightning Dev Kit's splicing/RBF (Replace-By-Fee) logic. When both channel partners tried to update a splice at the same time, the loser of a tie-breaker was supposed to contribute its inputs/outputs as the 'acceptor' of the RBF transaction, but the code incorrectly made the acceptor contribute nothing. The patch makes the acceptor include its queued splice contribution in the RBF transaction and report it in the response. It is a protocol-correctness bug that could cause stuck or inconsistent splice states, but it is not a clear theft-of-funds vulnerability.

Lower-prioritySend tx_init_rbf instead of splice_init when a splice is pendingby Jeffrey Czyz · 5873660a · Mar 12, 2026 · 3 filesMessage 73 · AdequateLow 26Details
Commit message · Jeffrey Czyz

Send tx_init_rbf instead of splice_init when a splice is pending

When the quiescence initiator has a pending splice and enters the stfu
handler with a QuiescentAction::Splice, send tx_init_rbf to bump the
existing splice's feerate rather than starting a new splice_init.

This reuses the same QuiescentAction::Splice variant for both initial
splices and RBF attempts -- the stfu handler distinguishes them by
checking whether pending_splice already exists.

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 · Low 26/100

This commit fixes a logic bug in the Lightning Dev Kit's splicing protocol. Previously, if a node tried to RBF (bump the fee of) a pending splice, it would incorrectly send a new splice_init message instead of tx_init_rbf, which could cause the peer to disconnect or the protocol to fail. The change makes the node detect when a splice is already pending and send the correct RBF message instead. It is a protocol correctness fix rather than a critical security vulnerability.

Security candidateHandle tx_ack_rbf on the initiator sideby Jeffrey Czyz · b07bfff8 · Mar 12, 2026 · 3 filesMessage 90 · StrongLow 32Details
Commit message · Jeffrey Czyz

Handle tx_ack_rbf on the initiator side

After sending tx_init_rbf, the initiator receives tx_ack_rbf from the
acceptor. Implement the handler to validate the response and begin
interactive transaction construction for the RBF funding transaction.

Only clear the interactive signing session in `reset_pending_splice_state`
when the current funding negotiation is in `AwaitingSignatures`. When an
earlier round completed signing and a later RBF round is in `AwaitingAck`
or `ConstructingTransaction`, the session belongs to the prior round and
must be preserved. Otherwise, disconnecting mid-RBF would destroy the
completed prior round's signing session and fire a false debug assertion.

Update test_splice_rbf_acceptor_basic to exercise the full initiator
flow: rbf_channel → funding_contributed → STFU exchange → tx_init_rbf →
tx_ack_rbf → interactive TX → signing → mining → splice_locked. This
replaces the previous test that manually constructed tx_init_rbf.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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
signing boundarydefensive validation
AI analysis · Low 32/100

This commit adds support in the Lightning Dev Kit for handling a specific protocol message (tx_ack_rbf) when a channel participant initiates a fee-bump (RBF) of a pending splice transaction. Previously, receiving this message caused an error. The change also fixes a related bug where resetting splice state could incorrectly discard a completed signing session from an earlier round, which could trigger a debug assertion. The commit is primarily a feature implementation with a defensive bugfix, not a disclosed security vulnerability.

Lower-priorityAdd rbf_channel API for initiating splice RBFby Jeffrey Czyz · 5b6ba439 · Mar 12, 2026 · 2 filesMessage 68 · AdequateLow 28Details
Commit message · Jeffrey Czyz

Add rbf_channel API for initiating splice RBF

Expose ChannelManager::rbf_channel as the entry point for bumping the
feerate of a pending splice funding transaction. Like splice_channel,
it returns a FundingTemplate to be completed and passed to
funding_contributed.

Validates that a pending splice exists with at least one negotiated
candidate, no active funding negotiation, and that the new feerate
satisfies the 25/24 increase rule required by the spec.

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
defensive validation
AI analysis · Low 28/100

This commit adds a new public API called rbf_channel to the Lightning Dev Kit's rust-lightning library. It lets a user bump the transaction fee (via replace-by-fee, or RBF) on a pending splice funding transaction before it is locked on-chain. The change is a feature addition, not a bug fix, and includes several safety checks such as requiring a pending splice, no active funding negotiation, and a minimum 25/24 feerate increase over the previous attempt. There is no direct evidence in the commit that this fixes a security vulnerability.

Lower-priorityAllow multiple RBF splice candidates in channel monitorby Jeffrey Czyz · 51fa46e9 · Mar 12, 2026 · 1 fileMessage 73 · AdequateLow 29Details
Commit message · Jeffrey Czyz

Allow multiple RBF splice candidates in channel monitor

The channel monitor previously rejected any new pending funding when one
already existed. This prevented adding RBF candidates for a pending
splice since each candidate needs its own pending funding entry.

Relax the check to only reject new pending funding when its splice
parent differs from existing entries, allowing multiple RBF candidates
that compete to confirm the same splice.

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 · Low 29/100

This change fixes a logic bug in how Bitcoin Lightning channels handle 'splicing' (a way to resize a channel's on-chain funds). Previously, the code blocked all new funding entries while any splice was still pending, which accidentally prevented valid 'Replace-By-Fee' (RBF) attempts—multiple competing versions of the same splice meant to speed up confirmation. The patch relaxes the rule so only splices that spend from a *different* parent funding transaction are rejected. This is a correctness/functional fix rather than a clear-cut security vulnerability, but the overly strict check could have caused operational failures around unconfirmed splices.

Lower-priorityAccept tx_init_rbf for pending splice transactionsby Jeffrey Czyz · 55196db0 · Mar 12, 2026 · 4 filesMessage 73 · AdequateLow 36Details
Commit message · Jeffrey Czyz

Accept tx_init_rbf for pending splice transactions

When a splice funding transaction has been negotiated but not yet
confirmed, either party may initiate RBF to bump the feerate. This
enables the acceptor to handle such requests, allowing continued
progress toward on-chain confirmation of splices in rising fee
environments.

Only the acceptor side is implemented; the acceptor does not contribute
funds beyond the shared funding input. The initiator side (sending
tx_init_rbf and handling tx_ack_rbf) is left for a follow-up.

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 · Low 36/100

This commit adds the ability for one side of a Lightning channel (the 'acceptor') to accept a fee-bump request for a pending splice transaction. Previously, such requests were rejected outright. The change is a partial feature implementation: only the acceptor side is implemented, and the code includes several safety checks to prevent misuse. There is no direct evidence in the commit that this fixes an active security vulnerability; it appears to be a protocol feature enhancement.

AI review queuedRustfmt reorg_tests.rsby Wilmer Paulino · 102bcd63 · Mar 12, 2026 · 1 fileMessage 28 · OpaqueInformational 15Details
Commit message · Wilmer Paulino

Rustfmt reorg_tests.rs

28/100 · OpaqueMessage clarity
✓ Subject identifies a change! No meaningful explanatory body
Why it was queued
second-pass: opaque commit message
AI analysis · Informational 15/100

This commit is purely a code-formatting cleanup. It removes a directive that told rustfmt to skip the file and then reformats the test code to match the project's style rules. No program logic, security behavior, or functionality was changed.

Lower-priorityFix claude-code-action CI failuresby Joost Jager · 1d172dca · Mar 12, 2026 · 1 fileMessage 88 · StrongInformational 15Details
Commit message · Joost Jager

Fix claude-code-action CI failures

Use pull_request_target to ensure secrets are available, and pass
github_token explicitly to avoid the OIDC token exchange flow.
See https://github.com/anthropics/claude-code-action/issues/649

AI tools were used in preparing this commit.

88/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode✓ Links an issue, advisory, or supporting reference
Why it was queued
documentation-only discount
AI analysis · Informational 15/100

This commit changes a GitHub Actions workflow so that an AI code-review bot receives an explicit GitHub access token. The stated goal is to fix a CI failure, but passing the default repository token to a third-party action can broaden what that action is able to do inside the repository. There is no evidence in the commit that this was done for malicious reasons or that the action misuses the token.

Lower-priorityEmit SpliceFailed for acceptor contributionsby Jeffrey Czyz · e93d43cf · Mar 11, 2026 · 2 filesMessage 68 · AdequateModerate 58Details
Commit message · Jeffrey Czyz

Emit SpliceFailed for acceptor contributions

The maybe_create_splice_funding_failed! macro only emitted SpliceFailed
and DiscardFunding events for the splice initiator. When an acceptor
contributed inputs/outputs and the negotiation failed (e.g., disconnect),
their contributions were silently discarded with no event notification,
preventing the acceptor from reclaiming its UTXOs.

Replace the is_initiator() filter with a post-hoc check on whether there
are contributions to discard. The initiator always gets events, the
acceptor gets events when it has contributions, and acceptors without
contributions get no events (nothing to discard).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Moderate 58/100

This commit fixes a bug in the Lightning Dev Kit's splicing code. When two Lightning nodes tried to update ('splice') a channel together and the negotiation failed, only the node that started the splice got a notification to reclaim its locked-up bitcoins. The other node (the 'acceptor') was silently left without any event, so its wallet software wouldn't know it needed to reclaim its contributed coins. The patch now emits the proper failure event for the acceptor too, but only when the acceptor actually contributed something.

Lower-priorityAdd claude code reviewingby Matt Corallo · 7b955db7 · Mar 11, 2026 · 1 fileMessage 66 · AdequateInformational 15Details
Commit message · Matt Corallo

Add claude code reviewing

We can tweak the prompt as we get experience, for now its just the
one copied
https://github.com/anthropics/claude-code-action/blob/main/docs/solutions.md

66/100 · AdequateMessage clarity
✓ Descriptive subject✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
Why it was queued
documentation-only discount
AI analysis · Informational 15/100

This commit adds a new GitHub Actions workflow that uses an Anthropic Claude AI assistant to automatically review pull requests. It is a CI/automation change, not a code change to the Lightning library itself. There is no direct security vulnerability in the diff, though any automated tool granted pull-request write permissions introduces a future supply-chain and permissions-management consideration.

AI review queuedTell claude to be DRYby Matt Corallo · 95488160 · Mar 10, 2026 · 1 fileMessage 38 · OpaqueInformational 15Details
Commit message · Matt Corallo

Tell claude to be DRY

38/100 · OpaqueMessage clarity
✓ Subject identifies a change✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
documentation-only discountsecond-pass: opaque commit message
AI analysis · Informational 15/100

This commit only adds a non-code guideline to a project documentation file (CLAUDE.md), instructing an AI coding assistant to avoid repeating code. It makes no changes to actual software, so it has no security effect on users of the project.

Lower-priorityClean up redundant steps in ci-tests-workspace.shby Joost Jager · b35a8498 · Mar 10, 2026 · 1 fileMessage 78 · AdequateInformational 15Details
Commit message · Joost Jager

Clean up redundant steps in ci-tests-workspace.sh

Replace the per-member cargo check + cargo doc loop with a single
`cargo doc --workspace` call. The per-member cargo check is redundant
with the workspace-level cargo check already run earlier in the script.
Also remove the separate `cargo test -p lightning-custom-message` which
is covered by the workspace-level cargo test.

Fix stale "except lightning-transaction-sync" echo messages, as it has
been a workspace member for a while now.

AI tools were used in preparing this commit.

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Informational 15/100

This commit is a routine cleanup of a CI shell script. It removes redundant test and documentation steps and updates stale log messages. There is no security relevance.

AI review queuedReject offer_amount of 0 as invalid per BOLT 12by Vincenzo Palazzo · a06c4469 · Mar 9, 2026 · 2 filesMessage 76 · AdequateLow 39Details
Commit message · Vincenzo Palazzo

Reject offer_amount of 0 as invalid per BOLT 12

Per the spec clarification in https://github.com/lightning/bolts/pull/1316:
- Writers MUST set offer_amount greater than zero when present
- Readers MUST NOT respond to offers where offer_amount is zero

Reject amount_msats(0) in the builder with InvalidAmount, and reject
parsed offers with amount=0 (with or without currency) during TLV
deserialization.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

76/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
Why it was queued
second-pass: broader security terminology
AI analysis · Low 39/100

This commit tightens validation of BOLT 12 Lightning offers so that an offer cannot specify a payment amount of zero. Previously, zero-amount offers could be built or parsed successfully, which the BOLT 12 specification now forbids. The change prevents users or automated systems from accidentally creating or accepting offers that request no payment, which could be used to confuse wallets, trigger unexpected behavior, or probe nodes.

Lower-priorityln: handle trampoline claims on restartby Carla Kirk-Cohen · 7b3d661a · Mar 9, 2026 · 1 fileMessage 80 · StrongLow 44Details
Commit message · Carla Kirk-Cohen

ln: handle trampoline claims on restart

This commit uses the existing outbound payment claims replay logic
to restore trampoline claims. If any single previous hop in a htlc
source with multiple previous hops requires claim, we represent this
with a single outbound claimed htlc because we assume that *all* of
the incoming htlcs are represented in the source, and will be
appropriately claimed (rather than submitting multiple claims, which
will end up being duplicates of each other). This is the case for
trampoline payments, where the htlc_source stores all previous hops.

80/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Low 44/100

This patch fixes a restart-related bug in how the Lightning node resumes claiming forwarded trampoline payments. Previously, after a restart, trampoline payments that needed to be claimed on-chain might not have been processed correctly because the code only looked at single-hop previous channels and ignored trampoline forwards that bundle multiple incoming hops. The fix reuses existing replay logic so those bundled incoming hops are also claimed. A user-visible effect could be that funds from a trampoline forward were temporarily stuck or not recovered automatically after a crash/restart.

Lower-priorityln: no longer support claims with missing counterparty_node_idby Carla Kirk-Cohen · bf106824 · Mar 9, 2026 · 1 fileMessage 73 · AdequateLow 41Details
Commit message · Carla Kirk-Cohen

ln: no longer support claims with missing counterparty_node_id

Move handling of payment replay into its own function and deprecate
old code that handled missing counterparty_node_id. By the time we
reach 0.3 we should have this data present.

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 41/100

This commit removes a fallback code path in LDK that previously tried to replay old Lightning payment claims even when the software didn't know which peer (counterparty) the claim was for. That missing information could cause crashes or unreliable behavior. Now, if the required peer ID is absent, LDK refuses to load the channel state and logs an error, forcing users to resolve those old forwards before upgrading. It is a hardening/cleanup change rather than a fix for an active exploit.

Lower-priorityln: add channel monitor recovery for trampoline forwardsby Maurice · f65e5d40 · Mar 9, 2026 · 1 fileMessage 65 · AdequateLow 41Details
Commit message · Maurice

ln: add channel monitor recovery for trampoline forwards

Implement channel monitor recovery for trampoline forwards
iterating over all hop data and updating pending forwards.

65/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides an explanatory body
AI analysis · Low 41/100

This commit fills in a previously unimplemented 'todo!' placeholder in the Lightning Dev Kit's channel recovery logic. When a node restarts and rebuilds its state from channel monitors, it now properly handles HTLCs (pending payments) that arrived as Trampoline forwards. Before this change, such forwards would have caused a panic during recovery, potentially preventing the node from restarting cleanly and possibly leaving forwarded payments stuck or lost.

Lower-priorityln/refactor: extract channelmonitor recovery to external helperby Maurice · bdac5ef6 · Mar 9, 2026 · 1 fileMessage 73 · AdequateInformational 14Details
Commit message · Maurice

ln/refactor: extract channelmonitor recovery to external helper

Move recovery logic for `HTLCSource::PreviousHopData` into
`channel_monitor_recovery_internal` to prepare for trampoline
forward reuse.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.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 straightforward code cleanup: it moves existing HTLC recovery logic into a new helper function without changing what the logic actually does. There is no visible security fix or behavior change.

Lower-priorityln: add trampoline routing failure handlingby Carla Kirk-Cohen · 4bcd0f60 · Mar 9, 2026 · 1 fileMessage 78 · AdequateLow 32Details
Commit message · Carla Kirk-Cohen

ln: add trampoline routing failure handling

Implement failure propagation for `HTLCSource::TrampolineForward`
by iterating through previous hop data and failing each HTLC with
`TemporaryTrampolineFailure`.

Note that testing should be implemented when trampoline forward is
completed.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.com>

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Low 32/100

This commit fills in a previously unimplemented 'todo!' placeholder for handling failed trampoline-routed payments. When a trampoline forward fails, the node now properly reports the failure back through each incoming payment hop using a standard temporary trampoline failure message, instead of crashing. This is a robustness improvement that prevents a panic path and ensures correct Lightning protocol behavior for an in-development feature.

Lower-priorityln/refactor: add blinded forwarding failure helper functionby Carla Kirk-Cohen · 4954de51 · Mar 9, 2026 · 1 fileMessage 73 · AdequateInformational 15Details
Commit message · Carla Kirk-Cohen

ln/refactor: add blinded forwarding failure helper function

We'll want this extracted when we need to handle trampoline and regular
forwards.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.com>

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 pure code cleanup: it extracts existing HTLC failure-handling logic into a new helper function and a small closure, with no functional changes. There is no security fix or behavior change visible in the diff.

Lower-priorityln: add trampoline routing payment claimingby Carla Kirk-Cohen · e25d97ce · Mar 9, 2026 · 1 fileMessage 80 · StrongLow 29Details
Commit message · Carla Kirk-Cohen

ln: add trampoline routing payment claiming

Implement payment claiming for `HTLCSource::TrampolineForward` by
iterating through previous hop data and claiming funds for each
HTLC. Similar to regular forwards, we need to block the outbound
channel's RAA on the inbound monitor persisting preimages received.
If we have multiple inbound HTLCs for trampoline, we'll add multiple
blockers so that we don't proceed until each inbound HTLC is claimable.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.com>

80/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Low 29/100

This commit finishes a previously unimplemented code path for 'trampoline routing' in the Lightning Dev Kit. Before this change, if a payment arrived via a trampoline forward, the software had a placeholder 'todo!()' where it should claim the funds. The commit adds the actual claiming logic, including safety checks that prevent the next channel step from proceeding until the incoming payment proof is durably saved. It is a feature-completion patch with defensive safety logic, not a fix for a known active vulnerability.

Lower-priorityln/refactor: pass closure to create PaymentForwarded eventby Carla Kirk-Cohen · 077aa088 · Mar 9, 2026 · 1 fileMessage 85 · StrongInformational 16Details
Commit message · Carla Kirk-Cohen

ln/refactor: pass closure to create PaymentForwarded event

When we introduce trampoline forwards, we're going to want to provide
two external pieces of information to create events:
- When to emit an event: we only want to emit one trampoline event, even
when we have multiple incoming htlcs. We need to make multiple calls
to claim_funds_from_htlc_forward_hop to claim each individual htlc,
which are not aware of each other, so we rely on the caller's closure
to decide when to emit Some or None.
- Forwarding fees: we will not be able to calculate the total fee for
a trampoline forward when an individual outgoing htlcs is fulfilled,
because there may be other outgoing htlcs that are not accounted for
(we only get the htlc_claim_value_msat for the single htlc that was
just fulfilled). In future, we'll be able to provide the total fee
from the channelmanager's top level view.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Informational 16/100

This commit is a code cleanup (refactor) inside the Lightning Dev Kit's channel manager. It moves the creation of a 'PaymentForwarded' event out of an internal helper function and into the caller by passing a closure. The actual logic for normal forwards is preserved unchanged; the change is preparing the code for future 'trampoline' forwarding support. There is no indication this fixes a security bug or introduces a vulnerability.

Lower-priorityln/refactor: add claim funds for htlc forward helperby Carla Kirk-Cohen · f70e6525 · Mar 9, 2026 · 1 fileMessage 73 · AdequateInformational 15Details
Commit message · Carla Kirk-Cohen

ln/refactor: add claim funds for htlc forward helper

Will need to share this code when we add trampoline forwarding. This
commit exactly moves the logic as-is, in preparation for the next
commit that will update to suit trampoline.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.com>

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 pure code reorganization (refactor) in the Lightning Dev Kit's channel manager. It extracts existing HTLC forwarding claim logic into a new helper function so the same code can be reused for an upcoming 'trampoline forwarding' feature. No behavior changes, bug fixes, or security-sensitive modifications are present in the diff.

Lower-priorityln: add failure_type helper to HTLCSource for HTLCHandlingFailureTypeby Carla Kirk-Cohen · bde040b1 · Mar 9, 2026 · 1 fileMessage 85 · StrongInformational 20Details
Commit message · Carla Kirk-Cohen

ln: add failure_type helper to HTLCSource for HTLCHandlingFailureType

To create the right handling type based on source, add a helper. This
is mainly useful for PreviousHopData/TrampolineForward. This helper
maps an OutboundRoute to a HTLCHandlingFailureType::Forward. This value
isn't actually used once we reach `forward_htlc_backwards_internal`,
because we don't emit `HTLCHandlingFailed` events for our own payments.
This issue is pre-existing, and could be addressed with an API change
to the failure function, which is left out of scope of this work.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
AI analysis · Informational 20/100

This commit is a small internal cleanup in a Lightning Network library. It adds a helper method so the code can pick the correct failure classification (regular forward vs. trampoline forward) based on where an HTLC came from, instead of always assuming a regular forward. The commit message explicitly says the wrong value for the node’s own outbound payments was already not used, so this is mostly preparatory/refactoring work rather than a fix for an active security bug.

Lower-priorityln: add TrampolineForward variant to HTLCSource enumby Maurice · 028b6370 · Mar 9, 2026 · 3 filesMessage 73 · AdequateLow 26Details
Commit message · Maurice

ln: add TrampolineForward variant to HTLCSource enum

We only have payment details for HTLCSource::TrampolineForward available
once we've dispatched the payment. If we get to the stage where we need
a HTLCId for the outbound payment, we expect dispatch details to be
present.

Co-authored-by: Arik Sosman <git@arik.io>
Co-authored-by: Maurice Poirrier <mpch@hey.com>

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Low 26/100

This commit adds a new internal bookkeeping variant called TrampolineForward to LDK's HTLCSource enum, which tracks Lightning payments being forwarded through a trampoline routing node. It also adds placeholder 'todo!()' stubs in several code paths that are not yet implemented for this new variant. The commit is part of ongoing trampoline-payment feature work and does not by itself fix a known security bug. The unimplemented stubs could, in theory, cause a panic if a trampoline forward reaches those code paths, but the commit message and diff treat this as expected incomplete functionality rather than a disclosed vulnerability.

Lower-priorityln: add TrampolineForward SendHTLCId variantby Carla Kirk-Cohen · 7bda2afb · Mar 9, 2026 · 1 fileMessage 68 · AdequateInformational 18Details
Commit message · Carla Kirk-Cohen

ln: add TrampolineForward SendHTLCId variant

This commit adds a SendHTLCId for trampoline forwards, identified by
their session_priv. As with an OutboundRoute, we can expect our HTLC
to be uniquely identified by a randomly generated session_priv.

TrampolineForward could also be identified by the set of all previous
outbound scid/htlc id pairs that represent its incoming HTLC(s). We
choose the 32 byte session_priv to fix the size of this identifier
rather than 16 byte scid/id pairs that will grow with the number of
incoming htlcs.

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
AI analysis · Informational 18/100

This commit adds a new internal identifier type for tracking forwarded Lightning payments that use Trampoline routing. It is a small, structural code change that does not appear to fix or introduce a security vulnerability on its own. It simply lets the software distinguish Trampoline forwards from other kinds of payment routes when recording which HTLCs were sent.