Nostr Wallet Connect (NWC) explicado

Antes de Nostr Wallet Connect, cada cliente Nostr tenía que construir su propia integración de billetera, o enviarse sin funcionalidad de zaps completamente. Esto produjo dos resultados malos: clientes que enviaban zaps se vieron obligados a ejecutar una billetera, y clientes que no querían ejecutar una billetera no podían soportar zaps.

NWC arregló esto separando la billetera del cliente. La billetera es su propia aplicación; el cliente envía solicitudes de gasto sobre Nostr mismo; todos ganan.

Si usas zaps en cualquier cliente sin billetera integrada, estás usando NWC ya sea que lo pienses o no. Esta guía hace el mecanismo explícito para que entiendas qué hace la cadena de conexión, cuáles son sus límites y cómo revocarlo.

Resumen. NWC es un protocolo (NIP-47) para que un cliente Nostr pida a una billetera Lightning que pague facturas. El emparejamiento es una cadena que se ve como nostr+walletconnect://.... La cadena otorga permiso de gasto hasta un presupuesto configurable. Cualquier billetera puede hablar NWC a cualquier cliente consciente de NWC, por lo que el emparejamiento funciona en todo el ecosistema.

Cuando estés listo, pide tu dirección @nostr.blog →

El problema antes de NWC

Pre-NWC, un cliente Nostr que quería soportar zaps tenía tres opciones malas.

Opción 1: Integrar una billetera en el cliente. Gestionar canales Lightning, manejar la custodia, ser una empresa de billeteras. La mayoría de los clientes no podían permitirse la ingeniería.

Opción 2: Pedir al usuario su nsec y sus credenciales de billetera. Firmar eventos en el lado del cliente y enviar solicitudes de pago de facturas directamente a la API de la billetera. Esto significaba que el cliente veía la clave API de la billetera, lo cual es una pesadilla de seguridad.

Opción 3: No soportar zaps. Algunos clientes tomaron este camino, lo que los hizo menos útiles.

NWC desacopla la billetera del cliente usando Nostr mismo como canal de señalización. El cliente nunca ve las credenciales de la billetera. La billetera nunca tiene que saber nada específico de Nostr excepto cómo recibir solicitudes.

Cómo funciona el protocolo

NWC se define en NIP-47. El flujo:

1. La billetera genera una cadena de conexión. Contiene una URL de retransmisión Nostr, una pubkey en la que escucha la billetera, y un secreto compartido para cifrado.
2. El usuario pega la cadena en el cliente. O escanea un código QR. De cualquier forma, el cliente ahora sabe dónde enviar solicitudes.
3. El cliente envía solicitudes de gasto cifradas sobre Nostr. "Paga esta factura por 1000 sats" va en un evento cifrado a la pubkey de escucha de la billetera en la retransmisión especificada.
4. La billetera recibe la solicitud y paga. Si la cantidad está dentro del presupuesto de la conexión, la billetera paga la factura inmediatamente.
5. La billetera responde con el resultado. Evento Nostr cifrado de vuelta al cliente: el pago tuvo éxito o falló, aquí está la prueba.

Todo sucede en menos de un segundo. El cliente nunca maneja Lightning directamente; solo habla con Nostr. La billetera nunca tiene que entender las características sociales de Nostr; solo escucha solicitudes de gasto.

Qué contiene la cadena de conexión

Una cadena NWC típica:

nostr+walletconnect://abc123def456...?relay=wss://relay.example.com&secret=xyz789...

Tres partes.

Una pubkey. La identidad de escucha de la billetera en Nostr. El cliente envía solicitudes a esta pubkey.

Una retransmisión. Donde está escuchando la billetera. El cliente y la billetera se conectan a esta retransmisión para intercambiar mensajes.

Un secreto. Usado para cifrar mensajes entre el cliente y la billetera, para que la retransmisión vea solo texto cifrado.

Juntos, estos tres valores otorgan al cliente permiso para enviar comandos de gasto a la billetera. La retransmisión es el buzón; la pubkey es la dirección; el secreto es la cerradura.

Presupuesto y permisos

Cada conexión NWC tiene límites establecidos por la billetera cuando se creó la conexión.

• Cantidad máxima por pago. Típicamente 10,000 a 100,000 sats dependiendo de lo que configures. Gastar más requiere una aprobación fresca.
• Cantidad máxima por día/semana/mes. Presupuesto móvil que se recarga en un horario.
• Fecha de expiración. Algunas billeteras expiran automáticamente las conexiones después de un período; otras las dejan abiertas hasta que se revocan.
• Métodos permitidos. Algunas billeteras te permiten otorgar solo "pagar factura", denegando "buscar saldo" o "listar transacciones".

El presupuesto significa que incluso si una cadena de conexión se filtra, el daño está limitado. Un atacante no puede drenar toda la billetera; puede gastar hasta el presupuesto, punto en el cual la billetera rechaza solicitudes adicionales hasta que aumentes el límite o generes una nueva conexión.

