A curated list of awesome things related to the lnurl super-protocol for interaction between Lightning wallets and third-party services.
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.
Apps and services supporting lnurl in the wild.
- 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/@telegramusernameallows 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. - 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.
- 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.
- Rewards to Bitcoin – Backup/Restore your anonymous user account with lnurl.
- Wheel of Fortune – Login with lnurl Instead of manually saving your key.
- 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
- ZEBEDEE – The REST API for game developers and Unity SDK automatically generates lnurl links that allow players to easily withdraw sats from the game.
- 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).
Some wallets that support lnurl.
| Wallet | fallback¹ | withdraw | pay | auth | channel |
|---|---|---|---|---|---|
| BLW | ☑️ | ☑️ | ☑️ | ☑️ | ☑️ |
| Blixt | ☑️ | ☑️ | ☑️ 💬 | ☑️ | ☑️ |
| BlueWallet | ☑️ | ☑️ | ☑️ | ||
| Breez | ☑️ | ☑️ | ☑️ | ☑️ | |
| coinos | ☑️ | ☑️ | ☑️ | ☑️ | |
| LNbits | ☑️ | ☑️ | ☑️ 💬 | ||
| @lntxbot | ☑️ | ☑️ | ☑️ 💬 | ☑️ | |
| Phoenix | ☑️ | ☑️ | ☑️ | ||
| Shockwallet | ☑️ | ☑️ | ☑️ | ☑️ | |
| ThunderHub | ☑️ | ☑️ 💬 | ☑️ | ☑️ | |
| Wallet of Satoshi | ☑️ | ☑️ | |||
| ZEBEDEE | ☑️ | ☑️ | ☑️ 💬 | ||
| Zap-Android | ☑️ | ☑️ | ☑️ | ☑️ | |
| Zap-iOS | ☑️ | ☑️ | ☑️ | ||
| 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.
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.
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.
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).
