This release introduces a change in the version numbering scheme, that should be backwards compatible.

For a list of all changes, please see v0.12.1..v22.11rc3.

This release introduces a change in the version numbering scheme, that should be backwards compatible.

For a list of all changes, please see v0.12.1..v22.11rc2.

We'd like to announce the 0.12.1 release of core-lightning, named by @adi2011.

This is a point release with a few bug fixes and build improvements: it's a recommended upgrade from 0.12.0, with no new features.

For a list of differences, please see v0.12.0..v0.12.1.

Highlights for Users

• Now with fewer bugs!
• Topology plugin could crash when it sees duplicate private channel announcements.
• getinfo no longer displays unannounced addresses; shows correct port for discovered IP addresses.
• Newly created channels sometimes were inexplicably disconnected, this has been fixed!

Highlights for the Network

• Bad gossip store reads and gossip propagation fixed.

Highlights for Developers

• Reliance on mistune and mrkd python libraries has been removed.

Since v0.12.0 we've had 26 commits from 5 different contributors over 29 days.

~ @niftynei, Christian, and Rusty

We're pleased to announce the 0.12.0 release of core-lightning, named by @adi2011.

Developers: please note the Great Msat Migration in the APIs!

Highlights for Users

• NEW Built-in bookkeeper plugin! This plugin tracks all movements of msats for your node, gives you a better idea of your costs and revenues, prints out CSVs that are uploadable to Koinly and CoinTracker, lets you inspect the on-chain footprint of a channel (useful when it goes to chain). Check out the new bkpr- prefixed commands.
• NEW Built-in commando plugin! This lets you create runes to allow access to your node from a commando client, which will let you send and receive RPC commands over the lightning network.
• NEW Emergency channel backup ("static backup")! Keep track of what peers you have channels with, and in case of node failure ask those peers to close the channel.
• NEW zeroconf channels are possible for whitelisted peers.
• hsmtool has a new command, checkhsm, which will let you check a BIP30 passphrase against the hsm_secret.
• Multiple log-file options will open multiple files for logging.
• Various crashes and issues fixed in connectd including crash on peer reconnect and large memory usage when many concurrent peers.
• PSBT: fixes signature encoding to comply with BIP-0174.
• We added dynamically detected public IP addresses to getinfo.
• Due to dependency issues on some platforms, a tarball of pre-generated manual pages is included with this release.

Highlights for the Network

• We prefer IPv6 connections when available.
• We now accept spam gossip and use it for routing, but don't relay it.
• We no longer create gossip messages with zlib encoding (but still understand them).
• We treat LND "internal error" as warnings, not force close events (reverts to v0.10.0 behavior).

Highlights for Developers

• _msat fields are added wherever they were missing in the API: they're still currently an "msat"-suffixed string, but will soon bean integer value. Test with deprecated_apis=false.
• The channel_state_changed notification now fires when a channel moves into state CHANNELD_AWAITING_LOCKIN.
• htlc_accepted_hook will now expose the short_channel_id and the per-channel HTLC id.
• pyln-testing now includes utilities to read and parse the gossip_store.
• startup_regtest.sh script now includes a fund_ln method.
• Rust binaries such as cln-grpc now included in our reproducible builds.
• Updated the bolts implementation for pyln-spec.
• Plugins no longer hang indefinitely if lightningd closes their connection.
• M1 architecture support.
• Upgrade docker base image from Debian buster to bullseye, works with glibc 2.29+.
• Docker images now built with rust plugin cln-grpc.

Since v0.11.1 we've had 508 commits from 31 different contributors over 80 days.

A special thanks goes to 9 first time contributors:

• Aditya Sharma
• Alex Myers
• Igor Bubelov
• Justin Moon
• Peter Neuroth
• Swapnil
• Jose A.P.
• Brian Barto
• AutonomoousOrganization

~ @niftynei, Christian, and Rusty

This is a minor release, highly recommended, which fixes several problems with the v0.11 (and v0.11.1) releases:

• Unwanted unilateral closes with LND. v0.11 removed logic to downgrade errors, and this reintroduces it when LND sends "internal error" as the reason for an error (which it seems to do often, but recovers).
• Two more occasional crashes fixed with reconnection logic.
• connectd large memory usage and large CPU usage reduced significantly.
• "Could not load channels from the database" failure on startup fixed, when we had old TORv2 addresses in the database.
• Two fixes to pay/routefinding code, for better payment success.

Thanks to all the people who reported bugs! Rusty.

This is a minor release, highly recommended, which fixes two problems with the v0.11.0.1 release:

