Zaps

Imagina a un músico callejero. Te gusta la canción, así que dejas una moneda en su sombrero. Todos los que están cerca ven caer la moneda, y el músico sonríe. Así de simple.

En internet, esa “moneda en el sombrero” siempre ha sido incómoda: las comisiones de las tarjetas se comen las propinas pequeñas, los sitios de pago piden crear una cuenta y la plataforma se queda con una parte. La respuesta de Nostr es el zap: un pequeño pago por Lightning (la red de pagos rápidos de Bitcoin) que aparece justo debajo de una publicación, a la vista de todos. Las propinas de unos pocos centavos están bien, y llegan en segundos.

Y aquí viene el giro que hace interesantes a los zaps: los relays nunca tocan el dinero. Un relay solo guarda eventos. Así que un zap es una pequeña carrera de relevos entre cuatro participantes, y los eventos de Nostr son solo el papeleo de la salida y de la meta.

Los cuatro participantes

• La app de quien envía: el cliente de Nostr donde tocas ⚡, conectado a tu wallet Lightning.
• El servidor de la wallet de quien recibe: la empresa o el equipo autoalojado que recibe pagos Lightning en nombre de quien recibe. Habla LNURL, un protocolo web sencillo para preguntar “¿cómo te pago?”.
• La red Lightning: donde el dinero se mueve de verdad.
• Los relays: donde se anuncia el zap, para que todas las apps puedan mostrarlo.

Dale a reproducir (o avanza con las flechas) y mira cómo Alice le hace un zap al dibujo del avestruz de Erin. Cada paso muestra exactamente qué viaja entre los participantes.

Elige un zap para seguir

Alice → Erin · 2100 sats Grace → Alice · 21 sats Bob → Dave · 1000 sats

Solo datos de demostración: wallets falsas, facturas falsas, no se mueve dinero real.

Cuatro participantes, diez pasos. Recorre cómo viaja una propina desde la app de quien envía, pasando por el servidor de la wallet de quien recibe y la red Lightning, hasta volver a los relays de Nostr como un recibo.

⏮ ◀ ▶ ▶ Velocidad 0.5×1×2× Paso 1 de 10

1. Encontrar la dirección Lightning. La app lee el perfil de Erin (kind 0). Su campo lud16 guarda una dirección Lightning que parece un correo: erin@wallet.alpha.example.

Versión en texto

1. 1. Encontrar la dirección Lightning. La app lee el perfil de Erin (kind 0). Su campo lud16 guarda una dirección Lightning que parece un correo: erin@wallet.alpha.example.
2. 2. Tocar la puerta de la wallet. La dirección se convierte en una URL web normal. La app le pregunta a ese servidor de wallet: “¿cómo le pago a Erin?”
3. 3. La wallet dice “hablo Nostr”. La respuesta incluye allowsNostr: true y un nostrPubkey: la clave que esta wallet usará para firmar los recibos. ¡Recuérdala, la revisaremos más adelante!
4. 4. Escribir y firmar una solicitud de zap. La app de Alice escribe una notita firmada: a quién se le paga, cuánto, qué publicación, un comentario y qué relays deben enterarse.
5. 5. Entregar la solicitud a la wallet. La solicitud de zap NO se publica en los relays. Viaja dentro de una petición web directo a la URL de callback del servidor de la wallet.
6. 6. Recibir una factura Lightning. El servidor revisa la solicitud y devuelve una factura por 2100 sats. La solicitud de zap va incrustada en la descripción de la factura, así que ambas quedan unidas.
7. 7. ¡A pagar!. La wallet de Alice paga la factura por la red Lightning. El dinero se mueve en segundos, sin tocar ningún relay.
8. 8. El pago se liquida. El servidor de la wallet ve su factura pagada. La preimagen secreta que se revela es el sello de “pagado” de Lightning.
9. 9. La wallet publica un recibo de zap. El servidor de la wallet firma un recibo de zap con su nostrPubkey y lo envía a los relays indicados en la solicitud.
10. 10. Todos ven el zap. Las apps cargan los recibos desde los relays, los verifican y los suman. La publicación de Erin ahora muestra ⚡ 2100 sats.

01

1. Encontrar la dirección Lightning

