Go to file
matthewcroughan 36e92765d3 treewide: use StaticFiles() rather than rel path
This commit is not exhaustive, and it is a trend in this codebase to not
use StaticFiles() and instead use relative paths. This means the code
cannot run anywhere other than the source code directory, as it will not
find the files it is looking for
2022-07-08 11:06:26 +01:00
.github Testing: postgres db backend (#711) 2022-07-07 18:29:26 +02:00
docs Testing: postgres db backend (#711) 2022-07-07 18:29:26 +02:00
lnbits treewide: use StaticFiles() rather than rel path 2022-07-08 11:06:26 +01:00
tests Testing: postgres db backend (#711) 2022-07-07 18:29:26 +02:00
.dockerignore fix dockerfile and add docker ignore (#714) 2022-07-07 18:30:21 +02:00
.editorconfig refactor: decorators, models and more broken bits 2020-03-04 23:11:15 +01:00
.env.example Logging with loguru (#708) 2022-07-07 14:30:16 +02:00
.gitignore gitignore: add Nix ignores 2022-07-08 09:20:38 +01:00
.prettierrc apply prettier to everything. 2020-05-03 13:55:17 -03:00
app.json fix: lnbits.com deploy 2020-09-28 23:49:11 +02:00
build.py Add Poetry as a build system 2022-07-08 09:22:35 +01:00
conv.py black formating 2022-06-01 14:53:05 +02:00
Dockerfile fix dockerfile and add docker ignore (#714) 2022-07-07 18:30:21 +02:00
LICENSE Update LICENSE 2022-01-30 08:27:05 -03:00
Makefile Testing: postgres db backend (#711) 2022-07-07 18:29:26 +02:00
mypy.ini reactivate actions (#682) 2022-06-27 01:11:35 +02:00
package-lock.json back 2022-01-30 19:43:30 +00:00
package.json update prettier to 2.1.1 2020-09-14 09:14:51 -03:00
Pipfile Logging with loguru (#708) 2022-07-07 14:30:16 +02:00
Pipfile.lock Support for encrypted macaroons (#521) 2022-02-14 17:54:05 +01:00
poetry.lock Add Poetry as a build system 2022-07-08 09:22:35 +01:00
Procfile hypercorn -k trio 2020-10-04 23:09:11 -03:00
pyproject.toml Add Poetry as a build system 2022-07-08 09:22:35 +01:00
pytest.ini Unit tests for FastAPI branch 2021-12-04 13:11:45 -06:00
README.md Update README.md 2022-03-01 19:07:21 +00:00
requirements.txt Logging with loguru (#708) 2022-07-07 14:30:16 +02:00

LNbits

license-badge docs-badge

Lightning network wallet

LNbits v0.3 BETA, free and open-source lightning-network 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 lnbits.com, or run your own LNbits server!

LNbits is a very simple Python server that sits on top of any funding source, and 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 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-network funding source, currently there is support for LND, c-lightning, Spark, LNpay, OpenNode, lntxbot, with more being added regularly.

See lnbits.org for more detailed documentation.

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 excellent 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 utilises LNURL, if the user scans the QR with a regular QR code scanner app, they will stilll be able to access the funds.

lnurl ATM

LNbits as an insta-wallet

Wallets can be easily generated and given out to people at events (one click multi-wallet generation to be added soon). "Go to this website", has a lot less friction than "Download this app".

lnurl ATM

Tip us

If you like this project and might even use or extend it, why not send some tip love!