1. Unwanted unilateral closes. We could get confused by reconnections, and think that a peer had sent us out-of-date "channel_reestablish" data. This caused us to complain about e.g. "bad reestablish revocation_number: 7457 vs 7462" and send an error and close the channel.
2. An overzealous check in connectd, particularly when reconnecting with multiple channels, which intermittently crashed the node.

Thanks to all the people who reported bugs! Rusty.

We're pleased to announce the 0.11.0 release of c-lightning, named on behalf of @SimonVrouwe.

This release is the first under the rebranded "Core Lightning" name. (Note: binaries are labelled v0.11.0.1 due to a minor bugfix required for reproducible builds).

Highlights for Users

• We now finally support multiple live channels to the same peer!
• If we detect rust support, we'll build the cln-grpc plugin for full native GRPC support.
• We advertize an external IP address if it's reported by two or more peers (disable-ip-discovery or always-use-proxy disables).
• You can specify two databases with --wallet, and we'll write to both at once (sqlite3 only).
• pay supports BOLT 11 payment metadata: we'll send it if it's in the invoice.
• New setchannel command (deprecates setchannelfee) allows setting max and min HTLC amounts. Try lightning-cli setchannel all 0 for #zerobasefee.
• pay can be forced to exclude channels or nodes with the exclude
• Significant speedup in start times for old nodes with many historical HTLCs.

Highlights for the Network

• We send the remote node's IP address in the init message, so they can tell what it is. (https://github.com/lightning/bolts/pull/917)
• We are more aggressive in sending our own gossip to peers, to help propagation.
• Default port is set by network, so regtest and testnet defaults are different. (https://github.com/lightning/bolts/pull/968)
• We never generate legacy onions, it's always TLV. We still forward legacy onions for now.
• We flush sockets before closing, so errors are more likely to reach the peer.
• Experimental support for announcing DNS addresses in node_announcement (https://github.com/lightning/bolts/pull/911)

Highlights for Developers

• pay has a maxfee parameter, which sets a simple LND-style upper fee (vs using maxfeepercent and exemptfee)
• You can create invoices with only a description hash, using deschashonly. We still store the full description, so use restraint!
• pay has deprecated paying solely by description hash: you should provide the full description, too.
• delinvoice has a new desconly parameter to simply trim the descriptions, but leave the rest intact.
• We have a rust crate cln-rpc to easily interact with our JSON-RPC.
• msggen tool allows easy generation of language bindings for our JSON RPC interface.

More details can be found in the changelog.

Thanks to everyone for their contributions and bug reports; please keep them coming.

Since 0.10.2, we've had 712 commits from 37 different authors over 170 days.

A special thanks goes to the 18 first time contributors (a new record!):

• Aaron Dewes
• Tim W
• manreo
• Gregory Sanders
• zero fee routing
• Stephen Webel
• Michael Dance
• Marnix
• lightning-developer
• kiwiidb
• Jules Comte
• JohnOnGit
• GoofyAF
• Denis Ahrens
• Clay Shoaf
• benthecarman
• azuchi
• Anand Suresh

Cheers, Christian, Rusty, Lisa.

We're pleased to announce the 0.10.2 release of c-lightning, named by @vincenzopalazzo.

This is a recommended upgrade: this release includes the patch for the recently disclosed CVE-2021-41592.

Highlights for Users

• Payments can now be retried without affecting the status of prior attempts.
• The route selection will now use the log-propability-based channel selection to increase success rate and reduce time to completion.
• close now reports the feeranges each side enforced, which allows users to determine which side caused a high or low feerate.
• Removal of old HTLC information and vacuuming shrinks large lightningd.sqlite3 by a factor of 2-3.

Highlights for the Network

• setchannelfee now has a grace period during which both old and new fee policies are considered. This prevents a fee update from making the channel unusable until the update propagated.
• We now perform quick-close if the peer supports it.
• We send regular pings to detect dead connections (particularly for Tor).
• Errors returning a channel_update no longer return an outdated one.
• Anchor output mutual close allow a fee higher than the final commitment transaction

Highlights for Developers

• Plugins now are notified about an upcoming shutdown, allowing them to store data and clean up before exiting.
• The datastore API (datastore, deldatastore, and listdatastore) exposes a simple key-value store, allowing plugin authors to store data in the c-lightning database.
• ping now only works if we have a channel with the peer.
• Relaxed the sqlite3 version match requirements to be at least a minimum version and a major version match

More details can be found in the changelog.

Thanks to everyone for their contributions and bug reports; please keep them coming.

Since 0.10.1, we've had 333 commits from 19 different authors over 85 days.

A special thanks goes to the 4 first time contributors:

• Dustin Dettmer
• Michael Folkson
• jerzybrzoska
• Devrandom

Cheers, Christian, Rusty, Lisa.