Documentation
Liquid Wallet Kit (LWK)
on Railway
Deploy Blockstream's Liquid Wallet Kit on Railway for multi-sig Bitcoin/Liquid operations with Jade HWW support.
If you want a full validating Liquid node instead of the lighter LWK path, use Blockstream's official Elements Core guide.
Official Blockstream GuideSet up a Liquid node →
Blockstream's guide covers Elements Core installation, Liquid chain sync, and the optional Bitcoin-node peg-in validation path.
Prerequisites
- ✓Railway account with a project
- ✓Blockstream Jade hardware wallet (optional, for HWW)
- ✓Basic CLI knowledge (cargo, docker)
Architecture
🔧
LWK CLI
Rust-based wallet kit
🚂
Railway
Hosting & persistence
💎
Jade HWW
Hardware signing
Setup Guide
1
Clone LWK Repository
git clone https://github.com/Blockstream/lwk.git cd lwk
2
Build LWK
cargo build --release # Or use Docker: docker build -t lwk .
3
Set Up Signer
Choose your signing method:
Software Signer
./lwk_cli signer create --mnemonic "your twelve words..."
Jade HWW
./lwk_cli signer create --jade /dev/ttyUSB0
4
Create Multi-Sig Wallet
# 2-of-2 multisig example ./lwk_cli wallet create --descriptor "wsh(multi(2,key1,key2))" --name my-liquid-wallet --network liquid
5
Deploy to Railway
# Option A: Docker railway init railway up # Option B: Direct binary # Add start command in Railway: ./lwk_cli server start --port $PORT
Railway Environment
# Required environment variables:
LIQUID_NETWORK=liquid
ELECTRUM_URL=https://liquid.electrum.blockstream.info:50002
ESPLORA_URL=https://liquid.electrum.blockstream.info
Using the Wallet
Get Balance
./lwk_cli wallet balance --wallet my-liquid-wallet
Issue Asset
./lwk_cli asset issue --ticker MYTOKEN --name "My Token" --amount 1000000 --wallet my-liquid-wallet
Send Transaction
./lwk_cli tx create \ --wallet my-liquid-wallet \ --recipient lq1... \ --satoshi 100000
Agentbot Integration
Connect your LWK instance to Agentbot for automated Liquid operations:
- →Use x402 protocol for L-BTC payments
- →Issue security tokens for fan clubs
- →Automated royalty distributions via Liquid