v0.0.105
API Updates
Phantom nodepayments are now supported, allowing receipt of a payment on
any one of multiple nodes without any coordination across the nodes being
required. See the newPhantomKeysManager's docs for more, as well as
requirements onKeysInterface::get_inbound_payment_key_materialand
lightning_invoice::utils::create_phantom_invoice(#1199).- In order to support phantom node payments, several
KeysInterfacemethods
now accept aRecipientparameter to select between the localnode_idand
a phantom-specific one. ProbabilisticScorer, aScorebased on learning the current balances of
channels in the network, was added. It attempts to better capture payment
success probability than the existingScorer, though may underperform on
nodes with low payment volume. We welcome feedback on performance (#1227).Score::channel_penalty_msatnow always takes the channel value, instead of
anOption(#1227).UserConfig::manually_accept_inbound_channelswas added which, when set,
generates a newEvent::OpenChannelRequest, which allows manual acceptance
or rejection of incoming channels on a per-channel basis (#1281).Payeehas been renamed toPaymentParameters(#1271).PaymentParametersnow has amax_total_cltv_expiry_deltafield. This
defaults to 1008 and limits the maximum amount of time an HTLC can be pending
before it will either fail or be claimed (#1234).- The
lightning-invoicecrate now supports no-std environments. This required
numerous API changes around timestamp handling and std+no-std versions of
several methods that previously assumed knowledge of the time (#1223, #1230). lightning-invoicenow supports parsing invoices with expiry times of more
than one year. This required changing the semantics ofExpiryTime(#1273).- The
CounterpartyCommitmentSecretsis now public, allowing external uses of
theBOLT 3secret storage scheme (#1299). - Several
Signmethods now receive HTLC preimages as proof of state
transition, see new documentation for more (#1251). KeysInterface::sign_invoicenow provides the HRP and other invoice data
separately to make it simpler for external signers to parse (#1272).Sign::sign_channel_announcementnow returns both the node's signature and
the per-channel signature.InMemorySignernow requires the node's secret
key in order to implement this (#1179).ChannelManagerdeserialization will now fail if theKeysInterfaceused
has a differentnode_idthan theChannelManagerexpects (#1250).- A new
ErrorActionvariant was added to sendwarningmessages (#1013). - Several references to
chain::Listenobjects inlightning-block-syncno
longer require a mutable reference (#1304).
Bug Fixes
- Fixed a regression introduced in 0.0.104 where
ChannelManager's internal
locks could have an order violation leading to a deadlock (#1238). - Fixed cases where slow code (including user I/O) could cause us to
disconnect peers with ping timeouts inBackgroundProcessor(#1269). - Now persist the
ChannelManagerprior toBackgroundProcessorstopping,
preventing race conditions where channels are closed on startup even with a
clean shutdown. This requires that users stop network processing and
disconnect peers prior toBackgroundProcessorshutdown (#1253). - Fields in
ChannelHandshakeLimitsprovided via theoverride_configto
create_channelare now applied instead of the default config (#1292). - Fixed the generation of documentation on docs.rs to include API surfaces
which are hidden behind feature flags (#1303). - Added the
channel_typefield toaccept_channelmessages we send, which
may avoid some future compatibility issues with other nodes (#1314). - Fixed a bug where, if a previous LDK run using
lightning-persistercrashed
while persisting updated data, we may have failed to initialize (#1332). - Fixed a rare bug where having both pending inbound and outbound HTLCs on a
just-opened inbound channel could causeChannelDetails::balance_msatto
underflow and be reported as large, or cause panics in debug mode (#1268). - Moved more instances of verbose gossip logging from the
Tracelevel to the
Gossiplevel (#1220). - Delayed
announcement_signaturesuntil the channel has six confirmations,
slightly improving propagation of channel announcements (#1179). - Several fixes in script and transaction weight calculations when anchor
outputs are enabled (#1229).
Serialization Compatibility
- Using
ChannelManagerdata written by versions prior to 0.0.105 will result
in preimages for HTLCs that were pending at startup to be missing in calls
toKeysInterfacemethods (#1251). - Any phantom invoice payments received on a node that is not upgraded to
0.0.105 will fail with an "unknown channel" error. Further, downgrading to
0.0.104 or before and then upgrading again will invalidate existing phantom
SCIDs which may be included in invoices (#1199).
Security
0.0.105 fixes two denial-of-service vulnerabilities which may be reachable from
untrusted input in certain application designs.
- Route calculation spuriously panics when a routing decision is made for a
path where the second-to-last hop is a private channel, included due to a
multi-hop route hint in an invoice. ChannelMonitor::get_claimable_balancesspuriously panics in some scenarios
when the LDK application's local commitment transaction is confirmed while
HTLCs are still pending resolution.
In total, this release features 109 files changed, 7270 insertions, 2131
deletions in 108 commits from 15 authors, in alphabetical order:
- Conor Okus
- Devrandom
- Elias Rohrer
- Jeffrey Czyz
- Jurvis Tan
- Ken Sedgwick
- Matt Corallo
- Naveen
- Tibo-lg
- Valentine Wallace
- Viktor Tigerström
- dependabot[bot]
- hackerrdave
- naveen
- vss96