La app lee el perfil de Erin (kind 0). Su campo lud16 guarda una dirección Lightning que parece un correo: erin@wallet.alpha.example.

Zaps en esta publicación ⚡ —

Qué viaja en este paso

▸  { "name": "erin" ,"display_name": "Erin" ,"about": "Artist. Drawing one weird animal per day. Zaps keep me caffeinated." ,"nip05": "erin@alpha.example" ,"lud16": "erin@wallet.alpha.example"  } 

Paso 1: encontrar el sombrero

Para dar una propina necesitas saber dónde está el sombrero. En Nostr, está en el perfil: el evento de metadatos (kind 0) tiene un campo llamado lud16 con una dirección Lightning. Parece un correo, erin@wallet.alpha.example, pero en realidad es un atajo para una URL web. Pruébalo:

Dirección Lightning → URL de la wallet

Una dirección Lightning lud16 es solo una forma corta de escribir una URL web. Escribe una para ver la URL que consultaría una app.

Dirección Lightning (lud16)

Prueba con un personaje de demostración alice@wallet.alpha.examplebob@wallet.beta.examplecarol@wallet.beta.exampledave@wallet.beta.example

La app consulta https://wallet.alpha.example/.well-known/lnurlp/erin

La app consulta esa URL y el servidor de la wallet responde con sus datos de pago. Dos campos de la respuesta importan para los zaps: allowsNostr: true (“sí, entiendo los zaps”) y nostrPubkey: la clave pública que el servidor de la wallet usará para firmar los recibos. Recuerda esa clave; es la estrella de la última sección.

{
  "callback": "https://wallet.alpha.example/lnurlp/erin/callback",
  "minSendable": 1000,
  "maxSendable": 100000000000,
  "metadata": "[[\"text/plain\",\"Zap Erin\"],[\"text/identifier\",\"erin@wallet.alpha.example\"]]",
  "tag": "payRequest",
  "allowsNostr": true,
  "nostrPubkey": "044b2cc412cc89149bc4f38a5067db6034dbaafe20321721a5414bb7237176f4"
}

import { nip57 } from "nostr-tools";

// metadataEvent = el kind 0 de quien recibe
const callback = await nip57.getZapEndpoint(metadataEvent); // null si !allowsNostr

Pasos 2–6: el papeleo

Antes de pagar, la app de Alice escribe una solicitud de zap: una notita que dice “Yo, Alice, quiero hacerle un zap de 2.100 sats a Erin por esta publicación, con el comentario ‘Love the ostrich! ⚡’. Por favor, anúncialo en estos relays.” Alice la firma con su clave, como cualquier evento, usando el kind 9734.

Sorpresa: esta nota no se publica en los relays. La app se la entrega directamente al servidor de la wallet de Erin en una petición web. El servidor la revisa y luego crea una factura Lightning (un cobro de un solo uso por exactamente 2.100 sats) y mete la solicitud de zap completa en la descripción de la factura. Ahora el cobro y la nota quedan pegados.

{
  "kind": 9734,
  "content": "Love the ostrich! ⚡",
  "tags": [
    ["relays", "wss://relay.alpha.example", "wss://relay.gamma.example"],
    ["amount", "2100000"],
    ["p", "c71750007e42443e5ca8c1ea00babed4e8c78a9cb45dd6db3733d918e0b55deb"],
    ["e", "def4b79eea11b4d6c0caa6da27dedc1ff5fc274a3378c64193f21aa05125d356"]
  ],
  "pubkey": "e550c6e92808f358382b7b8c14345344f5ef9a299529834d1c26d57b6ace44cc",
  "created_at": 1735684800,
  "id": "24539a56…",
  "sig": "b5beae9e…"
}

import { finalizeEvent, nip57 } from "nostr-tools";

const template = nip57.makeZapRequest({
  event: erinsPost,          // o { pubkey } para un zap a un perfil
  amount: 2_100_000,         // msat
  comment: "Love the ostrich! ⚡",
  relays: ["wss://relay.alpha.example"],
});
const zapRequest = finalizeEvent(template, aliceSecretKey);
const url = `${callback}?amount=2100000&nostr=${encodeURIComponent(JSON.stringify(zapRequest))}`;
const { pr: invoice } = await (await fetch(url)).json();

