v25.09rc2 Hot Wallet Guardian

Release Candidate 2 for Core Lightning v25.09

This release has been named by @king-11.

Note: release schedule moved one month: this is v25.09, and all deprecations incremented accordingly

Highlights for Users

• bookkeeper has been migrated into core lightning, allowing visibility into payments, fees and channel activities.
• xpay can now directly pay BIP353 addresses (like ₿[email protected]) and simple offers without extra steps.
• fetchinvoice is now more reliable.
• Better feedback when channel creation fails due to capacity limits.
• New browser tool for viewing CLN log files.
• Rust-based wss-proxy with better multi-address support.
• Now limiting the number of parts a payment can be split on xpay and askrene

Highlights for Developers

• bookkeeper plugin functionality is now integrated into Core Lightning with native listchainmoves and listchannelmoves commands, unified database storage, SQL query support, and real-time notifications for better financial auditability.
• Reckless now supports the modern uv package manager for Python plugins.
• Speaking of uv, we've transitioned away from poetry, now using uv.
• getroutes now accepts maxparts parameter to limit payment splitting for better route control.
• Flexible API responses - clnrest can return data in XML, YAML, or form-encoded formats beyond JSON.
• libplugin now allows synchronous calls at any time.
• Improvements to the rate of feasible solutions found in the main loop of the solver on askrene
• To increase the runtime, we've refactored the minimum cost flow solver, pruning some network arcs and reducing the internal unit of account.

Protocol Updates

• Splicing improvements allow for better compatibility with Eclair and continuous routing during channel modifications.
• Improve security by ensuring all peers must support channel type.
• Payment secrets now mandatory in BOLT11 invoices for better payment protection.

Since 25.05 we’ve had 300 commits in 64 days by 16 authors

A special thanks to the four first time contributors:

@Chand-ra
@sangbida
@MicahMaphet
@longhutianjie

An enormous thanks to the Core Lightning team:
@rustyrussell, @ShahanaFarooqui, @endothermicdev, @cdecker, @nepet, @Lagrang3, @sangbida and @niftynei

v25.09rc1 Hot Wallet Guardian

Release Candidate for Core Lightning v25.09

This release has been named by @king-11.

Note: release schedule moved one month: this is v25.09, and all deprecations incremented accordingly

Highlights for Users

• bookkeeper has been migrated into core lightning, allowing visibility into payments, fees and channel activities.
• xpay can now directly pay BIP353 addresses (like ₿[email protected]) and simple offers without extra steps.
• fetchinvoice is now more reliable.
• Better feedback when channel creation fails due to capacity limits.
• New browser tool for viewing CLN log files.
• Rust-based wss-proxy with better multi-address support.
• Now limiting the number of parts a payment can be split on xpay and askrene

Highlights for Developers

• bookkeeper plugin functionality is now integrated into Core Lightning with native listchainmoves and listchannelmoves commands, unified database storage, SQL query support, and real-time notifications for better financial auditability.
• Reckless now supports the modern uv package manager for Python plugins.
• Speaking of uv, we've transitioned away from poetry, now using uv.
• getroutes now accepts maxparts parameter to limit payment splitting for better route control.
• Flexible API responses - clnrest can return data in XML, YAML, or form-encoded formats beyond JSON.
• libplugin now allows synchronous calls at any time.
• Improvements to the rate of feasible solutions found in the main loop of the solver on askrene
• To increase the runtime, we've refactored the minimum cost flow solver, pruning some network arcs and reducing the internal unit of account.

Protocol Updates

• Splicing improvements allow for better compatibility with Eclair and continuous routing during channel modifications.
• Improve security by ensuring all peers must support channel type.
• Payment secrets now mandatory in BOLT11 invoices for better payment protection.

Since 25.05 we’ve had 300 commits in 64 days by 16 authors

A special thanks to the four first time contributors:

@Chand-ra
@sangbida
@MicahMaphet
@longhutianjie

An enormous thanks to the Core Lightning team:
@rustyrussell, @ShahanaFarooqui, @endothermicdev, @cdecker, @nepet, @Lagrang3, @sangbida and @niftynei

v25.05 - Satoshi's OP_RETURN Opinion

This release named by @nepet.

WARNING: Due to experimental protocol upgrades, --experimental-splicing is incompatible with previous CLN versions! You will not be able to reestablish channels with older nodes at all, if this is enabled! If you have CLN peers with the experimental splicing feature, consider disabling this option until they upgrade to support the latest draft spec.

Features for Users

• Reduced latency of commit and revoke messages.
• Reckless can update existing reckless-installed plugins via reckless update.
• Fixed routing of AskRene via high capacity channels.
• More accurate anchor fees.

Features for Developers

• listhtlcs pagination support with index, start and end parameters.
• The wait api now supports the listhtlcs subsystem.
• The beginnings of LSPS client and server plugins so far implementing the LSPS0 transport protocol.
• New signmessagewithkey rpc to sign input messages with our wallet keys
• sendonion is now compatible with sendpay with addition of total_amount_msat parameter.

Protocol Updates

