Skip to content

Latest commit



51 lines (28 loc) · 3.12 KB

File metadata and controls

51 lines (28 loc) · 3.12 KB


Looking to add support for Lightning Addresses to your service or wallet? Want to self-host all your infrastructure and still make use of Lightning Addresses? This is for you!


This document outlines the overall path to serving your own HTTP server with support for LNURL Pay + Internet Identifier protocols. At its core, Lightning Addresses are divided into two parts: sending and receiving. A wallet can support sending to Lightning Addresses without needing to support receiving. Any provider that supports receiving will likely also support sending for its users.


Sending to a Lightning Address is essentially just doing some string transformations and making a GET request to retrieve a LNURL Pay callback payload. Below is a diagram explaining it:

After receiving the LNURL Pay payload, the rest of the flow is the exact same as the LNURL Pay flow, there's virtually no difference. Again, Lightning Addresses are essentially another way of sharing how a user can obtain another user's LNURL Pay details.

Requirement: HTTPS is expected to be used, since this is sensitive data, where MITM impacts actual money.


In order to support receiving to a Lightning Address on your own infrastructure/domain setup, you will need a handful of things outlined below.

You will essentially need a RESTful HTTP API server that will handle GET requests and return the proper payload outlined in the LNURL Pay specification.

Internet Identifier

The Lightning Address is nothing more than another Internet Identifier, it should look identical to an email address. For more details on how to set up the Internet Identifier metadata check here.


In order to accept messages/comments alongside payments to your Lightning Address, you will have to support the optional comment feature outlined here.

LNURL Protocol

LNURL is a UX protocol built for the Lightning Network that aims to facilitate the sending, receiving, and handling of Lightning invoices from wallets to services (and vice versa).

LNURL is comprised of many sub-protocols, each with their own required, and optional, properties and features. Please refer to the LNURL RFC documentation for more details on how LNURL works. Specifically for the Lightning Address protocol, we are relying on the Internet Identifier metadata optional feature of the LNURL Pay sub-protocol.