webln.lnurl()

Request to execute a LNURL request. The application needs to pass a LNURL string which should be provided for example by the application's backend. The lnurl function can also accept a LUD-16 static identifier (e.g. [email protected]) instead of a LNURL string.
The method returns a promise which resolves once the LNURL flow is completed. It returns the last response from the LNURL server. For LNURL-pay requests it also contains payment information (preimage, payment hash) and for LNURL-auth requests it contains auth information (message, signature) 
This API may not be available on all providers. 
Method
async function lnurl(lnurl: string): LNURLResponse;
Response
type LNURLResponse =
  | {
      status: "OK";
      data?: unknown
    }
  | { status: "ERROR"; reason: string };
LNURL-pay Response 
type LNURLPayResponse =
  | {
      status: "OK";
      data: { 
        preimage: string, 
        paymentHash: string, 
        paymentRequest: string
      }
    }
  | { status: "ERROR"; reason: string };
LNURL-auth Response 
type LNURLAuthResponse =
  | {
      status: "OK";
      data: { 
        message: string, 
        signature: string
      }
    }
  | { status: "ERROR"; reason: string };
Code Example
// const lnurl = (provided by your application backend)
if (!webln.lnurl) { alert('not supported'); }
​
await webln.enable();
const result = await webln.lnurl(lnurl); // promise resolves once the LNURL process is finished (e.g. a payment is sent or the login is complete)
Demos
​Lightsats (LNURL-pay, LNURL-withdraw)
​getAlby.com (LNURL-auth login via getAlby extension, Lightning address)
Last modified 4mo ago