Los relays y el protocolo

Ya tienes un par de claves y sabes firmar un evento. Pero una nota firmada que se queda en tu computadora portátil es un diario, no una red social. Para llegar a otras personas tiene que viajar a algún lugar. En Nostr, ese lugar es un relay.

Los relays son tontos (y es un cumplido)

Imagina un relay como el tablón de anuncios de una cafetería. Cualquiera puede clavar una tarjeta, cualquiera puede acercarse a leer las tarjetas, y el dueño del café pone las reglas de la casa: nada de publicidad, solo socios, las tarjetas se retiran al mes. Eso es todo. El tablón no conoce a tus amigos, no ordena tu feed y no habla con el tablón de la cafetería de enfrente.

Tu cliente (la app que usas) es lo contrario: es tu asistente personal. Sabe qué tablones usan tus amigos, va a varios de ellos, recoge las tarjetas, descarta las repetidas, comprueba cada firma y te lo presenta todo bien ordenado.

Esta división es intencional:

• Los relays siguen siendo simples, así que son baratos de mantener. Miles de personas operan uno, desde grandes relays públicos hasta uno diminuto en el armario de alguien.
• La inteligencia está en los clientes, así que tú eliges el algoritmo, no una empresa.
• Nada depende de un solo relay. Si un tablón desaparece, tu asistente simplemente lee otro. De ahí viene la resistencia a la censura de Nostr.

Escuchando la línea

Clientes y relays hablan a través de un WebSocket: una línea telefónica que se queda abierta, para que ambos lados puedan hablar cuando quieran. Cada mensaje en esa línea es un pequeño array JSON cuyo primer elemento es una palabra en mayúsculas, como si gritara: el verbo.

Elige una conversación abajo y luego dale a reproducir, avanza paso a paso con las flechas o arrastra la barra de progreso. Haz clic en cualquier tipo de paquete de la leyenda para saltar directamente a él. No pierdas de vista la libreta del cliente: es toda la contabilidad que los relays no hacen.

Todo el vocabulario cabe en un pósit

NIP-01 define el lenguaje básico. Tu cliente dice tres cosas:

El relay responde con cinco:

Y hay un par extra para iniciar sesión, de NIP-42: AUTH. El relay envía un desafío aleatorio; tu cliente lo firma con tu clave y lo devuelve. Ninguna contraseña viaja por la línea, solo una firma. (También existe COUNT, de NIP-45, para preguntas del tipo “¿cuántos hay?”, pero casi nunca lo verás.)

["REQ", "feed", {"authors": ["e550c6e9…"], "kinds": [1], "limit": 2}]
["EVENT", "feed", {"id": "…", "pubkey": "…", "created_at": 1735686600, "kind": 1, "tags": [], "content": "…", "sig": "…"}]
["EOSE", "feed"]
["CLOSE", "feed"]

["EVENT", {"id": "…", "kind": 1, "…": "…"}]
["OK", "<event id>", true, ""]
["OK", "<event id>", false, "pow: difficulty 16 or more is required"]
["CLOSED", "feed", "rate-limited: slow down, too many requests"]
["NOTICE", "heads up: this relay restarts at 03:00 UTC"]

["AUTH", "ostrich-7f3a9c2e"]
["CLOSED", "dms", "auth-required: gift wraps are only served to their recipient"]

["AUTH", {"kind": 22242, "tags": [["relay", "wss://relay.delta.example"], ["challenge", "ostrich-7f3a9c2e"]], "content": "", "…": "id, pubkey, created_at, sig"}]
["OK", "<auth event id>", true, ""]

import { SimplePool } from "nostr-tools/pool";
import { finalizeEvent, generateSecretKey } from "nostr-tools/pure";

const relays = ["wss://relay.damus.io", "wss://nos.lol", "wss://relay.primal.net"];
const pool = new SimplePool();

// REQ a cada relay; onevent se dispara una vez por evento único, oneose cuando todos enviaron EOSE.
const sub = pool.subscribeMany(relays, { kinds: [1], limit: 3 }, {
  onevent: (event) => console.log(event.pubkey.slice(0, 8), event.content),
  oneose: () => sub.close(), // envía CLOSE a cada relay
});

// Publicar = un EVENT por relay; cada promesa se resuelve con el OK de ese relay.
const event = finalizeEvent(
  { kind: 1, created_at: Math.floor(Date.now() / 1000), tags: [], content: "hola relays" },
  generateSecretKey(),
);
const results = await Promise.allSettled(pool.publish(relays, event));
console.log(results.map((r) => r.status)); // p. ej. ["fulfilled", "fulfilled", "rejected"]

No pongas todas tus notas en un solo relay

Como los relays no copian eventos entre sí, tu cliente suele enviar cada nota a varios relays a la vez. Si uno se desconecta, se satura o decide que no le caes bien, tus seguidores aún pueden encontrar tu nota en los demás. Algunos relays son gratuitos, otros son de pago (una pequeña cuota es un gran filtro contra el spam), y cada uno tiene sus propias reglas. Combínalos a tu gusto.

Pruébalo: elige dónde publicar y luego empieza a tumbar relays.

¿Cómo sabe el cliente de Bob qué relays revisar para encontrar tus notas? Publicas una pequeña lista de relays “donde escribo”, y su cliente va allí. Eso es el modelo outbox (NIP-65), y lo veremos en el capítulo 7.

Escucha la versión real

Todo lo anterior estaba guionizado. Este panel envía un REQ real y muestra cada mensaje exactamente como llega. Por defecto habla con nuestros relays de práctica; activa el Modo en vivo en la cabecera y hablará con relays públicos reales. Tranquilo: solo lee. Nunca publicamos nada.

Fíjate en los mensajes CLOSE del final: en cuanto todos los relays han dicho EOSE, el panel cuelga amablemente. Un cliente real a menudo mantendría la suscripción abierta para recibir notas nuevas a medida que se publican.

Comprobación rápida