EP
← All projectsElements Project

Core Lightning

Modular C implementation of the Lightning Network protocol and node stack.

BitcoinLightning NetworkActive incident
Repository coverage

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

184security candidates280second-pass queue1894AI analyses
26commits · 30 days
185commits · 60 days
659commits · 180 days
1641commits · 365 days
Backfill bands
Aug 5 → Feb 61049 seen37 candidatesComplete
Feb 6 → Jun 6579 seen10 candidatesComplete
Jun 6 → Jul 678 seen1 candidatesComplete
Jul 6 → Aug 5147 seen16 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.

71/100 average clarity
484Strong · 80–100
1224Adequate · 60–79
241Thin · 40–59
30Opaque · 0–39
Read the scoring rubric →
Developer activity

Who is changing the project?

Public Git author strings; identities are not independently verified.

DeveloperCommitsCandidatesAnalyzedHigh riskMessage avg.
cdecker14910384
Níckolas Goline63844277
Rusty Russell96475958172
daywalker90113895164
Lagrang386578170
Vincenzo Palazzo13411182
dovgopoly15015164
Sangbida Chaudhuri14931146066
Dusty Daemon821378066
ShahanaFarooqui931093063
Peter Neuroth1024101071
Christian Decker36436072
Analysis record

Published AI watches

Last scanned 1 hour, 2 minutes ago

Informational 15 AI analysisMessage 73 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

contrib: add jaonoctus's signing key

This commit simply adds a new person's PGP public-key fingerprint to the list of trusted release signers in two documentation files. It does not change any code, fix any bug, or alter any security behavior of the software itself.

41278b4eby jaonoctus+2−02 files
No security note in commit
Informational 15 AI analysisMessage 73 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

wallet: fixed timestamps for invented bookkeeper deposits

This is a tiny internal fix to make a bookkeeping migration produce stable event ordering. It changes the timestamp used when creating historical 'deposit' records during a one-time database migration, so the records sort consistently with…

498e5086by daywalker90+2−01 file
No security note in commit
Informational 21 AI analysisMessage 85 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

docs: document missing and fix erroneous JSON-RPC error codes

This commit is a documentation-only cleanup of the JSON-RPC command help files. It corrects which numeric error codes are listed for each command so the published schemas match what the software actually returns. No program logic, validati…

Documentation-only change with no executable code modificationsCorrects RPC schema error-code metadata to match actual handler behaviorNo change to input parsing, authorization, cryptography, or network behavior
d1b6963bby daywalker90+204−1224 files
No security note in commit
Low 46 AI analysisMessage 73 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

channeld: initialize tx_sigs_allowed on startup

This commit fixes a bug where a setting that controls whether unexpected transaction signatures are allowed was not initialized when the channel daemon starts. If a peer sent such signatures before the channel was fully ready, the program …

use of uninitialized variableundefined behavior (invalid bool load)network-triggered code path
c09c4520by Erick Cestari+1−01 file
No security note in commit
Informational 15 AI analysisMessage 100 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

ci: fix the coverage nightly's profile handling

This commit fixes the project's internal nightly code-coverage CI workflow. It changes how test coverage files are collected, ensures the same LLVM compiler version is used to generate and merge coverage data, and uploads a Codecov-compati…

5685c9a3by cdecker+12−211 file
No security note in commit
Low 37 AI analysisMessage 78 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

schemas: make required fields match the code

This commit is a large cleanup of Core Lightning's API schemas, generated RPC bindings, and related plugin code. The stated goal is to make the documented 'required' fields match what the C code actually always produces or expects. In prac…

Large schema-only change with no accompanying security advisory or CVEOne semantic change to plugin hook response: invoice_payment hook can now reject with only failure_message and no resultMany fields change from optional to required in public RPC/protobuf interfaces
ddbd2963by daywalker90+1786−173950 files
No security note in commit
Informational 15 AI analysisMessage 73 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

doc: document error 313 on every command which can return it

This commit only updates documentation. It adds error code 313 to the documented error lists for several Core Lightning commands (fundpsbt, utxopsbt, txprepare, multiwithdraw, and upgradewallet). The error code already existed in the code …

a34b9758by Peter Neuroth+30−86 files
No security note in commit
Low 25 AI analysisMessage 88 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

tools/build-release.sh: name the checksum file when verifying the signature

This commit fixes a release-script check that verifies the cryptographic signature on a file of checksums. Previously, the script only told GPG to verify the signature file itself. If someone replaced that signature file with an inline-sig…

Incorrect cryptographic verification logic in release toolingPotential false-positive signature verification with inline-signed .asc substitutionRelease-integrity hardening
8e495707by Peter Neuroth+5−21 file
No security note in commit
Low 42 AI analysisMessage 95 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

doc: pass the manifest explicitly to gpg --verify

This commit updates Core Lightning's release documentation to tell users and release managers to run gpg --verify with both the signature file and the manifest file named explicitly. The old one-argument form can silently succeed even if t…

