区块链原理 / 系统课时

划分 public 输入与私有见证

划分 public 输入与私有见证

编写零知识证明电路时,必须先确定哪些数据允许验证者看到,哪些数据只能由证明者持有。本篇通过一个 Circom 乘法电路,演示如何声明 public 输入、保留私有见证,并检查主组件的公开输出,避免因信号分类错误泄露业务数据。

学习目标

  • 掌握 Circom 主组件公开输入的声明语法与默认可见性规则。
  • 能编写包含公开输入、私有输入和公开输出的完整电路。
  • 能检查公开信号清单,识别输出与业务逻辑造成的隐私泄露。

Circom 中哪些信号会公开

Circom 2 使用 signal input 和 signal output 定义组件接口,但输入与输出的公开规则并不对称。

对于最外层 main 组件:

  • 公开输入:在 component main {public [...]} 中列出的输入信号。
  • 私有输入:没有列入 public 清单的主组件输入信号,默认作为私有见证。
  • 公开输出:主组件所有 signal output,自动成为公开信号,不需要也不能通过省略 public 将其隐藏。
  • 内部信号:组件内部的中间信号不直接成为验证者的公开输入。

例如,一个电路有 price、quantity 和 total 三个信号。如果 price 是公开单价,quantity 是秘密购买数量,total 是公开金额,那么验证者能够看到 price 和 total,但不应直接获得 quantity。

Circom 主组件公开信号与私有见证的边界示意

编写公开输入与私有输入电路

下面使用适用于 Circom 2 的完整代码。创建文件 purchase.circom:

circom
pragma circom 2.0.0;

template Purchase() {
    signal input price;
    signal input quantity;
    signal output total;

    // 约束公开金额必须等于单价和私有数量的乘积
    total <== price * quantity;
}

// price 公开;未列出的 quantity 默认保持私有
component main {public [price]} = Purchase();

public 修饰的是 main 的输入声明,不是模板中的 signal input 语句。这里不能写成 signal public input price;,也不能把 total 放进 public 清单,因为它已经是自动公开的输出。

假设输入文件 input.json 为:

json
{
  "price": 20,
  "quantity": 3
}

该 JSON 是证明者生成见证时使用的完整输入,不是要公开提交给验证者的数据。实际系统应保护这个文件及生成的见证文件,避免将其写入日志或上传到公开存储。

在已安装 Circom 2 的环境中执行:

bash
circom purchase.circom --r1cs --wasm --sym -o .

预期结果:命令成功退出,并生成 purchase.r1cs、purchase.sym 以及 purchase_js 目录。编译器的具体日志随版本变化,不能仅凭是否打印提示判断信号公开性。

使用编译得到的见证生成器计算见证:

bash
node purchase_js/generate_witness.js purchase_js/purchase.wasm input.json witness.wtns

预期结果:命令成功退出,生成 witness.wtns 文件;满足约束的输入计算得到 total=60。如果安装了兼容的 snarkjs,可进一步查看见证值:

bash
snarkjs wtns export json witness.wtns witness.json

预期结果:生成 witness.json,其中按 Circom 常见的见证顺序依次包含常量 1、公开输出 total=60、公开输入 price=20 和私有输入 quantity=3。见证文件包含秘密值,不应发布。

公开信号与完整见证有什么区别

完整见证是使算术约束成立的一组信号赋值,其中既包含公开信号,也包含秘密信号及必要的内部信号。

本例的数据划分如下:

信号 示例值 分类 验证者直接获得
price 20 public 输入 是
quantity 3 私有见证 否
total 60 main 输出 是

在典型 Groth16 证明流程中,证明者使用完整见证生成证明,而验证者使用证明、验证密钥及公开信号验证约束成立,无须接收完整见证。

使用 snarkjs 生成 Groth16 证明时,生成的 public.json 通常按电路的公开信号顺序包含输出和显式公开输入。本例对应的内容为:

json
[
  "60",
  "20"
]

这是预期的数据结构示例,不代表前面的编译命令已经生成该文件。实际还需要完成可信设置、生成证明等步骤。

检查主组件输出是否泄露秘密

假设业务要求证明购买数量符合约束,却不希望外部知道数量。前面的乘法电路就不符合这一隐私目标:金额与单价公开后,购买数量可以被推算。

更隐蔽的错误是直接复制秘密输入到主组件输出,例如下面的片段示例,依赖前面 Purchase 模板的信号定义:

circom
// 错误示意:若在模板中增加该输出,会公开购买数量
signal output revealedQuantity;
revealedQuantity <== quantity;

这会使 revealedQuantity 自动成为主组件公开输出。即使 quantity 不在 public 清单中,它的值仍会泄露。

正确设计应先确定验证者究竟需要知道什么。例如验证者只需要确认数量为正,并且不超过 10,可以把公开结果设计成布尔意义的验证结论,同时在电路中约束数量范围,而不是输出原始数量。

不过,简单地输出固定的 valid=1 不能证明数量合法。必须真正添加范围约束,并确保非法见证无法满足这些约束。与此同时,如果证明系统没有绑定订单编号、用户身份或其他业务上下文,验证者也不能据此认定证明对应某笔特定订单。

按隐私目标审查公开信号

交付电路前,可以使用以下顺序审查:

  1. 列出 main 的全部 signal input,逐一核对哪些出现在 {public [...]} 中。
  2. 列出 main 的全部 signal output,无条件加入公开信息清单。
  3. 检查公开信号之间是否可以通过加减乘除、枚举或已知业务规则推断私有值。
  4. 检查生成见证的输入文件、调试日志、证明接口和持久化存储是否额外暴露秘密。
  5. 如果修改了公开信号接口,重新编译电路,并按所用证明系统重新生成相匹配的证明与验证材料。

可以做一个边界练习:把 component main {public [price]} 改为 component main {public [price, quantity]} 后重新编译。此时 quantity 已变成显式公开输入,验证者需要接收对应公开值;这不是仅仅改变开发期的标签,而是改变了证明语句的公开接口。

最终检查标准是:公开输入和全部主组件输出都符合业务允许披露的信息范围;私有见证没有通过输出、可逆关系或外围系统被间接泄露。

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

目录与阅读设置

阅读设置

17

记录一个想法

划分 public 输入与私有见证

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

登录哪都通