LNURL ist eine Familie optionaler Lightning-Anwendungsabläufe, beschrieben in LUD-Dokumenten. Sie übermittelt Parameter und Anfragen zwischen Wallet und Dienst; weder eine Bitcoin-Konsensregel noch eine universelle Berechtigung.
LNURL umfasst payRequest für Zahlungen, withdrawRequest für Auszahlungen und login zur Anmeldung sowie weitere Erweiterungen. Wallets unterstützen verschiedene LUD-Teilmengen. „Unterstützt LNURL“ bedeutet daher nicht, dass jede Funktion arbeitet oder jede Zustimmung dieselbe Wirkung hat. [LNURL — LUD index] [Lightning Labs — LNURL glossary]
Basis-LNURL nach LUD-01 kodiert eine HTTPS- oder Onion-URL in Bech32. Das ist weder Verschlüsselung noch eine BOLT 11-Rechnung. Der tag direkt in der URL oder in der JSON-Antwort nach GET bestimmt den Typ. Die Wallet muss Domain und Vorgang erkennen; das QR-Aussehen allein belegt den Empfänger nicht. [LNURL — LUD-01 encoding]
payRequest liefert callback, minSendable, maxSendable und metadata. Grenzen und gewählter amount stehen in msat; 1000 msat sind ein Satoshi. Nach Zustimmung zu den Bedingungen fordert die Wallet eine Rechnung in pr an und prüft vor Zahlung deren Betrag. Der statische Link selbst belegt keine Zahlung. [LNURL — LUD-06 payRequest]
Metadata ist eine Zeichenkette mit einem JSON-Array und verpflichtendem text/plain-Eintrag; weitere Typen sind optional. Beschreibung zusammen mit Domain und Betrag lesen. Basis-LNURL interpretiert den JSON-Inhalt, nicht nur den HTTP-Code; ERROR oder der Erhalt einer pr-Rechnung sind keine erfolgreiche Zahlung. [LNURL — LUD-01 encoding] [LNURL — LUD-06 payRequest]
withdrawRequest liefert k1, callback und minWithdrawable/maxWithdrawable in msat. Ihre Wallet erstellt eine Empfangsrechnung und übergibt sie als pr an den zahlenden Dienst. Status OK bestätigt die Anfrage; die Wallet wartet weiterhin auf tatsächlichen Eingang. Ein Auszahlungslink kann eine Berechtigung enthalten und ist kein öffentlicher Zahlungskontakt. [LNURL — LUD-03 withdrawRequest]
LNURL-auth mit tag login verwendet k1 und den domainspezifischen linkingKey. Nach Zustimmung signiert die Wallet mit ECDSA auf secp256k1; sie übermittelt dem Dienst keinen Seed. Action kann Registrierung, Anmeldung, Verknüpfung oder andere Autorisierung bedeuten. Die Signatur ist weder Bitcoin-Zahlung noch automatischer Identitätsnachweis einer Person. [LNURL — LUD-04 authentication]
HTTPS schützt die Übertragung, doch der Dienst kann Anfragen und Zeitpunkte kennen. Wiederholte Nutzungen können verknüpft werden. Bei auth fließt der vollständige Domainname in die Ableitung ein; eine andere Subdomain ändert linkingKey und kann zu einem anderen Konto führen. Wegen verschiedener Ableitungsverfahren ist die Übertragbarkeit zwischen Wallets nicht garantiert. LNURL bestimmt selbst keine Bitcoin-Verwahrung. [LNURL — LUD-01 encoding] [LNURL — LUD-04 authentication]
Optionales LUD-21 ergänzt eine verify-URL; die Antwort unterscheidet settled true/false und kann preimage liefern. Status OK bedeutet allein nicht settled true. Den Bezug zur konkreten Rechnung und den Wallet-Status prüfen. Nach verlorener Antwort nicht blind erneut zahlen; Dienstverfügbarkeit, Empfangsliquidität und Zustimmungsumfang bleiben eigenständige Bedingungen. [LNURL — LUD index] [LNURL — LUD-21 verification]
Für ein möglichst vollständiges Bild lies diesen Eintrag zusammen mit BOLT 11, BOLT 12, Lightning Network, Lightning Address, Bitcoin-Privatsphäre, Satoshi. Auf diesen Eintrag verweisen außerdem BOLT 12, Lightning Address.