中继 DHT 协议

libp2p protocol ID：/meshline/kad/1.0.0

本协议定义公共中继覆盖网络的连接、身份认证和资源操作，供合格公共中继发布、复制和查询可完整验证的 DHT 资源。客户端不作为 DHT 节点。Protocol 1.0 注册的资源类型只有账户路由；消息、联系人、资料、聊天历史和私钥不得作为该资源写入 DHT。

DHT Peer 对应的公共中继必须具有 status 为 active 的 Registry 记录，并通过当前 RelayDescriptor 绑定 relay_id、Peer ID 和可拨号地址。远端 Peer、路由表、缓存和查询路径都不属于用户信任根；每个存储方和查询方必须独立验证 key、资源类型、签名、有效期和候选记录顺序。

协议内容

部分	内容
连接与身份认证	覆盖网络的候选发现、Noise 扩展和中继资格验证
覆盖网络与节点维护	Peer 资格、入网与路由表维护、安全和节点状态持久化
账户路由发布与解析	共同签署、DHT 复制、迭代解析、缓存和重新发布
核心对象	资源 key 派生、`AccountRoute` 的结构、签名、revision 与候选选择
消息格式	protocol ID、消息分帧、protobuf 子集、公共字段和拒绝行为
DHT 操作	节点查找、资源查询与写入的消息及处理规则

操作索引

FIND_NODE：查询更接近目标 key 的合格 Peer；
GET_VALUE：查询并验证资源记录；
PUT_VALUE：验证并持久化资源记录。

一致性要求

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

连接与身份：按连接认证验证已知中继出站、仅有 Peer ID 与地址的候选连接及陌生中继入站；后两者须仅凭握手描述符和 Registry 完成认证。按覆盖网络维护规则验证资格失效、Peer ID 换绑与旧项移除。
消息与操作：按消息格式和DHT 操作验证长度前缀、payload 上限、非法消息拒绝、多节点 PUT/GET 及 FIND_NODE 候选验证。
路由验证：按核心对象验证网络与账户绑定、双方签名、资源 key、完整对象大小、时间边界、版本防回退及同版本冲突；无效高版本不得推进已知版本。
存储与恢复：按路由生命周期和版本与冲突规则验证重新发布、缓存、到期、清理、迁移、节点重启及网络分区恢复；版本下界和未解决冲突必须持续保留，最高版本路由到期或发生冲突后，须取得更高且无冲突的有效路由才能恢复解析。