Preimage

Le secret qui débloque

La preimage est le secret aléatoire (32 octets) qui correspond à un payment hash. C'est le grand débloqueur de Lightning : sa révélation par le destinataire libère tous les HTLCs le long de la route, en cascade. Tant qu'elle reste secrète, le paiement est en attente. Une fois révélée, le paiement est définitivement réglé.

Génération

La preimage est générée aléatoirement par le destinataire, localement et secrètement. Elle ne quitte son wallet que pour encaisser un HTLC : à ce moment-là elle est révélée à son partenaire de canal direct, qui la propage en remontant la route.

Preimage comme preuve de paiement

Une fois le paiement réussi, le payeur obtient la preimage. Il peut prouver à n'importe qui qu'il a effectué ce paiement, en dévoilant la preimage qui hashe vers le payment hash de l'invoice. C'est une preuve cryptographique non-falsifiable. Cette propriété est utilisée par L402 pour construire de l'authentification HTTP par paiement Lightning : tu paies, tu obtiens la preimage, tu l'utilises comme jeton d'API.

Hodl invoice

Une hodl invoice retient la preimage côté destinataire : il choisit quand la libérer, ce qui retient le paiement en pending. Permet l'escrow conditionnel, les paiements conditionnés à un événement externe, les services de mixage ou échange atomique. Risque : si la preimage n'est jamais libérée, le paiement reste pending jusqu'au timeout HTLC, gelant des fonds le long de la route.

Sécurité

Une preimage compromise (devinée, fuitée) avant le paiement permet à un attaquant d'encaisser sans avoir reçu le bien correspondant. Les implémentations utilisent un PRNG cryptographique solide, généralement /dev/urandom plus le state du wallet.