A blank steel backup plate and sealed recovery envelope, editorial illustration
Inheritance / GUIDE

Liana: a wallet with a built-in recovery plan

A desktop wallet where you spend as normal, and a second key, for an heir or a backup, can only move coins after a long period of inactivity. Set it up, back it up, keep the timelock fresh, and use the recovery path.

Start reading
10 min readEnglish
READING MODE

What Liana is

Liana is a free, open source Bitcoin wallet for Windows, Mac and Linux, made by Wizardsardine. Like any wallet, it has a key you spend with every day. Unlike most, it also lets you add a second key that can only move your coins after the wallet has been left untouched for a set time, a year by default.

That one idea solves two problems:

  • Inheritance. Give the second key to an heir. While you are around and using the wallet, it can do nothing. If you are gone, after the waiting time it can recover the coins, without a lawyer or a company holding your keys.
  • A safety net for yourself. Keep the second key somewhere else. If you lose your main key, you wait out the timer and recover with the other one.

The waiting time is enforced by the Bitcoin network itself, not by Liana or by Wizardsardine. Liana writes the rule into the wallet using a language called Miniscript; the Miniscript guide explains how.

Version 16.0 was current when I checked: released on 3 November 2026. Button names below come from the app's own source code at that version. Upgrading to 16 changes the wallet's database for good: older versions cannot open it afterwards.

Download it from lianawallet.com or from GitHub. Releases are built reproducibly and come with a list of checksums signed by the developer, so you can check your download. On Linux, the ready-made builds need a recent system (newer than Ubuntu 20 or Debian 11).

Liana ↗ · Liana 16.0 release ↗ · Liana: usage ↗

The one idea to understand: the timer

The waiting time is counted in blocks, about ten minutes each. A year is 52,596 blocks, Liana's default. The longest allowed is 65,535 blocks, about 15 months.

The timer runs separately for each coin, and starts when that coin is received. So the recovery key does not wait for you to be inactive in a general sense. It waits for each coin to sit unspent for the full period.

That means a coin you never touch will, one day, become spendable by the recovery key as well as by you. If you want your main key to stay in sole control, you have to refresh your coins before their timer runs out, by sending them to yourself. Liana reminds you, and has a button for it (see Keep the timer fresh). Each refresh is a normal transaction, with a normal fee.

Before you start

  • Two signing devices, one per key. Liana recommends a separate hardware wallet for each. It can make a key on the computer instead, a "hot key", but its own note says to use that only for testing, because the words are stored unprotected on the drive.
  • A device that supports Miniscript. Liana's list: Ledger, BitBox02, Jade (Segwit only, not Taproot), Specter DIY, and Krux by SD card, and others. Passport is not on Liana's list. Update the device's firmware first.
  • A way to reach the Bitcoin network. Your own node, a node Liana installs for you, or Wizardsardine's hosted service. See Choose how to connect.

Create the wallet

Welcomebitcoin ▾
Create a new Liana walletSelect
Add an existing Liana walletSelect
1 / 4
Illustration of creating a wallet, drawn from the wording in Liana 16.0. Not a screenshot; layout and colours are simplified.
  1. Open Liana. The drop-down at the top chooses the network: check it says bitcoin, not a test network. Then choose Create a new Liana wallet.
  2. Under Choose wallet type, pick a template:
    • Simple inheritance: your key spends at any time, your heir's key after the waiting time. The best starting point for most people.
    • Expanding multisig: two keys must sign today, and after the waiting time a third key can step in for a missing one.
    • Build your own: any mix of paths, keys and waiting times.
  3. Read the Introduction and click Next.
  4. On Set keys, the address type defaults to Taproot (recommended), which lowers fees and improves privacy. Switch it to Segwit only if one of your devices cannot do Taproot, such as a Jade.
  5. Click the waiting time to change it. Type a number of blocks or use the slider, then Apply.
  6. Click Set on the primary key and choose its device (next section). The inheritance key's Set button appears once the primary key is set. When every key is set, click Next.

Customize opens the full editor, where Add recovery path adds more than one: for example, a key for your partner after six months and one for a lawyer after a year. No two recovery paths can open at the same time.

Add the keys

Clicking Set opens Select key source:

  • Detected devices lists signing devices plugged in by USB and unlocked. A BitBox02 shows a pairing code first. If a device needs newer firmware, or is on the wrong network, Liana says so here.
  • Other options lets you import a key from a file, paste one, or Generate hot key stored on this computer. Keep that last one for testing.

Give each key a name you will recognise, such as "My Ledger" or "Sam's BitBox". If the same device is already used in another wallet, Key path account lets you pick a different account on it.

Back up the descriptor as well as the words

This is the step that matters most, and it is different from most wallets.

Back up your wallet configuration (descriptor)

This backup is required to recover your funds.

The descriptor:tr([...])#checksum (example)Back up descriptor

☑ I have backed up my descriptor

Next
1 / 3
Illustration of backing up, registering and connecting the wallet, drawn from the wording in Liana 16.0. Not a screenshot; layout and colours are simplified.

A Liana wallet is defined by two things:

  1. The keys, each backed up as recovery words for its own device, as usual.
  2. The descriptor: the wallet's rules. Which keys can spend, how many signatures are needed, and how long the waiting time is.

