v4.0rc1: release candidate of upcoming 4.0 release

See changelog here. Use only for testing. Report any bugs to the issue tracker. Thanks!

v3.0: Terceira

If you are unsure which file to download from the list, see the last section below. For installation instructions see the README.

---

This release introduces support for the BitBox02 signing device, as well as the possibility to label
payments, batches of payments, coins and addresses.

Breaking changes

• Descriptors with duplicate signers within a single spending path are not supported anymore.
  Note re-using a signer across spending paths (for instance for a decaying multisig) is still
  supported, this only concerns pathological descriptor where the same signer would be repeated in
  the same path.

Features

• Two new optional parameters were introduced to the listcoins command to be able to filter coins
  by status (confirmed, spent, etc..) and outpoints (to query specific coins).
• We updated the "quick try" guide
  to make use of the managed bitcoind. Trying out Liana on Signet is now easier than ever!

GUI-specific

• You can now use the BitBox02 signing device. The minimum
  supported version of the firmware is v9.15.0, so make sure to upgrade!
• It's now possible to label coins and payments (that is, a transactions output). It's also possible
  to label batches of payments (that is, a transaction itself) and addresses.
• The number of steps in the installer was reduced by dropping the final confirmation screen. The
  wallet will now start automatically after configuration, reducing the information load and number
  of clicks for the user.
• All text inputs are now sanitized to remove whitespaces. No need to manually remove a trailing
  whitespace when importing a PSBT for instance!
• Various loading screens at startup were updated to include more information.
• The transaction fee rate is now displayed in addition to the absolute fee in the details.
• The managed bitcoind version was bumped to 25.1 for new installations.

Fixes

• We fixed the minimum glibc version in the dependencies of the Debian package.
• We could previously crash if we were started up against a bitcoind itself recovering from a previous
  crash and in the process of re-connecting the entire chain.
• A few incorrect commands were corrected in the wallet recovery documentation.

GUI-specific

• Selecting a coinbase transaction won't make the GUI crash anymore.
• At startup there could previously be a small lag before the home page gets updated with the list
  of payments and correct balance.
• During installation, when using a managed bitcoind, the GUI could previously freeze after starting
  up bitcoind.

What file from the list should i download?

If you are not sure what executable below you should download, pick:

• Liana.zip if you are on MacOS,
• liana-3.0.exe if you are on Windows,
• liana_3.0-1_amd64.deb if you are running a Debian-based Linux (such as Ubuntu). Use apt install ./liana_3.0-1_amd64.deb as root (or preceded by sudo) to install it.
• liana-3.0-x86_64-linux-gnu.tar.gz if you use another Linux distribution. Note you may have to compile the software yourself if you are on Linux. See the README.

v3.0rc1: release candidate of upcoming 3.0 release

See changelog here. Use only for testing. Report any bugs to the issue tracker. Thanks!

v2.0: (un)conference season

This release significantly simplifies the installation of Liana. It also fixes a number of small
bugs and glitches.

Breaking changes

• Descriptors created with Liana v2 may not be backward compatible with Liana v1.

Features

• We made it possible to re-use an xpub within a descriptor, so long as it uses a different
  derivation path.
• We added new RPC commands allowing for updating and querying labels of txids, addresses and
  outpoints.
• We've made our RPC connection to bitcoind more robust.
• We now distribute packages for Debian-based and Arch-based Linux distributions.
• A guide on how to recover a Liana wallet backup with Bitcoin Core was added.
• An example config file for running lianad was added.
• We've worked around the use of prefixed-paths on Windows thereby allowing us to bring back the
  watchonly wallet at the same location as for other operating systems, under our own datadir.

GUI-specific

• The UX for creating a descriptor where a signer is present in different spending paths was
  significantly improved.
• The installation process, as well as the usage of the wallet, was made more user friendly by
  optionally encapsulating the management (download, start and stop) of the bitcoind.

Fixes

• We more gracefully stop the Bitcoin backend poller when the block chain is still in the process of
  being synchronized. This would previously appear to hang and could freeze the GUI.
• The handling of conflicting unconfirmed spend transactions (RBFs) was fixed.
• If paid directly through a coinbase transaction output, the wallet could have previously missed
  it. This was fixed.
• We now correctly treat immature coinbase deposits as unspendable. They are otherwise treated
  similarly to unconfirmed coins.
• We now tell bitcoind to load our watchonly wallet upon startup. Not loading the watchonly wallet
  on startup could make bitcoind unable to load it without reindexing the block chain, if using an
  aggressive pruning configuration.
• lianad will now print a more helpful message on startup failure (and link to the newly added
  config file example).

GUI-specific

• We now check the network of xpubs when importing a descriptor.
• The GUI would sometimes fail to connect to the Specter DIY signing device.
• We now convey the descriptor registration step on a signing device isn't necessary if none were
  used.
• We could previously appear to hang during shutdown.

---

