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.

v25.02rc1 - 2025-02-24

v25.02 release candidate: NAME-GOES-HERE

This release was named by XXX

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:

• BOLT12 offers now use a blinded path if the node has no advertised address.
• 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 242 commits in 68 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.

v24.11.1: The lightning-dev Mailing List II

This is a quick release due to the popularity of xpay, especially using the (reckless!) `xpay-handle-pay option.

Highlights:

1. xpay compatibility improved significantly for xpay-handle-pay: the JSON return should be identical, and it handles maxfeepercent and exemptfee parameters.
2. xpay results in listpays will include destination and amount_msat fields.
3. xpay doesn't spam the logs at INFO level any more
4. xpay now works through unannounced channels (oops!)
5. Alpine/OpenBSD compilation fix

You can see the full CHANGELOG for all details.

Happy xpay season from the Core Lightning Team!

v24.11: The lightning-dev Mailing List

We are pleased to announce the (giant, if slightly delayed) 24.11 release of Core Lightning, named by @ddustin. For a list of all changes, please see the changelog.

Highlights for Users:

• xpay is a new, experimental plugin for payments. It's rewritten from the ground up, on top of another plugin called askrene, which provides advanced routing advice for payments. The two play together: xpay tells askrene about the results of payment attempts, so it learns over time. The hard work was done by @Lagrang3 who wrote and refined the minimum-cost-flow solver which is the heart of askrene.
  • For reckless souls, xpay-handle-pay can be set to true (even at runtime, using setconfig) to have xpay take over the simple variants of pay.
• Paying and receiving offers (bolt12 send and receive) are enabled by default! This reflects it finally being included in the BOLT specs in September, to applause from all the different Lightning implementers.
• We're smarter about remembering where we successfully connected out to a peer, and will always try that again.
• pyln-client in 25.08 accidentally broke compatibility with older CLN versions. That's fixed.
• hsmtool generatehsm can now accept all the parameters on the command line.
• For large nodes:
  • The autoclean plugin would make nodes freeze for 30 seconds at a time when had a lot of work to do: it's now kinder and gentler.
  • gossipd and connectd queues are no longer slow (it was all gossipd's fault, be far too chatty).
  • listpays now takes start and limit parameters to speed it up if you only want recent payments.
• Some nasty bugs fixed, including one where extended downtime could mean we might never fully resolve unilateral closes (just missing returning the funds to our wallet).

Highlights for Developers:

• cln-grpc (our rust plugin to provide a GRPC interface) is enabled by default! Because of this, the new grpc-host option was added: we bind only to localhost by default. Almost all the JSON interfaces are now supported, thanks to @daywalker90 who has been tracking these in record time!
• All the RPC documentation now contains generated, accurate examples of their inputs and outputs.
• There's a new dev-splice command from @ddustin which lets you provide a splice script for describing complex moves, such as splicing into and out of multiple channels.
• Tracing infrastructure improved, including tracing across database accesses.
• exposesecret call (if explicitly enabled) allows backup of HSM secret via RPC api.
• libplugin is made more uniform: all routines now have a struct command context to use.

Highlights for the Network:

• We gossip harder: we try to stay connected to 10 nodes (see autoconnect-seeker-peers , picking random ones if we need to. Every hour we ask one peer for all its gossip, and we always send out our own gossip updates to up to 50 peers. This should help everyone stay up-to-date with what's happening in the network.
• Connectd will connect faster on startup, maintaining up to 10 outgoing connection attempts in parallel.

Since 24.08, we had 559 commits in 102 days from 28 different authors, including four new ones:

• Michael Cho
• Lakshya Singh
• Emmanuel Ferdman
• alfredo-toledano

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

v24.11 Release Candidate 3

Fixes since rc2:

• JSON-RPC: decode refused to decode expired bolt12 invoices.
• xpay: don't excees maxfee overall.
• Log unknown messages as "UNKNOWN" not "INVALID" so as not to freak people out

v24.11 Release Candidate 2

We are pleased to announce the (giant, if slightly delayed) 24.11 release of Core Lightning, named by @ddustin. For a list of all changes, please see the changelog

Highlights for Users:

• xpay is a new, experimental plugin for payments. It's rewritten from the ground up, on top of another plugin called askrene, which provides advanced routing advice for payments. The two play together: xpay tells askrene about the results of payment attempts, so it learns over time. The hard work was done by @Lagrang3 who wrote and refined the minimum-cost-flow solver which is the heart of askrene.
  • For reckless souls, xpay-handle-pay can be set to true (even at runtime, using setconfig) to have xpay take over the simple variants of pay.
• Paying and receiving offers (bolt12 send and receive) are enabled by default! This reflects it finally being included in the BOLT specs in September, to applause from all the different Lightning implementers.
• We're smarter about remembering where we successfully connected out to a peer, and will always try that again.
• pyln-client in 25.08 accidentally broke compatibility with older CLN versions. That's fixed.
• hsmtool generatehsm can now accept all the parameters on the command line.
• For large nodes:
  • The autoclean plugin would make nodes freeze for 30 seconds at a time when had a lot of work to do: it's now kinder and gentler.
  • gossipd and connectd queues are no longer slow (it was all gossipd's fault, be far too chatty).
  • listpays now takes start and limit parameters to speed it up if you only want recent payments.
• Some nasty bugs fixed, including one where extended downtime could mean we might never fully resolve unilateral closes (just missing returning the funds to our wallet).

Highlights for Developers:

• cln-grpc (our rust plugin to provide a GRPC interface) is enabled by default! Because of this, the new grpc-host option was added: we bind only to localhost by default. Almost all the JSON interfaces are now supported, thanks to @daywalker90 who has been tracking these in record time!
• All the RPC documentation now contains generated, accurate examples of their inputs and outputs.
• There's a new dev-splice command from @ddustin which lets you provide a splice script for describing complex moves, such as splicing into and out of multiple channels.
• Tracing infrastructure improved, including tracing across database accesses.
• exposesecret call (if explicitly enabled) allows backup of HSM secret via RPC api.
• libplugin is made more uniform: all routines now have a struct command context to use.

Highlights for the Network:

• We gossip harder: we try to stay connected to 10 nodes (see autoconnect-seeker-peers , picking random ones if we need to. Every hour we ask one peer for all its gossip, and we always send out our own gossip updates to up to 50 peers. This should help everyone stay up-to-date with what's happening in the network.
• Connectd will connect faster on startup, maintaining up to 10 outgoing connection attempts in parallel.

Since 24.08, we had 530 commits in 92 days from 28 different authors, including four new ones:

• Michael Cho
• Lakshya Singh
• Emmanuel Ferdman
• alfredo-toledano

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

v24.08.2 -- Steel Backed-up Channels

This point release addresses few crash fixes and includes an enhancement to remember and update channel hints for payments.

Changed

• pay: Now remembers and updates channel hints across payments.
• pay: Discarding an overly long or expensive route does not blacklist channels anymore.
• grpc: Channel type anchors/even was added to the grpc bindings.

Fixed

• gossipd: crash errors with large gossip_store (>4MB) growth on longer-running nodes.
• connectd: crash on erroneous timeout.
• Protocol: we could get confused on restart and not re-transmit our own channel_updates.
• rpc: listpeerchannels (and thus, pay) sped up on very large nodes.
• Improved pathfinding speed for large nodes.

v24.08.1 -- Steel Backed-up Channels

This hotfix release fixes few crash issues and some other bugs.

Fixed

• No longer crash if a plugin dies during lightningd startup.
• Fixed crash when starting channeld for older channel with no local alias.
• Will not crash for older pre-tlv peers where send_tlvs is NULL.
• Compilation will fail gracefully if jq is missing or an outdated version is detected.
• cln-plugin: Change default log level filter back to INFO.
• Fixed intermittant bug where hsmd (particularly, but also lightningd) could use 100% CPU.
• Made description optional in Wait(any)invoiceResponse to handle BOLT12.
• Removed bogus "BROKEN plugin-topology: DEPRECATED API USED: listchannels.include_private" message.