LNURL and Lightning Addresses — Making Lightning Human-Friendly

LNURL and Lightning Addresses

Lightning invoices are powerful but terrible for humans. Try reading lnbc1500n1pj9... to someone over the phone. LNURL and Lightning Addresses fix this, and they've become essential infrastructure.

What is LNURL?

LNURL is a set of protocols that use HTTP to negotiate Lightning payments. Instead of manually creating and sharing invoices, LNURL automates the handshake between sender and receiver.

Key LNURL Protocols

• LNURL-pay: Scan a static QR code, your wallet fetches a fresh invoice from the receiver's server
• LNURL-withdraw: The reverse — a service creates a QR you scan to pull sats to your wallet
• LNURL-auth: Login to websites using your Lightning wallet as identity. No passwords
• LNURL-channel: Request inbound channels from a service

Lightning Addresses

A Lightning Address looks like an email: uvin@uvin.lk. Under the hood, it's LNURL-pay with a specific discovery mechanism:

1. Sender's wallet parses uvin@uvin.lk
2. Makes a GET request to https://uvin.lk/.well-known/lnurlp/uvin
3. Gets back LNURL-pay parameters (min/max amount, metadata)
4. Sends the payment amount, gets a Lightning invoice
5. Pays the invoice

From the user's perspective: type an email-like address, enter amount, done. That's the UX we need.

Hosting Your Own Lightning Address

You can self-host using:

• LNbits: Full-featured Lightning accounts platform with LNURL support
• Satdress: Lightweight Lightning Address server
• Your own LND/CLN node: With a simple web server handling the well-known endpoint

The Custodial Trade-off

Here's the thing most people don't talk about: most Lightning Addresses are custodial. Services like Wallet of Satoshi, Stacker News, and Alby host your address, which means they hold your sats (at least briefly). Self-hosting your Lightning Address is possible but requires a always-online server.

I'm working on a guide for setting up self-hosted Lightning Addresses on a VPS for under $5/month. It'll be on the learning center soon.

LNURL-auth: The Sleeper Hit

I think LNURL-auth is the most underrated protocol in the Lightning ecosystem. It lets you authenticate to websites using your Lightning node's identity — no email, no password, no personal data. The website gets a unique identifier derived from your node's key, and you prove ownership with a cryptographic signature.

This is what internet authentication should have always been. And it already works today in wallets like Phoenix, Breez, and Zeus.

We went from unreadable invoice strings to email-like addresses in just a few years. Lightning UX isn't perfect yet, but the trajectory is undeniable.

Try setting up your own Lightning Address — start with our tools page.