DHT 测试向量执行说明

规范测试向量 · 通用执行规则

覆盖范围

文件：dht-keyspace-v1.json。章节为 resource_key 和 keyspace。

固定输入与引用

keyspace.peers 提供 libp2p 官方示例 Peer ID 的 base58btc 文本、原始 multihash bytes 和预期 keyspace 位置。

keyspace.cases 的 key_hex 是线上 Message.key，key_source.peer 指明 keyspace.peers 中的 Peer ID；资源 key 项的 key_source.value_ref 指向同文件 /resource_key/expected/expected_key_hex，展开后为该项 key_source.value。

执行步骤与断言

资源 key 派生

resource_key 提供账户路由资源标识的网络绑定派生输入和预期值；先独立比对其 Canonical JSON、UTF-8、SHA-256 和原始 key。

DHT key 的协议值是 expected_key_hex 解码后的原始 32 bytes；expected_key_base64url 只用于便于日志和测试框架比较。

Keyspace 与 FIND_NODE

逐 byte 核对 key 长度、SHA-256 位置和各候选的 XOR 距离。find_node_request_hex 是只含 type = FIND_NODE 和原始 key 的 protobuf 请求，framed_request_hex 另包含 unsigned-varint 长度前缀；响应必须回显同一原始 key。

自身 Peer 的距离必须为零。资源 key 已经过资源标识派生，计算距离时仍须执行一次 keyspace 映射；不得跳过该映射，也不得把映射后的结果代替线上 key。

这些向量不包含连接认证、路由表或实际网络查询。