Configurar NWC, paso a paso

Flujo concreto para un usuario típico emparejando una billetera con un cliente Nostr.

1. Abre tu billetera Lightning. Wallet of Satoshi, Phoenix, Alby Hub, Zeus, o cualquier billetera que soporte NWC.
2. Encuentra la configuración de NWC. Busca "Conexiones", "Nostr Wallet Connect", o "Aplicaciones" en el menú de configuración. Cada billetera lo pone en un lugar ligeramente diferente.
3. Crea una nueva conexión. Dale un nombre para que recuerdes para qué aplicación es. Establece un presupuesto.
4. Copia la cadena NWC generada. O obtén un código QR.
5. Abre tu cliente Nostr. Ve a la configuración, encuentra "Billetera Lightning" o "Configuración de zaps".
6. Pega la cadena NWC o escanea el código QR. El cliente prueba la conexión.
7. Éxito. Los botones de zap se encienden; tu próximo zap va a través de la billetera emparejada.

Si el cliente muestra "conexión fallida" después de emparejar, la causa más común es una falta de coincidencia de retransmisión (la retransmisión en la cadena NWC es una que el cliente no puede alcanzar) o un firewall bloqueando conexiones WebSocket.

Por qué esto es mejor que una billetera integrada

Tres ventajas reales de NWC sobre billeteras integradas.

Portabilidad. Puedes cambiar clientes Nostr sin cambiar billeteras. Tu saldo, historial y canales se quedan; el nuevo cliente simplemente se empareja con la misma billetera a través de una nueva conexión NWC.

Especialización. Los desarrolladores de billeteras se enfocen en la infraestructura Lightning; los desarrolladores de clientes se enfocen en la UX social. Cada lado mejora en su propio dominio, y la interoperabilidad funciona en todas las combinaciones.

Límite de seguridad. El cliente nunca tiene credenciales de billetera. Un cliente defectuoso puede en el peor de los casos enviar facturas incorrectas; no puede drenar la billetera o exportar la frase semilla.

El único caso donde integrado es claramente mejor es para usuarios que quieren el onboarding sin fricción máximo. Un cliente con una billetera incluida obtiene el usuario zapando un paso más rápido que emparejar una billetera externa. Es por esto que el registro de nostr.blog incluye una billetera por defecto, y los usuarios aún pueden emparejar billeteras externas a través de NWC más tarde si lo prefieren.

Revocar una conexión NWC

Si pierdes un dispositivo, dejas de usar un cliente, o quieres rotar credenciales, revoca la conexión del lado de la billetera.

1. Abre la billetera.
2. Encuentra la conexión en la lista de configuración.
3. Toca revocar o eliminar.
4. La cadena de conexión ya no funciona; cualquier cliente que la tenga obtiene "no autorizado" en la próxima solicitud.

Esto es instantáneo. A diferencia de las claves API que podrías filtrar en un repositorio de GitHub, las conexiones NWC pueden ser eliminadas en segundos y ninguna sesión persistente permanece. Esta es una propiedad de seguridad significativa.

Problemas comunes de NWC

"Conexión agotada." La retransmisión en la cadena NWC es inalcanzable desde tu red, o la billetera está sin conexión. Verifica que la aplicación de billetera esté abierta y conectada; algunas billeteras requieren que la aplicación esté activa para responder.

"Pago fallido" a pesar de una factura válida. Los canales de la billetera pueden carecer de la liquidez para enrutar el pago. Este es un problema de capa Lightning, no específico de NWC. Intenta con una cantidad diferente o en un momento diferente.

"Permiso denegado." El presupuesto de la conexión está agotado, la conexión ha expirado, o el tipo de solicitud no está en los métodos permitidos. Verifica la configuración de conexión de la billetera.

"El cliente no puede detectar la billetera." Después de pegar, el cliente se queda colgado. Cierra y reabre el cliente; algunos clientes almacenan en caché el estado de la conexión y solo revisan en el lanzamiento.

Hacia dónde va NWC

NIP-47 no es definitivo. El trabajo activo en 2026 cubre:

• Permisos más ricos. Más granular que "puede gastar hasta X por período", con reglas por destinatario o por cantidad.
• Enrutamiento multi-billetera. Un cliente emparejado con múltiples billeteras elige la mejor para cada pago basado en saldo, tarifa o ruta.
• Mejor informe de errores. Códigos de error estandarizados para que los clientes muestren mensajes útiles cuando los pagos fallan.
• Soporte de billetera sin conexión. NWC actual asume que ambos lados están en línea; los borradores permiten solicitudes encoladas que se resuelven cuando la billetera se reconecta.

El protocolo es lo suficientemente estable para el uso diario en 2026 y seguirá evolucionando. Emparejar una billetera hoy es una operación de un minuto; nada sobre el diseño actual se romperá más adelante.