How to setup LnURLPay or Lightning Address the easiest way

If you have a domain name then you have your own custom address and with Fiatjaf’s Bridge Server, any sats sent to your adress will go directly to your node.

Borowing from both Dearthcoin’s tutorial (Pay to Lightning Address – Telegraph) and Fiatjaf’s bridge service (https://bridgeaddr.fiatjaf.com/)

Assuming you have the domain name inna.com want something like sats@inna.com to be your Lightning address, do the following.

  1. Ensure your Lightning node has ample in-bound liquidity!

  2. Obtain your node´s REST address.
    Login to your Umbrel.
    Open the Lightning Node app, in the upper right hand corner click the three dots, then Connect Wallet. Ensure the first dropdown is REST Tor. Then copy the lndconnect url
    The lndconnect url is formatted as such: lndconnect://toraddress.onion:8080?cert=gibberish&macaroon=gibberish

You’ll need to reformat the address a bit. First remove lndconnect, replace it with https . And remove everything after the port.
So the address should look like https://toraddress.onion:8080

  1. Create a Macaroon.
    Go to Thunderhub, click on Tools, then Bake under Macaroon
    Set Create to Invoices to Yes, ensure all the others are set to No
    Then click Bake To Macroon, copy that text
    For this example we’ll pretend it’s macroongibberish=

  2. Create the DNS records
    Each domain provider is different but you’ll need to create 4 records.
    For the CNAME record, enter @ for the host, and bridgeaddr.fiatjaf.com for the value.
    For one of the TXT records, enter _host for the host , and your node’s REST address for the value, https://toraddress.onion:8080
    For the second TXT record, _kind and lnd
    And for the third TXT record: _macaroon and the macaroon you just created, macroongibberish=

Screenshot below from my config using Namecheap. The text obscured in green is the tor address for the node (https://toraddress.onion:8080) and purple is the macaroon (macroongibberish=)

Wait roughtly 30 minutes for the DNS records to update and propogate.

  1. Send a test transaction using a seperate wallet. (Wallet of Satoshi , Breez, and the Bitcoin Beach/Jungle wallets all support Lighting Addresses.) Theoretically any text in front of inna.com but feel free to use whatever you want when you share the address to your Nostr profile.
3 Likes