Lightning Terminal v0.15.0-alpha.rc1
Pre-releaseThis version of Lightning Terminal (LiT) ships lnd v0.19.0-beta
and tapd v0.6.0-rc2
which comes with full group key support for Taproot Assets Channels!
We'll be continuously working to improve the user experience based on feedback from the community.
Installation and configuration instructions can be found in the README.
This release packages LND v0.19.0-beta
, Taproot Assets Daemon v0.6.0-rc2
, Loop v0.31.1-beta
, Pool v0.6.5-beta
and Faraday v0.2.14-alpha
.
-
IMPORTANT NOTE: To avoid loss of funds, it's imperative that you read the Operational Safety Guidelines before before using tapd on mainnet!
-
The Taproot Assets daemon is still in alpha state, which means there can still be bugs and not all desired data safety and backup mechanisms have been implemented yet. Releasing on mainnet mainly signals that there will be no breaking changes in the future and that assets minted with v0.3.0+ will be compatible with later versions.
Breaking changes (from v0.14.x to v0.15.x)
There are no breaking changes between litd v0.14.1-alpha
and v0.15.0-alpha.rc1
.
If you are upgrading from an older version than litd v0.14.1-alpha
, please carefully read the release notes of litd v0.14.1-alpha
.
IMPORTANT NOTE if you ran litd
from the master branch at any point and you run into the following error on startup:
ErrTypeForDecoding want (type: *uint8, length: 1), got (type: *uint8, length: 147)
Then you should revert to the version of litd
you ran before, and execute the following commands on that old version before updating to this version:
- Run
lncli querymc > mission_control_backup.json
to back up your mission control state. - Run
lncli resetmc
to clear the mission control state in the database. - Update
lnd
andlncli
to the new version. - (optional) Use
lncli loadmc --mcdatapath mission_control_backup.json
to restore the backup. Note: This data will not persist across restarts.
Important note for Umbrel/Lightning Terminal users
DO NOT UNDER ANY CIRCUMSTANCE uninstall (or re-install) the "Lightning Terminal" app without first making a manual backup of all local tapd data, if you are using Taproot Assets as part of the "Lightning Terminal" app with Umbrel -- or any comparable node-in-a-box solution. Uninstalling Umbrel apps deletes application data. This Taproot Assets application data encumbers Taproot Assets AND bitcoin funds. Receiving and sending tapd assets updates the daemon's funds-custody material. Merely having the lnd seed phrase is NOT enough to restore assets minted or received. WITHOUT BACKUP BEFORE DELETION, FUNDS ARE DESTROYED.
lnd
in remote mode (lnd-mode=remote
)
NOTE that the minimum version of lnd
that can be used in --lnd-mode=remote
is v0.19.0-beta
.
Required changes when running in lnd
remote mode
When connecting to an existing lnd
node, that node must enable the RPC middleware interceptor feature. You can enable that by specifying the --rpcmiddleware.enable
command line flag or by adding rpcmiddleware.enable=true
to your lnd.conf
file. See the remote configuration docs for more information.
NOTE: Taproot Assets Channel functionality is only available when both lnd
and tapd
are running in the same process (by setting both
lnd-mode=integrated
and taproot-assets-mode=integrated
). Remote mode support
will be added in the future.
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 Oliver Gugger
's key from the ubuntu key server:
gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys F4FC70F07310028424EFC20A8E4256593F177720
Once you have his PGP key you can verify the release (assuming manifest-guggero-v0.15.0-alpha.rc1.sig
and manifest-v0.15.0-alpha.rc1.txt
are in the current directory) with:
gpg --verify manifest-guggero-v0.15.0-alpha.rc1.sig manifest-v0.15.0-alpha.rc1.txt
You should see the following if the verification was successful:
gpg: Signature made Wed 21 May 2025 20:08:47 CET
gpg: using RSA key F4FC70F07310028424EFC20A8E4256593F177720
gpg: Good signature from "Oliver Gugger <[email protected]>" [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:
cat manifest-v0.15.0-alpha.rc1.txt
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.15.0-alpha.rc1
Verifying the Release Timestamp
We have also started to timestamp the manifest file with OpenTimeStamps along with its signature. A new file is now included along with the rest of our release artifacts: manifest-v0.15.0-alpha.rc1.sig.ots
.
Assuming you have the opentimestamps client installed locally, the timestamps can be verified with the following command:
ots verify manifest-guggero-v0.15.0-alpha.rc1.sig.ots
These timestamps should give users confidence in the integrity of this release even after the key that signed the release expires.