跳到正文
Genupixel English

验证是怎么做的

通过 honest-router 的每次成功并计费的调用,都会返回一张回执。本页说明回执里有什么、验证程序检查什么,以及检查到哪里为止。

回执里有什么

回执的主要字段
字段含义
trace_id本次调用的标识,以 t_ 开头。
requested_model你发送的模型标识。
resolved_provider实际应答的服务商。
upstream_model网关发给该服务商的模型名。
request_commit_hash对请求字节的承诺哈希。
response_metadata_hash响应元数据的哈希。
signing_key_id签署这张回执的网关密钥。
trace_signatureEd25519 签名。
prev_trace_hash同一账户上一张回执的哈希。同一账户的回执由此连成一条链。

回执在响应体的 _a2auth.receipt 字段和 X-A2Auth-Receipt 响应头里;流式响应的回执在最后一个 SSE 事件里。任何人都可以用 GET /v1/receipts/<trace_id> 再次取回,不需要密钥。

验证程序检查什么

  1. 签名

    回执用 Ed25519 签名。对应的公钥公布在 /.well-known/honest-router-pubkey。

  2. 字节一致性承诺

    回执通过 request_commit_hash 对请求的原始字节作出承诺。

  3. Merkle 包含证明

    网关把最多 1,024 张回执归为一个批次,为这个批次计算一个根哈希并对它签名。验证程序检查你的回执在这个批次里。批次关闭后才有证明,最长需要 5 分钟。

  4. 透明锚定

    每个批次的根哈希发布到两个相互独立的地方:一个 GitHub 仓库和 Software Heritage 存档。验证程序拿根哈希与两处对照。

锚定检查有局限。它不能说明该提交今天仍在分支上;而且这个 GitHub 仓库属于网关的运营方,也就是我们自己。

两种验证方式

在浏览器里验证

验证页面接受回执文件、粘贴的 JSON,或者一个 trace_id。回执不会被上传到任何地方去检查。页面从网关取公钥和证明,从 GitHub 取锚定记录。

在命令行里验证

honest-verify 在终端里检查一张回执。加上 --pubkey-hex 和 --no-external,它不会访问 GitHub 和 Software Heritage。

两种工具都随早期访问提供。

回执不能证明什么

网关保存什么

网关保存请求和响应的哈希,不保存内容。一个例外:部分带 Idempotency-Key 的请求,网关会保留第一次的响应,默认 14 天。你调用的服务商会收到请求内容,它如何处理由该服务商的条款决定。