协议与 API 参考
1. JetStream Streams 与 KV Buckets
| 资源 | 类型 | 存储 / 保留策略 | 用途 |
|---|---|---|---|
ROGUE_CHAT | Stream | FileStorage、30d / 100k 条 / 512 MiB | 公开频道 (rogue.chat.*.msg、rogue.chat.*.delete) |
ROGUE_GATED | Stream | FileStorage、30d / 100k 条 / 512 MiB | 受限频道 (rogue.gated.*.msg、rogue.gated.*.delete) |
ROGUE_DM | Stream | FileStorage、30d / 512 MiB | 加密的 E2EE 私信 (rogue.dm.<0x>) |
ROGUE_CHANNELS | KV | FileStorage | 频道元数据 (ChannelMeta JSON) |
ROGUE_PRESENCE | KV | MemoryStorage、30s TTL | 在线用户状态 (active_room、level) |
ROGUE_PROFILES | KV | FileStorage | 压缩 secp256k1 公钥与 miner_level |
ROGUE_BANS | KV | FileStorage | 按小写 0x 记录的永久封禁 |
ROGUE_MUTES | KV | FileStorage、最长 24h TTL | 全局或按房间禁言 |
2. Subject 命名空间
rogue.auth.nonce— 访客 Request/Reply,用于获取一次性60s挑战。rogue.in.<0x>.chat.<room>— 客户端/代理发送房间消息的入口。rogue.in.<0x>.dm.<dest0x>— 客户端/代理发送 E2EE 私信的入口。rogue.in.<0x>.cmd.<action>— 入口 RPC 命令 (rooms、create_room、delete_room、topic、delete_msg、mute、unmute、ban、unban、stats)。rogue.chat.<room>.msg/rogue.gated.<room>.msg— 经过验证的v=1消息信封。rogue.err.<0x>— 结构化的 Gatekeeper 拒绝事件。
3. ECIES 线格式 (DMs)
Go (rogue-nats) 和 Rust (rogue-desktop-client) 均实现完全相同的方案:
- 临时
secp256k1密钥对(ephem_sk, ephem_pk)。 - 原始 ECDH
X坐标 (32字节)。 HKDF-SHA256(salt=nil, ikm=shared_x, info="rogue-dm-ecies-v1")→32字节 AES-256 密钥。- 使用随机
12字节 nonce 进行AES-256-GCM加密。
4. Gatekeeper 错误码
| 错误码 | 含义 |
|---|---|
ERR_BAD_REQUEST | JSON 格式错误、无效 0x 地址或无效房间名称 (^[a-z0-9-]{2,32}$) |
ERR_BANNED | 地址已被永久封禁 |
ERR_MUTED | 地址在全局或目标房间中被临时禁言 |
ERR_RATE_LIMIT | 超出每个地址的消息或房间创建速率限制 |
ERR_ROOM_NOT_FOUND | 目标房间不存在 |
ERR_ROOM_EXISTS | 房间名称已被占用 |
ERR_ROOM_LIMIT | 账户已达到最多 3 个活跃用户自建房间的上限 |
ERR_FORBIDDEN | MinerLevel 不足、非管理员尝试在 #announcements 发言或非房间所有者 |
ERR_INSUFFICIENT_BALANCE | 成熟余额 (latest 与 lookbackBlocks) 低于阈值 |
ERR_LINK_RESTRICTED | 发送链接需要 >= 10 ROGUE 或 MinerLevel >= 1(仅限 https://) |
ERR_INVALID_CONTENT | 文本为空、超过 2000 字符或包含禁止的控制/ANSI 字节 |
ERR_RECIPIENT_PUBKEY_UNKNOWN | 接收方从未连接过服务器,尚未注册其 secp256k1 公钥 |
ERR_RPC_UNAVAILABLE | 配置的 Rogue Signal JSON-RPC 端点调用失败 |