release-notes-0.15.1.md

Release Notes

Protocol/Spec Updates

• We'll now no longer clamp the co-op close fee to the commitment fee. Instead, if users are the initiator, they can now specify a max fee that should be respected.

Zero-Conf Channel Opens

• Introduces support for zero-conf channel opens and non-zero-conf option_scid_alias channels.

• The listchannels and closedchannels APIs have been updated to return alias and zero-conf information. A new listaliases API has also been added that returns a data dump of all existing alias info.

• Adds a ZeroConfAcceptor that rejects any zero-conf channel opens unless an RPC ChannelAcceptor is active. This is a safety measure to avoid funds loss.

Interoperability

• LND now waits until the peer's funding_locked is received before sending the initial channel_update. The BOLT specification requires this.

Build system

• Add the release build directory to the .gitignore file to avoid the release binary digest to be different whether that folder exists or not.

MuSig2

The experimental MuSig2 RPC interface has been updated to track version 0.4.0 of the draft BIP.

Taproot

lnd will now refuse to start if it detects the full node backend does not support Tapoot. With this change, the officially supported versions of bitcoind are: 21, 22, and 23.

lnd will now use taproot addresses for co-op closes if the remote peer supports the feature.

The wallet also creates P2TR change addresses by default in most cases.

NOTE for users running a remote signing setup: A manual account import is necessary when upgrading from lnd v0.14.x-beta to lnd v0.15.x-beta, see the remote signing documentation for more details. Please upgrade to lnd v0.15.3-beta or later directly!

lncli

• Add payment_addr flag to buildroute so that the mpp record of the route can be set correctly.

• Hop hints are now opt in when using lncli addholdinvoice. Users now need to explicitly specify the --private flag.

• Add chan_point flag to updatechanstatus and abandonchannel to offer a convenient way to specify the channel to be updated.

• Add ignore_pair flag to queryroutes to allow a user to request that specific directional node pairs be ignored during the route search.

Database

• Delete failed payment attempts once payments are settled, unless specified with keep-failed-payment-attempts flag.

• A new db configuration flag db.prune-revocation is introduced to take the advantage enabled by a recent space optimization. Users can set this flag to true to run an optional db migration during lnd's startup. This flag will prune the old revocation logs and save them using the new format that can save large amount of disk space. For a busy channel with millions of updates, this migration can take quite some time. The benchmark shows it takes roughly 70 seconds to finish a migration with 1 million logs. Of course the actual time taken can vary from machine to machine. Users can run the following benchmark test to get an accurate time it'll take for a channel with 1 millions updates to plan ahead,

  cd ./channeldb/migration30
  go test -bench=. -run=TestMigrateRevocationLogMemCap -benchtime=1000000x -timeout=10m -benchmem

Documentation

• Add minor comment on subscribe/cancel/lookup invoice parameter encoding.

• Log pubkey for peer related messages.

Neutrino

• Add getblockhash command to neutrino sub-server.

RPC Server

• Add previous_outpoints to GetTransactions RPC.

• Fix P2TR support in ComputeInputScript.

• Add wallet reserve RPC & field in wallet balance.

• The RPC middleware interceptor now also allows requests to be replaced instead of just responses. In addition to that, errors returned from lnd can now also be intercepted and changed by the middleware.

• The signrpc.SignMessage and signrpc.VerifyMessage now supports Schnorr signatures.

• A new flag skip_temp_err is added to SendToRoute. Set it to true so the payment won't be failed unless a terminal error has occurred, which is useful for constructing MPP.

• Add a message to the RPC MW registration flow so that the server can indicate to the client that it has completed the RPC MW registration.

Bug Fixes

• LND no longer creates non-standard transactions when calling SendCoins with the all flag. This would manifest with p2wsh/p2pkh output scripts at 1sat/vbyte.

• Fixed data race found in TestSerializeHTLCEntries.

• Fixed a bug in the SignPsbt RPC that produced an invalid response when signing a NP2WKH input.

• Fix race condition in sign_psbt test.

• Update the urfave/cli package because of a flag parsing bug.

• DisconnectPeer no longer interferes with the peerTerminationWatcher. This previously caused force closes.

• The HtlcSwitch now waits for a ChannelLink to stop before replacing it. This fixes a race condition.

• Integration tests now always run with nodes never deleting failed payments.

• Fixes a key scope issue preventing new remote signing setups to be created with v0.15.0-beta.

• Re-initialise registered middleware index lookup map after removal of a registered middleware

• Bitcoind cookie file path can be specified with zmq options

• Remove ScidAliasOptional dependency on ExplicitChannelTypeOptional

• Add a default case to the Address Type switch statement in the NewAddress rpc server method.

Code Health

Code cleanup, refactor, typo fixes

• Migrate instances of assert.NoError to require.NoError.

• Enforce the order of rpc interceptor execution to be the same as the order in which they were registered.

Tooling and documentation

• An .editorconfig file was added to autoconfigure most text editors to respect the 80 character line length and to use 8 spaces as the tab size. Rules for Visual Studio Code were also added. And finally, the code formatting rules were extracted into their own document.

Contributors (Alphabetical Order)

• bitromortac
• Carsten Otto
• Elle Mouton
• ErikEk
• Eugene Siegel
• Jordi Montes
• Matt Morehouse
• Slyghtning
• Oliver Gugger
• Olaoluwa Osuntokun
• Priyansh Rastogi
• Tommy Volk
• Yong Yu