mirrors/lnbits-legend
1
0
Fork 0
mirror of https://github.com/lnbits/lnbits-legend.git synced 2024-11-19 09:54:21 +01:00
Code Issues Packages Projects Releases Wiki Activity
d6f145eee9
lnbits-legend/lnbits/extensions/bleskomat
History
Charles Hill 4e6c30a909
Unit tests for FastAPI branch 
Run via `make test`
2021-12-04 13:11:45 -06:00
..
static/js fix bleskomat 2021-10-27 12:01:45 +01:00
templates/bleskomat blesko initial commit 2021-10-26 16:48:04 +01:00
__init__.py black 2021-11-12 04:14:55 +00:00
config.json blesko initial commit 2021-10-26 16:48:04 +01:00
crud.py black 2021-11-12 04:14:55 +00:00
exchange_rates.py Unit tests for FastAPI branch 2021-12-04 13:11:45 -06:00
fiat_currencies.json blesko initial commit 2021-10-26 16:48:04 +01:00
helpers.py Fix Bleskomat extension for FastAPI branch 2021-11-16 11:59:34 -03:00
lnurl_api.py Unit tests for FastAPI branch 2021-12-04 13:11:45 -06:00
migrations.py blesko initial commit 2021-10-26 16:48:04 +01:00
models.py Unit tests for FastAPI branch 2021-12-04 13:11:45 -06:00
README.md blesko initial commit 2021-10-26 16:48:04 +01:00
views_api.py black 2021-11-12 04:14:55 +00:00
views.py Fix Bleskomat extension for FastAPI branch 2021-11-16 11:59:34 -03:00

README.md

Bleskomat Extension for lnbits

This extension allows you to connect a Bleskomat ATM to an lnbits wallet. It will work with both the open-source DIY Bleskomat ATM project as well as the commercial Bleskomat ATM.

Connect Your Bleskomat ATM

  • Click the "Add Bleskomat" button on this page to begin.
  • Choose a wallet. This will be the wallet that is used to pay satoshis to your ATM customers.
  • Choose the fiat currency. This should match the fiat currency that your ATM accepts.
  • Pick an exchange rate provider. This is the API that will be used to query the fiat to satoshi exchange rate at the time your customer attempts to withdraw their funds.
  • Set your ATM's fee percentage.
  • Click the "Done" button.
  • Find the new Bleskomat in the list and then click the export icon to download a new configuration file for your ATM.
  • Copy the configuration file ("bleskomat.conf") to your ATM's SD card.
  • Restart Your Bleskomat ATM. It should automatically reload the configurations from the SD card.

How Does It Work?

Since the Bleskomat ATMs are designed to be offline, a cryptographic signing scheme is used to verify that the URL was generated by an authorized device. When one of your customers inserts fiat money into the device, a signed URL (lnurl-withdraw) is created and displayed as a QR code. Your customer scans the QR code with their lnurl-supporting mobile app, their mobile app communicates with the web API of lnbits to verify the signature, the fiat currency amount is converted to sats, the customer accepts the withdrawal, and finally lnbits will pay the customer from your lnbits wallet.