Verification bypass risk in release artifact validationgpg --verify single-argument form can exit 0 without reading the intended manifestDocumentation-only hardening of release process
2dee8699by Peter Neuroth+9−62 files
Vendor flagged security relevance
Low 25 AI analysisMessage 58 · Thin
EP Elements ProjectCore Lightning BitcoinLightning Network

Cargo.lock: update dependencies

This commit is a routine update to the Rust dependency lock file (Cargo.lock), bumping many third-party libraries to newer patch or minor versions. The commit message gives no security reason for the update, and no verified references link…

Routine dependency refresh with no stated security rationaleUpdates to security-sensitive transitive crates (rustls, hyper, h2, tokio, webpki-roots) but no evidence these versions fix known vulnerabilitiesNo source-code changes or patch-specific fixes visible in the diff
c1551c55by daywalker90+298−2761 file
No security note in commit
High 80 AI analysisMessage 85 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

common: bound JSON nesting depth when parsing

This commit fixes a stack-overflow risk in Core Lightning's JSON parser. Before the fix, an attacker could send a valid JSON-RPC message containing thousands of nested brackets or braces. The parser's own helper functions used recursion fo…

Stack-overflow via deeply nested JSONRecursive JSON traversal without depth boundDenial-of-service vector in JSON-RPC input parsing
83f92e4bby Níckolas Goline+90−22 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 28 · Opaque
EP Elements ProjectCore Lightning BitcoinLightning Network

common: minor typo fixes

This commit only fixes typos and comment style. It changes two C-style comments from // to /* */ and corrects a grammar error in a documentation comment ('element' to 'elements'). There are no code behavior changes, no bug fixes, and no se…

273d7f02by w3lld1+3−32 files
No security note in commit
Informational 20 AI analysisMessage 90 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

pyln-testing: truncate long testnames

This change fixes a test-infrastructure bug in Core Lightning's Python testing helpers. When running tests against a PostgreSQL database, very long test names could be silently shortened by PostgreSQL, causing different test runs or nodes …

No security-relevant signal: change is in test framework code onlyFixes a test reliability issue, not a runtime vulnerabilityNo input sanitization, authentication, cryptography, or network changes
c4fe4cbaby Peter Neuroth+59−12 files
No security note in commit
Moderate 60 AI analysisMessage 73 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

wallet: exclude immature coinbase outputs from fee rescue selection

This fix prevents Core Lightning from trying to use freshly created bitcoins (immature coinbase rewards) as emergency funds for fee-bump transactions. Such a transaction would be invalid under Bitcoin's rules and would be rejected by the n…

Consensus-invalid transaction generation preventedFee rescue / CPFP failure mode mitigatedCoinbase maturity check added to coin selection
34883ff7by cdecker+5−12 files
Vendor flagged security relevance
Moderate 59 AI analysisMessage 91 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

askrene: fix crash loading node bias with description

This commit fixes a bug in Core Lightning's askrene plugin that could prevent a node from restarting. When a saved routing layer contained a node bias with a description, the plugin accidentally freed the description's memory while using i…

Use-after-free / double-take of a tal-allocated string during plugin startupDenial-of-service-like symptom: lightningd aborts before replying to init, node cannot restartFixes publicly reported issue #9433 by endothermicdev
4681177dby Vincenzo Palazzo+2−32 files
No security note in commit
Informational 12 AI analysisMessage 91 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

tests: restart the node which owns the layer in node bias test

This commit only fixes a test case so it actually exercises the intended code path. It does not change any production code, so it cannot introduce or fix a real-world security vulnerability by itself. The test change is a reproducer for a …

0f3f67a0by Vincenzo Palazzo+3−21 file
No security note in commit
High 78 AI analysisMessage 68 · Adequate
EP Elements ProjectCore Lightning BitcoinLightning Network

dualopend: bound the feerates a peer opens at

This commit fixes a bug in Core Lightning's experimental dual-funded channel feature. When another node tried to open a channel, Core Lightning was not checking whether the proposed transaction fees were reasonable. A peer could request a …

Missing input validation on wire-parsed feerate fieldsPeer could induce signing and storage of feerate == 0RBF remote path allowed unbounded upward feerate walks
ba08356fby cdecker+140−04 files
Vendor flagged security relevance
High 72 AI analysisMessage 100 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

tests: regression coverage for out-of-range feerates

