Meshline
简体中文规范下载 Markdown 原文

中文为规范基准;英文为维护译本。

中继 RPC 协议

Meshline Protocol 1.0

libp2p protocol ID:/meshline/relay/1.0.0

本协议定义合格公共中继之间的直接账户查询和跨中继消息投递。消息不沿 DHT 查询路径逐跳转发;源中继解析当前账户路由后,直接连接目标归属中继。源中继和目标中继的含义遵循客户端—中继协议的角色定义。

连接、远端响应、缓存和传输网络都不属于用户信任根;无法通过签名、路由和对象验证的响应不得转交客户端。

协议内容

部分 内容
方法公共约定 流内消息分帧、JSON-RPC 请求与响应、目标路由、错误和资源控制
账户查询方法 设备授权状态、完整设备状态和账户资料查询
消息投递方法 跨中继消息投递的授权、验证、时间线写入与幂等结果
中继 RPC 通知 设备证书状态缓存失效提示

方法索引

通知索引

一致性要求

兼容实现须遵循一致性测试边界,并覆盖:

  • 连接与传输:按方法公共约定验证 Peer 身份、长度前缀及接收上限、JSON-RPC 封装、目标选择、路由刷新和错误恢复;消息分帧失败关闭或 reset stream,不构造应用层响应。
  • 查询与通知:按账户查询方法及中继 RPC 通知验证设备状态与失效提示、跨中继响应的账户和签名绑定,以及公开资料与受限设备查询的权限区别;未经验证的远端响应不得作为成功结果转交客户端。
  • 可靠投递:按 message.deliver 验证收件授权、完整参数幂等、结果保留、响应丢失、路由迁移及重启后的投递与结果确认。