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.