Skip to content

Latest commit

 

History

History
34 lines (23 loc) · 1.77 KB

16.md

File metadata and controls

34 lines (23 loc) · 1.77 KB

LUD-16: Paying to static internet identifiers.

author: akumaigorodski author: andreneves author: fiatjaf discussion: https://t.me/lnurl/11610


Paying to internet identifiers (email-like addresses)

The idea here is that a SERVICE can offer human-readable addresses for users or specific internal endpoints that use the format <username>@<domainname>, e.g. [email protected]. A user can then type these on a WALLET. The <username> is limited to a-z0-9-_.. Please note that this is way more strict than common email addresses as it allows fewer symbols and only lowercase characters.

Upon seeing such an address, WALLET makes a GET request to https://<domain>/.well-known/lnurlp/<username> endpoint if domain is clearnet or http://<domain>/.well-known/lnurlp/<username> if domain is onion. For example, if the address is [email protected], the request is to be made to https://bitcoin.org/.well-known/lnurlp/satoshi.

The response from SERVICE then MUST be the same as in LUD-06, step 3, and the flow is the same.

If providing such a scheme, SERVICE MUST add to the metadata JSON array either a text/email entry or a text/identifier entry, as in examples below:

[
    "text/identifier", // indication that this payment link is associated with an internet identifier string
    content // an internet identifier string in standard [email protected] format
]

or

[
    "text/email", // indication that this payment link is associated with an email address
    content // an email string in standard [email protected] format
]

The text/email entry MUST be used if the internet identifier corresponds to an actual email address.