Without the descriptor, the recovery words alone cannot find or spend the coins. Liana says so on the screen: "This backup is required to recover your funds", and the file "does not include your seed phrase(s)".

  • Click Back up descriptor. Liana saves an encrypted file that can only be opened with one of the wallet's keys. Store copies in several places: with your own backup, and with each person who holds a key, such as your heir.
  • Someone who finds the descriptor can see your balance and history, but cannot spend. Someone who finds a key's words without the descriptor cannot find the wallet. Keep both, and keep them apart.
  • Tick I have backed up my descriptor.
  • If you use hardware signing devices, Register descriptor comes next: register the wallet on each device. Each device then knows the rules and can check what it signs. Registering is not a backup: you still need the file. With pasted keys or a hot key, Liana skips this step.

Write a short note for your heir, kept with their key: that the wallet is a Liana wallet, where the descriptor file is, and that the key works only after the waiting time. The inheritance plan guide covers what else to leave them.

Choose how to connect

  • Use your own node. "The Liana wallet will not connect to any external server." Choose I already have a node to connect to Bitcoin Core on this computer, or to an Electrum server on this computer or another one (start a remote address with ssl:// for an encrypted connection). Or let Liana install a pruned Bitcoin Core for you. That needs about 30 GB of disk space and can take days to sync. Liana checks the download before installing it. It cannot connect to Bitcoin Core on another machine.
  • Use Liana Connect. Wizardsardine runs the server and keeps a backup of your descriptor, and several computers or people can share the wallet. You sign in with an email address, and Liana's own description says Wizardsardine "will be able to see your wallet's information, associated to an email address". It cannot move your coins. I found no price for it.

Liana warns that a node you do not control can show you incorrect balances. You can switch later in Settings.

Last, give the wallet a name and click through Finalize installation.

Receive and send

The sidebar holds Dashboard, Send, Receive and Drafts & approvals, then Recovery, Transactions, Coins/UTXOs and Settings.

Receive

  1. Open Receive and click Generate address. Liana's advice: always generate a new address for each deposit.
  2. Give it a label so you know later what it was for.
  3. Before you share it, check it on your hardware wallet with Verify on signing device.

Send

  1. Open Send. Enter the Address, a Payment label (Liana requires one) and the amount. Add payment pays several people in one transaction.
  2. Set the fee with Smart select (Low, Medium or High) or Manual.
  3. Under Coins selection, choose which coins pay. Each shows how long until its recovery path opens.
  4. Click Next, then Sign, and approve on your device. If a second person must sign, use Export to send them the transaction and Import to bring it back.
  5. Click Broadcast.

A payment stuck unconfirmed can be sped up from Transactions with Bump fee, or cancelled with Cancel transaction.

Keep the timer fresh

DashboardSendReceiveRecoveryCoins/UTXOs
0.250 BTC
Recovery path is or will soon be available for 2 coin(s).
Reset timelock
1 / 3
Illustration of the timelock warning, the self-transfer and the Recovery page, drawn from the wording in Liana 16.0. Not a screenshot. Amounts are examples.

When a coin is within the last tenth of its waiting time, the Dashboard shows Recovery path is or will soon be available for N coin(s). For a one-year wait that is roughly the last five weeks.

  1. Click Reset timelock. Liana opens a Self-transfer with those coins already selected.
  2. Click Next, sign with your main key, and broadcast. The coins move to a new address in the same wallet, and their timer starts again once the transaction confirms.

Coins/UTXOs shows every coin's remaining time and has its own Reset timelock button. A useful habit is to refresh everything once a year on a date you will remember.

If you miss it, nothing is lost: your main key can still spend as usual. The only change is that the recovery key can now spend those coins too.

Using the recovery path

This is what your heir, or you after losing your main key, would do.

  1. Install Liana and choose Add an existing Liana wallet. Pick the same way to connect.
  2. Bring in the descriptor with Import a backup (the encrypted file, opened by plugging in the recovery key's device) or Paste a descriptor. With your own Bitcoin Core, rescan afterwards under Settings > Node to find the coins.
  3. Open Recovery in the sidebar. It lists each path that is open and the coins it can move, or says No recovery path is currently available if the waiting time has not passed.
  4. Pick the path, click Next, and enter an address in a different wallet. Liana warns if you send to the same wallet, because its main key is the one that was lost.
  5. Sign with the recovery key and broadcast.

Practise this once with a small amount on a test wallet before you rely on it, ideally with the person who will one day do it. A recovery rehearsal shows how.

Before you rely on it

  • Each key is on its own hardware wallet, with its words backed up.
  • The descriptor file is saved in several places, including with your heir.
  • The descriptor is registered on each device.
  • Your heir has a note saying what the wallet is and where things are.
  • You have a yearly reminder to refresh your coins.
  • You have rehearsed a recovery with a small amount.

Liana makes an inheritance plan possible without handing your keys, or your coins, to anyone else. If you would like help designing the paths and waiting times for your situation, or rehearsing a recovery with your family, that is something I cover in mentorship sessions.

Sources & further reading

Researched 17 November 2026. Software and services change: check the current documents before you act.

Make a plan someone else can follow → · Miniscript → · Do you actually need multisig? → · A backup is a plan you have tested → · Run a node you actually use → · Running a node →

Continue your path

One question leads to another.

01Make a plan someone else can follow02Your balance is a collection of stories

Find your next answer.

Search the complete field guide · Esc to close