Skip to content

v26.12 Release Candidate 1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Nov 15:26
v26.12rc1

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

  • pay is on its way out: it will be replaced by xpay in v27.03, so xpay-handle-pay is deprecated and no longer shown in listconfigs.
  • lightning-hsmtool can now recover HTLC outputs after channel state loss.
  • listforwards and the forward_event notification have a new failure_reason field 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 xpay no longer retries every channel through a node that keeps returning unknown_next_peer.
  • bkpr-listbalances no 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_ready retransmission 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> becomes T), 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 and to_self_delay are u16, htlc_accepted cltv_expiry_relative is signed, never-emitted fields such as num_skipped, next_fee_step and splice tx are gone, and connect with an unresolved address now parses.
  • cln-grpc: the msat amount fields of on-chain methods are deprecated in favour of new *_sat fields.
  • Notifications no longer carry the legacy payload object or flat unwrapped fields, coin_movement drops tags, txid, utxo_txid and vout, and wait no longer returns a details object.
  • askrene getroutes has a maxhops parameter (already in v26.06.10) and new error codes 215 and 220.
  • invokerune and destroyrune are deprecated: use createrune and blacklistrune.

Protocol Updates

  • Experimental option_simple_close for one-shot mutual close fee negotiation. Enable with --experimental-simple-close.
  • We reject tx_init_rbf once the peer has sent splice_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_msat now fails with temporary_channel_failure instead of required_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:

An enormous thanks to the core-maintaining Core Lightning team:

And to everyone else who contributed to this release: