📟

LNPoS

Hardware Lightning point-of-sale terminal.

Hardware & DevicesOpen Source

Source API Docs

Free and open-source bitcoin offline LN pos, onchain pos, offline (meatbag) atm

Join us t.me/lnbits, t.me/makerbits

To be used with extensions LNPoS, FOSSA

Installation:

Old tutorial that needs updating -> https://www.youtube.com/watch?v=IhwCEDwGg2E

1. Web-installer. Easy setup using browser https://lnpos.lnbits.com.

2. Terminal Build the project sh build.sh, find the USB device sh debug.sh , push the firmware sh debug.sh /dev/ttyACM0 (<-whatever your device is called)

Hardware:

• Lilygo TTGO/Tdisplay
• The Lilygo Keyboard specifically made for LNPoS => or get yourself the LNPoS Kit, dimensions 40x52x11mm e.g. in the LNbits shop
• 3.7V lithium iron flat battery with 1.25mm JST with < 1000 mAh to fit inside the standard LNPoS Kit
• LNbits LNURLdevice extension

LNPoS – Offline Lightning Network payments

A random pin generated on the device is encrypted and passed trough the payee. When the payment has been made the unencrypted pin is sent as a receipt. This function makes use of LNURL-pay protocol. Uses LNbits LNURLDevice extension.

Onchain – Generate fresh addresses using an xPub

Use an xPub to generate a fresh address for every payment. Useful for large purchases. Includes a mempool.space QR so the payment can be verified.

LNATM – Meatbag ATM, give refunds, accept cash for sats.

Create withdraw/faucet links. Uses more-or-less. This function makes use of LNURL-withdraw protocol. Uses LNbits LNURLDevice extension.

API Reference

See the LNPoS API documentation for endpoint details.

Related Pages

• LNPoS API Reference: API endpoints for this extension
• All Extensions: Browse all LNbits extensions