本地证明与资源准备
私密操作把 Note/Credit 原像、成员路径和本次授权等私密见证交给本地 prover,生成与公开语句绑定的证明。服务端只验证公开证明并不需要拿到这些见证。
选择后端
| 运行环境 | 接入方式 | 应用需准备 |
|---|---|---|
| Node / 原生服务 | @invisi-labs/prover/native | 匹配的 BB 程序、认证电路与 VK、缓存目录 |
| 浏览器 | @invisi-labs/prover/wasm | 匹配的 WASM 资源、动态 chunk、线程环境及 CRS |
| Go / Rust | 对应本地 prover | 兼容的 witness 生成器、BB 与认证资源 |
Core 交易与 Provenance 使用独立资源集。仅做 Core 操作不需要加载 Provenance 目录;做来源证明时再配置相应资源,不能因资源缺失而自动切换到其他版本。
配置本地资源
下面 TypeScript 工厂函数只配置后端,不立即生成证明。调用方传入 BB 可执行文件和经过认证的 Core 本地目录。只有生成来源证明时,才需要传入独立的 provenanceCatalog。
import { NativeProver } from "@invisi-labs/prover/native";
export function localProver(bbBin: string, coreCatalog: string, provenanceCatalog?: string) {
return new NativeProver({
bbBin,
resources: {
directory: coreCatalog,
...(provenanceCatalog ? { provenanceDirectory: provenanceCatalog } : {}),
offline: true,
},
});
}
offline: true 只禁止电路与 VK 下载,不代表 WASM 初始化或 CRS 也已离线可用。浏览器应用需单独部署这些运行时资源,保持动态加载文件与必要的线程版本完整。
正确执行顺序
- 固定网络、实例、输入、输出和执行模式。
- 如果使用 Broadcaster,先取得并审阅最终费用报价。
- 导出 Wallet EIP-712 授权,向用户展示条款并附加签名。
- 对需要 ZK 证明的操作调用
prove(),使用与目标语句匹配的产物并验证结果;Shield 使用ready(),Credit 撤销使用其独立 owner 授权路径。 - 需要时附加独立的公开入金授权,执行提交前校验,再提交。
公开 Shield 不需要 ZK proof;owner 撤销 Credit 也使用独立授权路径。直接 EVM proof 与递归聚合成员 proof 不能互换;签名报价选择的 execution 必须与证明路径一致。
故障处理
资源哈希不符、缺少 VK、错误网络、证明失败与 RPC 超时应分别报告。重新证明不能自动创建新付款;保留原操作、输入预留与提交结果。不要将私钥或证明见证上传到公共服务来“自动修复”。
缓存有助于重复加载,但不取代受信资源身份。包安装成功也不表示对应证明资源已发布,详见版本与兼容性。