Firmar e iniciar sesión

En el capítulo 2 aprendiste que tu identidad en Nostr es un par de claves. La clave pública es tu credencial con tu nombre; la clave secreta (que se muestra como una nsec) es la pluma que escribe tu firma en cada evento.

Así que aquí va el acertijo: quieres usar diez apps de Nostr distintas. Todas necesitan tu firma en las notas que publicas. ¿Le das tu pluma a las diez?

Por favor, no. Piensa en tu clave secreta como la llave maestra de tu casa. No le darías una copia a cada repartidor. Preferirías tener un portero que les abra la puerta por ti, revise lo que traen y nunca saque la llave de su bolsillo. En Nostr, ese portero se llama firmante.

Iniciar sesión sin contraseñas

En Nostr no hay cuentas, así que no hay contraseña que escribir. Cuando una app dice “iniciar sesión”, lo único que realmente necesita es:

1. Tu clave pública, para saber de quién es el feed que debe mostrar y qué notas buscar.
2. Una forma de conseguir firmas, para que tus publicaciones, likes y follows cuenten como tuyos.

El atajo peligroso es darle a la app tu nsec, que cubre ambas cosas a la vez. La forma segura es darle solo el punto 1, más una línea telefónica con un firmante para el punto 2.

Pruébalo: ¿quién puede tocar tu clave?

Abajo tienes la misma nota firmada de tres maneras. Todo es real: claves reales, firmas Schnorr reales y cifrado real ejecutándose en tu navegador. Las claves son de demostración, creadas solo para esta página, así que juega con libertad.

Cosas para probar:

• Firma con Pegar tu nsec y mira cómo el detector de fugas se pone en rojo. Ahora la app es tú.
• Cambia a Extensión del navegador, firma y luego pulsa Rechazar en el firmante. No se firma nada.
• Prueba Bunker remoto y abre los saltos de la columna central: el relay solo transporta texto ilegible.

La extensión del navegador (NIP-07)

El firmante más común es una extensión del navegador (entre las populares están Alby, nos2x y Nostr Connect). Sigue el NIP-07, que es maravillosamente pequeño: la extensión añade un objeto llamado window.nostr a cada página web. Una app web lo usa como si hiciera una llamada telefónica:

• “¿Quién eres?” → getPublicKey() devuelve tu clave pública. Ese es todo el inicio de sesión.
• “Firma esta nota, por favor.” → signEvent(template) hace que la extensión aparezca, te muestre la nota y, si la apruebas, devuelva el evento terminado y firmado.

La clave secreta vive en el almacenamiento privado de la extensión. La página web no puede leerla, igual que un sitio web no puede husmear en las cookies de otro.

Recorre ambas pestañas paso a paso. En la primera, fíjate en que solo viajan a la app cosas terminadas: una clave pública y un evento firmado.

interface WindowNostr {
  getPublicKey(): Promise<string>; // pubkey en hex
  signEvent(event: { created_at: number; kind: number; tags: string[][]; content: string }): Promise<Event>; // añade id, pubkey, sig
  nip44?: {
    encrypt(pubkey: string, plaintext: string): Promise<string>;
    decrypt(pubkey: string, ciphertext: string): Promise<string>;
  };
  nip04?: { /* misma forma, obsoleto */ };
}

if (!window.nostr) throw new Error("No se encontró un firmante NIP-07. Instala una extensión de Nostr.");

const pubkey = await window.nostr.getPublicKey(); // todo el "inicio de sesión"

const signed = await window.nostr.signEvent({
  kind: 1,
  created_at: Math.floor(Date.now() / 1000),
  tags: [],
  content: "gm!",
}); // lanza un error si el usuario pulsa "Rechazar"

El firmante remoto, o “bunker” (NIP-46)

