Saltar al contenido principal

Referencia de Protocolo y API

1. Streams de JetStream y Buckets KV​

RecursoTipoAlmacenamiento / RetenciónPropósito
ROGUE_CHATStreamFileStorage, 30d / 100k msgs / 512 MiBCanales públicos (rogue.chat.*.msg, rogue.chat.*.delete)
ROGUE_GATEDStreamFileStorage, 30d / 100k msgs / 512 MiBCanales restringidos (rogue.gated.*.msg, rogue.gated.*.delete)
ROGUE_DMStreamFileStorage, 30d / 512 MiBDMs cifrados E2EE (rogue.dm.<0x>)
ROGUE_CHANNELSKVFileStorageMetadatos de canales (ChannelMeta JSON)
ROGUE_PRESENCEKVMemoryStorage, TTL 30sPresencia activa de usuarios (active_room, level)
ROGUE_PROFILESKVFileStorageClaves públicas secp256k1 comprimidas y miner_level
ROGUE_BANSKVFileStorageBaneos permanentes por 0x en minúsculas
ROGUE_MUTESKVFileStorage, TTL hasta 24hSilencios globales o por sala

2. Espacio de Nombres de Subjects​

  • rogue.auth.nonce — Request/Reply de invitado para obtener un reto de un solo uso de 60s.
  • rogue.in.<0x>.chat.<room> — Ingreso de clientes/agentes para mensajes en salas.
  • rogue.in.<0x>.dm.<dest0x> — Ingreso de clientes/agentes para DMs E2EE.
  • rogue.in.<0x>.cmd.<action> — Comandos RPC de ingreso (rooms, create_room, delete_room, topic, delete_msg, mute, unmute, ban, unban, stats).
  • rogue.chat.<room>.msg / rogue.gated.<room>.msg — Sobres de mensaje validados v=1.
  • rogue.err.<0x> — Eventos estructurados de rechazo del Gatekeeper.

3. Formato Wire ECIES (DMs)​

Tanto Go (rogue-nats) como Rust (rogue-desktop-client) implementan exactamente el mismo esquema:

  1. Par de claves efímero secp256k1 (ephem_sk, ephem_pk).
  2. Coordenada X cruda de ECDH (32 bytes).
  3. HKDF-SHA256(salt=nil, ikm=shared_x, info="rogue-dm-ecies-v1") → clave AES-256 de 32 bytes.
  4. Cifrado AES-256-GCM con un nonce aleatorio de 12 bytes.

4. Códigos de Error del Gatekeeper​

CódigoSignificado
ERR_BAD_REQUESTJSON malformado, dirección 0x inválida o nombre de sala inválido (^[a-z0-9-]{2,32}$)
ERR_BANNEDLa dirección está baneada permanentemente
ERR_MUTEDLa dirección está silenciada temporalmente de forma global o en la sala destino
ERR_RATE_LIMITSe excedió el límite de mensajes o creación de salas por dirección
ERR_ROOM_NOT_FOUNDLa sala destino no existe
ERR_ROOM_EXISTSEl nombre de la sala ya está en uso
ERR_ROOM_LIMITLa cuenta alcanzó el máximo de 3 salas activas creadas por usuario
ERR_FORBIDDENMinerLevel insuficiente, usuario no administrador en #announcements o no es propietario de la sala
ERR_INSUFFICIENT_BALANCEEl saldo maduro (latest y lookbackBlocks) está por debajo del umbral
ERR_LINK_RESTRICTEDLos enlaces requieren >= 10 ROGUE o MinerLevel >= 1 (solo https://)
ERR_INVALID_CONTENTTexto vacío, > 2000 caracteres o bytes de control/ANSI prohibidos
ERR_RECIPIENT_PUBKEY_UNKNOWNEl destinatario nunca se ha conectado para registrar su clave pública secp256k1
ERR_RPC_UNAVAILABLEFalló el endpoint JSON-RPC de Rogue Signal configurado