lnd/docs/release-notes/release-notes-0.16.0.md
Antoni Spaanderman ed112681f5
lncli: Allow lncli to read binary PSBTs from a file
BIP 174 states that PSBTs can be encoded in 2 formats:
- plain text as base64
- in a file as binary

With this change, lncli will also try to read a PSBT as binary
2022-11-17 12:41:46 +01:00

278 lines
12 KiB
Markdown

# Release Notes
## BOLT Specs
* Warning messages from peers are now recognized and
[logged](https://github.com/lightningnetwork/lnd/pull/6546) by lnd.
## RPC
* The `RegisterConfirmationsNtfn` call of the `chainnotifier` RPC sub-server
[now optionally supports returning the entire block that confirmed the
transaction](https://github.com/lightningnetwork/lnd/pull/6730).
* [Add `macaroon_root_key` field to
`InitWalletRequest`](https://github.com/lightningnetwork/lnd/pull/6457) to
allow specifying a root key for macaroons during wallet init rather than
having lnd randomly generate one for you.
* [A new `SignedInputs`](https://github.com/lightningnetwork/lnd/pull/6771)
field is added to `SignPsbtResponse` that returns the indices of inputs
that were signed by our wallet. Prior to this change `SignPsbt` didn't
indicate whether the Psbt held any inputs for our wallet to sign.
* [Add list addresses RPC](https://github.com/lightningnetwork/lnd/pull/6596).
* Add [TrackPayments](https://github.com/lightningnetwork/lnd/pull/6335)
method to the RPC to allow subscribing to updates from any inflight payment.
Similar to TrackPaymentV2, but for any inflight payment.
* [Catch and throw an error](https://github.com/lightningnetwork/lnd/pull/6945)
during `openchannel` if the local funding amount given is zero.
* [Extend](https://github.com/lightningnetwork/lnd/pull/6831) the HTLC
interceptor server implementation with watchdog functionality to cancel back
HTLCs for which an interceptor client does not provide a resolution in time.
If an HTLC expires, the counterparty will claim it back on-chain and the
receiver will lose it. Therefore the receiver can just as well fail off-chain
a few blocks before so that the channel is saved.
* [Make remote channel reserve amount configurable for
`openchannel`](https://github.com/lightningnetwork/lnd/pull/6956)
* [`ForwardingHistory` ](https://github.com/lightningnetwork/lnd/pull/7001) now
enriches each forwarding event with inbound and outbound peer alias names if
the new flag `PeerAliasLookup` in `ForwardingHistoryRequest` is set to true.
[`lncli fwdinghistory` ](https://github.com/lightningnetwork/lnd/pull/7083)
enables this feature by default but adds a new flag `skip_peer_alias_lookup`
to skip the lookup.
* The graph lookups method `DescribeGraph`, `GetNodeInfo` and `GetChanInfo` now
[expose tlv data](https://github.com/lightningnetwork/lnd/pull/7085) that is
broadcast over the gossip network.
* [Add new HTLC notifier event and lookup
RPC](https://github.com/lightningnetwork/lnd/pull/6517) for the final
settlement of incoming HTLCs. This allows applications to wait for the HTLC to
actually disappear from all valid commitment transactions, rather than assume
that it will. With the new extensions, situations can be avoided where the
application considers an HTLC settled, but in reality the HTLC has timed out.
Final resolution data will only be available for htlcs that are resolved
after upgrading lnd.
* Zero-amount private invoices [now provide hop
hints](https://github.com/lightningnetwork/lnd/pull/7082), up to `maxHopHints`
(20 currently).
## Wallet
* [Allows Taproot public keys and tap scripts to be imported as watch-only
addresses into the internal
wallet](https://github.com/lightningnetwork/lnd/pull/6775). NOTE that funding
PSBTs from imported tap scripts is not currently possible.
* [The wallet birthday is now used properly when creating a watch-only wallet
to avoid scanning the whole
chain](https://github.com/lightningnetwork/lnd/pull/7056).
## Build
[The project has updated to Go
1.19](https://github.com/lightningnetwork/lnd/pull/6795)! Go 1.18 is now the
minimum version needed to build the project.
[The minimum recommended version of the Go 1.19.x series is 1.19.2 because
1.19.1 contained a bug that affected lnd and resulted in a
crash](https://github.com/lightningnetwork/lnd/pull/7019).
[Use Go's `runtime/debug` package to get information about the build](
https://github.com/lightningnetwork/lnd/pull/6963/)
[A wire parsing bug has been fixed that would cause lnd to be unable _decode_
certain large transactions](https://github.com/lightningnetwork/lnd/pull/7100).
## Misc
* [Fixed a bug where the Switch did not reforward settles or fails for
waiting-close channels](https://github.com/lightningnetwork/lnd/pull/6789)
* [Fixed a flake in the TestChannelLinkCancelFullCommitment unit
test](https://github.com/lightningnetwork/lnd/pull/6792).
* [Fixed error typo](https://github.com/lightningnetwork/lnd/pull/6659).
* [The macaroon key store implementation was refactored to be more generally
usable](https://github.com/lightningnetwork/lnd/pull/6509).
* [Fixed a bug where cookie authentication with Tor would fail if the cookie
path contained spaces](https://github.com/lightningnetwork/lnd/pull/6829).
[With the module updated](https://github.com/lightningnetwork/lnd/pull/6836),
`lnd` now parses Tor control port messages correctly.
* [Add option to encrypt Tor private
key](https://github.com/lightningnetwork/lnd/pull/6500), and [update the Tor
module](https://github.com/lightningnetwork/lnd/pull/6526) to pave the way for
this functionality.
* [Fixed potential data race on funding manager
restart](https://github.com/lightningnetwork/lnd/pull/6929).
* [Fixed a flake in the TestBlockCacheMutexes unit
test](https://github.com/lightningnetwork/lnd/pull/7029).
* [Create a helper function to wait for peer to come
online](https://github.com/lightningnetwork/lnd/pull/6931).
* [Stop handling peer warning messages as errors](https://github.com/lightningnetwork/lnd/pull/6840)
* [Stop sending a synchronizing error on the wire when out of
sync](https://github.com/lightningnetwork/lnd/pull/7039).
* [Update cert module](https://github.com/lightningnetwork/lnd/pull/6573) to
allow a way to update the tls certificate without restarting lnd.
* [Fixed a bug where paying an invoice with a malformed route hint triggers a
never-ending retry loop](https://github.com/lightningnetwork/lnd/pull/6766)
* [Migrated from go-fuzz to Go 1.18's new standard fuzz testing
library](https://github.com/lightningnetwork/lnd/pull/7127). [Updated build
and documentation to reflect
this](https://github.com/lightningnetwork/lnd/pull/7142).
* [Added missing wire tests for Warning
message](https://github.com/lightningnetwork/lnd/pull/7143).
## `lncli`
* [Add an `insecure` flag to skip tls auth as well as a `metadata` string slice
flag](https://github.com/lightningnetwork/lnd/pull/6818) that allows the
caller to specify key-value string pairs that should be appended to the
outgoing context.
* [Fix](https://github.com/lightningnetwork/lnd/pull/6858) command line argument
parsing for `lncli sendpayment`.
* [Fix](https://github.com/lightningnetwork/lnd/pull/6875) mapslice cap out of
range error that occurs if the number of profiles is zero.
* [A new config option, `batchwindowduration` has been added to
`sweeper`](https://github.com/lightningnetwork/lnd/pull/6868) to allow
customize sweeper batch duration.
* [Add `base_fee_msat` and `fee_rate_ppm` flags to
`openchannel`](https://github.com/lightningnetwork/lnd/pull/6753) requests
so that the user can specify fees during channel creation time in addition
to the default configuration.
* [Sleep for 10ms when funding locked message is not
received](https://github.com/lightningnetwork/lnd/pull/7126) to avoid CPU
spike.
* [A new config option, `mailboxdeliverytimeout` has been added to
`htlcswitch`](https://github.com/lightningnetwork/lnd/pull/7066).
* [Label the openchannel tx first before notifying the channel open
event.](https://github.com/lightningnetwork/lnd/pull/7158)
* [Add check for `pay_req` argument in `sendpayment` and `decodepayreq`
commands to trim "lightning:" prefix before processing the request](
https://github.com/lightningnetwork/lnd/pull/7150). Invoices may be prefixed
with "lightning:" on mobile and web apps and it's likely for users to copy
the invoice payment request together with the prefix, which throws checksum
error when pasting it to the CLI.
* [Allow lncli to read binary PSBTs](https://github.com/lightningnetwork/lnd/pull/7122)
from a file during PSBT channel funding flow to comply with [BIP 174](https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki#specification)
## Code Health
* [test: use `T.TempDir` to create temporary test
directory](https://github.com/lightningnetwork/lnd/pull/6710)
* [The `tlv` package now allows decoding records larger than 65535 bytes. The
caller is expected to know that doing so with untrusted input is
unsafe.](https://github.com/lightningnetwork/lnd/pull/6779)
* [test: replace defer cleanup with
`t.Cleanup`](https://github.com/lightningnetwork/lnd/pull/6864).
* [test: fix loop variables being accessed in
closures](https://github.com/lightningnetwork/lnd/pull/7032).
## Watchtowers
* [Create a towerID-to-sessionID index in the wtclient DB to improve the
speed of listing sessions for a particular tower ID](
https://github.com/lightningnetwork/lnd/pull/6972). This PR also ensures a
closer coupling of Towers and Sessions and ensures that a session cannot be
added if the tower it is referring to does not exist.
* [Remove `AckedUpdates` & `CommittedUpdates` from the `ClientSession`
struct](https://github.com/lightningnetwork/lnd/pull/6928) in order to
improve the performance of fetching a `ClientSession` from the DB.
* [Allow user to update tower address without requiring a restart. Also allow
the removal of a tower address if the current session negotiation is not
using the address in question](
https://github.com/lightningnetwork/lnd/pull/7025)
### Tooling and documentation
* [The `golangci-lint` tool was updated to
`v1.46.2`](https://github.com/lightningnetwork/lnd/pull/6731)
* [Tests in `htlcswitch` will now clean up the temporary resources they create](https://github.com/lightningnetwork/lnd/pull/6832).
* Updated the github actions to use `make fmt-check` in its [build
process](https://github.com/lightningnetwork/lnd/pull/6853).
* Database related code was refactored to [allow external tools to use it more
easily](https://github.com/lightningnetwork/lnd/pull/5561), in preparation for
adding a data migration functionality to `lndinit`.
* [`golangci-lint` will now check new code using additional
linters.](https://github.com/lightningnetwork/lnd/pull/7064)
* Update github actions to [check commits against the target base
branch](https://github.com/lightningnetwork/lnd/pull/7103) rather than just
using the master branch. And [skip the commit
check](https://github.com/lightningnetwork/lnd/pull/7114) for all non-PR
events.
### Integration test
The `lntest` has been
[refactored](https://github.com/lightningnetwork/lnd/pull/6759) to provide a
better testing suite for writing integration tests. A new defined structure is
implemented, please refer to
[README](https://github.com/lightningnetwork/lnd/tree/master/lntemp) for more
details. Along the way, several
PRs([6776](https://github.com/lightningnetwork/lnd/pull/6776)) have been made
to refactor the itest for code health and maintenance.
# Contributors (Alphabetical Order)
* Alejandro Pedraza
* andreihod
* Antoni Spaanderman
* Carla Kirk-Cohen
* Conner Babinchak
* cutiful
* Daniel McNally
* Elle Mouton
* ErikEk
* Eugene Siegel
* Graham Krizek
* hieblmi
* Jesse de Wit
* Joost Jager
* Jordi Montes
* lsunsi
* Matt Morehouse
* Michael Street
* Jordi Montes
* Olaoluwa Osuntokun
* Oliver Gugger
* Priyansh Rastogi
* Roei Erez
* Yong Yu