This release marks a minor release in the 0.6-beta series. This release contains no major new features, and instead contains a series of bug-fixes, optimizations, and stability improvements.
Verifying the Release
In order to verify the release, you'll need to have gpg or gpg2 installed on your system. Once you've obtained a copy (and hopefully verified that as well), you'll first need to import the keys that have signed this release if you haven't done so already:
curl https://keybase.io/roasbeef/pgp_keys.asc | gpg --import
Once you have his PGP key you can verify the release (assuming manifest-v0.6.1-beta-rc2.txt and manifest-v0.6.1-beta-rc2.txt.sig are in the current directory) with:
gpg --verify manifest-v0.6.1-beta-rc2.txt.sig
You should see the following if the verification was successful:
gpg: assuming signed data in 'manifest-v0.6.1-beta-rc2.txt'
gpg: Signature made Mon May 6 13:10:07 2019 PDT
gpg: using RSA key F8037E70C12C7A263C032508CE58F7F8E20FD9A2
gpg: Good signature from "Olaoluwa Osuntokun <laolu32@gmail.com>" [ultimate]
That will verify the signature on the main manifest page which ensures integrity and authenticity of the binaries you've downloaded locally. Next, depending on your operating system you should then re-calculate the sha256 sum of the binary, and compare that with the following hashes (which are included in the manifest file):
2bde52f143b1e18f1a09c527d15506061b870286fbac96188cc7760ee832e30c lnd-darwin-386-v0.6.1-beta-rc2.tar.gz
d9b534a24784720efa7d350aa303783a017bec6968d0a325fdd6faa3ed8a9469 lnd-darwin-amd64-v0.6.1-beta-rc2.tar.gz
ada49f0db88a4d17ab67aef097d2fd9b913268b1e8f29d2c1eca5fb22c06cf19 lnd-dragonfly-amd64-v0.6.1-beta-rc2.tar.gz
175518ef32f27c365949a1ad25f5aaa118edfb7f5ac9b7150c9bb2ea475978e3 lnd-freebsd-386-v0.6.1-beta-rc2.tar.gz
d6399e05a6b5644206b7c5ee6b42b3d2695464a8c055fc8233e483c37f96e501 lnd-freebsd-amd64-v0.6.1-beta-rc2.tar.gz
6ffd5de533005e24c56f7caafb44540cdae541ce6652acf9dac69daa8618beb2 lnd-freebsd-arm-v0.6.1-beta-rc2.tar.gz
19bb8acec1d79c376363a7660b7ef75624829cfdb6e83841e84b7dc98bbb10bc lnd-linux-386-v0.6.1-beta-rc2.tar.gz
860a5d0a56c1ec9eef33a5f29c20013221b95298468825a1b7793d13320cba70 lnd-linux-amd64-v0.6.1-beta-rc2.tar.gz
ce3e3ce3df6d5d98a78c776a06fa9a2cc5826f4ad6579bc36de4b6d634495efa lnd-linux-arm64-v0.6.1-beta-rc2.tar.gz
b238090ada661f95a9ad83e04af8a5196a22ebaf1861ded016b5081ce052afa9 lnd-linux-armv6-v0.6.1-beta-rc2.tar.gz
acaed77436ea210164553ac9e11b87c92ed918f10b6a5e54f96c01ca0b93fe24 lnd-linux-armv7-v0.6.1-beta-rc2.tar.gz
531ded86200180aeb353fae688a27c47c3127db77ff2090e7a11b6301af33d9e lnd-linux-mips64-v0.6.1-beta-rc2.tar.gz
2fc53aa465bb1328720236e1d3b935d7e8b5041419b090ef70887c570f1e89f1 lnd-linux-mips64le-v0.6.1-beta-rc2.tar.gz
8ba89de80eb8cceb455a2ec4e236390abccf856b5fc887e8ab72192e55ca1c9c lnd-linux-ppc64-v0.6.1-beta-rc2.tar.gz
ea4577691c710aeda59b6c3275386d1636998d98526db88384d65f03eb904fa1 lnd-netbsd-386-v0.6.1-beta-rc2.tar.gz
e94d00624c857bfa00917f5b8679c294b749490e485ec20433fc3dcb29c5db4b lnd-netbsd-amd64-v0.6.1-beta-rc2.tar.gz
c686fb833634a6001addb216e1e61be7ee0b21aaa9454909b9c89c665c6ec9fe lnd-openbsd-386-v0.6.1-beta-rc2.tar.gz
c8429494d6065675e72bb61f5b801eadae2beb57db325c14c235b7231e4e633f lnd-openbsd-amd64-v0.6.1-beta-rc2.tar.gz
ebdc2cca43877f680cd9f1ee6ac90c21e56f6ccde740288b3a37ddf46b954c27 lnd-source-v0.6.1-beta-rc2.tar.gz
db3bcdfac537a5640a53d3b8aa4472b0c348b800b3642ad90c966a61f91c752a lnd-windows-386-v0.6.1-beta-rc2.zip
dc8258ae4c7003876ba851e928006b796647598de2f5538e5c6f8d1fb3b176c0 lnd-windows-amd64-v0.6.1-beta-rc2.zip
6f75ce9dfb1a6f9c3f9537aee310429f89cd934f45079677ee59880d395d77e3 vendor.tar.gz
One can use the shasum -a 256 <file name="" here=""> tool in order to re-compute the sha256 hash of the target binary for your operating system. The produced hash should be compared with the hashes listed above and they should match exactly.
Finally, you can also verify the tag itself with the following command:
git verify-tag v0.6.1-beta-rc2
Building the Contained Release
With this new version of lnd, we've modified our release process to ensure the bundled release is now fully self contained. As a result, with only the attached payload with this release, users will be able to rebuild the target release themselves without having to fetch any of the dependencies. Note that at this stage, binaries aren't yet fully reproducible (even with go modules). This is due to the fact that by default, Go will include the full directory path where the binary was built in the binary itself. As a result, unless your file system exactly mirrors the machine used to build the binary, you'll get a different binary, as it includes artifacts from your local file system. This will be fixed in go1.13, and before then we may modify our release system to do this automatically.
In order to re-build from scratch, assuming that vendor.tar.gz and lnd-source-v0.6-beta.tar.gz are in the current directory:
tar -xvzf vendor.tar.gz
tar -xvzf lnd-source-v0.6.1-beta-rc2.tar.gz
GO111MODULE=on go install -v -mod=vendor -ldflags "-X github.com/lightningnetwork/lnd/build.Commit=v0.6.1-beta" ./cmd/lnd
GO111MODULE=on go install -v -mod=vendor -ldflags "-X github.com/lightningnetwork/lnd/build.Commit=v0.6.1-beta" ./cmd/lncli
The -mod=vendor flag tells the go build command that it doesn't need to fetch the dependencies, and instead, they're all enclosed in the local vendor directory.
Additionally, it's now possible to use the enclosed release.sh script to bundle a release for a specific system like so:
LNDBUILDSYS="linux-arm64 darwin-amd64" ./release.sh
The release.sh script will now also properly include the commit hash once again, as a regression caused by a change to the internal build system has been fixed.
⚡️⚡️⚡️ OK, now to the rest of the release notes! ⚡️⚡️⚡️
Release Notes
Tor
A bug has been fixed in the minimum version verification for the Tor daemon that lnd enforces. Before this fix, lnd would at times fail to connect to a Tor daemon with a version beyond the minimum version we require.
Protocol and Cross Implementation Compatibility Improvements
lnd will now properly handle the conversion from an UpdateFailMalformedHTLC error to a regular UpdateFailHTLC error. Before this fix, lnd would incorrectly send an error that wasn't able to be decrypted by the sender of an the original HTLC.
On-Chain Commitment/HTLC Handling
A series of parameters related to when lnd will go to chain for an HTLC, and also when it will reject an incoming/outgoing HTLC for being "too close for comfort" have been adjusted. As a result, it's no longer possible for lnd to accept an HTLC then immediately go to chain for it. Additionally, it's now possible for lnd to forward an HTLC as the last hop to a destination with a very low final CLTV delta.
lnd will now detect a local force close (self initiated) based on the outputs rather then the old txid based comparison. This patches an edge case related to SCB restoration where if a user broadcasted a force close then restored their SCB, lnd would miss this local force close transaction and attempt to redeem using an incorrect path. This bug has never been observed in the wild, but nevertheless warranted patching.
Gossip and P2P Handling
Non Write Pool Blocking Writes
Flushing a message to the socket is no longer blocks the write pool. One result of this change is that we are now we are able to gracefully handle timeout errors and resume partially sent messages. As of #2819, if a message is partially written to the wire due to a timeout error, we will try to write the full message again. In turn, this will produce an authentication error on the remote side (after it is able to read the number of bytes specified in the header) since the middle of the latter ciphertext will not pass as the MAC check.
We resolve this by splitting the Write call into two subroutines, WriteMessage and Flush. WriteMessage encrypts the plaintext and buffers the ciphertext on the underlying connection. A subsequent call to Flush will then attempt to write the bytes out on the wire. If a timeout error is encountered during flush, we can safely resume the byte stream by calling Flush again. In addition to being able to resume partial writes, this also has a yuuuge benefit in not blocking the write pool with network operations. This fully decouples the number of write pool workers from the number of peers, since the blocking operations now take place in each peer.
Synchronous Gossip Response Writes
All replies to gossip query messages are now fully synchronous. This means that if a peer requests a set of channels, then we won't send the next message until after the current message has been flushed to the socket. Node operators should find that start up is now much snappier, and the post start up memory burst to also be much lower.
SyncManager Simplification and Improvements
We've made some improvements to the recently introduced SyncManager. These improvements include:
* Active syncers will no longer attempt to synchronize our graph with remote peers. Instead, we'll now rely on synchronizing our graph with remote peers through the routine historical syncs performed by the SyncManager. Since active syncers will no longer attempt this synchronization, the SyncManager's round-robin is no longer needed.
* Handling initial historical sync disconnections: Every time lnd starts up, it attempts an initial historical graph sync with the first peer that connects. If the peer ends up disconnecting, then we wouldn't handle finding a replacement to continue performing the initial historical sync.
* Queueing active syncers until the initial historical sync completes: We do this to ensure we can properly handle any new channel updates at tip. This is required for fresh nodes that are syncing the channel graph for the first time. If we begin accepting updates at tip while the initial historical sync is still ongoing, then we risk not processing certain updates since we've yet to learn of the channels themselves.
RPC Bug Fixes
Sends to regular p2pk(Pay to PubKey) addresses are now disallowed.
The route cache has been removed. After updates to the SendToRoute RPC command, the cache could at times cause an incorrect result from QueryRoutes.
Networking Bug Fixes
We've fixed an issue that would cause our automatic NAT traversal to fail on certain Linux distributions.
It's now again possible for the gRPC server to listen on both IPv4 and IPv6 simultaneously.
lnd will now automatically re-create port port forwarding if we detect that the external public IP has changed.
Litecoin
lnd is now able to connect to Litecoin coins running on the regest network as well as the simnet network.
No More main Package!
There is no longer a main package, instead the top-level package within the project is now lnd. This is a prep for changes to make lnd easier to embed in mobile applications for iOS and Android.
Changelog
The full list of changes since 0.6.0-beta can be found here:
Contributors (Alphabetical Order)
Chris Coverdale
Conner Fromknecht
Damian Mee
Danny Paz
frennkie
Johan T. Halseth
Joost Jager
Matt Drollette
Offer Markovich
Olaoluwa Osuntokun
Robert Habermann
Valentine Wallace
Wilmer Paulino
/laolu32@gmail.com