区块链原理 / 系统课时

用见证生成 Groth16 证明

用见证生成 Groth16 证明

完成 Circom 电路编译、见证计算和 Groth16 可信设置后,就可以使用 snarkjs 生成真正的零知识证明。本篇将使用已有见证与最终证明密钥,产出 proof.json 和 public.json,并检查证明文件的内容,理解私有见证为什么不会直接进入证明结果。

学习目标

  • 使用 snarkjs 和 Groth16 证明密钥生成证明文件。
  • 区分见证、证明密钥、证明和公开输入各自的职责。
  • 检查 proof.json 与 public.json,理解私有输入的保护边界。

明确生成证明需要的文件

Groth16 是一种零知识简洁非交互式知识论证方案。证明者需要证明自己知道一组满足电路约束的见证,但不必把私有见证交给验证者。

以一个简单的乘法电路为例:公开输入为 result,私有输入为 a、b,电路要求 a × b = result。证明者知道 a = 3、b = 7,可以向验证者证明公开结果 21 对应着满足约束的秘密输入,而不直接提交 3 和 7。

生成证明需要以下文件:

文件 来源 用途
witness.wtns Circom 见证计算 保存满足电路约束的完整见证
circuit_final.zkey Groth16 可信设置的最终产物 包含该电路对应的证明密钥
proof.json snarkjs 生成 保存 Groth16 证明对象
public.json snarkjs 生成 保存公开信号值

前两个文件是输入,后两个文件是本次要生成的输出。circuit_final.zkey 必须对应生成见证时使用的同一电路及其约束系统,不能混用其他电路的密钥。

证明生成与后续验证的文件关系如下。

Groth16 证明生成与验证的数据流

使用 snarkjs 生成证明

下面以 snarkjs 0.7.x 的命令行接口为准。假设已经安装 Node.js,并通过 npm 安装 snarkjs,且工作目录中已有有效的 witness.wtns 和 circuit_final.zkey。

先确认工具可以运行:

bash
npx snarkjs --version

预期结果:终端显示 snarkjs 的版本或版本相关信息。不同安装版本的输出格式可能不同,确认版本为 0.7.x 即可。

在两个输入文件所在目录执行:

bash
npx snarkjs groth16 prove circuit_final.zkey witness.wtns proof.json public.json

该命令的四个位置参数依次是最终证明密钥、见证文件、证明输出路径、公开信号输出路径。snarkjs 会使用证明密钥和见证计算 Groth16 证明,并将结果写入两个 JSON 文件。

预期结果:命令成功结束,当前目录新增 proof.json 和 public.json。成功执行不代表证明已经经过独立验证,后续还需要使用验证密钥验证。

使用 Node.js 检查输出文件,避免依赖不同操作系统的文本查看工具:

bash
node -e 'const fs = require("node:fs"); for (const name of ["proof.json", "public.json"]) { const value = JSON.parse(fs.readFileSync(name, "utf8")); console.log(name, Array.isArray(value) ? "array" : typeof value); }'

预期输出:

text
proof.json object
public.json array

如果文件不存在,先检查当前工作目录与命令返回的错误信息。如果提示证明密钥或见证不兼容,应重新核对电路版本、编译产物和对应的可信设置结果,而不是直接修改 JSON 文件。

检查 proof.json 与 public.json

proof.json 是 Groth16 证明的序列化结果。在 snarkjs 0.7.x 中,通常包含 pi_a、pi_b、pi_c、protocol 和 curve 等字段。

其中 pi_a、pi_b、pi_c 表示证明使用的椭圆曲线群元素的序列化数据,protocol 标识证明协议,curve 标识对应曲线,例如常用的 bn128。这些字段不是原始输入变量名,也不会直接列出 a = 3、b = 7。

可以运行以下命令,只检查字段和数据结构,不打印完整证明:

