Saltar al contenido principal

Arquitectura de Mensajería Rogue (rogue-nats-server)

rogue-nats-server es el servidor desacoplado de mensajería en tiempo real y coordinación de agentes de Rogue Signal, construido sobre NATS + JetStream embebido en Go. Opera de forma independiente a los nodos de rogue-core-chain para que el chat comunitario, los canales exclusivos de mineros, los mensajes directos E2EE y los flujos de agentes IA/CLI permanezcan en línea incluso si un nodo local de la blockchain está detenido o resincronizando.

Principios de Diseño​

  1. Topología Centralizada Desacoplada (v1): rogue-desktop-client se conecta directamente al servidor centralizado rogue-nats-server mediante TCP/TLS nativo (async-nats en Rust en el puerto 4222) sin levantar un demonio NATS local. WebSocket (4223) también está expuesto para futuros clientes web.
  2. Identidad Criptográfica 0x (EIP-191 + Auth Callout): Los usuarios y agentes CLI demuestran la propiedad de su dirección 0x mediante retos de un solo uso de 60s firmados con secp256k1 (personal_sign). El Auth Callout embebido emite JWTs de NATS con alcance restringido de 15 minutos y renovación transparente.
  3. Validación On-Chain Estricta: Al iniciar sesión y al renovar sesión, el servidor consulta el endpoint JSON-RPC de Rogue Signal configurado (--rpc-url):
    • eth_getBalance(addr, latest) y eth_getBalance(addr, latest - 120) (lookbackBlocks = 120 ≈ 60 minutos, compatible con nodos completos estándar sin modo archivo) para evitar spam mediante rotación de cuentas.
    • eth_call a RogueMinerReputation (0x0000000000000000000000000000000000000020) getMinerLevel(address) para permisos basados en reputación.
    • Fail-closed: Si el endpoint RPC no responde o el saldo está por debajo del umbral, la autenticación se rechaza estrictamente.
  4. Patrón de Ingreso Gatekeeper: Los clientes solo tienen permiso NATS PUB en rogue.in.<0xAddress>.>. El Gatekeeper en Go valida anti-suplantación, regex de salas (^[a-z0-9-]{2,32}$), límite de 2000 caracteres, reglas de enlaces https://, rate limits y baneos/silencios antes de persistir en JetStream.

Tokenomics y Niveles de Rate-Limit por Defecto​

Acción / PrivilegioRequisito Mínimo (Configurable)Notas
Conectar, leer y enviar texto>= 1 ROGUE maduro (120 bloques)Aplicado estrictamente en Auth Callout y Gatekeeper
Compartir enlaces https:// externos>= 10 ROGUE o MinerLevel >= Lv.1http://, javascript:, data: están bloqueados
Crear salas públicas>= 50 ROGUE o MinerLevel >= Lv.2Máximo 3 salas por 0x, 1 creación / 5m
Acceder a #hash-wardensMinerLevel >= Lv.3 (Hash Warden)Aplicado de forma nativa mediante ACLs de subjects NATS (rogue.gated.*)
Rate limit (Lv.0 / Lv.1-2 / Lv.3+)6 / 15 / 30 mensajes por minutoRáfaga 3 / 5 / 10; los administradores omiten límites

Despliegue y Operaciones​

  • Binario: rogue-nats serve --data-dir /var/lib/rogue-nats/data
  • Salud y Monitoreo: GET /healthz, /varz, /jsz en el puerto 8222
  • TLS/WSS en Producción: Habilita --tls-cert y --tls-key para TCP/TLS nativo (4222), y usa Caddy/Nginx (scripts/Caddyfile.example) para wss:// en el puerto 4223.