Anatomía de un evento

En el capítulo anterior obtuviste un par de claves. Ahora vamos a usarlo. En Nostr, todo lo que haces es un evento: una publicación, un like, tu perfil, la lista de personas que sigues. Trabajos distintos, una sola forma. Aprende esa forma una vez y podrás leer todo el protocolo.

Un sobre sellado con huella

Piensa en un evento como una postal que guardas en una funda de plástico transparente:

• La postal es lo que quieres decir: el texto, cuándo lo escribiste, qué tipo de mensaje es y unas cuantas etiquetas adhesivas.
• La huella estampada en la funda se calcula a partir de la postal. Cambia una sola letra de la postal y la huella deja de coincidir.
• Tu sello de lacre va encima de la huella. Solo tú puedes estamparlo, pero cualquiera puede comprobar que es tuyo.

Eso es todo. Eso es un evento. La huella es el id, y el sello de lacre es la firma.

Aquí tienes uno de verdad, escrito por Alice. Haz clic en cualquier campo para saber qué hace.

Pruébalo ya: cambia a Un falsificador (sin clave) y modifica el texto. El contenido se actualiza, pero el id y la firma viejos siguen pegados, y la verificación te descubre en la primera comprobación. Vuelve a Alice y la misma edición está perfecta, porque ella puede volver a firmar.

Los siete campos

Todo evento tiene exactamente estos siete campos. No se exige nada más, y no se permite nada menos.

kind: un número, muchos trabajos

El kind les dice a las apps cómo leer el resto. El kind 1 es una nota de texto corta, el kind 0 es tu perfil, el kind 3 tu lista de seguidos y el kind 7 una reacción (un “like”). El número también les dice a los relays cómo guardarlo: la mayoría de los eventos se guardan para siempre, pero algunos son reemplazables (solo importa tu perfil más reciente) y otros son efímeros (pásalo, no lo guardes). Recorreremos todo el zoológico en el capítulo 6.

tags: etiquetas adhesivas

Los tags son una lista de listas pequeñas. El primer elemento es el nombre de la etiqueta y el resto son sus valores:

• ["e", "<event id>"] apunta a otro evento. Así funcionan las respuestas y las citas.
• ["p", "<pubkey>"] menciona a una persona, para que su app le avise.
• ["t", "nostr"] es un hashtag.

Las etiquetas de una sola letra son especiales: los relays las indexan, así que un cliente puede pedir “dame todas las notas con el tag #nostr” o “todas las respuestas a este evento”.

created_at: una afirmación, no un reloj

created_at es una marca de tiempo Unix que elige el autor. Nada impide que Alice escriba “enero de 2009”. Los clientes ordenan los feeds según este campo, y muchos relays rechazan eventos de un futuro demasiado lejano, pero no lo tomes como prueba de cuándo ocurrió algo.

Cómo se hace la huella

Para calcular el id, todos los clientes siguen la misma receta de NIP-01:

1. Serializar. Pon los campos en un orden fijo dentro de un arreglo JSON, sin espacios extra: [0, pubkey, created_at, kind, tags, content]. El 0 inicial es un marcador de versión.
2. Hashear. Codifica ese texto como bytes UTF-8 y pásalos por SHA-256. Salen 32 bytes, escritos como 64 caracteres hexadecimales. Ese es el id.
3. Firmar. Alice firma el id con su clave secreta usando una firma Schnorr. Esa es la sig.

Un hash tiene una propiedad maravillosa llamada efecto avalancha: cambia un carácter de la entrada y aproximadamente la mitad de los bits de salida se invierten. Mira el contador de “dígitos del id que cambiaron” en el laboratorio: una sola letra suele revolver unos 60 de los 64 dígitos hexadecimales.

[0,"a73883912a48c3551c1548fd454876d577126a61c76b5486c807bfec5869e183",1735686600,1,[],"testing testing is this thing on"]

import { sha256 } from "@noble/hashes/sha2.js";
import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils.js";

const serialized = JSON.stringify([0, pubkey, created_at, kind, tags, content]);
const id = bytesToHex(sha256(utf8ToBytes(serialized)));

Comprobar el sello

Cuando tu app recibe un evento de un relay, no confía en él solo porque llegó. Lo verifica, en dos pasos:

1. Vuelve a calcular el id a partir de los campos. ¿Coincide con el id que dice tener el evento? Si no, algo se cambió después de firmar.
2. Comprueba la sig contra el id y la pubkey. Si falla, el evento no fue firmado con esa clave.

Ambas comprobaciones son matemática pura y se ejecutan en tu propio dispositivo. Esa es la gran idea: no necesitas confiar en el relay. Un relay puede negarse a entregar las notas de Alice, pero no puede cambiar ni una palabra de ellas, ni inventar notas nuevas en su nombre, sin que lo descubran.

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

const sk = generateSecretKey(); // Uint8Array(32)
const event = finalizeEvent(
  {
    kind: 1,
    created_at: Math.floor(Date.now() / 1000),
    tags: [["t", "nostr"]],
    content: "¡Hola Nostr!",
  },
  sk,
); // agrega pubkey, id y sig

verifyEvent(event); // true

// Una copia alterada, tal como llegaría desde la red (JSON plano):
const tampered = JSON.parse(JSON.stringify({ ...event, content: "¿Hola Nostr?" }));
verifyEvent(tampered); // false: el id ya no coincide

["e", "<32-byte hex event id>", "<recommended relay URL, optional>", "<author pubkey, optional>"]
["p", "<32-byte hex pubkey>", "<recommended relay URL, optional>"]
["a", "<kind>:<pubkey hex>:<d tag value>", "<recommended relay URL, optional>"]

Inspecciona cualquier evento

¿Tienes un evento que sacaste de otro lado? Pégalo en la herramienta inspector de eventos: comprueba el id y la firma directamente en tu navegador y explica cada campo.

Comprobación rápida