bash
node -e 'const p = require("./proof.json"); const s = require("./public.json"); console.log("protocol:", p.protocol); console.log("curve:", p.curve); console.log("proof parts:", ["pi_a", "pi_b", "pi_c"].every(k => Array.isArray(p[k]))); console.log("public signals:", s.length);'

对于使用 bn128 曲线的有效 Groth16 证明,以及仅公开一个输出 result 的示例电路,预期输出为:

text
protocol: groth16
curve: bn128
proof parts: true
public signals: 1

这里的公开信号数量取决于电路定义,不一定都是 1。Circom 电路的主组件可以有多个公开信号,主组件的输出也属于公开信号;具体顺序应以对应电路生成的信号布局为准。

对于前面 result = 21 的示例,如果电路只公开 result,public.json 应为:

json
[
  "21"
]

字段元素通常采用十进制字符串保存,因此这里是字符串 "21",不是 JSON 数字 21。不要擅自转换成 JavaScript Number,较大的有限域元素可能超过其安全整数范围。

为什么证明文件不直接包含私有见证

Groth16 的证明生成算法会使用完整见证,但输出的是由证明算法计算出的少量椭圆曲线群元素,而不是见证变量列表。

在通常的零知识安全假设下,证明能让验证者确信存在满足电路约束的见证,同时不从证明中额外泄露这些见证的私有取值。证明生成还会使用随机性,因此同一有效见证多次生成的证明通常不同。

需要区分三个安全边界:

  1. 文件边界:witness.wtns 包含私有数据,proof.json 不直接保存原始私有输入。
  2. 公开信号边界:public.json 中的内容本来就允许验证者读取,公开输出可能间接暴露私有输入的信息。
  3. 电路约束边界:零知识性质不会自动保证电路表达的业务规则正确,也不会替代必要的范围约束和输入有效性检查。

例如,如果公开 result = 21,且电路只约束 a × b = 21,那么从公开结果就可以推测可能的因子组合。零知识不会隐藏公开结果自身包含的信息。

此外,对于仅有乘法约束的电路,证明表示存在满足乘法关系的见证,并不证明私有变量必然为指定的 3 和 7。如果业务要求限制输入范围、绑定某个承诺或特定身份,必须在电路中增加相应约束。

用验证命令确认文件可用

生成证明后,最直接的验收方式是使用同一可信设置所导出的验证密钥执行 Groth16 验证。

如果当前目录还没有验证密钥,可以从最终 zkey 导出:

bash
npx snarkjs zkey export verificationkey circuit_final.zkey verification_key.json

预期结果:当前目录新增 verification_key.json。它是验证者使用的公开验证密钥,不需要向验证者提供 witness.wtns 或 circuit_final.zkey。

随后执行:

bash
npx snarkjs groth16 verify verification_key.json public.json proof.json

预期输出:对于证明、验证密钥和公开信号相互匹配且证明有效的情况,snarkjs 会显示类似结果:

text
[INFO]  snarkJS: OK!

不同小版本的日志前缀可能略有差异,以验证成功标志 OK! 为准。

如果验证失败,可按以下顺序排查:

  1. 检查 verification_key.json 是否从本次证明使用的 circuit_final.zkey 导出。
  2. 检查 public.json 是否由同一次 groth16 prove 生成,未被手动修改。
  3. 检查 proof.json 是否完整、未损坏,且使用的协议与曲线匹配。
  4. 如果重新编译过电路,应重新生成匹配的见证、证明密钥及证明,不要混用新旧文件。

还可以把 public.json 中的 "21" 改成 "22",保存后重新运行验证命令。对于原本有效的示例证明,预期结果是验证失败,通常显示 Invalid proof,因为公开信号已经不再与生成证明时绑定的值一致。测试完成后应恢复原始文件。

至此,交给验证者的最小材料是 proof.json、public.json 和对应的 verification_key.json。完整见证保留在证明者侧。证明成功生成和证明成功验证是两个不同的检查点,只有验证通过,才能确认这些证明材料满足对应验证密钥下的 Groth16 验证关系。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用见证生成 Groth16 证明

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通