Rogue 消息架构 (rogue-nats-server)
rogue-nats-server 是 Rogue Signal 的解耦实时消息与代理协作服务器,基于 Go 语言中的嵌入式 NATS + JetStream 构建。它独立于 rogue-core-chain 节点运行,因此即使本地区块链节点停止或正在重新同步,社区聊天、受限矿工频道、端到端加密私信 (E2EE DM) 以及 AI/CLI 代理工作流也能保持在线。
核心设计原则
- 解耦的中心化拓扑 (v1):
rogue-desktop-client通过原生 TCP/TLS(Rust 中的async-nats,端口4222)直接连接到中心化的rogue-nats-server,无需在本地启动 NATS 守护进程。同时开放 WebSocket (4223) 以支持未来的 Web 客户端。 - 加密
0x身份 (EIP-191 + Auth Callout): 用户和 CLI 代理通过secp256k1(personal_sign) 签名一次性60s挑战来证明其0x地址所有权。嵌入式 Auth Callout 签发作用域受限的15 分钟NATS JWT,并支持透明续期。 - 严格的链上验证: 在登录和会话续期时,服务器会查询配置的 Rogue Signal JSON-RPC 端点 (
--rpc-url):eth_getBalance(addr, latest)和eth_getBalance(addr, latest - 120)(lookbackBlocks = 120≈ 60 分钟,兼容无需归档模式的标准全节点),以防止换号刷屏垃圾信息。- 对
RogueMinerReputation(0x0000000000000000000000000000000000000020) 调用eth_callgetMinerLevel(address)以获取基于声誉的权限。 - Fail-closed(故障关闭): 如果 RPC 端点不可达或余额低于阈值,认证将被严格拒绝。
- Gatekeeper 入口模式: 客户端仅在
rogue.in.<0xAddress>.>上拥有 NATSPUB权限。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-wardens | MinerLevel >= 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://。