• Peer storage graduates from experimental to default feature while bringing performance improvements.
• Splicing interoperability with Eclair and splice RBF capability.

Since 25.02, we've had 338 commits in 103 days by 22 authors, including five new ones:

• Erick Cestari
• Zen
• Jiri Jakes
• Boris Nagaev
• 21M4TW

See the changelog for full details.

Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v25.05rc1

Release Candidate for Core Lightning v25.05

Features for Users

• Reduced latency of commit and revoke messages.
• Reckless can update existing reckless-installed plugins via reckless update.
• Fixed routing of AskRene via high capacity channels.
• More accurate anchor fees.

Features for Developers

• listhtlcs pagination support with index, start and end parameters.
• The wait api now supports the listhtlcs subsystem.
• The beginnings of LSPS client and server plugins so far implementing the LSPS0 transport protocol.
• New signmessagewithkey rpc to sign input messages with our wallet keys
• sendonion is now compatible with sendpay with addition of total_amount_msat parameter.

Protocol Updates

• Peer storage graduates from experimental to default feature while bringing performance improvements.
• Splicing interoperability with Eclair and splice RBF capability.

See the changelog for full details.

Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v25.02.2 - Onion Packet Filler Accreditation III

Fixed

• docker: Fixed broken docker image due to sqlite version not supporting an advanced query ([#8246])

See the changelog for a full list.

Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v25.02.1 - Onion Packet Filler Accreditation II

Several bug-fixes were addressed in this release, including:

• wallet: we could miss our own returned outputs on mutual closes if our peer didn't support option_shutdown_anysegwit. Any such outputs will be found by an automatic rescan upon upgrading.
• lightningd now properly handles duplicate HTLCs on closing and no longer spams the log.
• Unilateral closes now calculate fees with the correct HTLC timeout and no longer pay egregious fees.
• Fixed an occasional crash on bitcoind_getrawblockbyheight callback.
• fixed tracepoint crashes in autoclean/chanbackup.
• topology crash on invoice creation if a peer had a really high feerate.
• make cleans up the old clnrest directory prior to building and installing the new rust version of the plugin.

See the changelog for a full list.
Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v24.11.2 The lightning-dev Mailing List III

Several bug-fixes were addressed in this release, including:

• wallet: we could miss our own returned outputs on mutual closes if our peer didn't support option_shutdown_anysegwit. Any such outputs can be found by rescan after this upgrade, or by upgrading to v25.02.1 which will trigger the rescan automatically.
• lightningd now properly handles duplicate HTLCs on closing and no longer spams the log.
• Unilateral closes now calculate fees with the correct HTLC timeout and no longer pay egregious fees.
• Corrected an occasional lightningd crash on bitcoind_getrawblockbyheight when the parent has already been freed.
• fixed tracepoint crashes in autoclean/chanbackup.
• topology crash on invoice creation if a peer had a really high feerate.

See the changelog for a full list.
Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v25.02 Onion Packet Filler Accreditation

This release named by @s373nZ .

Please note: the reproducible build is currently non-deterministic due to the compilation step of the new clnrest plugin. We don't want that to hold up the release, however. The issue is known and will be addressed in a subsequent point release.

Highlights for users:

• Channel backup turns our peers into watchtowers by now allowing your node to generate penalty transactions!
• blacklisted runes can now be restored via relist.
• xpay has many, many bugfixes, and is now almost seamlessly compatible when xpay-handle-pay is used.
• lightning-cli has neater help output, and doesn't crash occasionally on xpay notifications.
• setconfig does more safety checks and uses a separate "config.setconfig" file for runtime changes: you can also now set transient=true if you don't want the config files changed.
• Fixed a bug where we would fail to collect our own funds if we force closed a channel we had leased with --experimental-dual-fund.

Highlights for the network:

• Splicing: stricter checking for better interoperability with Eclair.

Highlights for developers:

• clnrest is now a rust plugin.
• listpeerchannels now contains fields their_max_htlc_value_in_flight and our_max_htlc_value_in_flight to better calculate channel limits.
• New notifications plugin_stopped and plugin_started.
• fetchinvoice now has BIP353 DNS payment instruction support.

Since 24.11.1, we had 261 commits in 76 days from 21 different authors, including three new ones:

• Nishant Bansal
• gudnuf
• Erick λ

See the CHANGELOG for more details!

Thank you from the Core Lightning Team:
@endothermicdev, @rustyrussell, @cdecker, @nepet, @ShahanaFarooqui, and @niftynei.

v25.02 Release Candidate 3

25.02 Release Candidate 3

Changes since rc2:

• offers: don't send blinded path to neighbor for invoices (#8125)
• msggen: add missing InjectOnionMessage and channel_state_changed notification for v25.02 (#8123)

v25.02 Release Candidate 2

Fixes since rc1:

• xpay: Corrected the CLTV values in blinded paths which sometimes caused spurious failures.
• onchaind: Correctly collect our own (delayed) funds if we have a unilateral close when we are still offering a lease.
• Protocol: We now renegotiate an interrupted close, even if we don't need it, instead of sending an error.

See the CHANGELOG for more details.