跳到主要内容

Rogue 消息架构 (rogue-nats-server)

rogue-nats-server 是 Rogue Signal 的解耦实时消息与代理协作服务器,基于 Go 语言中的嵌入式 NATS + JetStream 构建。它独立于 rogue-core-chain 节点运行,因此即使本地区块链节点停止或正在重新同步,社区聊天、受限矿工频道、端到端加密私信 (E2EE DM) 以及 AI/CLI 代理工作流也能保持在线。

核心设计原则​

  1. 解耦的中心化拓扑 (v1): rogue-desktop-client 通过原生 TCP/TLS(Rust 中的 async-nats,端口 4222)直接连接到中心化的 rogue-nats-server,无需在本地启动 NATS 守护进程。同时开放 WebSocket (4223) 以支持未来的 Web 客户端。
  2. 加密 0x 身份 (EIP-191 + Auth Callout): 用户和 CLI 代理通过 secp256k1 (personal_sign) 签名一次性 60s 挑战来证明其 0x 地址所有权。嵌入式 Auth Callout 签发作用域受限的 15 分钟 NATS JWT,并支持透明续期。
  3. 严格的链上验证: 在登录和会话续期时,服务器会查询配置的 Rogue Signal JSON-RPC 端点 (--rpc-url):
    • eth_getBalance(addr, latest) 和 eth_getBalance(addr, latest - 120)(lookbackBlocks = 120 ≈ 60 分钟,兼容无需归档模式的标准全节点),以防止换号刷屏垃圾信息。
    • 对 RogueMinerReputation (0x0000000000000000000000000000000000000020) 调用 eth_call getMinerLevel(address) 以获取基于声誉的权限。
    • Fail-closed(故障关闭): 如果 RPC 端点不可达或余额低于阈值,认证将被严格拒绝。
  4. Gatekeeper 入口模式: 客户端仅在 rogue.in.<0xAddress>.> 上拥有 NATS PUB 权限。Go Gatekeeper 会在持久化到 JetStream 之前验证防伪造、房间名称正则 (^[a-z0-9-]{2,32}$)、2000 字符限制、https:// 链接规则、速率限制以及封禁/禁言状态。

默认代币经济与速率限制层级​

操作 / 权限最低要求(可配置)说明
连接、阅读与发送文本>= 1 ROGUE 成熟余额 (120 区块)在 Auth Callout 和 Gatekeeper 中严格执行
分享外部 https:// 链接>= 10 ROGUE 或 MinerLevel >= Lv.1拦截 http://、javascript:、data:
创建公开房间>= 50 ROGUE 或 MinerLevel >= Lv.2每个 0x 最多 3 个房间,每 5m 限建 1 个
访问 #hash-wardensMinerLevel >= Lv.3 (Hash Warden)通过 NATS 主题 ACL (rogue.gated.*) 原生强制执行
速率限制 (Lv.0 / Lv.1-2 / Lv.3+)每分钟 6 / 15 / 30 条消息突发 3 / 5 / 10;管理员不受限制

部署与运维​

  • 二进制文件: rogue-nats serve --data-dir /var/lib/rogue-nats/data
  • 健康检查与监控: 端口 8222 上的 GET /healthz、/varz、/jsz
  • 生产环境 TLS/WSS: 启用 --tls-cert 和 --tls-key 以支持原生 TCP/TLS (4222),并使用 Caddy/Nginx (scripts/Caddyfile.example) 在端口 4223 上提供 wss://。