LNURL je rodina volitelných aplikačních postupů Lightning popsaných v dokumentech LUD. Přenáší parametry a požadavky mezi peněženkou a službou; není bitcoinovým konsenzuálním pravidlem ani jediným univerzálním oprávněním.
LNURL zahrnuje payRequest pro placení, withdrawRequest pro výběr a login pro přihlášení, vedle dalších rozšíření. Peněženky podporují různé podmnožiny LUD. Nápis „podporuje LNURL“ tedy neříká, že fungují všechny operace nebo že jejich schválení má stejný účinek. [LNURL — LUD index] [Lightning Labs — LNURL glossary]
Základní LNURL podle LUD-01 kóduje HTTPS nebo onion URL do Bech32. Není to šifrování ani faktura BOLT 11. Typ určuje tag přímo v URL, nebo v JSON odpovědi po GET. Peněženka musí rozpoznat doménu a operaci; vzhled QR sám nedokládá příjemce. [LNURL — LUD-01 encoding]
payRequest vrací callback, minSendable, maxSendable a metadata. Limity i zvolený amount jsou v msat; 1000 msat je jeden satoshi. Po schválení podmínek peněženka vyžádá fakturu v poli pr a ověří její částku před platbou. Statický odkaz sám není dokladem zaplacení. [LNURL — LUD-06 payRequest]
Metadata jsou řetězec obsahující JSON pole s povinným záznamem text/plain; další typy jsou volitelné. Zobrazený popis je třeba číst společně s doménou a částkou. Základní LNURL interpretuje JSON tělo, ne samotný HTTP kód; odpověď ERROR nebo přijatá pr faktura se nesmí zaměnit za úspěšnou platbu. [LNURL — LUD-01 encoding] [LNURL — LUD-06 payRequest]
withdrawRequest vrací k1, callback a limity minWithdrawable/maxWithdrawable v msat. Vaše peněženka vytvoří příjmovou fakturu a předá ji jako pr službě, která ji má zaplatit. Status OK potvrzuje přijetí požadavku; peněženka stále čeká na skutečný příjem. Výběrový odkaz může nést oprávnění, proto jej nepovažujte za veřejný platební kontakt. [LNURL — LUD-03 withdrawRequest]
LNURL-auth s tag login používá výzvu k1 a doménový linkingKey. Peněženka po souhlasu podepíše výzvu pomocí ECDSA na secp256k1; neposílá službě seed. Action může znamenat registraci, přihlášení, propojení či jinou autorizaci. Podpis výzvy není bitcoinová platba ani automatický důkaz totožnosti člověka. [LNURL — LUD-04 authentication]
HTTPS chrání přenos, ale služba může znát požadavky a jejich časování. Opakovaná použití mohou být provázána. U auth vstupuje do odvození celý název domény; změna subdomény mění linkingKey a může vést k jinému účtu. Přenos přihlášení mezi peněženkami není zaručen, protože používají různé odvozovací postupy. LNURL samo neurčuje úschovu bitcoinů. [LNURL — LUD-01 encoding] [LNURL — LUD-04 authentication]
Volitelné LUD-21 přidává verify URL; její odpověď rozlišuje settled true/false a může vrátit preimage. Ani status OK sám neznamená settled true. Ověřte vazbu na konkrétní fakturu a stav peněženky. Po ztrátě odpovědi nezahajujte další platbu naslepo; dostupnost služby, příjmová likvidita a rozsah souhlasu zůstávají samostatné podmínky. [LNURL — LUD index] [LNURL — LUD-21 verification]
Pro nejúplnější obraz čtěte toto heslo společně s BOLT 11, BOLT 12, Lightning Network, Lightning Address, Soukromí v Bitcoinu, Satoshi. Opačným směrem na něj odkazují také BOLT 12, Lightning Address.