BOLT-11

Le format historique d'invoice

BOLT-11 est le format d'invoice Lightning historique, utilisé depuis les premières versions du protocole. Une invoice BOLT-11 commence par "lnbc" (Lightning Bitcoin) et encode dans une chaîne Bech32 toutes les informations nécessaires au paiement : montant, payment hash, durée de validité, route potentielle, description.

Anatomie

Une invoice typique contient le préfixe "lnbc" pour mainnet ou "lntb" pour testnet, suivi du montant (par exemple "100u" pour 100 micro-BTC ou 10 000 sats), du payment hash sur 32 octets, du payment secret de BIP-83 sur 32 octets, d'une description ou hash de description, d'une expire_date, et de route hints pour atteindre un nœud privé. L'ensemble est signé par la clé du destinataire pour authentifier l'invoice.

Les limites

BOLT-11 a plusieurs faiblesses qui ont motivé BOLT-12. L'usage est unique : une invoice est jetable, il faut en générer une nouvelle pour chaque paiement. Le montant est figé : il faut le connaître à l'avance, sauf à utiliser des "0 amount invoices" peu supportées. L'invoice n'est pas réutilisable : impossible de partager une invoice statique. Les métadonnées sont limitées : description simple, pas de support marchand structuré. La confidentialité est réduite : la route hint expose l'identifiant du nœud destinataire.

Ergonomie

Les invoices BOLT-11 se partagent via QR code ou texte. La pratique courante : un commerçant affiche une invoice à chaque paiement, le client scanne, ça paie en quelques secondes. C'est efficace mais nécessite un canal interactif entre payeur et destinataire.

Migration vers BOLT-12

BOLT-12 résout les limites de BOLT-11 avec les Offers : factures réutilisables, statiques, supportant les blinded paths pour la confidentialité. Adoption progressive sur Phoenix, CLN, et de plus en plus côté LND. BOLT-11 restera supporté longtemps en parallèle pour compatibilité.