Release candidate for v0.17.0. Testers wanted: the rebalancer is new, so please run it on a node you watch and report what you see. Not yet recommended for unattended production use.
What changed
- Rebalancing moves to a new engine, xrebalance: circular rebalances planned from each peer's earnings record and executed through the external
xrebalanceplugin on CLN'saskrenemin-cost-flow router. Cycles run on a Poisson clock and on demand when a forward drains a channel. Pricing is strict: a cycle's fee budget comes from what the involved peers actually earn. - The built-in rebalancer (JIT, earnings, initial,
FundsMover,clboss-movefunds) is removed. JIT rebalancing is removed deliberately: holding an incoming HTLC while a rebalance runs delays the whole payment path; demand-triggered cycles cover the same need without holding HTLCs. If you relied on JIT rebalancing, please open an issue describing your case. - Channel-open candidates are ranked by their earnings track record (keepers first, unknowns next, underperformers last); among unknowns, peers advertising splicing are preferred.
clboss-track-record <nodeid>shows the verdict. - Many options are dynamic:
lightning-cli setconfigchanges them without a restart, and bad values are rejected instead of silently ignored. - New contrib tools:
clboss-xrebalance-view(the rebalancer's view of your node and the request the next cycle would send) andcln-plugin-bounce.
Requirements and upgrading from 0.16.x
- Core Lightning v26.04 or later (v25.09 is the hard floor; below v26.04 CLBOSS starts with a warning).
- Install the
xrebalanceplugin, v0.4.5 or later, and load it alongside CLBOSS -- see "The xrebalance plugin" under Installing in the README. Without it CLBOSS runs everything except rebalancing. - Remove
clboss-max-rebalance-fee-ppmfrom your configuration;lightningdrefuses to start on an unknown option. - Nothing else to set; the new
clboss-xrebalance-*options default to values run on live nodes.
Known issue
- #337: earnings attribution misses rebalance parts on a channel younger than the last
listpeerchannelssnapshot (up to ten minutes after lock-in). Bookkeeping only; the funds move correctly. Fix in the next candidate.
Reporting
- The
XRebalancer:log lines describe every cycle (candidates, floor, request, and the transfer summary). Please include them, yourclboss-xrebalance-*settings, and the CLN and plugin versions in reports.
See CHANGELOG.md for details.