fiatjaf e408febf97 hypercorn -k trio		4 years ago
.github	fix: revert default python version to 3.7 in Pipfile, closes #85	4 years ago
docs	hypercorn -k trio	4 years ago
lnbits	fix requirements after rebase.	4 years ago
tests	migrate to trio so c-lightning sockets stop hanging.	4 years ago
.editorconfig	refactor: decorators, models and more broken bits	5 years ago
.env.example	broken invoice listener on c-lightning and other fixes around wallets.	4 years ago
.gitignore	poor man's flask-assets.	4 years ago
.prettierrc	apply prettier to everything.	5 years ago
Dockerfile	hypercorn -k trio	4 years ago
LICENSE	Create LICENSE	5 years ago
Makefile	poor man's flask-assets.	4 years ago
Pipfile	hypercorn -k trio	4 years ago
Pipfile.lock	hypercorn -k trio	4 years ago
Procfile	hypercorn -k trio	4 years ago
README.md	Moved install guide to more prominent position	4 years ago
app.json	fix: lnbits.com deploy	4 years ago
package-lock.json	Improve setup instructions and README	4 years ago
package.json	update prettier to 2.1.1	4 years ago
pyproject.toml	refactor: add some dev files and `black` original code	5 years ago
pytest.ini	migrate to trio so c-lightning sockets stop hanging.	4 years ago
requirements.txt	fix requirements after rebase.	4 years ago

README.md

LNbits

LNbits v0.1 BETA, free and open-source lightning-network wallet/accounts system

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

The wallet can run on top of any lightning-network funding source, currently there is support for LND, CLightning, Lntxbot, LNpay, OpenNode, with more being added regularily.

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 locally

See the development docs 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..

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)

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.

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.

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".

Tip me

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