How blockstream/lwk works
Liquid Wallet Kit is a Rust toolkit for building Liquid wallets and applications, rather than a single end-user wallet. A typical developer workflow defines a wallet from a descriptor, builds it, synchronizes wallet state from a chain service, then creates and signs transactions. The workspace also exposes app/RPC and language-binding entry points, hardware signers, swaps, payment instructions, asset registry and pricing, and Simplicity support. Edges below follow explicit imports or documented behavior; several major subsystems are represented from the tree and index without claiming their unsampled internals were inspected.
Main entry points: wollet.rs Watch-Only Wallet · elements_wallet.rs Wallet Builder · lib.rs App RPC Server · descriptor.rs Wallet Descriptor
Components 22
Wallet Core
- Wallet Descriptor
lwk_wollet/src/descriptor.rs - Watch-Only Wallet
lwk_wollet/src/wollet.rs - Wallet Builder
lwk_wollet/src/elements_wallet.rs - Chain Clients
lwk_wollet/src/clients - Wallet Updates
lwk_wollet/src/update.rs - Transaction Builder
lwk_wollet/src/tx_builder - Shared Wallet Logic
lwk_common/src/lib.rs - Wallet Persistence
lwk_common/src/store.rs
Developer Interfaces
- App RPC Server
lwk_app/src/lib.rs - RPC Methods
lwk_app/src/method.rs - Command Line
lwk_cli/src/main.rs - WebAssembly API
lwk_wasm/src/lib.rs - Language Bindings
lwk_bindings/src/lib.rs
Signing Devices
- Software Signer
lwk_signer/src/software.rs - Jade Signer
lwk_jade/src/sign_liquid_tx.rs - Ledger Signer
lwk_ledger/src/client.rs
Network Services
- Boltz Swaps
lwk_boltz/src/chain_swaps.rs - Asset Registry
lwk_registry/src/registry.rs - Price Data
lwk_prices/src/lib.rs
Payment and Contracts
- Payment Instructions
lwk_payment_instructions/src/lib.rs - Simplicity Runtime
lwk_simplicity/src/runner.rs
Other components
- Developer
Connections 22
- Developer → Wallet Builder: builds wallet
- Wallet Builder → Wallet Descriptor: uses descriptor
lwk_wollet/src/lib.rs - Wallet Builder → Watch-Only Wallet: builds
lwk_wollet/src/lib.rs - Watch-Only Wallet → Chain Clients: scans through
lwk_wollet/src/lib.rs - Watch-Only Wallet → Wallet Updates: uses updates
lwk_wollet/src/lib.rs - Watch-Only Wallet → Transaction Builder: creates transactions
lwk_wollet/src/lib.rs - Watch-Only Wallet → Shared Wallet Logic: uses shared logic
- Wallet Builder → Wallet Persistence: configures stores
- Developer → App RPC Server: calls RPC
- App RPC Server → RPC Methods: dispatches methods
lwk_app/src/lib.rs - App RPC Server → Watch-Only Wallet: wires wallet calls
lwk_app/src/lib.rs - Developer → Command Line: runs commands
- Developer → WebAssembly API: uses API
- Developer → Language Bindings: uses bindings
- Watch-Only Wallet → Software Signer: signs with
- Watch-Only Wallet → Jade Signer: signs with
- Watch-Only Wallet → Ledger Signer: signs with
- Developer → Boltz Swaps: initiates swaps
- Developer → Asset Registry: queries assets
- Developer → Price Data: queries prices
- Developer → Payment Instructions: parses payments
- Developer → Simplicity Runtime: runs programs