Las extensiones son geniales en una computadora portátil, pero ¿qué pasa con tu teléfono, una computadora compartido o una app que no puede instalar extensiones? El NIP-46 lleva el firmante a un dispositivo distinto, llamado bunker. Puede ser una app en tu teléfono, un pequeño servidor en casa o un servicio alojado.

Lo ingenioso: la app y el bunker se comunican a través de un relay de Nostr cualquiera, como si se pasaran notas por un buzón. Cada nota del buzón va cerrada con cifrado NIP-44, así que el relay ve quién se pasa notas, pero no lo que dicen.

1. El bunker te da un enlace de conexión: bunker://<bunker pubkey>?relay=wss://…&secret=….
2. Lo pegas en la app. La app crea un par de claves desechable solo para hablar con el bunker.
3. La app envía una solicitud connect cifrada; el bunker comprueba el secreto de un solo uso y responde ack.
4. La app envía get_public_key para conocer tu pubkey, que puede ser distinta de la clave del propio bunker en el enlace.
5. A partir de ahí, cada solicitud sign_event aparece en tu teléfono. Apruébala y el evento firmado vuelve.

Cambia el diagrama de arriba a la pestaña Bunker NIP-46 y recórrelo paso a paso. Abre los detalles de un salto para comparar lo que ve el relay con lo que descifra el bunker.

{
  "kind": 24133,
  "pubkey": "<client pubkey (throwaway)>",
  "tags": [["p", "<remote-signer pubkey>"]],
  "content": "<nip44(request)>",
  "created_at": 1735689600,
  "id": "…",
  "sig": "…"
}

{ "id": "s1", "method": "sign_event", "params": ["{\"kind\":1,\"content\":\"gm\",\"tags\":[],\"created_at\":1735689600}"] }
{ "id": "s1", "result": "{\"kind\":1,…,\"id\":\"…\",\"pubkey\":\"…\",\"sig\":\"…\"}" }

import { generateSecretKey } from "nostr-tools/pure";
import { BunkerSigner, parseBunkerInput } from "nostr-tools/nip46";

const pointer = await parseBunkerInput("bunker://…?relay=wss://relay.example&secret=…");
if (!pointer) throw new Error("URL de bunker no válida");

const clientKey = generateSecretKey(); // desechable: guárdala para retomar la sesión más tarde
const bunker = BunkerSigner.fromBunker(clientKey, pointer, { onauth: (url) => window.open(url) });
await bunker.connect();

const pubkey = await bunker.getPublicKey(); // la clave del usuario, no la del bunker
const signed = await bunker.signEvent({ kind: 1, created_at: Math.floor(Date.now() / 1000), tags: [], content: "gm" });

Nombres que puedes leer: NIP-05

Las claves públicas son geniales para las computadoras y terribles para los humanos. Nadie quiere decirle a un amigo “sígueme en npub1qy88wumn8ghj7…”. El NIP-05 añade una etiqueta parecida a un correo electrónico, como alice@alpha.example.

Funciona como una credencial con tu nombre que te imprime una empresa. Alice escribe alice@alpha.example en su perfil (metadatos kind 0). Tu app no se lo cree sin más: le pide al dominio alpha.example un pequeño archivo llamado nostr.json y comprueba que el nombre alice apunte a la clave pública de Alice. Si el dominio está de acuerdo, la app muestra una marca de verificación.

Prueba Nombre prestado: el perfil de Alice dice ser bob@beta.example, pero el dominio tiene ahí la clave de Bob, así que la comprobación falla. Cualquiera puede escribir cualquier nombre en su perfil; solo quien controla el dominio puede respaldarlo.

{
  "names": { "alice": "<64-char lowercase hex pubkey>" },
  "relays": { "<that pubkey>": ["wss://relay.alpha.example"] }
}

import { queryProfile, isValid } from "nostr-tools/nip05";

const pointer = await queryProfile("alice@alpha.example"); // { pubkey, relays } | null
const ok = await isValid(profilePubkey, "alice@alpha.example"); // true si el dominio está de acuerdo

Comprobación rápida