xplorfin / awesome-lnurl

A curated list of awesome lnurl things.

Awesome lnurl

A curated list of awesome things related to the lnurl super-protocol for interaction between Lightning wallets and third-party services.

• Awesome lnurl
  • Documentation
  • Services
  • Wallets
  • Libraries
  • Tools
  • Contribute
  • License

---

Documentation

Readings about lnurl.

• The spec – The confusing, but honest, lnurl spec.
• lnurl-auth explained – Everything you always wanted
• lnurl-withdraw flow – One of those incomprehensible program action-data flows detailing how lnurl-withdraw takes place.
• lnurl-pay flow – Same as above, but for *lnurl-pay (doesn't include all features).
• Coindesk article – An honest report on lnurl.
• Beyond Coffee: Bitcoin for Every Day Use with LNURL – An insightful article with explanations and use cases.

Services

Apps and services supporting lnurl in the wild.

lnurl-pay

• Bitrefill – Allows funding your account with lnurl.
• Blixt's lnurl-pay chat – A simple chat you have to pay 10 satoshis to send an anonymous message directly from your wallet (the interface is just a QR code) as a proof-of-concept for lnurl-pay comments.
• Etleneum – For all reusable method calls, with or without a fixed number of satoshis in them, you can grab an lnurl at the main contract page and replay it from your wallet later.
• Lightning Gifts – Create gifts without leaving your wallet by playing and replaying the basic gift lnurl.
• @lntxbot – https://lntxbot.bigsun.xyz/@telegramusername allows you to send money to anyone using a fixed lnurl. It can be printed and shared at will. It's basically an old-style address.
• lnshort.it – Allows you to pay for redirects and fund your account balance with an lnurl.
• NextPay – A personal lnurl tipping server you can deploy freely and easily and it will talk to your LND node.
• coinos – Allows you to fund your account with an lnurl.
• lnbits – The LNURLp plugin allows anyone to generate lnurl payment codes and dispatch webhooks whenever a new payment comes in.
• lntorub – Build reusable URLs that allow you to recharge Russian transport tickets, phones, send money to Russian debit cards and recharge Skype globally.
• tip.bigsun.xyz – Static donation lnurls that send money directly to your node, noncustodially. Ideal for street musicians.
• zbd.gg – Static lnurl pay QR codes for users of ZEBEDEE Wallet to accept payments and messages.

lnurl-auth

• coinos – Allows you to add multiple linking keys to the same account.
• Etleneum – The only supported login method is lnurl.
• ilno – A light, self-hosted embeddable comments server similar to Disqus/Isso with lnurl user logins.
• LNMarkets – lnurl is a private login option.
• lnshort.it – The only supported login method is lnurl.
• Rewards to Bitcoin – Backup/Restore your anonymous user account with lnurl.
• Wheel of Fortune – Login with lnurl Instead of manually saving your key.

lnurl-withdraw

• A big collection of services allow you to withdraw your balances with lnurl: HangarSix Warzone Tournaments, Etleneum, Paywall, Kriptode, lngames.net, LightningScratchAnd.win, Lightning Gifts, LNMarkets, Stekking, Microlancer.
• And also exchanges: GraafOne on Canada and SouthXchange on Argentina.
• @21isenough's LightningATM – A DIY ATM machine that eats coins and spits out sats.
• @arcbtc's TheFossa – A DIY ATM machine that eats coins and spits out sats.
• @lntxbot – You can extract your balance from the Telegram bot to another wallet with lnurl, or even share withdraw codes so you can physically pay friends.
• Bitcoin Bounce – Play for free and win satoshi prizes. lnurl is the only way to redeem.
• Bleskomat – The offline Lightning Network ATM - device source code, lnurl server implementation, and build instructions included.
• coinos – Allows you to issue lnurl vouchers.
• LNPay.co – Provides static lnurl rechargeable faucets you can print, email or easily embed!
• LNURLProxyAPI – Allows you to issue noncustodial lnurls from your own home node. Like lightning.gifts, but noncustodial.
• LightningCashback – A POS system that prints lnurl QR codes containing your change in receipts (fiat onramp?).
• LNbits – The LNURLw plugin allows anyone to generate lnurl vouchers.
• Rewards to Bitcoin – Android app that lets you cash out Play Store balance with lnurl
• Surfcity Parking – Surfcity lets you find and share parking spaces in residential areas. Pay with credit/debit card or BTC Lightning for your booking. Parking space owners can opt to withdraw anytime to their Lightning wallet through lnurl or use SEPA (EUR, CZK, GBP) monthly payouts.
• ZEBEDEE – The REST API for game developers and Unity SDK automatically generates lnurl links that allow players to easily withdraw sats from the game.

lnurl-channel

• bifrost – A self-hosted lnurl-powered invite-based channel-opening service.
• Bitrefill's Thor – Buy a reliable incoming channel from this super liquid node, or get a turbo channel from which you can spend immediately.
• LNBIG – Get free inbound channels on your mobile wallet from this mysterious entity.
• lnch-vekslak – Your self-hosted Thor. Allows you to sell or open channels with people in the streets (make sure to read and edit the code before using or you'll pay a high price).

Wallets

Some wallets that support lnurl.

Wallet	fallback¹	withdraw	pay	auth	channel
BLW	☑️	☑️	☑️	☑️	☑️
Blixt	☑️	☑️	☑️ 💬	☑️	☑️
BlueWallet	☑️	☑️	☑️
Breez	☑️	☑️		☑️	☑️
coinos		☑️	☑️	☑️	☑️
LNbits	☑️	☑️	☑️ 💬
@lntxbot	☑️	☑️	☑️ 💬	☑️
Phoenix	☑️	☑️		☑️
Shockwallet	☑️	☑️	☑️		☑️
ThunderHub		☑️	☑️ 💬	☑️	☑️
Wallet of Satoshi	☑️	☑️	☑️
Zap-Android	☑️	☑️	☑️		☑️
Zap-iOS		☑️	☑️		☑️
ZEBEDEE	☑️	☑️	☑️ 💬
Zeus	☑️	☑️	☑️ 💬

¹=the fallback scheme is defined on the first page of the LNURL specifications. It allows to embed an bech32-encoded LNURL string into a normal Web-URL so that for example a LNURL QR code can be opened on every smartphone as a fallback with a normal web browser (if a specialised wallet app is not installed yet). Every LNURL supporting wallet should be able to parse such Web-URLs for bech32-encoded LNURL strings - it easy to implement and just requires a handfull of additional lines of code.

Libraries

Integrate lnurl in projects and services.

• go-lnurl – lnurl helper structs, encode/decode, verify signatures, misc helpers.
• lnurl-node – CLI tool and lnurl server in Node.js.
• passport-lnurl-auth – Passport strategy that uses lnurl-auth
• lnurl-platformio – Implementation of lnurl in C++ for PlatformIO (software tooling for hardware devices).
• js-lnurl – Tools for adding lnurl support in a JavaScript wallet.
• php-lnurl – Easy PHP encoding and decoding of bech32 lnurls.
• python-lnurl – Tools for dealing with lnurl in Python.
• lnurl-ruby – A gem that provides helpers to work with lnurl from Ruby.
• lnurl-rust – Rust helpers for lnurl.
• lnurl.net – Library for lnurl in C#. Provides lnurl-auth helpers.
• dart_lnurl – Library for lnurl in Dart.

Tools

Stuff for learning, using and playing with lnurl.

• lnurl-toolbox – A web interface with tools for testing and integrating lnurl.
• Lightning Decoder – A nice clean UI for decoding Lightning invoices and lnurls.
• lnurl codec – The most simple lnurl encoder/decoder.
• lnurl playground – A simple tool that allows you to try and see how your wallet interacts with an lnurl server.
• SeedAuth – A JS app that allows you to login to lnurl-auth services using just a username and password.
• SeedAuthExtension – A Chrome & Firefox extension that allows you to login to lnurl-auth services using just a username and password.

Contribute

Please contribute! Open an issue or a PR and we’ll discuss it or merge it. If you’re opening a PR, please ensure all formatting is ok (if you’re in a hurry just open an issue).

License