Admins, miembros y moderación NIP-29
Cómo administran hoy una comunidad de relay en Obelisk. Los admins de un canal editan el canal y sus miembros desde los ajustes del canal; el operador del relay maneja roles, miembros, emojis y el orden de los canales desde los ajustes del servidor. Cada acción es un evento NIP-29 estándar que cualquier cliente Nostr puede leer.
Dónde vive la moderación
En el viejo Obelisk híbrido, los admins vivían en una tabla de Postgres y un panel web de admin llamaba a una API HTTP para sacar gente. En el nuevo Obelisk, los permisos viven en el relay. Las herramientas de admin están en la app, pero cada click publica un evento NIP-29 firmado, y el que lo hace cumplir es el relay.
Eso significa que:
- Cualquier cliente NIP-29 puede mostrar la misma lista de admins y de miembros.
- Cambiar de cliente no cambia los permisos.
- Cambiar de relay sí: la moderación es por relay y por grupo, porque el relay es quien la aplica.
Dos tipos de admin
Obelisk tiene dos niveles de autoridad, y nunca se mezclan:
- Admins de canal. Un canal es un grupo NIP-29. Sus admins son las personas que figuran en el último evento
39001del relay para ese grupo. Manejan ese canal y nada más. - El operador del relay. La clave que el relay declara como su operador (el npub de
contacten su documento NIP-11, o si no supubkey). Solo el operador ve los ajustes del servidor, y solo sus eventos cambian cosas de todo el relay, como los roles, las categorías y la imagen del servidor.
Ajustes del canal (admins de canal)
Abrí un canal y entrá a sus ajustes desde el encabezado del canal (en el celular, desde la hoja de ajustes del canal). Desde ahí un admin puede:
- Editar el canal: nombre, descripción, ícono y banner.
- Definir quién entra: público (todos leen y escriben), solo lectura (todos leen, los miembros escriben) o privado (oculto, solo miembros).
- Elegir el tipo de canal: texto, voz y video (una malla entre participantes para salas chicas), voz para salas grandes (por un SFU que elegís y verificás) o publicaciones (un feed de posts, cada uno con su propio chat, con etiquetas curadas).
- Manejar los miembros: agregar a alguien por npub o clave hex (si querés, como admin), bajar a un admin a miembro, o sacar a alguien del canal.
En el chat mismo, un admin puede borrar cualquier mensaje del canal ("Eliminar para todos") y quitar sus reacciones.
Ajustes del servidor (operador del relay)
El operador del relay tiene un botón de ajustes del servidor arriba de la lista de canales. Abre cinco herramientas:
- Perfil y banner del servidor: el nombre, ícono, banner y descripción que todos ven para el relay.
- Emojis, GIFs y stickers: los favoritos y packs propios del servidor, que ven todos los miembros.
- Canales y categorías: los nombres de las categorías y el orden de los canales dentro de ellas.
- Roles y rangos: insignias por niveles (nombre, color, emoji) que aparecen al lado del nombre de cada miembro. Un miembro puede tener varias; la de más rango es la que se muestra. Los roles son etiquetas, no permisos: el relay sigue conociendo solo admins y miembros.
- Miembros y moderación: una tabla con todos los admins y miembros de todos los canales del relay, filtrable por nombre, rol y canal, para bajar de rango o sacar gente en bloque.
Los eventos detrás de los botones
Cada acción de arriba es uno de estos eventos, firmado por el admin y con la hora del relay. No hay un log de moderación escondido: los eventos son el log.
| Kind | Qué es |
|---|---|
9007 | Crear grupo: un canal nuevo |
9002 | Editar metadata: nombre, imágenes, acceso, tipo de canal |
9000 | Agregar usuario: sumar un miembro, o hacerlo admin |
9001 | Sacar usuario: sacar a alguien del canal |
9003 | Quitar permiso: bajar a un admin a miembro |
9005 | Borrar evento: quitar un mensaje o una reacción |
39000 | Metadata del grupo, publicada por el relay |
39001 | Lista de admins, publicada por el relay |
39002 | Lista de miembros, publicada por el relay |
El relay revisa cada pedido contra su propia lista de admins antes de aceptarlo, y después publica el estado actualizado en 39000/39001/39002. Los roles, las categorías y la imagen del servidor son eventos reemplazables del propio operador (NIP-78, kind 30078), y Obelisk solo los lee de la clave del operador.
¿Y las expulsiones entre relays?
Las expulsiones NIP-29 son por relay. Si a alguien lo sacan de tu grupo en el relay A, nada le impide crear un grupo con el mismo ID en el relay B y postear ahí. Es a propósito: los relays son soberanos. Si te importa que la moderación sea portable, corré tu propio relay (o un conjunto de relays que controles) y replicá el estado de los grupos entre ellos.
Qué pasó con el CLI de admin
Versiones anteriores de Obelisk traían un CLI de Node (scripts/admin-cli) que manejaba una API HTTP de admin con un nsec. La API ya no existe, así que el CLI tampoco, y todo lo que hacía ahora está en los ajustes del canal y del servidor dentro de la app. Un script igual puede hacer el mismo trabajo sin Obelisk: cargá una clave con nostr-tools o cualquier SDK Nostr, armá los eventos NIP-29 de arriba y publicalos en el relay. El relay los juzga igual que a un click en la app.