This commit adds regression tests for three related bugs where wildly wrong Bitcoin transaction feerates could enter Core Lightning. In the worst case, a malicious or broken fee source could make the node think a feerate was zero (due to a…

Integer overflow in feerate conversion (u32 wrap from 0xFFFFFFFF perkb to 0 perkw)Absurd feerate from external fee source bypassing sanity ceilingDatabase-stored out-of-range feerate causing startup abort/crash loop
65bdbc47by cdecker+137−02 files
No security note in commit
Moderate 64 AI analysisMessage 86 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

lightningd: don't assert on funding feerates read from the db

This update fixes a crash bug in Core Lightning. When the software tried to list details of a channel opening in progress, it could crash if a stored fee rate was extremely large or zero. The crash happened because the code used an interna…

Integer overflow in RBF escalation (u32 * 25 / 24) leading to assertion failureAssertion failure in read-only introspection RPC (listpeerchannels) causing crash-loop at startupDatabase value treated as invariant despite originating from external fee estimator
d67c4936by cdecker+72−227 files
Vendor flagged security relevance
Moderate 53 AI analysisMessage 86 · Strong
EP Elements ProjectCore Lightning BitcoinLightning Network

wallet: clamp absurd inflight funding feerates on upgrade

This commit fixes a bug where Core Lightning nodes could get stuck in a crash loop. If a node had previously stored an extremely high or zero fee rate for an in-progress channel funding operation (a 'splice' or dual-funded channel RBF), a …

Integer overflow in fee-rate calculation (u32 overflow when multiplying by 25/24)Assertion failure leading to daemon crash loop at startupDatabase migration clamps out-of-range stored funding feerates
f057c692by cdecker+34−01 file
Vendor flagged security relevance
Repository ledger

Explore captured commits

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

Security candidatecontrib: add jaonoctus's signing keyby jaonoctus · 41278b4e · Sep 21, 2026 · 2 filesMessage 73 · AdequateInformational 15Details
Commit message · jaonoctus

contrib: add jaonoctus's signing key

Add jaonoctus's PGP fingerprint to the "Signatures For Releases" table
in both SECURITY.md and the security-policy doc, which are kept in sync.

Changelog-None

73/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
signing boundarydocumentation-only discount
AI analysis · Informational 15/100

This commit simply adds a new person's PGP public-key fingerprint to the list of trusted release signers in two documentation files. It does not change any code, fix any bug, or alter any security behavior of the software itself.

Lower-prioritytests: fix test_blinded_forward_policy flakeby daywalker90 · e4a30698 · Sep 17, 2026 · 1 fileMessage 68 · AdequateTriage 0Details
Commit message · daywalker90

tests: fix test_blinded_forward_policy flake

l1 isn't part of the l2-l3 funding, so join_nodes([l2, l3]) can leave it
a block behind. The final CLTV only just meets l3's cltv-final, so l3
then rejects with "Expiry cltv too soon" and l1 reports the opaque
"Malformed error reply". Sync all nodes before reading the blockheight.

Changelog-None

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Provides detailed explanatory context✓ Mentions testing or verification
AI review queuedwallet: fixed timestamps for invented bookkeeper depositsby daywalker90 · 498e5086 · Sep 17, 2026 · 1 fileMessage 73 · AdequateInformational 15Details
Commit message · daywalker90

wallet: fixed timestamps for invented bookkeeper deposits

migrate_setup_coinmoves() stamped wallet deposits with wall-clock time
via coinmvt_current_time(), so a slow migration could place the deposit
after the channel journal entry in bkpr-listaccountevents, flaking
test_migration_no_bkpr.

Use base_timestamp + 1, like the channel moves, so the order is stable.

Changelog-None

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
signing or wallet pathsecond-pass: security-sensitive path
AI analysis · Informational 15/100

This is a tiny internal fix to make a bookkeeping migration produce stable event ordering. It changes the timestamp used when creating historical 'deposit' records during a one-time database migration, so the records sort consistently with channel records instead of using the real-time clock. There is no security issue here.

Lower-prioritytests: wait for peer disconnect in test_blindedpath_noaddrby daywalker90 · 8cfd1fc9 · Sep 17, 2026 · 1 fileMessage 83 · StrongTriage 0Details
Commit message · daywalker90

tests: wait for peer disconnect in test_blindedpath_noaddr

l2.rpc.disconnect() returns before l3 notices the socket close, so l3
could still see l2 as connected and add a route hint, flaking the check
that a disconnected peer is not used as a blinded path entry.

Changelog-None

83/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Lower-prioritytests: fix flake in test_dataloss_protectionby daywalker90 · 946f700c · Sep 15, 2026 · 1 fileMessage 78 · AdequateTriage 0Details
Commit message · daywalker90

tests: fix flake in test_dataloss_protection

l2 detects the data loss and sends l1 an "Awaiting unilateral close"
error (after the channeld's 1 second delay), which l1 must receive to
drop to chain. But l1's channeld normally sends a warning and exits
first; if l2's error arrives before l1's connectd has torn that subd
down it is routed to the dying channeld and lost, so l1 never sees it
and we time out waiting for:

l1.daemon.wait_for_log("They sent ERROR.*Awaiting unilateral close")

Reconnect if we don't see it: channel->error is resent when the peer
reconnects, so l1 gets the error and drops to chain. We may already be
disconnected, in which case disconnect() fails with "Peer not
connected": that's fine, connect() is what matters.

This restores the workaround the test had before 6fdaec313 replaced it
with the channeld sleep.

Changelog-None

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Lower-prioritysendpay: idempotent success on replay of completed self-paymentsby Lagrang3 · b6841e4c · Sep 15, 2026 · 2 filesMessage 73 · AdequateTriage 0Details
Commit message · Lagrang3

sendpay: idempotent success on replay of completed self-payments

According to the documentation of sendpay:

Calls to sendpay with the same payment_hash,
amount_msat, and destination as a previous
successful payment (even if a different route
or partid) will return immediately with success.

A self payment is a special case, but the destination being
always ourselves should follow the same rule.

Changelog-Fixed: sendpay: immediate success when replaying a completed self payment.

Signed-off-by: Lagrang3 <lagrang3@protonmail.com>

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Lower-priorityrenepay: free pending routes when the payment finishesby daywalker90 · 3e950097 · Sep 14, 2026 · 2 filesMessage 73 · AdequateTriage 0Details
Commit message · daywalker90

renepay: free pending routes when the payment finishes

A payment can complete while some of its routes are still in flight.
This happens with MPP, or when a retry succeeds before all the parts of
a previous attempt have resolved. payment_collect_results() only frees
the routes that reached a final state, so the still-in-flight routes
stay in the global pay_plugin->pending_routes map forever.

The serialized onion of such a route is only reachable through the tal
tree (struct route does not keep a pointer to it), so memleak reports
it at shutdown:

**BROKEN** plugin-cln-renepay: MEMLEAK: 0x55c92426bfc8
**BROKEN** plugin-cln-renepay: label=u8[]
**BROKEN** plugin-cln-renepay: alloc:
**BROKEN** plugin-cln-renepay: common/sphinx.c:183 (serialize_onionpacket)
**BROKEN** plugin-cln-renepay: plugins/renepay/routetracker.c:353 (create_onion)
**BROKEN** plugin-cln-renepay: plugins/renepay/routetracker.c:410 (route_sendpay_request)
**BROKEN** plugin-cln-renepay: parents:
**BROKEN** plugin-cln-renepay: struct route
**BROKEN** plugin-cln-renepay: struct pay_plugin

Implement the routetracker_cleanup() hook, which was a TODO: when the
payment finishes, collect the routes that are still pending for it and
free them, which removes them from the pending routes map through the
existing destructor.

Changelog-Fixed: renepay: fix a memory leak of routes that were still in flight when the payment completed.

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Lower-prioritytests: fix test_htlc_sig_persistence flakeby daywalker90 · 43acdddd · Sep 14, 2026 · 1 fileMessage 45 · ThinTriage 0Details
Commit message · daywalker90

tests: fix test_htlc_sig_persistence flake

Changelog-None

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Mentions testing or verification! No meaningful explanatory body
Lower-prioritytests: fix test_rbf_non_last_mined flakeby daywalker90 · 72fa1a60 · Sep 14, 2026 · 1 fileMessage 68 · AdequateTriage 0Details
Commit message · daywalker90

tests: fix test_rbf_non_last_mined flake

```
# The funding transaction gets mined (should be the 2nd inflight)
bitcoind.generate_block(6, wait_for_mempool=1)

# l2 comes back up
l2.start()

# everybody's got the right things now
l1.daemon.wait_for_log(r'to CHANNELD_NORMAL')
l2.daemon.wait_for_log(r'to CHANNELD_NORMAL')

channel = only_one(l1.rpc.listpeerchannels()['channels'])
> assert channel['funding_txid'] == inflights[1]['funding_txid']
E AssertionError: assert '12f2577bf10d40dd85e2de4ea867b59145fdcad541e861cf5993fbc5428b3aa7' == '1b8c5be4b21f8b741202cc2fcb1eb4ee0d529196870cfdeea03b1e69f88b436d'
E
E - 1b8c5be4b21f8b741202cc2fcb1eb4ee0d529196870cfdeea03b1e69f88b436d
E + 12f2577bf10d40dd85e2de4ea867b59145fdcad541e861cf5993fbc5428b3aa7

tests/test_opening.py:1448: AssertionError
```

Changelog-None

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Provides detailed explanatory context✓ Mentions testing or verification
Security candidatedocs: document missing and fix erroneous JSON-RPC error codesby daywalker90 · d1b6963b · Sep 11, 2026 · 24 filesMessage 85 · StrongInformational 21Details
Commit message · daywalker90

docs: document missing and fix erroneous JSON-RPC error codes

Audit the `errors` sections of the RPC schemas against the error codes
the handlers actually raise, and fix the discrepancies.

FUNDING_STILL_SYNCING_BITCOIN (304) is only raised by `fundpsbt` and
`utxopsbt` (wallet/reservation.c), and is forwarded verbatim by every
other command which can return it. Document it on `fundpsbt`,
`utxopsbt`, `txprepare`, `withdraw`, `multiwithdraw`, `upgradewallet`,
`fundchannel` and `multifundchannel`. Conversely, `fundchannel_start`
and `openchannel_init` do not call either: when the node is not synced
they delay via topology_add_sync_waiter() and retry, so drop their
stale 304.

Also fix the remaining discrepancies:

- `delpay` documented 211 for a status mismatch, but that path returns
208 (PAY_NO_SUCH_PAYMENT); 211 is never raised by `delpay`, so replace
it;
- document missing codes: `createinvoice` 907 (INVOICE_OFFER_INACTIVE),
`enableoffer` 1007 (OFFER_USED_SINGLE_USE), `getroutes` 217
(PAY_USER_ERROR) and `addpsbtoutput` 302/309;
- add `errors` sections to `splice_init`, `splice_update` and
`splice_signed` (351-356), `disableoffer` and `disableinvoicerequest`
(1001), `preapproveinvoice` (213), `preapprovekeysend` (214) and
`recover` (1600).

The splice commands can also fail asynchronously, after the command has
gone pending, through the channeld message handlers in channel_control.c
which resolve the pending command via splice_command_for_chan().
Document those codes too: 350 (SPLICE_BROADCAST_FAIL) on `splice_signed`;
357/359/360 (SPLICE_FUNDING_LOW/SPLICE_LOW_FEE/SPLICE_HIGH_FEE) on
`splice_update`; and 358/362/363 (SPLICE_STATE_ERROR/SPLICE_ABORT/
SPLICE_CHANNEL_ERROR) on all three.

Changelog-None

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
Why it was queued
signing boundarysigning or wallet pathboot or update path
AI analysis · Informational 21/100

This commit is a documentation-only cleanup of the JSON-RPC command help files. It corrects which numeric error codes are listed for each command so the published schemas match what the software actually returns. No program logic, validation, or behavior was changed, so it cannot be exploited or cause runtime failures. It mainly helps developers and automated tools build correct clients.

Lower-prioritydocs: remove old references to pay, use xpayby Lagrang3 · 78f4cd72 · Sep 9, 2026 · 4 filesMessage 72 · AdequateTriage 0Details
Commit message · Lagrang3

docs: remove old references to pay, use xpay

Changelog-None.

Signed-off-by: Lagrang3 <lagrang3@protonmail.com>

72/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides an explanatory body
Why it was queued
documentation-only discount
Lower-prioritydualopend: initialize state->reconnected on startupby Erick Cestari · 8c8fdf4e · Sep 8, 2026 · 1 fileMessage 73 · AdequateTriage 0Details
Commit message · Erick Cestari

dualopend: initialize state->reconnected on startup

state->reconnected was only set to true after do_reconnect_dance(),
so a fresh dualopend never wrote it. A commitment_signed arriving
out of turn in the main loop made handle_commit_signed() read an
uninitialized bool, which UBSan flags as a load of an invalid bool
value.

Default it to false, so an out-of-turn commitment_signed is always
rejected unless we really reconnected.

Changelog-None

Signed-off-by: Erick Cestari <erickcestari03@gmail.com>

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Security candidatechanneld: initialize tx_sigs_allowed on startupby Erick Cestari · c09c4520 · Sep 8, 2026 · 1 fileMessage 73 · AdequateLow 46Details
Commit message · Erick Cestari

channeld: initialize tx_sigs_allowed on startup

peer->tx_sigs_allowed was only set in peer_reconnect() and when we
receive channel_ready, so on a fresh channeld start a stray
tx_signatures arriving before the peer's channel_ready made
handle_unexpected_tx_sigs() read an uninitialized bool. UBSan flags
this as a load of an invalid bool value, and in normal builds the
"warn and disconnect" branch was effectively taken at random.

Default it to false: we only allow an unexpected tx_signatures when
reconnecting.

Changelog-None

73/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
signing boundary
AI analysis · Low 46/100

This commit fixes a bug where a setting that controls whether unexpected transaction signatures are allowed was not initialized when the channel daemon starts. If a peer sent such signatures before the channel was fully ready, the program would read an uninitialized value. In practice this usually caused a random, harmless disconnection, but under undefined-behavior detection it was flagged as a serious bug. The fix simply sets the value to false at startup.

Security candidateci: fix the coverage nightly's profile handlingby cdecker · 5685c9a3 · Sep 8, 2026 · 1 fileMessage 100 · StrongInformational 15Details
Commit message · cdecker

ci: fix the coverage nightly's profile handling

Three things stand between the restored scripts and a nightly that
finishes:

pyln-testing sets CLN_TEST_NAME for every test, so the profiles land in
$CLN_COVERAGE_DIR/<test-name>/ and never directly in $CLN_COVERAGE_DIR.
The coverage-raw/*.profraw upload glob therefore matches nothing, under
if-no-files-found: error. A local three-test run produced 515 profiles,
all of them in subdirectories. Both jobs now hand the directory to
collect-coverage.sh, which walks it and drops what crashed tests left
half-written; that also retires the flattening cp, which could collide
on <pid>-<signature>.profraw between matrix cells.

The build uses the runner's default clang while the report job installed
LLVM 18 and symlinked llvm-profdata to it. There are no compatibility
guarantees for the raw profile format across LLVM releases, so the two
have to come from the same one.

Codecov cannot read a .profdata; it gets the lcov export instead.

Changelog-None
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HGKo3ccLpkH2xFeEXUzEBK

100/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference✓ Names security-relevant behavior explicitly
Why it was queued
signing boundarydocumentation-only discount
AI analysis · Informational 15/100

This commit fixes the project's internal nightly code-coverage CI workflow. It changes how test coverage files are collected, ensures the same LLVM compiler version is used to generate and merge coverage data, and uploads a Codecov-compatible lcov report instead of an unreadable .profdata file. There is no security issue here—just build-script maintenance.

Lower-prioritycoverage: export lcov beside the HTML reportby cdecker · f78f900f · Sep 8, 2026 · 1 fileMessage 86 · StrongTriage 0Details
Commit message · cdecker

coverage: export lcov beside the HTML report

llvm-cov can emit lcov from the profile and binary list the script has
already assembled, so this costs one more invocation and gives the
report a machine-readable form. The nightly needs it: it currently hands
Codecov coverage/merged.profdata, which Codecov cannot parse. It is also
what GitLab's coverage visualization wants, via lcov_cobertura.

Paths are rewritten relative to the repository root, since both
consumers match the report against the repository tree.

Changelog-None
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HGKo3ccLpkH2xFeEXUzEBK

86/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference
Lower-prioritycoverage: restore the scripts every caller already referencesby cdecker · 662e338f · Sep 8, 2026 · 6 filesMessage 91 · StrongTriage 0Details
Commit message · cdecker

coverage: restore the scripts every caller already references

None of these are new: 4b9cffe183 wrote the documentation and the callers
for them, but .gitignore swallowed the directory itself, so master ships
a coverage feature whose every entry point is a missing file.

- Makefile's coverage-clang-collect and coverage-clang-report call
collect-coverage.sh and generate-coverage-report.sh
- .github/workflows/coverage-nightly.yaml calls the same two, and has
failed at "Merge coverage data" every night since
- doc/COVERAGE.md documents those two plus per-test-coverage.sh,
per-test-coverage-html.sh and cleanup-corrupt-profraw.sh
- doc/contribute-to-core-lightning/contributor-workflow.md points at
clang-coverage-report.sh, which the same commit deleted from
contrib/ after re-pointing the doc at contrib/coverage/

The files are restored unmodified; clang-coverage-report.sh is
byte-identical to the one removed from contrib/.

Changelog-None
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HGKo3ccLpkH2xFeEXUzEBK

91/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference
Lower-prioritygitignore: anchor the coverage entry to the repository rootby cdecker · 35110bd8 · Sep 8, 2026 · 1 fileMessage 91 · StrongTriage 0Details
Commit message · cdecker

gitignore: anchor the coverage entry to the repository root

The entry is unanchored, so it matches contrib/coverage/ as well as the
coverage/ build output directory it was meant for. That is how 4b9cffe183
came to add the coverage documentation, the Makefile targets, the
pyln-testing plumbing and the nightly workflow while silently leaving the
scripts they all call out of the commit.

Changelog-None
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HGKo3ccLpkH2xFeEXUzEBK

91/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference
Lower-priorityaskrene: cut-off arcs with very low probabilityby Lagrang3 · 9ddd2274 · Sep 7, 2026 · 3 filesMessage 80 · StrongTriage 0Details
Commit message · Lagrang3

askrene: cut-off arcs with very low probability

Arcs with very low probability of success are pruned early.
This only applies to the single path solver because the MPP code
uses arc linearization and already the low probability tail is removed.

Changelog-None

Signed-off-by: Lagrang3 <lagrang3@protonmail.com>

80/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
Security candidateschemas: make required fields match the codeby daywalker90 · ddbd2963 · Sep 3, 2026 · 50 filesMessage 78 · AdequateLow 37Details
Commit message · daywalker90

schemas: make required fields match the code

Fields added to `required` (source where unconditionally added):
- askrene-create-layer/layers[]. & askrene-listlayers/layers[]:
`biases`, `node_biases` - plugins/askrene/layer.c:1512,1519
- bkpr-channelsapy/channels[]: `fees_in_msat` - plugins/bkpr/channelsapy.c:292
- bkpr-report: `format` (request) - plugins/bkpr/bookkeeper.c:520;
`format-hint` - plugins/bkpr/report.c:499
- datastore & deldatastore: `generation`, `hex` - lightningd/datastore.c:19,20
- decode/offer_recurrence[]: `compulsory_field` - plugins/offers.c:880
- delpay/payments[]: `groupid` - lightningd/pay.c:144
- feerates/onchain_fee_estimates: `unilateral_close_nonanchor_satoshis`
- lightningd/chaintopology.c:788
- fundchannel_start: `channel_type` - lightningd/opening_control.c:321
- help: `format-hint` - lightningd/jsonrpc.c:496
- hook/onion_message_recv & _secret: `unknown_fields`,
`reply_blindedpath.{first_path_key,hops}` - lightningd/onion_message.c:30,31,66
- listchannels/channels[]: `htlc_maximum_msat` - plugins/topology.c:263
- listclosedchannels/closedchannels[]: `channel_type`
- lightningd/closed_channel.c:43
- listconfigs: `configs` - lightningd/configs.c:275
- listpays/pays[]: `amount_sent_msat` - plugins/xpay/listpays.c:183
- listpeerchannels/channels[]: `channel_type` - lightningd/peer_control.c:959,
lightningd/dual_open_control.c:128, lightningd/opening_control.c:48
- listpeers/peers[]: `features` - lightningd/peer_control.c:2619
- multifundchannel: `failed` - plugins/spender/multifundchannel.c:501
- notification/coin_movement: `extra_tags` - lightningd/coin_mvts.c:169
- offer: `force_paths` - lightningd/offer.c:24
- openchannel_init & openchannel_bump: `requires_confirmed_inputs`
- lightningd/dual_open_control.c:3478
- parsefeerate: `perkw` - lightningd/chaintopology.c:823
- pay: `destination` - plugins/xpay/xpay.c:473, plugins/libplugin-pay.c:2144
- reckless (request): `target/subcommand` - plugins/recklessrpc.c:280
- renepay & renepaystatus/paystatus[]: `groupid`, `destination`
- plugins/renepay/json.c:269,278,279
- sendonion: `groupid` - lightningd/pay.c:144; pending branch `message` - :299
- sendpay & waitsendpay: `groupid` - lightningd/pay.c:144
- splice_signed: `outnum` - lightningd/channel_control.c:548
- splicein & spliceout: `psbt`, `txid` - plugins/spender/splice.c:1763,1764

Fields removed from `required` (conditional in code):
- bkpr-editdescriptionbypaymentid/items[]: `description`
- plugins/bkpr/chain_event.c:33-34, plugins/bkpr/channel_event.c:53-54
- createinvoice & sendinvoice: `description` - lightningd/invoice.c:64-65
- hook/invoice_payment: `result` - lightningd/invoice.c:237 (optional);
`failure_message` only used when `result` is absent, now required there
via if/then/else
- invoicerequest (request): `description` - plugins/offers_offer.c:693 (p_opt)
- splice_signed (request): `channel_id` - lightningd/channel_control.c:2511
(p_opt)

Note: bkpr-editdescriptionbyoutpoint keeps `description` required: the
SQL refetch filters credit_msat > 0 (recorder.c:376-382) and the desc was
just stored keyed by outpoint (bookkeeper.c:853).

Adjust plugins and tests to the now-required fields:
- lsps-plugin: peer.features is non-optional (listpeers)
- wss-proxy-plugin: listconfigs' configs object is non-optional
- cln-rpc/src/test.rs

Changelog-None

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
signing boundarysigning or wallet pathparser or protocol path
AI analysis · Low 37/100

This commit is a large cleanup of Core Lightning's API schemas, generated RPC bindings, and related plugin code. The stated goal is to make the documented 'required' fields match what the C code actually always produces or expects. In practice it mostly removes 'optional' markers from fields that were already unconditionally emitted, and makes a few truly conditional fields optional. It also changes one plugin hook response schema so that a plugin can reject a payment by returning only a custom failure_message, without a result field. The changes are broad but are described by the project as a schema consistency fix, not a security fix. There is no direct evidence in the commit of an exploitable vulnerability.

Security candidatedoc: document error 313 on every command which can return itby Peter Neuroth · a34b9758 · Sep 2, 2026 · 6 filesMessage 73 · AdequateInformational 15Details
Commit message · Peter Neuroth

doc: document error 313 on every command which can return it

FUND_CANNOT_AFFORD_WITH_EMERGENCY is raised in exactly two places,
`fundpsbt` and `utxopsbt` (wallet/reservation.c), when the node has an
anchor channel and the transaction would not leave `min-emergency-msat`
behind. Note that this does not require `opening_anchor_channel`: any
existing anchor channel is enough.

Every other command which can return it does so by forwarding one of
those two errors verbatim, but only `withdraw`, `fundchannel` and
`multifundchannel` documented it. Add it to the rest:

- `fundpsbt` and `utxopsbt`, which raise it directly;
- `txprepare` and `multiwithdraw`, which call them;
- `upgradewallet`, which calls `utxopsbt` via txprepare_continue() and
had no `errors` section at all, so document -1 and 301 there too.

Changelog-None

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
signing boundarysigning or wallet path
AI analysis · Informational 15/100

This commit only updates documentation. It adds error code 313 to the documented error lists for several Core Lightning commands (fundpsbt, utxopsbt, txprepare, multiwithdraw, and upgradewallet). The error code already existed in the code and was already documented for some commands; this change makes the documentation complete and consistent. No code behavior changes.

Lower-prioritydoc: fix wording of the min-emergency-msat error descriptionby Peter Neuroth · d7d1e78c · Sep 2, 2026 · 4 filesMessage 73 · AdequateTriage 0Details
Commit message · Peter Neuroth

doc: fix wording of the min-emergency-msat error description

The three schemas which documented error 313 all read "The
`min-emergency-msat` reserve not be preserved", which is missing a verb.

Changelog-None

73/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Lower-priorityaskrene: fix set zero bias on persistent layersby Lagrang3 · 23f7e3f3 · Sep 2, 2026 · 2 filesMessage 68 · AdequateTriage 0Details
Commit message · Lagrang3

askrene: fix set zero bias on persistent layers

Changelog-Fixed: askrene: setting an absolute bias value to zero on a persistent layer doesn't result on a NULL pointer dereference.

Reported-by: @whkim0 and @Ahmadsm2005
Suggested-fix: @Andezion
Signed-off-by: Lagrang3 <lagrang3@protonmail.com>

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Security candidatetools/build-release.sh: name the checksum file when verifying the signatureby Peter Neuroth · 8e495707 · Sep 2, 2026 · 1 fileMessage 88 · StrongLow 25Details
Commit message · Peter Neuroth

tools/build-release.sh: name the checksum file when verifying the signature

The --verify path called `gpg --verify ../SHA256SUMS-$VERSION.asc` and
let gpg work out the rest. For a proper detached signature it does find
the sibling file, so this happened to work, but an inline signed .asc
would verify its own embedded payload and exit 0 without ever looking at
the checksums we just compared. Since the exit status is what decides
whether we print "Verified Successfully!", that is not a distinction we
want to leave to gpg.

Changelog-None: docs and release tooling only, nothing user-facing.

88/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Names security-relevant behavior explicitly
Why it was queued
signing boundary
AI analysis · Low 25/100

This commit fixes a release-script check that verifies the cryptographic signature on a file of checksums. Previously, the script only told GPG to verify the signature file itself. If someone replaced that signature file with an inline-signed message containing its own text, GPG would still report success without ever checking the actual checksum file. The fix explicitly names the checksum file so GPG verifies the signature against the intended manifest. This is a hardening change in internal release tooling, not a fix for an active vulnerability in the Lightning node software users run.

Security candidatedoc: pass the manifest explicitly to gpg --verifyby Peter Neuroth · 2dee8699 · Sep 2, 2026 · 2 filesMessage 95 · StrongLow 42Details
Commit message · Peter Neuroth

doc: pass the manifest explicitly to gpg --verify

We told people to drop SHA256SUMS and SHA256SUMS.asc into the same
directory and run `gpg --verify SHA256SUMS.asc`. That relies on gpg
guessing what to check, and the guess only happens for a real detached
signature. If the .asc turns out to be an inline signed message, gpg
verifies the payload embedded in the .asc itself, never touches
SHA256SUMS, and exits 0. It does warn on stderr, but that is easy to
scroll past and worthless to anything checking the exit code.

Spell out both filenames instead, and explain why. Also drop the
"gpg: assuming signed data in 'SHA256SUMS'" line from the sample
output, since gpg has nothing left to assume once we name the file.

95/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode✓ Mentions testing or verification✓ Names security-relevant behavior explicitly
Why it was queued
signing boundarydocumentation-only discount
AI analysis · Low 42/100

This commit updates Core Lightning's release documentation to tell users and release managers to run gpg --verify with both the signature file and the manifest file named explicitly. The old one-argument form can silently succeed even if the .asc file is not a proper detached signature over the manifest, because gpg may verify only a message embedded inside the .asc file and never check SHA256SUMS. The change prevents a subtle but real verification bypass in the release process, though it is a documentation-only fix and does not change any code or tooling.

Lower-prioritydoc: document CLN_PLUGIN_LOG in the cln-plugin crateby Porter · d421449f · Aug 31, 2026 · 1 fileMessage 81 · StrongTriage 0Details
Commit message · Porter

doc: document CLN_PLUGIN_LOG in the cln-plugin crate

The cln-plugin crate has no crate-level documentation, and CLN_PLUGIN_LOG
is not mentioned anywhere in the crate. Add a crate-level doc block
describing the variable, its accepted values, and the behaviour when it
is unset.

Fixes #6927

81/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference