Open-source Lightning & on-chain infrastructure
Ship any Lightning product in under 3 minutes
Breez Infra is the open-source stack for introducing Lightning and on-chain payments into your app, platform, or product — wallets, checkout flows, micropayments, and more. No node required.
Community deployments
🇸🇳 Senegal
Lightning + on-chain
🇧🇯 Benin
Wallets & rails
What you can build
One infrastructure, endless Lightning products
Breez Infra is the foundation for any project that needs Lightning or on-chain Bitcoin — ship wallets, checkout flows, micropayments, and payment rails without running your own node.
Lightning Wallets
Spin up a self-custodial wallet backend — receive, send, check balance, and sign messages. Build mobile or web wallets without running a node.
Custom Lightning Addresses
Deploy your own Lightning address system on your domain. Route user@yourapp.com payments through LNURL and BOLT 12 offers.
Payment Rails
Embed sats-based checkout into marketplaces, SaaS products, or community platforms. BOLT 11, BOLT 12, on-chain, and fiat conversion built in.
EdTech Micropayments
Charge per lesson, per article, or per minute of video. Perfect for educational platforms where traditional payment fees kill small transactions.
Pay-for-WiFi
Sell timed internet access at events, co-working spaces, or cyber cafés. Captive portal + Lightning invoice in one flow.
Merchant & POS Tools
Generate QR invoices for local merchants, track payment status in real time, and onboard businesses to the Lightning economy.
Quick Start
Up and running in 3 minutes
Three steps from zero to a live Lightning and on-chain payment stack. No full node, no DevOps headache — just Node.js, a Breez API key, and your product.
Get your Breez API key
Request a free Breez API key and prepare a dedicated demo wallet mnemonic.
Clone & configure
Install dependencies, add your Breez credentials, then generate read and spend keys with the built-in rotation CLI.
Launch your infrastructure
Your Lightning and on-chain payment stack is live. Plug it into your app, marketplace, or platform immediately.
npm start · Docs: npm run docs:dev · Rotate keys: npm run rotate-keys -- --graceCapabilities
Infrastructure primitives, ready to compose
Wallet core, invoice engine, on-chain receive, and payment rails — the building blocks for any project that accepts Bitcoin.
Wallet Core
Self-custodial wallet powered by Breez Liquid SDK. Mnemonic-backed, nodeless — the foundation for any Lightning product you want to build.
Payment Rails
Pay Lightning invoices, LNURL, Lightning addresses, and on-chain Bitcoin. Fiat-to-sats conversion for flexible pricing.
Invoice Engine
BOLT 11 and BOLT 12 invoices with QR codes, payment tokens, and automatic status tracking when sats arrive.
On-Chain Payments
Receive Bitcoin on-chain alongside Lightning. Generate addresses, QR codes, and unified payment flows for any product that needs both layers.
Tiered API Keys
Read keys for frontends, spend keys for admin. Generate and rotate them from the CLI with npm run rotate-keys — no manual secret crafting.
Event-Driven Flows
SDK payment events trigger downstream actions — unlock WiFi, grant course access, or notify your app when a payment lands.
Developer-Ready
Swagger at /api-docs, Mintlify guides, and a clean MVC architecture. Extend controllers to match your use case.
Battle-tested in Africa
Real projects, real Bitcoin payments
From startups to community platforms, teams across Africa use Breez Infra to introduce Lightning and on-chain payments into products people use every day.
Architecture
The stack behind your Bitcoin payments
Whether you are launching a wallet, adding checkout to a SaaS product, or enabling micropayments on a content platform — Breez Infra gives you a nodeless, self-custodial backend for Lightning and on-chain from day one.
Safe by design
Read keys for client apps, spend keys server-side only. Rotate keys with npm run rotate-keys — use --grace to roll out without downtime.
Event-driven architecture
Payment events trigger real-world actions — unlock WiFi, grant course access, or notify your frontend instantly.
Real-world patterns included
Pay-for-WiFi, merchant invoicing, and fiat rates — reference implementations you can fork and adapt.
Payment flow
WiFi packages
API Reference
RESTful primitives for every product
Wallet, invoice, payment, and WiFi endpoints — compose them into wallets, Lightning address routers, edtech paywalls, or merchant tools. Interactive Swagger docs at /api-docs when the server is running.
/health/rates/priceContribute
Claim an issue. Ship from the browser.
Open issues sync from GitHub. Comment /claim on any issue to trigger the assignment workflow — no maintainer ping needed.
Pick an open issue
Browse bugs, features, and good-first tasks from the live GitHub board.
Comment /claim
A GitHub Action listens for your comment, assigns the issue to you, and labels it in progress.
Ship a PR
Fork, branch, and open a pull request. CI runs on every push.
No open issues right now — be the first to propose one.
Open new issueRequires a issue_comment workflow in the repo — add .github/workflows/claim-issue.yml to assign contributors when they comment /claim.
Your Lightning stack starts here
Clone the repo, configure your keys, and add Lightning and on-chain payments to your next app, SaaS, marketplace, or community platform.