Quickstart

This guide walks through a minimal single-signature flow on Liquid testnet: create a signer, open a wollet, sync, send, sign, and broadcast.

Quickstart

This guide walks through a minimal single-signature flow on Liquid testnet: create a signer, open a wollet, sync, send, sign, and broadcast.

For installation options see Installing LWK. For deeper explanations see How LWK Works.

1. Install

Pick your language binding (see Installing LWK for all platforms):

pip install lwk
# Cargo.toml
[dependencies]
lwk_wollet = "0.17.0"
lwk_signer = "0.17.0"
lwk_common = "0.17.0"
npm install lwk_wasm

2. Create a signer

use lwk_signer::{bip39::Mnemonic, SwSigner};

let mnemonic = Mnemonic::generate(12)?;
let is_mainnet = false;
let signer = SwSigner::new(&mnemonic.to_string(), is_mainnet)?;
from lwk import Mnemonic, Signer, Network

mnemonic = Mnemonic.from_random(12)
signer = Signer(mnemonic, Network.testnet())
const mnemonic = lwk.Mnemonic.fromRandom(12);
const network = lwk.Network.testnet();
const signer = new lwk.Signer(mnemonic, network);

3. Open a wollet

Derive a CT descriptor from the signer and create a watch-only wollet:

use lwk_wollet::{Network, WolletBuilder, WolletDescriptor};

let desc = signer.wpkh_slip77_descriptor()?;
let wd = WolletDescriptor::from_str(&desc)?;
let mut wollet = WolletBuilder::new(Network::TestnetLiquid, wd).build()?;
desc = signer.wpkh_slip77_descriptor()
wollet = Wollet(network, desc, datadir=None)
const desc = signer.wpkhSlip77Descriptor();
const wollet = new lwk.Wollet(network, desc);

4. Sync and check balance

Connect a blockchain client and scan the chain. Fund the wallet with testnet L-BTC from liquidtestnet.com/faucet if needed.

See Blockchain Scan for client setup.

5. Send, sign, broadcast

  1. Create an unsigned PSET with Transaction Creation.
  2. Sign it with Transaction Signing.
  3. Broadcast via Transaction Broadcast.

Next steps

TopicGuide
Multisig custodyMultisig
Issue an assetIssuance
CLI workflowlwk_cli on GitHub

Next: Signers


The Liquid Network is a production Bitcoin sidechain built with Elements, supporting confidential transactions, asset issuance and programmable smart contracts.

© 2026 Liquid Network
All rights reserved.

Feedback and Requests

We'd be happy to hear your suggestions on how to improve this site.

Simplicity Forum

Discuss SimplicityHL, tooling and applications on Liquid at community.simplicity-lang.org.

Liquid Dev Community

Community Telegram group where most of the Liquid developers hang out. Go to t.me/liquid_devel to join.