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

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

账户路由发布与解析

中继 DHT 协议 · AccountRoute · DHT 操作 · 归属中继变更

发布与复制

账户路由文档所指定的当前归属中继负责完成新路由的共同签署和发布;其他合格存储方可以按重新发布与持久化规则复制已经生成的最终共同签名文档。新路由的完整发布流程为:

  1. 客户端先确认指定中继保存着该账户的有效权威 AccountDeviceState,或者向它预存完整设备状态,并确认返回 staged 及有效的 staged_until;
  2. 客户端构造 revision 高于已知版本、指定该中继且省略 relay_signature 的账户签名文档,再通过 account.route.publish 提交;
  3. 中继确认自身身份、Registry 状态和 RelayDescriptor,按照 AccountRoute 验证规则验证除尚未生成的 relay_signature 外的全部约束,并确认本地仍保存该账户的有效权威状态或尚未到期的当前预存设备状态;
  4. 验证通过后,中继只追加 relay_signature,形成最终共同签名文档;确认最终文档满足对象验证规则中的大小限制后,按 account.route.publish 的规则,将当前路由、相应的路由版本信息及本次使用的设备状态在同一次本地原子提交中持久化并启用;
  5. 中继按 Kademlia 查询规则查找接近资源 key 的合格 Peer,并向这些 Peer 执行 PUT_VALUE;
  6. 存储方按 PUT_VALUE 规则处理记录并返回结果。

归属中继必须先完成路由与设备状态的本地原子提交,再向 DHT 复制记录。在达到中继自身的副本确认策略前,account.route.publish 不得返回成功。

重新发布与持久化

当前归属中继必须持久化自身负责重新发布的最终 AccountRoute,并在记录有效期间重新发布,使 DHT 中仍有可查询副本。节点重启后,必须继续重新发布仍有效且仍由自身负责的路由。

其他合格存储方可以通过 PUT_VALUE 重新发布本地保存的最终共同签名文档。重新发布前,必须按 AccountRoute 验证规则重新确认记录有效,且该记录是本地已知最高 revision 的无冲突路由,本地 DHT value 也尚未失效。复制时必须原样保留完整文档,包括双方签名和全部未知属性。其他节点的复制不免除归属中继的持续维护义务。

过期记录不得作为查询结果返回,也不得用于路由或重新发布;相应的路由版本信息继续独立保留。重新发布同样遵循版本下界,不能恢复发布已经被更高版本替换的旧路由。

解析与候选选择

查询方按 Kademlia 查询规则从合格 Peer 解析目标 key,执行 GET_VALUE,验证查询过程中取得的候选 Peer,并收集能够按账户路由资源规则完整验证的记录。

查询完成后,查询方按路由版本与冲突解决结合本地持久化的最高版本确定结果。客户端接口的响应及错误码见 account.route.resolve 方法定义。

解析结果可以缓存,但不得在 AccountRoute 到期或本地 DHT value 失效后继续使用。缓存不得绕过已经保存的最高版本或同版本冲突信息;缓存失效不清除这些信息。

解析后的目标中继选择、路由错误和重新解析遵循中继 RPC 方法公共约定。