LNbits, free and open-source lightning-network wallet/accounts system.
Go to file
dni ⚡ 741ecac78b
feat: improve on api structure, add openapi tags (#2295)
this logically groups api endpoints and gioves them specific openapi tags. which makes them nice on the `/docs` endpoint and makes the `api.py` more approachable
* add wallets list endpoint
* remove trailing slashes from endpoints
* fixup topup url
* fix trailing slash on auth
* backwards compatibility
2024-03-28 08:59:28 +01:00
.github ci: run jmeter only if linting passes to save resources (#2366) 2024-03-26 20:27:12 +01:00
docs initial scaffolding for zbd wallet 2024-02-23 16:11:27 -03:00
integration feat: improve on api structure, add openapi tags (#2295) 2024-03-28 08:59:28 +01:00
lnbits feat: improve on api structure, add openapi tags (#2295) 2024-03-28 08:59:28 +01:00
nix add option to pass additional variables 2023-12-11 08:33:16 +01:00
tests feat: improve on api structure, add openapi tags (#2295) 2024-03-28 08:59:28 +01:00
tools feat: add tool preimage generator (#2321) 2024-03-12 11:46:46 +01:00
.dockerignore good bye venv (#1569) 2023-03-16 16:45:23 +01:00
.editorconfig add editorconfig config, fix issues (only whitespace changes) (#1958) 2023-09-25 11:06:25 +01:00
.env.example feat: add database debug env var (#2333) 2024-03-21 09:59:17 +01:00
.gitignore ci: workflow to check bundle files (#2126) 2023-11-28 10:39:21 +01:00
.pre-commit-config.yaml chore: update ruff and black in precommit config (#2336) 2024-03-21 11:05:01 +01:00
.prettierignore ignore upgrades dir in linters and formatters and precommit (#1783) 2023-06-26 10:38:40 +02:00
.prettierrc FIX: prettier formatting (#1395) 2023-01-23 14:23:30 +01:00
Dockerfile fix: docker image invoice listener were not stopping (#2278) 2024-02-16 15:24:50 +02:00
flake.lock [FEAT] Auth, Login, OAuth, create account with username and password #1653 (#2092) 2023-12-12 11:38:19 +01:00
flake.nix fix: remove custom devshells from the flake 2023-12-28 13:25:34 +01:00
LICENSE Update LICENSE 2022-01-30 08:27:05 -03:00
Makefile remove CACHE_VERSION from service-worker.js (#2342) 2024-03-22 12:33:42 +01:00
package-lock.json chore(deps): bump follow-redirects from 1.15.5 to 1.15.6 (#2326) 2024-03-21 16:43:48 +01:00
package.json Adds optional confetti to incoming payments in wallet (#2231) 2024-02-08 13:34:03 +00:00
poetry.lock chore: update ruff and black in precommit config (#2336) 2024-03-21 11:05:01 +01:00
pyproject.toml chore: release 0.12.4 2024-03-24 13:44:47 +01:00
README.md initial scaffolding for zbd wallet 2024-02-23 16:11:27 -03:00

LNbits BETA

license-badge docs-badge

Lightning network wallet

Free and Open-Source Lightning Wallet Accounts System

(Join us on https://t.me/lnbits)

LNbits is beta, for responsible disclosure of any concerns please contact lnbits@pm.me

Use legend.lnbits.com, or run your own LNbits server!

LNbits is a Python server that sits on top of any funding source. It can be used as:

  • Accounts system to mitigate the risk of exposing applications to your full balance via unique API keys for each wallet
  • Extendable platform for exploring Lightning network functionality via the LNbits extension framework
  • Part of a development stack via LNbits API
  • Fallback wallet for the LNURL scheme
  • Instant wallet for LN demonstrations

LNbits can run on top of any Lightning funding source. It currently supports the following, but more and more are added regularly:

  • LND (REST and gRPC)
  • Core Lightning aka CLN (gRPC, REST and Spark)
  • Eclair
  • LNPay
  • LNbits
  • OpenNode
  • Alby
  • ZBD
  • LightningTipBot

See LNbits manual for more detailed documentation about each funding source.

Checkout the LNbits YouTube video series.

LNbits is inspired by all the great work of opennode.com, and in particular lnpay.co. Both work as funding sources for LNbits.

Running LNbits

See the install guide for details on installation and setup.

LNbits as an account system

LNbits is packaged with tools to help manage funds, such as a table of transactions, line chart of spending, export to csv + more to come..

Lightning network wallet

Each wallet also comes with its own API keys, to help partition the exposure of your funding source.

(LNbits M5StackSats available here https://github.com/arcbtc/M5StackSats)

lnurl ATM

LNbits as an LNURL-withdraw fallback

LNURL has a fallback scheme, so if scanned by a regular QR code reader it can default to a URL. LNbits exploits this to generate an instant wallet using the LNURL-withdraw.

lnurl fallback

Using lnbits.com/?lightning="LNURL-withdraw" will trigger a withdraw that builds an LNbits wallet. Example use would be an ATM, which utilizes LNURL, if the user scans the QR with a regular QR code scanner app, they will still be able to access the funds.

lnurl ATM

LNbits as an instant wallet

Wallets can be easily generated and given out to people at events. "Go to this website", has a lot less friction than "Download this app".

lnurl ATM

Tip us

If you like this project send some tip love!