BR⚡LN Guide
What a Lightning Address is and how to get yours
A Lightning Address looks like an email, name@domain, and lets you receive sats over Lightning without creating an invoice for every payment. The payer just types the address and the amount.
How it works under the hood
The payer's wallet turns name@domain into a request to https://domain/.well-known/lnurlp/name (the LNURL-pay standard). The server answers with the minimum and maximum amounts it accepts and an address to request the invoice. The wallet asks for an invoice for the chosen amount, receives it and pays it. Every payment uses a fresh invoice, created on the spot.
That is why the address holds no money and no keys: it only points to whoever creates the invoices. Whoever controls the domain controls where the payments go, so use a domain you trust.
Where to get one
- In your phone wallet: Wallet of Satoshi, Blink and Coinos give you one right away. It is the fastest way, but in those wallets the company holds the sats.
- On your own node: pay.br-ln.com creates a
name@pay.br-ln.comaddress that creates invoices straight on your node (LND, Tor-only included) or in your LNbits wallet. It is free, with no sign-up, and the sats land on your node, not with the club. It also receives Nostr zaps. The site is in Portuguese, with an English button.
How to connect it to your LND node
pay.br-ln.com needs two things from your LND: an address to reach its REST interface (port 8080) and an invoice-only macaroon. With a home node behind Tor, the address is a dedicated .onion for REST, different from the .onion the node uses to talk to other nodes. If you do not have that address yet, create it in 5 minutes from the node's terminal (on LightningOS, the panel's terminal or SSH):
- Check that REST answers:
curl -sk https://127.0.0.1:8080/v1/getinfo. A message asking for a macaroon means it is up. - Create the Tor address: open
sudo nano /etc/tor/torrcand add these two lines at the end:HiddenServiceDir /var/lib/tor/lnd-rest/andHiddenServicePort 8080 127.0.0.1:8080. Save with Ctrl+O and exit with Ctrl+X. - Reload Tor, without taking the node down:
sudo systemctl reload tor. - Get the address:
sudo cat /var/lib/tor/lnd-rest/hostname. If it says the file does not exist, wait a few seconds and try again. - Create the invoice-only macaroon. On LightningOS: Lightning Ops › Custom macaroon › Invoice permissions preset. On any other LND:
lncli bakemacaroon invoices:read invoices:write. - On pay.br-ln.com, choose LND and fill in the address like this, without the node pubkey:
https://ADDRESS.onion:8080, then paste the macaroon.
Never use the admin.macaroon here. The invoice macaroon can only create and check invoices: whoever has it cannot spend your sats. And do not send the macaroon by chat or email; it goes straight into the form.
How to test yours
- Paste the address into the Lightning decoder: it shows whether the server answers and the amounts it accepts.
- Get your first sats from the faucet: 21 free sats a day, straight to the address (it pays connections from Brazil).
Things to keep in mind
- If the address points to a node behind Tor, the first invoice of the day can take a few seconds: that is Tor building the circuit.
- Sharing the address is safe: it cannot be used to spend anything. But anyone who has it sees the name you chose, so do not use personal details.
Frequently asked questions
Is a Lightning Address the same as a Lightning invoice?
No. An invoice is good for one payment and expires. A Lightning Address is permanent and creates a new invoice for every payment.
Can I receive with any wallet?
Almost any modern Lightning wallet can pay a Lightning Address. To receive, the address needs a server that creates the invoices: your wallet, your node or a service like pay.br-ln.com.
Does pay.br-ln.com cost anything?
No. It is free, needs no sign-up and you do not have to be a club member. The sats go straight to your node or your LNbits wallet.
Does the node address on pay.br-ln.com include the pubkey?
No. Only the LND REST address with the port, for example https://xxxx.onion:8080. If your node only has the .onion it uses to talk to other nodes, create one for REST as the steps above show.
