跳到主要内容

来源证明、交付与证据

花费普通私密 Note 输入时,付款方本地生成来源证明。收款方可以核验输出的已发布认可,无需获知这些输入。此流程独立于付款执行:交付或重试来源证据不会发送付款。

先冻结操作,再生成证明​

  1. 通过钱包正常流程核实输入所有权与 Protocol 花费状态。若代发要求认可输入,从已认可集合选币,同时保留对其他已收资产的展示。
  2. 准备操作并收敛最终服务报价,冻结 calldata、有序普通 Note 输入、输出和公开入金语句。
  3. 为同一操作生成Core 交易证明与独立来源证明;认证认可根,并尽量本地构建成员路径。
  4. 交付来源证据、取得所需预检/tracking 结果,在向 Broadcaster 交付付款前持久化。
  5. 通过另外授权的钱包/代发流程发送付款,再观察该精确操作的来源认可。

来源证明不进入主合约 calldata。服务费变化可能改变公开操作语句,使来源证明绑定失效;广播前应基于最终语句重新生成。恢复证据时不要重新报价已经提交的付款。

本地证明需要兼容的 SDK/证明器代码与独立认证的来源产物、manifest、验证密钥和证明资源。按运行环境预置 native 工具/CRS 或支持的浏览器后端。Provenance 服务只做验证,不提供 witness 生成或远程 proving 入口。向用户承诺浏览器或移动端证明体验前,应核实实际运行时支持与资源要求。

证明绑定了什么​

Bundle 使用 format: "invisi-provenance-proof-v1"、target: "evm"、认证过的 circuitId 和 manifestSha256、11 个 publicInputs、hex proof bytes 与 rootCertificates。公开输入顺序如下:

chain_id, protocol_address, token_address, chain_generation,
source_count, sources_digest, input_count,
operation_digest_hi, operation_digest_lo, input_digest, binding

11 个值均为规范 BN254 Field word。operation digest 绑定规范结算语句,input digest 绑定有序有效 Note nullifier。根证书将认可成员关系绑定到同一 scope 与 generation。使用 SDK 规范 codec 和认证 manifest,不要自行 hash 任意 JSON,也不能使用服务器响应临时指定的验证密钥。

独立来源电路容量为 K10、K20、K40、K80、K120、K160、K190,按实际普通私密 Note 输入数选择能容纳的最小档位,与主电路容量独立。例如 5 个输入、10 个输出使用来源 K10;无普通私密输入时无需生成成员来源证明。

输入跨物理认可树时,每棵树提供一张覆盖输入的证书,按 treeId 严格递增排列。证书必须属于同一 scope 和当前 generation,列表须与 source_count、sources_digest 一致。物理树轮换本身不改变 generation。认可根不证明输入可花费,Protocol nullifier 规则仍然适用。

不要向服务发送 opening、与花费关联的输入 commitment、nonce、seed、私钥/view key、IPN、成员 witness 或解密余额。公开证明输入通过摘要绑定 nullifier 与成员关系,实际输入开口与路径始终留在本地。

通过 HTTP 交付证据​

下列示例要求 shell、curl、jq 与 HTTP 接入中配置的可信 PROVENANCE_RPC。先用 SDK 已冻结字段的最终结算 calldata 与真实 proof sidecar 创建 candidate.json。这里的最终语句指交易字段已固定,不表示已经达到链上最终性。下面是局部结构示意,必须由真实证明和完整证书替换:

{
"data": "0x<canonical settlement calldata>",
"proofSidecars": [
{
"operationIndex": "0",
"proofBundle": {
"format": "invisi-provenance-proof-v1",
"circuitId": "<ID from the authenticated manifest>",
"manifestSha256": "<authenticated 64-character SHA-256>",
"target": "evm",
"publicInputs": ["<exactly eleven canonical field words>"],
"proof": "0x<locally generated proof bytes>",
"rootCertificates": ["<complete authenticated certificate objects>"]
}
}
]
}

每个 sidecar 的索引对应结算成员;最多接受 5 个不重复且在范围内的 sidecar。不带私密 Note 输入的成员不能附 sidecar。整个 JSON 请求必须小于等于 256 KiB,即使 proof 本身未超过解码后的 64 KiB 限制。

拥有真实 candidate.json 后,广播前预检如下:

