RPC 与 WebSocket 节点接入
职责
节点模块负责连接、请求超时、订阅生命周期、节点切换和错误分类。业务模块通过 Adapter 获取结果,避免直接绑定某一家 RPC 服务。
建议调用上下文
请求携带链标识、节点逻辑名称、方法、超时预算和 trace ID。日志不记录包含凭证的完整节点 URL。查询结果尽可能带区块高度或观测位置,以便判断数据新鲜度。
连接与切换
WebSocket 断开后重新建立连接、重新订阅并记录可能缺失的范围。切换节点时确认目标链一致,并检查数据滞后;链上查询返回的旧值不应被当作最新状态覆盖。
错误分类
超时、限流、连接错误、协议错误、业务拒绝和查询不到分别处理。只读查询可以按预算退避重试;提交交易的超时需要转入结果追踪,不能沿用相同的通用重试逻辑。
验证场景
节点断流、限流、响应变慢、落后节点及重连重复事件。待确认信号属于有覆盖边界的观测,不应把未观测到解读为没有发生。