Cómo funciona Obelisk
Obelisk es una app web sin backend propio. Firma eventos Nostr con tu clave y los manda directo a tu servidor, que es un relay NIP-29, y a los otros relays que necesita. Esto es lo que pasa cuando iniciás sesión, mandás un mensaje o te unís a un grupo.
La forma de la app
Obelisk tiene dos partes que se mueven: la app web en tu navegador y los relays con los que habla.
┌───────────────────────┐ eventos firmados ┌──────────────────────┐
│ App web de Obelisk │ ───────────────► │ Tu servidor │
│ (tu navegador; │ ◄─────────────── │ (un relay NIP-29) │
│ tu clave firma) │ └──────────────────────┘
│ │ perfiles, DMs ┌──────────────────────┐
│ │ ◄──────────────► │ Otros relays Nostr │
└───────────────────────┘ └──────────────────────┘
El servidor de una comunidad, lo que configurás en Ajustes del servidor, es un relay NIP-29. Guarda los canales, los mensajes y los roles, y hace cumplir quién puede hacer qué. No hay nada entre vos y él: no hay base de datos de Obelisk, ni servicio de cuentas, ni servidor de sesiones. Tu clave se queda con vos (en una extensión del navegador, en una app firmante o sellada en tu dispositivo) y firma cada evento. Un solo gestor de conexiones en la app mantiene un WebSocket abierto con cada relay y le manda los eventos firmados directo; para leer, la misma app se suscribe al stream del relay.
El sitio en sí lo sirve un servidor Next.js chiquito: las páginas, sus headers de seguridad, las vistas previas de links (así un link que solo mirás nunca llega a un servicio de previews de terceros) y las páginas públicas de notas y perfiles. No guarda cuentas, ni claves, ni mensajes.
Qué pasa cuando iniciás sesión
-
La pantalla de login te ofrece estas formas de entrar:
- Extensión del navegador (NIP-07): Alby, nos2x y similares firman a través de
window.nostr. La clave nunca sale de la extensión. - App firmante (NIP-46): escaneás un QR o pegás un link de bunker de Amber, nsec.app u otro firmante remoto. La clave se queda en esa app y Obelisk le pide que firme.
- nsec: pegás una clave privada. Antes de guardarla en este dispositivo se sella con una clave que el navegador no puede exportar, así que nunca queda guardada en claro.
- Generar: creás un par de claves nuevito ahí mismo, y lo respaldás.
- Extensión del navegador (NIP-07): Alby, nos2x y similares firman a través de
-
La app deriva tu pubkey, busca tu perfil kind 0 en relays de perfiles, se conecta a tu servidor, y ya estás adentro. No hay cuenta, ni contraseña, ni token nuestro: la clave es tu identidad, y el registro de sesión en tu dispositivo está cifrado. Si el navegador no puede guardar ese registro de forma segura, el login dura solo mientras la pestaña esté abierta.
Qué pasa cuando mandás un mensaje
- Escribís un mensaje en un canal de tu servidor.
- La app arma un evento kind 9 (mensaje de grupo NIP-29), etiquetado con el ID del grupo y, si es una respuesta, con el evento al que responde.
- El evento se firma con tu clave: la extensión, la app firmante o, para una clave pegada o generada, el navegador.
- El gestor de conexiones lo publica en ese relay por el WebSocket.
- El relay verifica que puedas escribir ahí, guarda el mensaje, y todos los que están suscritos a ese canal lo ven aparecer.
No hay un paso de "mandar al servidor de Obelisk". Tu servidor es el relay.
Qué pasa cuando te unís o creás un grupo
Los grupos son grupos NIP-29. El relay los guarda, no nosotros.
- Crear: la app manda un evento
9007(crear grupo). El relay te registra como primer admin del grupo en su lista de admins39001. - Unirse / salir: mandás un pedido para unirte
9021o para salir9022. El relay te deja entrar (o guarda el pedido para un admin) y actualiza su lista de miembros39002. - Moderación: los admins suman y sacan gente con
9000(put user) y9001(remove user); el relay lo hace cumplir. - Canales, metadata, admins, miembros: todos eventos NIP-29 estándar que publica el mismo relay:
39000(metadata),39001(admins),39002(miembros).
Los grupos pertenecen al relay que estás mirando, así que cambiar de relay es cambiar de servidor. A la app no le importa qué relay sea, mientras hable NIP-29.
¿Y los perfiles y los DMs?
Los perfiles y los mensajes directos no viven en tu servidor. La app va a buscarlos sola a otros relays Nostr:
- Perfiles (kind 0) y feeds sociales salen de relays de perfiles y de feed que podés cambiar en los ajustes, nunca de tu servidor.
- DMs están apagados hasta que los activás en los ajustes. Obelisk los manda como NIP-17: "gift-wrapped" y cifrados con NIP-44, entregados a los relays inbox del receptor, así un relay no ve ni quién manda ni el contenido. También lee los mensajes NIP-04 más viejos (kind 4), para que aparezcan las conversaciones que ya tenías.
Ambos son cifrados de punta a punta: solo el emisor y el receptor tienen las claves para descifrar.
¿Y la voz?
Los canales de voz usan WebRTC, negociado con eventos Nostr. En un canal de voz común, hasta cuatro personas se conectan directo entre sí (una malla). Para salas más grandes, un admin del canal puede hacerlo canal SFU, que pasa por un SFU mediasoup que el admin elige o hostea. El audio y el video nunca pasan por un servidor de Obelisk.
¿Y los zaps Lightning?
Los zaps son NIP-57:
- La app firma un zap request (kind 9734) y lo manda al servidor LNURL del receptor, que responde con una factura Lightning.
- Tu wallet la paga: una wallet del navegador por WebLN, o una wallet que conectás con Nostr Wallet Connect (NIP-47).
- El servidor LNURL del receptor publica el recibo del zap (kind 9735) en los relays que figuran en el pedido, para que todos vean que los sats se movieron.
Ninguna plataforma cobra fee. Tu wallet, la wallet del receptor, sin intermediarios.
Qué no hacemos
- No hosteamos tus mensajes: los guarda el relay de tu servidor.
- No tenemos base de datos de usuarios ni cuentas.
- No emitimos tokens de login ni cookies de sesión. La única cookie recuerda tu idioma.
- Nunca vemos tu clave, así que la app no te puede dejar afuera: tu identidad sirve en cualquier relay que hable NIP-29.