Shoutout to Pythcoiner for steadily helping by testing, guiding new
users and even contributing a guide to recover from a Liana wallet
backup with nothing but Bitcoin Core 25.0!

---

If you are not sure what executable below you should download, pick:

• Liana.zip if you are on MacOS,
• liana-2.0.exe if you are on Windows,
• liana_2.0-1_amd64.deb if you are running a Debian-based Linux (such as Ubuntu). Use apt install ./liana_2.0-1_amd64.deb as root (or preceded by sudo) to install it.
• liana-2.0-x86_64-linux-gnu.tar.gz if you use another Linux distribution. Note you may have to compile the software yourself if you are on Linux. See the README.

v2.0rc2: test upcoming 2.0 release (now with more fixes!)

See changelog here. Use only for testing. Report any bugs to the issue tracker. Thanks!

v2.0rc1: test release of upcoming v2.0

See changelog here. Use only for testing. Report any bugs to the issue tracker. Thanks!

v1.1: Miami sunset

This is a small patch release for the 1.0 version of Liana. It fixes a couple glitches that have been encountered in the wild:

• The GUI would sometimes fail to connect to the Specter DIY signing device.
• We didn't set the bitcoind watchonly wallet as to be loaded upon bitcoind startup. This could cause issues that would lead to the user having to reindex when using an aggressive pruning configuration.

Upgrading is recommended but not necessary if you are not using a Specter DIY signing device.

If you are not sure what executable below you should download, pick:

• Liana.zip if you are on MacOS,
• liana-1.1.exe if you are on Windows,
• liana_1.1-1_amd64.deb if you are running a Debian-based Linux (such as Ubuntu). Use apt install ./liana_1.1-1_amd64.deb as root (or preceded by sudo) to install it.
• liana-1.1-x86_64-linux-gnu.tar.gz if you use another Linux distribution. Note you may have to compile the software yourself if you are on Linux. See the README.

v1.0: Miami sunrise

This is the first non-beta release of Liana.

Improvements were concentrated on the GUI. The UI was entirely overhauled.

Learn more about Liana from our website: https://wizardsardine.com/liana/.

Installation

If you are unsure which file to download, choose:

• Liana.zip if you are on MacOS
• liana-1.0.exe if you are on Windows
• liana-1.0-x86_64-linux-gnu.tar.gz if you are on Linux

Changelog

Features

• The createspend command now allows you to not provide any destination. In this case it will
  create a send-to-self transaction containing a single change output.

GUI-specific

• Overall there is a new layout and color scheme. The "draft transactions" menu was renamed to
  the more common "PSBTs".
• The homepage now features a list of payments, instead of transactions.
• The spend transaction creation process is now contained in a single screen. It allows you to
  easily create a send-to-self transaction by not specifying any recipient.
• The homepage will now feature an approximation of the remaining time before the first recovery
  path becomes available.
• The homepage now features a button to refresh all coins whose recovery path is available (or close
  to be), if there is any.
• Entries in the coins list now features a button to refresh a coin (create a send-to-self
  transaction in order to restart the timelock).
• You can now generate multiple receive addresses in a row.
• We now display the alias of signing devices (if any) in the final installer step.

Fixes

GUI-specific

• Send-to-self transactions are now displayed as such instead of being affected a "0.00000BTC"
  value.
• The installer will not present a step to register the descriptor on the signing device if there
  isn't any.
• Some wording improvements all around.
• The slider to configure timelocks in the installer now has a step of 144 (instead of 1).

Notable contributions

Shout out to @jp1ac4 for steadily contributing bug fixes and cool new features throughout this release!

v1.0rc1: Miami sunrise

This was the release candidate of version 1.0. Refer to the v1.0 release.

v0.4: more usable and more recovery paths!

This fourth release brings support for descriptors with multiple recovery paths as well as several
usability improvements in the GUI around signing devices management, and more.

Features

• We now support having multiple recovery path in a descriptor.
• We now support more general descriptors: multisigs in the primary or any of the recovery paths
  henceforth aren't required to use multi() anymore and the maximum number of keys per spending
  path is thereby lifted.

GUI-specific

• You can now re-register the descriptor on a hardware signing device in the settings.
• You can now change the alias of each of the signers from the settings panel.
• At signing time we now warn you if the descriptor is not registered on the signing device.
• The signer alias is now displayed along with its type when signing.
• You can now connect to a running daemon without having to provide a path to its configuration,
  provided it is using the default location for its data directory (or --datadir is used).
• The GUI will now log to a installer.log file at the root of the datadir during installation, and
  to a <network>/liana-gui.log when running. In case of crash, this will contain a backtrace.
• During installation we now check the connection to bitcoind.

Fixes

• We won't error when parsing of descriptor with a 1-of-N multisig as primary path.
• We won't error at startup if our watchonly wallet is loading on bitcoind. Instead, we'll wait for
  completion of the previous loading attempt.
  ...