BOLT 11

BOLT 11 es la especificación de las facturas Lightning (invoices): las solicitudes de pago codificadas que empiezan con lnbc (mainnet) o lntb (testnet). Es una de las especificaciones BOLT que definen cómo interoperan las distintas implementaciones de Lightning.

Una factura BOLT 11 codifica todo lo que quien paga necesita para completar el pago:

• Monto (opcional: quien paga puede indicarlo si la factura no lo trae).
• Hash de pago: el hash de la preimagen secreta que, al revelarse, completa el pago.
• Secreto de pago: un valor aleatorio que impide que los nodos intermedios sondeen al destinatario.
• Clave pública del nodo de destino: escrita de forma explícita, o recuperada a partir de la firma.
• Pistas de enrutamiento para nodos poco conectados al grafo público (útiles para billeteras móviles).
• Vencimiento: 1 hora si la factura no indica otro. El software del nodo suele fijar un plazo más largo al crear la factura, como 24 horas (LND) o una semana (Core Lightning).
• Descripción (memo): una nota corta, o el hash de una descripción más larga. Toda factura debe llevar una cosa o la otra.
• Una firma del nodo del destinatario, que prueba que ese nodo creó la factura.

Todo esto se codifica con bech32, el formato que el BIP 173 definió para las direcciones SegWit nativas, pero sin el límite de 90 caracteres de ese formato. El resultado es una sola cadena de texto, por lo general de unos cientos de caracteres, que cabe en un código QR y se puede copiar y pegar, escanear o transmitir por NFC con un toque.

Las facturas BOLT 11 son de un solo uso por diseño. Una vez que un pago se liquida, la preimagen deja de ser secreta, porque quien pagó y todos los nodos de la ruta ya la vieron. Si un segundo pago a la misma factura pasa por cualquiera de esos nodos, ese nodo podría quedárselo en lugar de reenviarlo. Para recibir pagos repetidos con un identificador fijo, necesitas algo que entregue una factura nueva cada vez, como las Offers (ofertas) de BOLT 12, su sucesor moderno, o un servicio que genere una factura por cada pago.

BOLT 11 se incorporó a la especificación de Lightning en junio de 2017 y se convirtió en la lengua franca de las solicitudes de pago en Lightning. Las Offers de BOLT 12, integradas a la especificación en septiembre de 2024, corrigen varias de sus limitaciones. Consulta la entrada factura Lightning para ver hasta dónde llegaba la compatibilidad con Offers en octubre de 2026.