Today, Breez released a big update to the Nodeless SDK ⚡️
Check out the release notes for more details: https://github.com/breez/breez-sdk-liquid/releases/tag/0.8.0
1. WASM support
Nodeless now supports WebAssembly, so apps can now add Bitcoin payments directly into browsers and node.js environments.
To make WASM happen, we’ve made major improvements across the SDK.
⚠️ Warning: we’re about to go technical ⚠️
WASM-Compatible SDK Core
We updated the 𝚜𝚍𝚔-𝚌𝚘𝚖𝚖𝚘𝚗 crate to work in WASM environments by:
→ Integrating a WASM-compatible gRPC client using 𝚝𝚘𝚗𝚒𝚌_𝚠𝚎𝚋_𝚠𝚊𝚜𝚖_𝚌𝚕𝚒𝚎𝚗𝚝
→ Implementing custom DNS resolution for WASM
→ Refactoring the internal REST client to remove non-WASM-compatible dependencies
→ Introducing a new 𝚜𝚍𝚔-𝚖𝚊𝚌𝚛𝚘𝚜 crate for shared macro support across platforms
New WASM-Specific Crate
We added a dedicated WASM interface using 𝚠𝚊𝚜𝚖-𝚋𝚒𝚗𝚍𝚐𝚎𝚗, with custom type and callback handling to provide a smooth developer experience.
Flexible SDK Customization
The new 𝙻𝚒𝚚𝚞𝚒𝚍𝚂𝚍𝚔𝙱𝚞𝚒𝚕𝚍𝚎𝚛 makes it easy to configure SDK components:
→ Includes platform-specific filesystem abstractions
→ Supports persistent storage in both Web and Node.js environments
SQLite and Cache Handling
Since traditional databases are challenging in WASM, we:
→ Use an adapted in-memory SQLite setup via 𝚛𝚞𝚜𝚚𝚕𝚒𝚝𝚎
→ Added a custom persistent watcher to handle state
Background Tasks & System Adaptations
We implemented WASM-friendly alternatives for:
→ Background task spawning
→ Interval management
→ Accessing system time
Alternative Blockchain Data Sources
Electrum isn’t viable in-browser, so we:
→ Integrated support for 𝚆𝚊𝚝𝚎𝚛𝚏𝚊𝚕𝚕𝚜 as a lightweight blockchain data source
WASM-Ready Boltz Integration
→ We refactored the Boltz swap client to be fully compatible with WASM environments.
gRPC-Web Proxy Support
All gRPC-based services (e.g., Breez Server and real-time sync):
→ Now support 𝚐𝚁𝙿𝙲-𝚆𝚎𝚋 proxies
→ Enabling full connectivity from browser environments
Need more guidance on building Lightning payments on the web? Check out our WASM demo app. https://github.com/breez/wasm-example-app
2. Lower Minimum Send/Receive Amounts
We’ve significantly lowered the minimums for sending and receiving payments with the Breez SDK - Nodeless.
You can now:
➡️ Send from just 21 sats ⬅️ Receive from just 100 sats
3. Pay Fees with Non-Bitcoin Assets
Users can now pay fees without using Bitcoin — instead paying fees with other assets like USDT.
A smoother UX for your users — more flexibility for your app.
