核心用法
GRASS（Game Real-time Application Streaming Service）是Structs游戏的实时事件推送系统，基于NATS WebSocket协议。与轮询查询不同，GRASS采用发布-订阅模式，在事件发生时即时推送至客户端。核心工作流程包括：1）从公会配置获取WebSocket端点（如ws://crew.oh.energy:1443）；2）使用>通配符订阅发现实际事件主题；3）按实体类型订阅特定主题（structs.planet.*、structs.player.*等）；4）解析JSON事件负载并触发响应逻辑。
关键发现：Struct事件常出现在planet主题而非struct主题上，订阅时需注意此特性。
显著优点
- 实时性：毫秒级事件送达，远优于轮询的秒级延迟，对 raid 检测、舰队拦截等时效敏感场景至关重要
- 事件丰富：覆盖战斗（
struct_attack含逐发弹药详情）、经济（库存变动、挖矿完成）、社交（公会成员变动）等全游戏维度 - 自动化友好：天然支持"Defence Contractor"模式——AI代理监听事件并自动执行响应交易（如挖矿完成后立即精炼）
- 多实体监控：单连接可同时订阅多个星球、舰队、玩家，适合多账号管理
- 与链事件分离：GRASS处理游戏层事件，Tendermint WebSocket处理链层事件，架构清晰
潜在缺点与局限性
- 端点动态性：GRASS由各公会独立托管，URL非硬编码，需先查询公会配置获取，且并非所有公会都提供此服务
- 仅HTTP无SSL：当前GRASS端点为纯WebSocket（
ws://），非加密连接，存在中间人窃听风险 - 无官方SDK：需自行集成NATS客户端（
nats.ws或nats-py），处理重连、解析容错等底层逻辑 - 主题发现必需：实际主题模式可能与文档不符，必须先用
>通配符观察才能确定有效订阅 - 速率限制暗示：文档提及每密钥约6秒一笔交易的序列号约束，高频自动化需自行限流
- UGC审核事件不完整：
ugc_moderated等链事件需通过Tendermint另购订阅，GRASS不覆盖
适合人群
- 实时竞技玩家：需要即时响应raid、舰队抵达等威胁的PVP参与者
- 自动化开发者：构建挂机挖矿-精炼循环、自动防御部署等无人值守工具的开发者
- 多账号管理者：同时监控多个玩家、舰队、星球状态的公会管理员
- 数据分析师：需要完整事件流进行游戏经济、战斗模式分析的第三方研究者
- AI代理构建者：实现"Defence Contractor"模式的自治游戏代理
常规风险
| 风险类别 | 描述 | 缓解建议 |
|---------|------|---------|
| 连接安全 | `ws://`明文传输，事件内容可被窃听 | 避免在公共网络使用；敏感操作二次确认 |
| 端点可用性 | 公会级服务，可能离线或变更 | 实现指数退避重连；维护备用端点列表 |
| 自动化误操作 | 事件触发链式交易可能造成意外损失 | 设置Alpha支出上限；关键操作人工确认 |
| 权限过度授权 | 自动化代理密钥权限过大 | 使用`permission-grant-on-object`最小权限原则；分离签名密钥 |
| 事件解析失败 | 非结构化消息或 schema 变更 | 防御性JSON解析；记录原始消息用于调试 |
| 资源耗尽 | 过量订阅或忘记关闭连接 | 限制单连接订阅数（建议10-20）；明确关闭空闲连接 |