跳到主要内容

本地证明与资源准备

私密操作把 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 也已离线可用。浏览器应用需单独部署这些运行时资源,保持动态加载文件与必要的线程版本完整。

正确执行顺序​

  1. 固定网络、实例、输入、输出和执行模式。
  2. 如果使用 Broadcaster,先取得并审阅最终费用报价。
  3. 导出 Wallet EIP-712 授权,向用户展示条款并附加签名。
  4. 对需要 ZK 证明的操作调用 prove(),使用与目标语句匹配的产物并验证结果;Shield 使用 ready(),Credit 撤销使用其独立 owner 授权路径。
  5. 需要时附加独立的公开入金授权,执行提交前校验,再提交。

公开 Shield 不需要 ZK proof;owner 撤销 Credit 也使用独立授权路径。直接 EVM proof 与递归聚合成员 proof 不能互换;签名报价选择的 execution 必须与证明路径一致。

故障处理​

资源哈希不符、缺少 VK、错误网络、证明失败与 RPC 超时应分别报告。重新证明不能自动创建新付款;保留原操作、输入预留与提交结果。不要将私钥或证明见证上传到公共服务来“自动修复”。

缓存有助于重复加载,但不取代受信资源身份。包安装成功也不表示对应证明资源已发布,详见版本与兼容性。