区块链原理 / 系统课时

完成匿名资格证明端到端集成

完成匿名资格证明端到端集成

这一节把匿名资格证明收束成一个可运行的最小应用:用户持有私有资格数据,在本地生成见证和 Groth16 证明,链上只接收公开信号与证明,并通过一次性标识阻止同一资格重复消费。最终验收关注三件事:有效证明能通过、篡改公开输入会失败、同一 nullifier 不能再次使用。

学习目标

  • 串联 Circom 电路、见证计算、Groth16 证明和 Solidity 验证器的数据流。
  • 将资格条件、接收者和一次性 nullifier 绑定到同一组公开信号。
  • 用本地命令和 Foundry 测试验证成功路径、错误公开输入和重放攻击。

固定端到端的数据边界

最小应用可以把公开信号固定为三个字段:eligible、recipient、nullifier。其中资格原始数据继续留在电路私有输入中,链上不接收出生日期、成员编号或凭证秘密值。

一个可验收的示例约定如下:私有凭证中包含 age=22 和秘密 secret=123456;公开资格条件为年龄至少 18 岁;recipient 绑定实际领取地址;nullifier 由秘密和业务域在电路内确定性生成。链上只接受 eligible=1 的证明。

匿名资格证明端到端组件与数据流

这里最容易犯的错误是只让 Verifier 检查“数学上存在一个满足约束的见证”,却没有把公开信号和业务语义绑定。例如证明中的 recipient 若未与 msg.sender 对比,其他账户拿到 proof 后就可能代为提交;nullifier 若不进入公开信号,则合约无法识别重复消费。

生成见证和 Groth16 证明

假设项目已经完成 Circom 编译并拥有 credential_js/credential.wasm、credential_js/generate_witness.js、credential.r1cs 和最终阶段生成的 credential_final.zkey。input.json 中既可以出现私有输入,也可以出现作为电路输入的公开值;是否公开由 Circom 主组件的 public 声明决定。

下面命令使用 Circom 2 生成的 witness calculator 和 snarkjs。实际项目路径不同,替换 <PATH> 即可。

bash
cd <PATH>
node credential_js/generate_witness.js credential_js/credential.wasm input.json witness.wtns
snarkjs groth16 prove credential_final.zkey witness.wtns proof.json public.json
snarkjs zkey export verificationkey credential_final.zkey verification_key.json
snarkjs groth16 verify verification_key.json public.json proof.json

预期输出:最后一条验证命令成功时,snarkjs 输出验证成功信息;不同版本的附加日志可能不同。

text
[INFO]  snarkJS: OK!

运行后还要直接检查 public.json。例如电路声明三个公开信号时,文件应只有三个对应的域元素字符串,顺序必须与电路生成的公开信号顺序一致。前端和 Solidity 不能自行交换 recipient 与 nullifier 的位置,否则 proof 本身没有变化,Verifier 仍会因为公开输入不匹配而返回失败。

在 Solidity 中完成一次性消费

链上业务合约应把“验证证明”和“消费资格”放在同一笔交易中。下面的最小合约假定已经存在由 snarkjs 导出的 Verifier,并且它暴露常见的 verifyProof 接口。不同电路的公开输入数组长度必须按实际导出合约调整,这里固定为 3。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IGroth16Verifier {
    function verifyProof(
        uint256[2] calldata a,
        uint256[2][2] calldata b,
        uint256[2] calldata c,
        uint256[3] calldata publicSignals
    ) external view returns (bool);
}

contract AnonymousEligibilityConsumer {
    IGroth16Verifier public immutable verifier;
    mapping(uint256 => bool) public usedNullifiers;

    event EligibilityConsumed(address indexed recipient, uint256 indexed nullifier);

    constructor(address verifierAddress) {
        verifier = IGroth16Verifier(verifierAddress);
    }

    function consume(
        uint256[2] calldata a,
        uint256[2][2] calldata b,
        uint256[2] calldata c,
        uint256[3] calldata publicSignals
    ) external {
        uint256 eligible = publicSignals[0];
        uint256 recipient = publicSignals[1];
        uint256 nullifier = publicSignals[2];

        require(eligible == 1, "not eligible");
        require(recipient == uint256(uint160(msg.sender)), "wrong recipient");
        require(!usedNullifiers[nullifier], "nullifier used");
        require(verifier.verifyProof(a, b, c, publicSignals), "invalid proof");

        usedNullifiers[nullifier] = true;
        emit EligibilityConsumed(msg.sender, nullifier);
    }
}

这是片段示例,依赖实际生成的 Groth16 Verifier 合约;验收时应以导出合约的真实 verifyProof 参数类型为准。这里先检查 nullifier、再调用 Verifier 可以让明显的重放请求更早失败,但只有交易最终成功时 usedNullifiers[nullifier] = true 才会被持久化;后续逻辑若回滚,这次写入也会一起回滚。

用三组测试完成项目验收

验收不要只测试“正确 proof 返回 true”。至少覆盖成功、公开输入篡改和重放三条路径。使用 Foundry 时,可以把真实生成的一组 proof 固定为测试夹具,再对公开信号做最小修改。

测试顺序可以按下面的检查表执行:

  1. 使用原始 proof、eligible=1、正确 recipient 和未使用 nullifier 调用 consume,交易成功,并确认 usedNullifiers(nullifier) 返回 true。
  2. 保持 proof 不变,把 recipient 改为另一个地址。合约应在业务绑定或 Verifier 校验阶段回滚,不能产生消费事件。
  3. 恢复原始公开信号,再次提交完全相同的 proof。第二次调用应以 nullifier used 回滚。
  4. 可额外把 eligible 从 1 改成 0,确认不满足资格的公开声明不会进入验证成功路径。

Foundry 可以直接执行指定测试合约并显示详细调用信息:

bash
forge test --match-contract AnonymousEligibilityConsumerTest -vv

预期输出中的测试名称以项目实际命名为准;三条验收用例都通过时,汇总应显示 3 个测试通过、0 个失败。

text
Ran 3 tests for test/AnonymousEligibilityConsumer.t.sol:AnonymousEligibilityConsumerTest
[PASS] test_ConsumeValidProof()
[PASS] test_RevertWhenRecipientIsChanged()
[PASS] test_RevertWhenNullifierIsReused()
Suite result: ok. 3 passed; 0 failed; 0 skipped

如果第一条就失败,按 public.json 顺序、Solidity publicSignals 顺序、导出 Verifier 的接口三处逐项核对;如果第一次成功而第二次仍成功,问题不在 Groth16,而在业务合约没有持久化或检查 nullifier。完成这三条验证后,这个最小应用才同时具备隐私证明、业务身份绑定和一次性消费三个端到端约束。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成匿名资格证明端到端集成

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

登录哪都通