Decodificador LNURL

Qué es realmente LNURL

LNURL es una familia de protocolos que pone una url donde empieza una interacción Lightning. En lugar de copiar una factura nueva para cada pago, escaneas o pulsas algo que apunta tu wallet a un endpoint web, y la wallet sigue desde ahí. La cadena lnurl1 que todos reconocen no es nada más exótico que esa url, codificada en bech32 para sobrevivir a códigos QR y al copiar y pegar.

El sabor más común es LNURL-pay, que permite a una wallet pedir una factura por un importe dentro de los límites que publica el receptor. También existe LNURL-withdraw, donde los papeles se invierten y el endpoint se ofrece a pagarte, y variantes de login y de canales.

Las direcciones Lightning son LNURL disfrazado

Una dirección como propinas@ejemplo.com es una convención de nombres encima de LNURL-pay: la wallet la convierte en una petición al endpoint /.well-known/lnurlp/propinas de ejemplo.com y sigue exactamente igual que si hubiera escaneado una cadena lnurl1. Por eso el formato de dirección se impuso para propinas y zaps en Nostr; se recuerda, se imprime y cabe en un campo de perfil.

El decodificador acepta ambas formas. Te muestra la url https en claro y, cuando el endpoint permite peticiones desde el navegador, descarga sus parámetros: importe mínimo y máximo, la descripción que adjunta el receptor y si anuncia soporte de zaps de Nostr.

Por qué decodificar antes de pagar

Todo el modelo de confianza de LNURL es el dominio detrás de la url. Un código QR en un cartel o un enlace en un DM pueden apuntar a cualquier parte, y una vez decodificado, el dominio coincide con quien dice cobrar o no coincide. Diez segundos mirando la url real es la comprobación antiestafa más barata de Lightning.

Decodificar también es la vía rápida para depurar un pago que falla. Si el endpoint no responde o sus límites excluyen tu importe, el decodificador lo muestra en claro, en lugar de una wallet dando vueltas.

Un detalle que conviene saber: un endpoint LNURL puede cambiar sus parámetros en cualquier momento, porque viven en un servidor web y no en la cadena que decodificaste. Esa flexibilidad es la gracia del invento, y también la razón de que el dominio decodificado sea la única constante a la que anclar la confianza entre pagos.