Referencia de Protocolo y API
1. Streams de JetStream y Buckets KV
| Recurso | Tipo | Almacenamiento / Retención | Propósito |
|---|---|---|---|
ROGUE_CHAT | Stream | FileStorage, 30d / 100k msgs / 512 MiB | Canales públicos (rogue.chat.*.msg, rogue.chat.*.delete) |
ROGUE_GATED | Stream | FileStorage, 30d / 100k msgs / 512 MiB | Canales restringidos (rogue.gated.*.msg, rogue.gated.*.delete) |
ROGUE_DM | Stream | FileStorage, 30d / 512 MiB | DMs cifrados E2EE (rogue.dm.<0x>) |
ROGUE_CHANNELS | KV | FileStorage | Metadatos de canales (ChannelMeta JSON) |
ROGUE_PRESENCE | KV | MemoryStorage, TTL 30s | Presencia activa de usuarios (active_room, level) |
ROGUE_PROFILES | KV | FileStorage | Claves públicas secp256k1 comprimidas y miner_level |
ROGUE_BANS | KV | FileStorage | Baneos permanentes por 0x en minúsculas |
ROGUE_MUTES | KV | FileStorage, TTL hasta 24h | Silencios 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 de60s.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 validadosv=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:
- Par de claves efímero
secp256k1(ephem_sk, ephem_pk). - Coordenada
Xcruda de ECDH (32bytes). HKDF-SHA256(salt=nil, ikm=shared_x, info="rogue-dm-ecies-v1")→ clave AES-256 de32bytes.- Cifrado
AES-256-GCMcon un nonce aleatorio de12bytes.
4. Códigos de Error del Gatekeeper
| Código | Significado |
|---|---|
ERR_BAD_REQUEST | JSON malformado, dirección 0x inválida o nombre de sala inválido (^[a-z0-9-]{2,32}$) |
ERR_BANNED | La dirección está baneada permanentemente |
ERR_MUTED | La dirección está silenciada temporalmente de forma global o en la sala destino |
ERR_RATE_LIMIT | Se excedió el límite de mensajes o creación de salas por dirección |
ERR_ROOM_NOT_FOUND | La sala destino no existe |
ERR_ROOM_EXISTS | El nombre de la sala ya está en uso |
ERR_ROOM_LIMIT | La cuenta alcanzó el máximo de 3 salas activas creadas por usuario |
ERR_FORBIDDEN | MinerLevel insuficiente, usuario no administrador en #announcements o no es propietario de la sala |
ERR_INSUFFICIENT_BALANCE | El saldo maduro (latest y lookbackBlocks) está por debajo del umbral |
ERR_LINK_RESTRICTED | Los enlaces requieren >= 10 ROGUE o MinerLevel >= 1 (solo https://) |
ERR_INVALID_CONTENT | Texto vacío, > 2000 caracteres o bytes de control/ANSI prohibidos |
ERR_RECIPIENT_PUBKEY_UNKNOWN | El destinatario nunca se ha conectado para registrar su clave pública secp256k1 |
ERR_RPC_UNAVAILABLE | Falló el endpoint JSON-RPC de Rogue Signal configurado |