LNURL es una familia de flujos opcionales de aplicaciones Lightning descritos en documentos LUD. Transmite parámetros y solicitudes entre cartera y servicio; no es una regla de consenso de Bitcoin ni una autorización universal.
LNURL incluye payRequest para pagos, withdrawRequest para retiros y login para autenticación, además de otras extensiones. Las carteras implementan diferentes subconjuntos LUD. “Admite LNURL” no implica que funcione cada operación ni que aprobarlas tenga el mismo efecto. [LNURL — LUD index] [Lightning Labs — LNURL glossary]
LNURL básico, según LUD-01, codifica una URL HTTPS u onion en Bech32. No es cifrado ni una factura BOLT 11. El tag directamente en la URL o en el JSON tras GET determina el tipo. La cartera debe identificar dominio y operación; la apariencia del QR no acredita al receptor. [LNURL — LUD-01 encoding]
payRequest devuelve callback, minSendable, maxSendable y metadata. Los límites y amount elegido están en msat; 1000 msat equivalen a un satoshi. Tras aceptar las condiciones, la cartera solicita una factura en pr y verifica su importe antes de pagar. Un enlace estático no demuestra el pago. [LNURL — LUD-06 payRequest]
Metadata es una cadena que contiene un array JSON con una entrada text/plain obligatoria; otros tipos son opcionales. Lea la descripción junto con dominio e importe. LNURL básico interpreta el cuerpo JSON, no solo el código HTTP; ERROR o recibir una factura pr no deben confundirse con pago exitoso. [LNURL — LUD-01 encoding] [LNURL — LUD-06 payRequest]
withdrawRequest devuelve k1, callback y límites minWithdrawable/maxWithdrawable en msat. Su cartera crea una factura receptora y la entrega como pr al servicio que debe pagarla. Status OK reconoce la solicitud; la cartera aún espera el ingreso real. El enlace de retiro puede contener autorización y no debe tratarse como contacto público de pago. [LNURL — LUD-03 withdrawRequest]
LNURL-auth con tag login usa el desafío k1 y linkingKey específico del dominio. Tras el consentimiento, la cartera firma con ECDSA sobre secp256k1; no envía su semilla al servicio. Action puede ser registro, acceso, vinculación u otra autorización. Firmar el desafío no es pagar bitcoin ni demostrar automáticamente la identidad de una persona. [LNURL — LUD-04 authentication]
HTTPS protege el transporte, pero el servicio puede conocer solicitudes y tiempos. Los usos repetidos pueden vincularse. Auth deriva la clave del dominio completo; cambiar el subdominio cambia linkingKey y puede crear otra cuenta. La portabilidad entre carteras no está garantizada porque difieren sus métodos de derivación. LNURL no determina la custodia de bitcoin. [LNURL — LUD-01 encoding] [LNURL — LUD-04 authentication]
LUD-21 opcional añade una URL verify; la respuesta distingue settled true/false y puede devolver preimage. Status OK solo no significa settled true. Compruebe la correspondencia con la factura y el estado de la cartera. Tras perder la respuesta, no pague otra vez a ciegas; disponibilidad, liquidez receptora y alcance del consentimiento siguen siendo condiciones separadas. [LNURL — LUD index] [LNURL — LUD-21 verification]
Para obtener la imagen más completa, lee esta entrada junto con BOLT 11, BOLT 12, Lightning Network, Lightning Address, Privacidad en Bitcoin, Satoshi. También enlazan con esta entrada BOLT 12, Lightning Address.