jq '{jsonrpc:"2.0",id:10,method:"provenance_evaluateTransaction",params:[.]}' \
candidate.json |
curl --fail-with-body --silent --show-error "$PROVENANCE_RPC" \
-H 'Content-Type: application/json' --data-binary @-

检查 broadcastDecision、recognitionState、inputProofStatus、reasons 和有效期。允许的私密输入候选必须带有持久化 tracking,其 operationDigest 应与冻结操作一致。多成员结果的 tracking 位于各 operations 内。预检有效期 30 秒,上链与最终认可仍待完成。

独立付款之前或之后交付来源证明,使用相同查询结构调用 provenance_submitSourceProof:

jq '{jsonrpc:"2.0",id:11,method:"provenance_submitSourceProof",params:[.]}' \
candidate.json |
curl --fail-with-body --silent --show-error "$PROVENANCE_RPC" \
-H 'Content-Type: application/json' --data-binary @-

历史 calldata 仅在付款于原 deadline 内完成时可匹配;重复交付可复用 tracking。此路径无需另发 txHash 通知,worker 独立匹配规范且 finalized 的执行。两个端点都不签署、发送或重发付款。纯公开入金操作由普通索引流程处理,不建立私密 tracking 任务。

观察完成与安全恢复​

使用 {trackingId} 查询 provenance_getTracking。ID 为不含 0x 的 48 位小写 hex,应保密。状态为 pending_confirmation、pending_source、recognized、expired、superseded、stale_generation。匹配的 locator 必须与原付款的 blockHash、txHash、operationIndex 完全一致;再查询原操作认可并验证已发布 checkpoint。证明作业仅为 valid 不足以完成流程。

HTTP 响应丢失时,先核对原交易与已有任务,再继续操作。等待来源检查不是再次付款的理由。过期依赖完整且独立 finalized 的历史,不能只看本地计时器或落后索引。superseded 与 stale-generation 任务不能直接用旧证据重新打开。

显式机器恢复可调用 provenance_submitProof,提交已被索引的操作 locator、proofBundle 与 idempotencyKey。提交前持久化精确请求;响应丢失后使用相同 body 与 key 重试,同 key 改 body 会返回 IDEMPOTENCY_CONFLICT。使用返回的 jobId 查询 provenance_getProofJob,状态为 queued、verifying、valid、invalid、retryable_error 或 stale_generation。无效证明不会将 Note 列黑。generation 或证明内容变化,需要重新绑定证据并使用适当的新 key。

保留可核验证据​

应用应保存的内容用途与隐私
预期 scope、签发者/密钥信任历史、规则、manifest pin、generation重建接受声明时的信任上下文
冻结的原 calldata/hash、operation digest、有序 nullifier、最终报价与已签提交记录核对精确付款并防止误重发;按钱包操作数据保护
proof bundle、证书、本地交付模式、tracking ID;适用时保存恢复请求/key 与 job ID恢复交付而不创建另一笔操作;私有机器标识不进入 Explorer 或日志
mined locator、最终操作认可结果、checkpoint 证书与必要叶子/路径证据将已发布结果绑定到预期操作与链
来源判断、adapter/capability、coverage、数据/来源版本、评估/过期时间与可用证据引用解释准确的公开来源声明;证据引用是摘要,不是供应商报告
原输入 opening 与重建材料,在钱包控制下本地加密保存generation 变化后重新证明;不能作为恢复数据上传

根证书包含签发者/密钥 ID、scope、generation、根序号、物理 tree ID、leaf count/root、确认区块号/hash、决策日志 hash、前序 checkpoint hash、签发时间与签名。验证规范签名及锚点,再从认证的叶子/路径证据重算 Note 成员关系。保存实际用于核验的证书,不假定之后的可变视图与之等价。

操作资金评估历史单次最多返回 200 项,并标记是否截断。旧 finalized 记录可能缺少新证据字段。一次响应不是完整档案,服务也不会永久保存所有候选材料。无引用的终态预检验证缓存会在 24 小时后清理;已采用的证明证据和已发布认可历史保留可审计性。需要更长独立审计链时,应确认运营者的保留与导出安排。

重组后先在规范链核对原付款,再刷新 generation 与根,必要时本地重做来源证明。旧签名历史保留作审计,但拒绝用于新证明。仅拥有输出的收款方通常无法重做付款方历史私密输入证明。