Pasos 7–10: se mueve el dinero y luego llega el anuncio

La wallet de Alice paga la factura por Lightning. Los relays no ven nada de esto: es Lightning puro. Cuando llega el pago, el servidor de la wallet de Erin escribe un recibo de zap (kind 9735), lo firma con su nostrPubkey y lo publica en los relays que indicó Alice. Cada app que carga la publicación de Erin encuentra el recibo, lo verifica y suma ⚡ 2.100 al contador.

{
  "kind": 9735,
  "pubkey": "044b2cc412cc89149bc4f38a5067db6034dbaafe20321721a5414bb7237176f4",
  "content": "",
  "tags": [
    ["p", "c71750007e42443e5ca8c1ea00babed4e8c78a9cb45dd6db3733d918e0b55deb"],
    ["P", "e550c6e92808f358382b7b8c14345344f5ef9a299529834d1c26d57b6ace44cc"],
    ["e", "def4b79eea11b4d6c0caa6da27dedc1ff5fc274a3378c64193f21aa05125d356"],
    ["bolt11", "lnbc21000n1p…"],
    ["description", "{\"kind\":9734,\"content\":\"Love the ostrich! ⚡\",…}"],
    ["preimage", "0e03fe78…"]
  ],
  "created_at": 1735684802
}

["REQ", "zaps", { "kinds": [9735], "#e": ["def4b79eea11b4d6c0caa6da27dedc1ff5fc274a3378c64193f21aa05125d356"] }]

¿Puedes confiar en un zap?

Ahora viene la parte honesta. Cualquiera puede publicar un evento kind 9735: es solo un evento. Así que, antes de sumar un zap al contador, una app revisa el recibo:

1. ¿La firma del recibo es válida?
2. ¿Lo firmó el servidor de la wallet de quien recibe, es decir, el nostrPubkey que vimos en el paso 1?
3. ¿Contiene una solicitud de zap real y firmada?
4. ¿El monto de la factura coincide con el monto que pidió Alice?

Estas comprobaciones atrapan manipulaciones e impostores. Pero mira con atención el último escenario de abajo: un servidor de wallet deshonesto puede firmar un recibo de aspecto perfecto para una factura que nadie pagó. ¡Y pasa todas las comprobaciones!

▸  { "id": "7682a16d40733fd532c600fc001391fdb208a9a6037f88d1f1cad2f1694ac347" ,"pubkey": "044b2cc412cc89149bc4f38a5067db6034dbaafe20321721a5414bb7237176f4" ,"created_at": 1735684802 ,"kind": 9735 ,▸ "tags": [ ▸  [ … 2 elementos ] ,▸  [ … 2 elementos ] ,▸  [ … 2 elementos ] ,▸  [ … 2 elementos ] ,▸  [ … 2 elementos ] ,▸  [ … 2 elementos ]  ] ,"content": "" ,"sig": "2e584640f02b15def129e281551368b07bfcd0531c652a0f15a294fa1823bf6925eda9dc2e5c23c14ceab38865e14deb2e9ba682ab62722856a706f79cb35434"  } 

Ese es el modelo de confianza en una frase: un recibo de zap es el proveedor de wallet de quien recibe diciendo “esto se pagó”. Demuestra que alguien pidió una factura, y la wallet responde por el resto. Normalmente no hay problema (la wallet la elige quien recibe, y mentir solo inflaría sus propios ingresos), pero por eso los contadores de zaps son señales sociales, no registros contables. Los únicos que saben con certeza que hubo un pago son quien pagó (que tiene la preimagen) y quien recibió (cuyo saldo subió).

import { nip57 } from "nostr-tools";

// Descarta los recibos que fallan lo básico antes de contarlos.
const request = JSON.parse(receipt.tags.find((t) => t[0] === "description")?.[1] ?? "null");
const err = nip57.validateZapRequest(JSON.stringify(request)); // null cuando la solicitud está bien
const okSigner = receipt.pubkey === lnurlPayResponse.nostrPubkey;
const sats = nip57.getSatoshisAmountFromBolt11(receipt.tags.find((t) => t[0] === "bolt11")?.[1] ?? "");

Comprobación rápida