Repository navigation
v26.12 Release Candidate 1
Pre-release
Pre-release
As you might have noticed, there was no v26.09. An unusually high number of vulnerability reports came in this year, and we spent that release slot fixing them and shipping the fixes in the v26.06.x point releases. Work on master carried on in the meantime, so v26.12 is effectively a double release: two cycles' worth of changes with a whopping 832 commits since v26.06. If you're upgrading from v26.06.x, please read the changelog carefully.
Highlights for Users
payis on its way out: it will be replaced byxpayin v27.03, soxpay-handle-payis deprecated and no longer shown inlistconfigs.lightning-hsmtoolcan now recover HTLC outputs after channel state loss.listforwardsand theforward_eventnotification have a newfailure_reasonfield explaining why a local forward failed (insufficient_outgoing_liquidity,too_many_htlcs,max_htlc_value_in_flight).- Better payments: askrene now remembers successful payments through a channel ("impressions") and accounts for fees in its probability costs, and
xpayno longer retries every channel through a node that keeps returningunknown_next_peer. bkpr-listbalancesno longer takes lightningd down when an account's debits exceed its credits; it logs the inconsistency and reports that account as 0msat.- Splicing fixes: no more crash when splicing a channel that hasn't been announced yet, and no stray
channel_readyretransmission on reconnect after a splice. - Experimental: wallet transaction and UTXO tracking driven by
bwatch(--experimental-bwatch).
Highlights for Developers
- The gRPC wire format is now frozen: released field numbers and types can no longer change, and CI checks every change against the last release.
- cln-rpc: fields that are required in the schema up to v26.06 are now required in the Rust types (
Option<T>becomesT), and messages from nodes older than v26.06 no longer parse. - cln-rpc and cln-grpc follow corrected schemas: payment timestamps are
u32, lease fields andto_self_delayareu16,htlc_acceptedcltv_expiry_relativeis signed, never-emitted fields such asnum_skipped,next_fee_stepand splicetxare gone, andconnectwith anunresolvedaddress now parses. - cln-grpc: the msat amount fields of on-chain methods are deprecated in favour of new
*_satfields. - Notifications no longer carry the legacy
payloadobject or flat unwrapped fields,coin_movementdropstags,txid,utxo_txidandvout, andwaitno longer returns adetailsobject. - askrene
getrouteshas amaxhopsparameter (already in v26.06.10) and new error codes 215 and 220. invokeruneanddestroyruneare deprecated: usecreateruneandblacklistrune.
Protocol Updates
- Experimental
option_simple_closefor one-shot mutual close fee negotiation. Enable with--experimental-simple-close. - We reject
tx_init_rbfonce the peer has sentsplice_locked, as BOLT #2 requires. - Interactive channel negotiation fails if the outputs sum to more than 21M BTC.
- Forwarding an HTLC that would exceed the outgoing channel's
max_htlc_value_in_flight_msatnow fails withtemporary_channel_failureinstead ofrequired_node_feature_missing. - A peer reconnecting to a channel where we lost state now reliably force-closes it.
See the changelog for full details.
Thanks
Since v26.06 we've had 832 commits in 169 days by 41 authors.
A special mention to our 19 first-time contributors:
- @EduardMikhrin
- @jaonoctus
- @amartya1523
- @kwsantiago
- @w3lld1
- @SashaMIT
- @Amperstrand
- @bittylicious
- @bhuvan-somisetty
- @coolstack-coder
- @seedhammer
- @mikeua
- @drymi11
- @vaibhav8a
- @ThomsenDrake
- @freeport-porter
- @mattraydub
- @daeho-ro
- @coreyphillips
An enormous thanks to the core-maintaining Core Lightning team:
And to everyone else who contributed to this release: