BOLT 11 je standard podepsané Lightning faktury v kódování Bech32. Obsahuje payment hash, údaje příjemce a platební podmínky; je to požadavek, nikoli důkaz úspěšné platby.
Bech32 má kontrolní součet proti chybám přepisu; není šifrováním. Podpis ECDSA nad secp256k1 chrání obsah faktury a váže jej ke klíči příjemce, ne k ověřené osobě. BOLT 11 na rozdíl od adres Bech32 nemá limit 90 znaků. QR může používat velká písmena; smíšená velikost není platná. [BOLT 11 — Invoice protocol]
Prefix lnbc označuje hlavní síť, lntb testnet, lntbs signet a lnbcrt regtest. Částka je v BTC s násobitelem m, u, n či p. U p musí poslední číslice být 0, aby šlo o celé msat; 1000 msat je jeden satoshi. Chybějící částka znamená, že ji plátce doplní, ne nulovou platbu. [BOLT 11 — Invoice protocol]
Pole p nese payment hash: SHA256 z payment preimage. Pole s nese payment_secret, který příjemce požaduje v poslední části směrované platby. Secret není preimage ani seed peněženky. Aktuální BOLT 11 vyžaduje obě pole; přečtení secret z faktury samo nedokazuje zaplacení. [BOLT 11 — Invoice protocol] [BOLT 4 — Onion routing]
Faktura obsahuje právě jednu variantu: text d, nebo hash h externího popisu. U h musí peněženka ověřit SHA256 dodaného popisu; samotný hash neříká, co se kupuje. Podpis potvrzuje vazbu obsahu na klíč, nikoli pravdivost obchodního slibu. Dekódovaný text se má zobrazovat bezpečně jako data. [BOLT 11 — Invoice protocol]
Čas timestamp plus x určuje konec platnosti; bez x je výchozí doba 3600 sekund. Pole c je min_final_cltv_expiry_delta pro poslední HTLC v blocích, nikoli další doba platnosti v sekundách; při jeho absenci se použije alespoň 18 bloků. Vypršení faktury nevrací již dokončenou platbu. [BOLT 11 — Invoice protocol]
Pole 9 označuje požadované a volitelné funkce. Neznámý sudý bit vyžaduje odmítnutí, neznámý lichý se ignoruje; známé závislosti funkcí musí být splněny. Basic MPP lze použít jen při nabídnuté funkci basic_mpp. Rozdělení do více částí nevytvoří několik nezávislých faktur. [BOLT 11 — Invoice protocol] [BOLT 9 — Assigned feature flags]
Pole r přidává routing hints pro dosažení příjemce; může zveřejnit klíče uzlů, identifikátory kanálů a parametry poplatků. Neprokazuje aktuální likviditu. Volitelné f může nabídnout on-chain adresu, což je jiný způsob platby s vlastními poplatky a potvrzeními. Celá faktura proto není soukromý ani trvale opakovatelný kontakt. [BOLT 11 — Invoice protocol] [BOLT 4 — Onion routing]
Po odeslání rozlišujte čekající a dokončený výsledek. Uchovejte fakturu a odpovídající preimage jako podklady o vypořádání, nikoli jen snímek QR. Po ztrátě odpovědi nejprve ověřte stav v peněžence. Nová faktura nebo další platební cesta může způsobit další platbu; samotný formát neposkytuje univerzální ochranu proti opakování. [BOLT 4 — Onion routing] [Core Lightning — Payment result]
Pro nejúplnější obraz čtěte toto heslo společně s Lightning Network, HTLC, BOLT 12, Nostr Wallet Connect, Satoshi. Opačným směrem na něj odkazují také Nostr Wallet Connect, BOLT 12, LNURL, Lightning Address.