https://github.com/lnbits/bleskomat

https://github.com/lnbits/bleskomat

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/lnbits/bleskomat
• Owner: lnbits
• License: mit
• Created: 2023-02-14T10:45:07.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-01T09:02:34.000Z (3 months ago)
• Last Synced: 2024-08-01T09:39:57.642Z (3 months ago)
• Language: Python
• Size: 124 KB
• Stars: 1
• Watchers: 4
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-lnbits - Bleskomat - Connect one or more Bleskomat ATMs to LNbits wallet accounts (Uncategorized / Uncategorized)

README

        
# Bleskomat - [LNbits](https://github.com/lnbits/lnbits) extension

For more about LNBits extension check [this tutorial](https://github.com/lnbits/lnbits/wiki/LNbits-Extensions)

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](https://github.com/samotari/bleskomat) as well as the [commercial Bleskomat ATM](https://www.bleskomat.com/).

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