LDK
← All projectsLightning Dev Kit

rust-lightning

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

BitcoinCryptographic librariesLightning NetworkNormal
Repository coverage

1497 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.

225security candidates209second-pass queue1479AI analyses
74commits · 30 days
208commits · 60 days
663commits · 180 days
1491commits · 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.

69/100 average clarity
359Strong · 80–100
790Adequate · 60–79
288Thin · 40–59
60Opaque · 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 Corallo35847356473
Jeffrey Czyz17741177168
Wilmer Paulino14939149169
Leo Nash11613116162
Valentine Wallace13710135169
Vincenzo Palazzo10210184
Joost Jager16224162069
elnosh301330056
shaavan22622069
Carla Kirk-Cohen78366068
benthecarman18318071
Analysis record

Published AI watches

Last scanned 15 minutes ago

Low 32 AI analysisMessage 91 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Only fetch TXIDs instead of entire block during gossip verification' (#4846)

This commit changes how the Lightning Dev Kit's block-sync module verifies Lightning network gossip announcements. Instead of downloading entire Bitcoin blocks (which can be large), it now downloads only the list of transaction IDs for a b…

API surface change in UtxoSource traitReduced data exposure: no longer fetches full blocks for gossip verificationNew JSON parsing for txid lists and TxOut values
ebe7a447by Matt Corallo+275−1025 files
No security note in commit
Low 35 AI analysisMessage 81 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Merge PR 'Allow filtered block rescans at the current tip' (#4847)

This commit changes how the Lightning Dev Kit (LDK) node software handles receiving the same block twice through its filtered-block interface. Previously, calling filtered_block_connected with the current tip again would trigger an asserti…

Assertion relaxation in block connection pathPotential denial-of-service vector removed: previously a malicious or buggy filter provider could crash the node by replaying the current tipNew test coverage for same-block filtered rescan
54ddbd0bby Matt Corallo+177−486 files
No security note in commit
Informational 15 AI analysisMessage 83 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Add test framework coverage of `Listen` block connection replays

This commit only adds a new test mode to the project's internal testing framework. It lets developers simulate a specific way blocks are delivered to the Lightning node (a 'replay' through the Listen interface) so that behavior is covered …

bf6ad23eby Matt Corallo+18−32 files
No security note in commit
Informational 15 AI analysisMessage 83 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Update functional test block connection to detect block replays

This commit changes only internal test helper code in the Lightning Dev Kit repository. It makes the functional test framework smarter about 'block replays'—situations where the same block is fed to a test node more than once—so the fake b…

No production code modifiedNo cryptographic, consensus, or networking changesCommit message frames change as test-framework correctness, not security
477facb4by Matt Corallo+41−333 files
No security note in commit
Moderate 66 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Correct HTLC confusion on unrevoked counterparty commitment txs

This patch fixes a bug in the Lightning Dev Kit where the software could confuse HTLCs (payment contracts) on live, unrevoked counterparty commitment transactions with ones from old, revoked transactions. Previously, it relied only on whet…

Incorrect revocation state detection for counterparty commitment transactionsHTLC direction not previously checked when matching against pending HTLCsPromotion of debug assertions to full assertions for HTLC claim path consistency
f06a08a6by Matt Corallo+26−192 files
Vendor flagged security relevance
Low 47 AI analysisMessage 85 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Return `Err`s` instead of panicking on oversized messages

This commit changes how the Lightning networking code handles oversized encrypted messages. Previously, certain conditions would cause the program to crash with a panic. Now the code returns errors instead, which is a defensive improvement…

panic-to-error conversion for oversized message encryption/decryptiondenial-of-service hardening against oversized peer messagesdebug_assert retained to preserve test coverage of invariant violations
08f12bc7by Matt Corallo+68−313 files
Vendor flagged security relevance
Moderate 62 AI analysisMessage 85 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Avoid panicking when attempting to send an oversized message

This commit fixes a crash bug in the Lightning Dev Kit's peer message handling. Previously, if a message grew too large to be sent over the encrypted peer connection, the code would panic (abruptly terminate the whole program). The patch m…

Replaces a `.expect()` panic path with a fallible `Result` in peer message encryptionAdds graceful peer disconnection when a critical message cannot be sentIncludes a regression test for oversized-message handling
c5fdc3bfby Matt Corallo+148−901 file
Vendor flagged security relevance
High 74 AI analysisMessage 78 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Avoid oversized relayed failure messages

This patch fixes a crash bug in the Lightning Dev Kit's handling of HTLC failure messages. A downstream peer could send a maximally-sized failure message without attribution data. When the node added its own attribution data while relaying…

Denial-of-service via remote-triggered panic in message encryptionOversized message exceeding Noise/Lightning wire framing limitMissing length validation before adding attribution data during relay
6b1dfb1aby Matt Corallo+64−191 file
Vendor flagged security relevance
Moderate 64 AI analysisMessage 83 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Reject attempts to advance one-hop blinded forward paths

This commit fixes a denial-of-service bug in rust-lightning where a maliciously crafted one-hop blinded reply path could cause the node to panic when it tried to respond. The fix rejects paths with too few hops before advancing them, and a…

Denial-of-service vector via malformed blinded pathPanic in onion construction due to zero-hop pathUntrusted reply path input validation gap
969a40cfby Matt Corallo+49−14 files
Vendor flagged security relevance
High 72 AI analysisMessage 96 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

lightning-types: replace Zl/Zp separators in `PrintableString`

This commit fixes a log-forgery risk in a Rust Lightning library helper called PrintableString. That helper is meant to make untrusted text safe to print by replacing dangerous characters with a placeholder. It already caught most control …

log injection / log forgery via U+2028/U+2029 line separatorsincomplete input sanitisation in PrintableStringpeer-controlled strings (node alias, BOLT 12 description/issuer/payer_note, peer_msg) as attack surface
75defa9cby Vincenzo Palazzo+63−83 files
Vendor flagged security relevance
Moderate 69 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Apply the unfunded channel peer limit to all unaccepted channels

This commit fixes a rate-limiting bug in the Lightning Dev Kit (LDK) that let a single peer bypass the cap on how many different peers can have unfunded (not-yet-funded) channels open. Previously, if a peer sent multiple channel requests q…

Denial-of-service resource exhaustion via rapid inbound channel open requestsLogic error in rate-limiting conditionRegression test added for the bypass scenario
56a4ee43by Matt Corallo+87−62 files
Vendor flagged security relevance
Moderate 60 AI analysisMessage 88 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Allow filtered block rescans at the current tip

This commit fixes a bug where replaying the current blockchain block through a normal listener callback could crash two core Lightning components (ChannelManager and OutputSweeper) with a panic. The fix recognizes a same-block replay as a …

panic in chain listener callbacksame-block replay/rescan mishandlingassertion failure on valid chain input
686f9860by Elias Rohrer+118−123 files
Vendor flagged security relevance
Moderate 57 AI analysisMessage 78 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Avoid panic when reorged claims cannot merge

This commit fixes a crash bug in the Lightning Dev Kit's on-chain transaction handler. During a deep blockchain reorganization, a previously settled HTLC claim could be 'resurrected' at a block height where it could no longer be combined w…

Assertion/panic in reorg handling pathDeep blockchain reorg as trigger conditionHTLC claim resurrection after reorg
f1dc8487by Matt Corallo+219−52 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 45 · Thin
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Update crate repository links to forgejo

This commit simply updates the 'repository' web links in 15 package metadata files from GitHub to a self-hosted Forgejo instance. It does not change any program code, build logic, dependencies, or security behavior. There is no security is…

eb77676dby benthecarman+15−1515 files
No security note in commit
Low 45 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Account for message type prefix len in prevtx length enforcement

This commit fixes a small but real accounting bug in how rust-lightning checks whether a previous transaction (prevtx) attached to a funding input will make the resulting Lightning wire message too large. The code previously compared the m…

Off-by-constant length check in protocol message size enforcementPotential acceptance of a prevtx that produces an oversized Lightning wire messageDenial-of-service / protocol-interop risk from peer message rejection
d29e1415by Wilmer Paulino+21−41 file
No security note in commit
Moderate 54 AI analysisMessage 73 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Retransmit splice_locked for 0-conf channels missing tx_signatures

This commit fixes a bug in the Lightning Dev Kit where, after a disconnection, a node could fail to retransmit a 'splice_locked' message to a peer that was still waiting for transaction signatures. Without this retransmission, the two peer…

Protocol state desynchronization between channel peers after reconnectionMissing retransmission of splice_locked for 0-conf splice channelsPotential channel unusability or stuck splice negotiation
5434015bby Wilmer Paulino+266−12 files
No security note in commit
Low 37 AI analysisMessage 83 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

bolt12: add pay_for_bolt12_invoice for externally-sourced invoices

This commit adds a new API, pay_for_bolt12_invoice, that lets users pay a BOLT 12 invoice even if LDK did not originally request it. It is intended for advanced use cases like multi-sender payments and replaces an older, more restrictive A…

New API removes internal invoice-origin verification, shifting trust boundary to callerDocumentation explicitly warns caller to verify invoice via Bolt12Invoice::verify_using_metadata and to ensure unique payment_id to avoid duplicate paymentsInput validation added for zero amount, overpay, and partial-amount-without-MPP
5b80fe9cby Alkamal01+550−156 files
No security note in commit
Low 26 AI analysisMessage 90 · Strong
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Include to_self_delay size in DelayedPaymentOutput weight calculation

This commit fixes a small accounting bug in how the Lightning wallet estimates the size (and therefore transaction fee) of a special Bitcoin transaction that sweeps funds back to the user after a channel closes. The old code always assumed…

debug assertion failure possible in development/testing buildstransaction weight/fee estimate overestimation up to 3 WUconstant replaced with per-descriptor length computation
e6652237by Matt Morehouse+97−83 files
No security note in commit
Informational 18 AI analysisMessage 65 · Adequate
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

Correct docs on `ChannelSigner::get_per_commitment_point`

This commit only updates documentation comments for a Rust function called get_per_commitment_point. It removes an outdated warning that the method was non-asynchronous and that returning an error could cause a crash, and replaces it with …

Documentation-only changeRemoves outdated panic warningAdds retry/unblock guidance for signer errors
5057809bby Matt Corallo+6−31 file
No security note in commit
Informational 16 AI analysisMessage 35 · Opaque
LDK Lightning Dev Kitrust-lightning BitcoinCryptographic librariesLightning Network

ln/refactor: remove BlindedTrampolineEntrypoint

This commit is a small internal code cleanup in the Lightning Dev Kit's Trampoline routing code. It removes a separate 'BlindedTrampolineEntrypoint' payload variant and folds an optional blinding point into the existing 'Forward' variant. …

Refactor-only change with no added bounds checks or validationNo mention of vulnerability, CVE, security fix, or bug in commit messageTLV field changed from required to optional, but only for a newly unified variant used in internal construction
3e0c2697by Carla Kirk-Cohen+8−263 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-priorityConstruct outbound OMs before enqueueing themby Valentine Wallace · 332b3e59 · Sep 24, 2025 · 1 fileMessage 68 · AdequateInformational 12Details
Commit message · Valentine Wallace

Construct outbound OMs before enqueueing them

Makes the next commit cleaner when we add support for forwarding onion messages
within send_onion_message_internal. Also rename enqueue_onion_message to
specify that it is used for outbound onion messages.

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

This commit is a straightforward internal code reorganization in the onion messaging module. It moves the construction of outbound onion messages to happen before they are placed in a send queue, and renames a helper function to clarify it handles outbound traffic. There is no indication of a security fix or behavior change.

Lower-priorityExtract util to forward onion messagesby Valentine Wallace · 912f3c21 · Sep 24, 2025 · 2 filesMessage 68 · AdequateInformational 18Details
Commit message · Valentine Wallace

Extract util to forward onion messages

In an upcoming commit, we will need to repurpose this logic when, as a static
invoice server node, we update our support for forwarding invoice requests from
payers to often-offline recipients. We currently treat these forwarded invreqs
as outbound onion messages that are initiated by our node, when they should
really be treated as forwarded onion messages.

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

This commit is a code cleanup: it pulls out the logic for forwarding onion messages into a reusable helper function. The behavior is essentially unchanged, except log messages now include the original sender's node ID for better debugging. There is no indication this fixes or introduces a security vulnerability.

Lower-priorityInvoice server: treat forwarded invreqs as OM forwardsby Valentine Wallace · 2460c465 · Sep 24, 2025 · 5 filesMessage 73 · AdequateModerate 62Details
Commit message · Valentine Wallace

Invoice server: treat forwarded invreqs as OM forwards

Previously, when a static invoice server forwarded an invoice request to an
often-offline recipient, they would treat the outbound message like any other
outbound onion message initiated by their own node. That means they would
buffer the onion message internally in the onion messenger and generate a
ConnectionNeeded event if the next-hop node was offline.

Buffering the onion message in this case poses a DoS risk for the invoice
server node, since they do not control the quantity of invoice requests they
receive on behalf of often-offline recipients. Instead, we should treat these
forwarded invoice requests like any other onion message that needs to be
forwarded -- if the next-hop node is offline, either drop the message or
generate an OnionMessageIntercepted event for it (pushing the DoS management
onto the handler of the interception event).

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

This change fixes a denial-of-service (DoS) risk in the Lightning Dev Kit's 'static invoice server' feature. Previously, when an invoice server forwarded a request to an often-offline recipient, it would internally buffer those messages and try to connect to the offline node, which could pile up and overwhelm the server. Now these forwarded requests are handled like normal onion message forwards: if the next hop is offline, the message is either dropped or handed off to the user via an interception event, pushing the DoS management burden onto the user instead of the server node.

Lower-priorityLog `PublicKey`s as `Display`, not `Debug`by Elias Rohrer · adc8a876 · Sep 24, 2025 · 7 filesMessage 45 · ThinInformational 19Details
Commit message · Elias Rohrer

Log `PublicKey`s as `Display`, not `Debug`

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 19/100

This commit changes how public keys appear in log and error messages. Previously they were logged using Rust's Debug format, which prints raw byte arrays. Now they use the Display format, which prints the standard readable string form of a public key. This is a code-quality and readability improvement; it does not fix a security vulnerability and does not change program behavior beyond log formatting.

Lower-prioritySkip `LSPS5ServiceHandler` persistence if unnecessaryby Elias Rohrer · 86523057 · Sep 24, 2025 · 1 fileMessage 65 · AdequateInformational 19Details
Commit message · Elias Rohrer

Skip `LSPS5ServiceHandler` persistence if unnecessary

.. we only persist the service handler if necessary.

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

This commit is a performance and robustness improvement for the LSPS5 service handler in rust-lightning. It adds a 'needs_persist' flag so that peer state is only written to disk when something has actually changed, rather than on every persistence call. It also handles the case where a peer's state has already been dropped, returning success instead of an error. There is no direct evidence in the commit or supplied references that this fixes an active security vulnerability.

Lower-priorityAdd test asserting LSPS5 service state is persisted across restartsby Elias Rohrer · 52aa2864 · Sep 24, 2025 · 1 fileMessage 83 · StrongInformational 14Details
Commit message · Elias Rohrer

Add test asserting LSPS5 service state is persisted across restarts

We add a simple test that runs the LSPS5 flow, persists, and ensures we
recover the service state after reinitializing from our `KVStore`.

83/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Informational 14/100

This commit only adds a new automated test to the project. It checks that a service's webhook registration state survives a restart when using a persistent key-value store. There are no changes to production code, no bug fixes, and no security-related behavior changes.

Lower-priorityRemove pruned LSPS2/LSPS5 peer state entries from the `KVStore`by Elias Rohrer · f70a9021 · Sep 24, 2025 · 3 filesMessage 73 · AdequateLow 35Details
Commit message · Elias Rohrer

Remove pruned LSPS2/LSPS5 peer state entries from the `KVStore`

Previously, we'd persist peer states to the `KVStore`, but, while we
pruned them eventually from our in-memory state, we wouldn't remove it
from the `KVStore`.

Here, we change this and regularly prune and delete peer state entries
from the `KVStore`.
Note we still prune the state-internal data on peer disconnection, but
leave removal to our (BP-driven) async `persist` calls.

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

This change fixes a cleanup bug in a Lightning liquidity service. Previously, when peer state was pruned from memory, the corresponding saved data was left behind in the persistent key-value store. Over time this could accumulate stale entries and potentially allow old or expired peer data to be reloaded after a restart. The patch now deletes those stale store entries during regular persistence cycles.

Lower-priorityMention `user_channel_id` uniqueness in `invoice_params_generated` docsby Elias Rohrer · 454f0e62 · Sep 24, 2025 · 1 fileMessage 65 · AdequateInformational 15Details
Commit message · Elias Rohrer

Mention `user_channel_id` uniqueness in `invoice_params_generated` docs

We update the docs of `invoice_params_generated` and mention that
`user_channel_id` needs to be unique value.

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

This commit only changes documentation comments in a Rust source file. It adds a note reminding developers that a user-supplied identifier (user_channel_id) must be unique and that channel creation should be idempotent based on it. No code behavior was changed, so there is no direct security vulnerability or fix in the commit itself.

Lower-priorityAdd inline persistence with async `LSPS2ServiceHandler` API methodsby Elias Rohrer · a72bbeec · Sep 24, 2025 · 1 fileMessage 65 · AdequateLow 32Details
Commit message · Elias Rohrer

Add inline persistence with async `LSPS2ServiceHandler` API methods

.. and wrap them accordingly for the `LSPS2ServiceHandlerSync` variant.

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

This commit changes several LSPS2 (a Lightning service protocol) API methods from synchronous to asynchronous so they can save peer state to disk inline, right when state changes. It also adds synchronous wrapper methods that immediately poll the new async versions. The change is a reliability improvement: it makes sure state is persisted before returning, reducing the chance of losing track of a payment or channel if the program crashes. There is no direct evidence in the commit that this fixes a security vulnerability, but inconsistent persistence can lead to loss-of-funds or state-confusion bugs in Lightning nodes.

Lower-priorityAdd test asserting LSPS2 service state is persisted across restartsby Elias Rohrer · 2983178c · Sep 24, 2025 · 2 filesMessage 83 · StrongInformational 15Details
Commit message · Elias Rohrer

Add test asserting LSPS2 service state is persisted across restarts

We add a simple test that runs the LSPS2 flow, persists, and ensures we
recover the service state after reinitializing from our `KVStore`.

83/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Informational 15/100

This commit only adds a new automated test to verify that LSPS2 service state survives a restart when stored in a key-value store. It does not change production code behavior, fix a bug, or introduce any security-relevant change. There is no indication of a vulnerability or security issue in the commit itself.

Lower-priorityAdd `LSPS5ServiceHandler` persistenceby Elias Rohrer · d0760a29 · Sep 24, 2025 · 3 filesMessage 58 · ThinInformational 19Details
Commit message · Elias Rohrer

Add `LSPS5ServiceHandler` persistence

We add simple `persist` call to `LSPS5ServiceHandler` that sequentially
persist all the peer states under a key that encodes their node id.

58/100 · ThinMessage clarity
✓ Descriptive subject✓ Provides detailed explanatory context
AI analysis · Informational 19/100

This commit adds a save-to-disk feature for a new Lightning service protocol (LSPS5) so that webhook registration state is not lost when the program restarts. It is a routine reliability improvement, not a security fix, and does not change any access controls or cryptographic behavior.

Lower-priorityRead persisted LSPS2 service state in `LiquidityManager::new`by Elias Rohrer · 651d4df9 · Sep 24, 2025 · 6 filesMessage 65 · AdequateLow 30Details
Commit message · Elias Rohrer

Read persisted LSPS2 service state in `LiquidityManager::new`

We read any previously-persisted state upon construction of
`LiquidityManager`.

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

This commit changes how the Lightning Dev Kit liquidity manager starts up: it now reads previously saved LSPS2 service state from disk when created. Previously, the manager started with empty in-memory state even if data had been saved, which could cause it to lose track of active liquidity requests and routing information after a restart. The change also makes the constructors return errors if the saved data is corrupt or inconsistent, rather than silently starting fresh. This is a reliability and data-integrity improvement, not a typical remote-exploitable vulnerability.

Lower-priorityAdd `EventQueue` persistenceby Elias Rohrer · 88a3cf5b · Sep 24, 2025 · 16 filesMessage 50 · ThinLow 34Details
Commit message · Elias Rohrer

Add `EventQueue` persistence

We add simple `persist` call to `EventQueue` that persists it under a
`event_queue` key.

50/100 · ThinMessage clarity
✓ Descriptive subject✓ Provides an explanatory body
AI analysis · Low 34/100

This commit adds the ability to save (persist) the LiquidityManager's event queue to disk so events survive application restarts. It is a feature commit, not a security patch. Most event types are explicitly documented as not persisted, while LSPS2 'OpenChannel' and LSPS5 'SendWebhookNotification' events are now saved and replayed after restart. The code includes safety notes warning callers to make their channel-opening logic idempotent because persisted events may be replayed.

Lower-priorityAdd `LSPS2ServiceHandler` persistenceby Elias Rohrer · bf6d4084 · Sep 24, 2025 · 4 filesMessage 58 · ThinInformational 24Details
Commit message · Elias Rohrer

Add `LSPS2ServiceHandler` persistence

We add simple `persist` call to `LSPS2ServiceHandler` that sequentially
persist all the peer states under a key that encodes their node id.

58/100 · ThinMessage clarity
✓ Descriptive subject✓ Provides detailed explanatory context
AI analysis · Informational 24/100

This commit adds a new save-to-disk feature for the LSPS2 service handler in the Lightning Dev Kit's liquidity module. It makes the handler remember peer state across restarts by writing it to a key-value store. There is no direct security bug visible in the diff, but the change introduces new code paths that handle locks, serialization, and storage, and it removes the kv_store field from the top-level LiquidityManager in favor of embedding it inside the handler. A small typo in a doc comment was also introduced.

Lower-priorityRead persisted LSPS5 service state in `LiquidityManager::new`by Elias Rohrer · aceb3c1f · Sep 24, 2025 · 3 filesMessage 65 · AdequateLow 25Details
Commit message · Elias Rohrer

Read persisted LSPS5 service state in `LiquidityManager::new`

We read any previously-persisted state upon construction of
`LiquidityManager`.

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

This commit fixes a bug where the LSPS5 service (a liquidity service feature) was not reloading previously saved peer state when the LiquidityManager was restarted. Previously, after a restart, any stored webhook or peer settings could be forgotten, potentially causing service inconsistencies. Now the code reads saved state from disk during startup, similar to how LSPS2 state was already being handled.

Lower-priorityRead persisted event queue state in `LiquidityManager::new`by Elias Rohrer · 6a01d75d · Sep 24, 2025 · 6 filesMessage 65 · AdequateLow 31Details
Commit message · Elias Rohrer

Read persisted event queue state in `LiquidityManager::new`

We read any previously-persisted state upon construction of
`LiquidityManager`.

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

This commit fixes a bug where the LiquidityManager would start with an empty event queue after a restart, even if important events had been saved to disk before shutdown. Now it reads the saved queue when it starts up, so no events are lost. This is a reliability/correctness fix rather than a typical security vulnerability.

Lower-priorityHave background processor task drive `LiquidityManger` persistenceby Elias Rohrer · 5fb21bdf · Sep 24, 2025 · 6 filesMessage 73 · AdequateLow 27Details
Commit message · Elias Rohrer

Have background processor task drive `LiquidityManger` persistence

We let the background processor task regularly call
`LiquidityManger::persist`. We also change the semantics of the `Future`
for waking the background processor to also be used when we need
repersisting (which we'll do in the next commit).

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

This commit changes how the background processor saves the LiquidityManager's state to disk. Previously, the LiquidityManager's persistence was not driven by the regular background task, which could lead to state not being saved promptly. The patch adds a new background persistence call and changes the wake-up signal so it also fires when the LiquidityManager needs to be repersisted. This is a reliability improvement that reduces the risk of losing or getting inconsistent LiquidityManager state after a crash or restart.

Lower-prioritySkip `EventQueue` persistence if unnecessaryby Elias Rohrer · 179420c0 · Sep 24, 2025 · 4 filesMessage 60 · AdequateInformational 17Details
Commit message · Elias Rohrer

Skip `EventQueue` persistence if unnecessary

.. we only persist the event queue if necessary and wake the BP to do so
when something changes.

60/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides an explanatory body
AI analysis · Informational 17/100

This change is a performance and reliability optimization, not a security fix. It teaches the liquidity service's event queue to skip writing to disk when nothing has changed, and to wake the background persister only when a save is actually needed. Previously, the queue may have been persisted repeatedly even when unchanged. The patch also ensures that if a persistence write fails, the system marks the queue as needing to be saved again so it won't lose data.

Lower-prioritySkip `LSPS2ServiceHandler` persistence if unnecessaryby Elias Rohrer · 631d3f01 · Sep 24, 2025 · 1 fileMessage 65 · AdequateInformational 20Details
Commit message · Elias Rohrer

Skip `LSPS2ServiceHandler` persistence if unnecessary

.. we only persist the service handler if necessary.

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

This commit is a performance and reliability optimization for the LSPS2 (Lightning Service Provider Specification 2) service handler in rust-lightning. It adds a flag so the code only writes peer state to disk when something has actually changed, instead of writing it every time. If a write fails, it marks the state as needing to be saved again later. There is no direct security vulnerability being fixed here; it is mainly about avoiding unnecessary disk writes and making sure failed writes are retried.

Lower-priorityAdd `LSPS2ServiceHandlerSync` wrapperby Elias Rohrer · 01a94e68 · Sep 24, 2025 · 2 filesMessage 50 · ThinInformational 18Details
Commit message · Elias Rohrer

Add `LSPS2ServiceHandlerSync` wrapper

.. to allow access in a non-async context

50/100 · ThinMessage clarity
✓ Descriptive subject✓ Provides an explanatory body
AI analysis · Informational 18/100

This commit adds a thin synchronous wrapper around an existing asynchronous LSPS2 service handler in the Lightning Dev Kit's liquidity module. It does not change any security logic, cryptography, or network behavior; it only exposes the same methods in a non-async API style. There is no indication this fixes or introduces a vulnerability.

Lower-priorityImplement serialization for LSPS2 state typesby Elias Rohrer · 53ebf780 · Sep 24, 2025 · 5 filesMessage 45 · ThinInformational 15Details
Commit message · Elias Rohrer

Implement serialization for LSPS2 state types

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 15/100

This commit adds data-saving (serialization) support for internal LSPS2 state types in the lightning-liquidity crate. It does not change network behavior, fix a bug, or alter security checks. It is a routine feature addition that enables these objects to be written to disk or restored later.

Lower-priorityLet `LiquidityManager` take a `KVStore` and add `Sync` wrapperby Elias Rohrer · 0f4db0da · Sep 24, 2025 · 7 filesMessage 85 · StrongInformational 15Details
Commit message · Elias Rohrer

Let `LiquidityManager` take a `KVStore` and add `Sync` wrapper

We add `KVStore` to `LiquidityManager`, which will be used in the next
commits. We also add a `LiquidityManagerSync` wrapper that wraps a the
`LiquidityManager` interface which will soon become async due to usage
of the async `KVStore`.

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 15/100

This commit is a routine internal refactor for the rust-lightning project. It adds a key-value store parameter to the LiquidityManager component and introduces a synchronous wrapper (LiquidityManagerSync) so existing code can keep using the manager while the underlying implementation becomes asynchronous. There is no indication of a security fix or vulnerability being addressed.

Lower-priorityImplement serialization for LSPS5 state typesby Elias Rohrer · ede58985 · Sep 24, 2025 · 3 filesMessage 45 · ThinInformational 20Details
Commit message · Elias Rohrer

Implement serialization for LSPS5 state types

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
AI analysis · Informational 20/100

This commit adds serialization support for LSPS5 (webhook-related) state types so they can be saved to disk and restored. It is a routine feature patch: it makes app names, webhook URLs, webhook records, and peer state persistable. There is no direct evidence in the commit that this fixes an active security bug, but adding serialization can indirectly improve reliability and reduce state-loss risks.

Lower-priorityAdd symlink for `async_poll.rs`by Elias Rohrer · 29e4aeb8 · Sep 24, 2025 · 3 filesMessage 60 · AdequateInformational 15Details
Commit message · Elias Rohrer

Add symlink for `async_poll.rs`

.. this is likely only temporary necessary as we can drop our own
`dummy_waker` implementation once we bump MSRV.

60/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides an explanatory body
AI analysis · Informational 15/100

This commit adds a symbolic link (a file that points to another file) so that a shared helper file can be reused between two Rust crates. It also adjusts the helper's imports to work in both crates. There is no security-relevant change here.

Lower-priorityEmit DiscardFunding event when no splice transaction confirmsby Wilmer Paulino · aa912ce5 · Sep 24, 2025 · 2 filesMessage 85 · StrongLow 42Details
Commit message · Wilmer Paulino

Emit DiscardFunding event when no splice transaction confirms

When adding support for emitting these events in the channel monitor, we
only covered the case where one of the splice transaction candidates
confirmed. We also need to emit an event when none of them can confirm
due to a commitment transaction confirming (and no longer under reorg
risk) for the pre-splice funding.

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 42/100

This commit fixes a missing notification in the Lightning Dev Kit's channel monitoring logic. When a splice (a planned funding change) never confirms on the blockchain and instead the original commitment transaction confirms, the software now emits a 'DiscardFunding' event. Previously, this event was only emitted when one of the splice candidates confirmed. Without this event, wallets or users relying on it to stop watching or clean up unconfirmed splice funding transactions could leave those transactions being monitored indefinitely, potentially causing confusion, wasted resources, or delayed cleanup.