| url | /libraries.md |
|---|---|
| description | Official clients, SDKs and libraries for integrating with Boltz — start here instead of integrating directly. |
::: danger
Securely integrating Boltz API directly is extremely involved. Based on our experience, integration is complex, error-prone, and likely a multi-month effort with numerous edge cases to cover, which will result in loss of funds if not handled correctly. Therefore, we strongly recommend using one of the official clients, SDKs, or libraries listed below instead.
If the libraries below do not serve your needs and you are absolutely committed to the task, do not integrate Boltz API directly without first contacting us via Support Chat or Email.
We do not provide support for custom integrations that we were not involved with.
:::
Boltz Client ⭐ Recommended
Covers most server-side use cases (e.g., swap server creating swaps for clients). Our battle-tested reference client for accepting Lightning payments without running a node and rebalancing existing Lightning nodes; it also provides a full-fledged Go library for Boltz API. Used by e.g.: Boltz BTCPay Plugin
Supported currencies: LN, BTC, LBTC
Breez SDK - Nodeless ⭐ Recommended
Covers most client-side use cases (e.g., mobile or browser app). A polished end-to-end solution for developers that includes a wallet, notification system, WebAssembly support, and bindings for Kotlin, Flutter, Python, React Native, and Swift. Used by e.g.: Klever Wallet and Misty Breez
Supported currencies: LN, BTC, LBTC
Boltz Core (TypeScript)
Our reference library in TypeScript. Used by e.g.: Boltz Web App and Boltz Backend
Supported currencies: LN, BTC, LBTC, RBTC, TBTC, WBTC, USDT,
USDC
Boltz Rust (Rust)
Our reference library in Rust, developed and maintained by the amazing folks at Bull Bitcoin and Boltz. Features bindings for Python. Used by e.g.: Bull Bitcoin Mobile and Aqua Wallet via Boltz Dart
Supported currencies: LN, BTC, LBTC