breez-sdk-spark

What it is and what it does

Breez SDK - Spark is a Python wrapper around Breez's Rust-based Bitcoin and stablecoin payment SDK, designed to let developers add non-custodial payment flows to their applications without running a full node. It abstracts away the complexity of Bitcoin, Lightning, and Spark (a Layer 2 protocol built on multi-signature delegation) so that users can send and receive payments in BTC, USDT, USDC, and Spark tokens via Lightning addresses, LNURL-Pay, on-chain addresses, and Spark addresses.

The SDK handles key management (keys stay with the user), multi-device sync, payment persistence, and automatic on-chain claims. Under the hood, Spark uses a shared signing protocol where Spark Operators facilitate instant settlement without requiring blockchain confirmations, while funds remain non-custodial and can be exited to the Bitcoin main chain at any time. You'll need a free API key from Breez to initialize the SDK.

Use it for:

• Add Bitcoin/Lightning payment acceptance to a Python web app or service without managing your own node infrastructure.
• Build a mobile or desktop wallet that supports multiple payment protocols (Lightning, on-chain, Spark tokens) with a single SDK.
• Implement stablecoin (USDT/USDC) send functionality in a fintech or remittance application.
• Enable seedless, passkey-based login for a Bitcoin app with real-time balance sync across devices.
• Integrate Spark token issuance and transfer for custom tokenized value on a Bitcoin Layer 2.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python bindings for the Breez Spark SDK, enabling non-custodial Bitcoin and stablecoin payments via Lightning, Spark, and on-chain protocols.

Yes—if you are building a Bitcoin or stablecoin payment feature in Python and want to avoid the operational burden of running a Lightning node or managing keys yourself. The SDK is free, actively maintained, has no runtime dependencies, and covers a broad range of payment protocols. The main gotcha is the required API key; beyond that, install friction is low and security posture is solid (no vulnerabilities reported, MIT license, recent release).

Install

breez-sdk-spark on PyPI

pip install breez-sdk-spark

uv add breez-sdk-spark

poetry add breez-sdk-spark

Installing breez-sdk-spark

Before you install

Medium install friction: precompiled wheels available across macOS, Linux (x86_64, aarch64), and Windows. Package is actively maintained with a recent release and no runtime dependencies to manage.

License in practice

MIT license (permissive) places no restrictions on commercial or private use; you may modify and distribute freely with attribution.

Quickstart

pip install breez-sdk-spark

from breez_sdk_spark import BreezSDK

# Initialize SDK with API key (required from breez.technology)
sdk = BreezSDK(api_key='your_api_key')

Requires a free API key obtained from breez.technology; without it, SDK initialization will fail.

Verify before relying

• Exact Python version support (requires_python field is unspecified in metadata)
• Whether passkey login and multi-device sync work out-of-the-box or require additional backend setup
• Real-world latency and fee characteristics for Spark vs. Lightning vs. on-chain payments
• Availability and stability of Spark Operators that facilitate the shared signing protocol

Package facts

Evidence: breez_sdk_spark-0.22.0-cp310-cp310-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp310-cp310-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp310-cp310-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp310-cp310-win32.whl; breez_sdk_spark-0.22.0-cp310-cp310-win_amd64.whl; breez_sdk_spark-0.22.0-cp311-cp311-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp311-cp311-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp311-cp311-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp311-cp311-win32.whl; breez_sdk_spark-0.22.0-cp311-cp311-win_amd64.whl; breez_sdk_spark-0.22.0-cp312-cp312-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp312-cp312-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp312-cp312-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp312-cp312-win32.whl; breez_sdk_spark-0.22.0-cp312-cp312-win_amd64.whl; breez_sdk_spark-0.22.0-cp313-cp313-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp313-cp313-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp313-cp313-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp313-cp313-win32.whl; breez_sdk_spark-0.22.0-cp313-cp313-win_amd64.whl

Tags

More Internet packages