跳到主要内容

Provenance:来源认可与信任

Provenance 让钱包、DApp 和服务核实普通 Note 是否属于指定签发者的来源认可集合。服务筛查实际公开入金、验证客户端本地生成的来源证明,并为链下认可树发布签名 checkpoint。有效来源证明说明输入在特定链、Core 实例与签发者规则下满足认可成员关系;它不证明所有权、身份、法律合规、资金绝对安全,也不保证收款方能够花费。

先通过 HTTP 接入发现和查询服务,再按证明与证据流程完成本地证明、交付、核验和恢复。

三种独立决定​

决定权威与含义
协议执行合约执行花费授权、金额守恒与 nullifier 规则;Protocol RPC 提供已索引的链上事实。
来源认可Provenance 检查配置的外部来源和输入证明,独立认证已最终确定的链上事实,再发布认可。
代发接单Broadcaster 根据来源要求、报价、模拟和广播策略决定是否接单。

broadcastDecision: "allow" 只是短期有效的预检结果,不表示已经发送、上链、最终确认或获得认可。来源证明作业的 valid 也不表示最终认可。应等待原操作变为 recognized,并取得已发布 checkpoint。

来源认可在链下进行,不改变 Protocol 的花费规则。来源拒绝不会冻结链上资产、撤销已广播交易或自动退款。更换代发服务不能凭空获得同一签发者规则下的认可。

哪些操作需要什么证据?​

操作所需来源证据认可对象
Shield 或有公开入金、无普通 Note 输入的 transact实际公开 payer、token、到账本金与必需来源筛查普通 Note 输出
无公开入金的私密 transact每个普通 Note 输入均属于认可集合的本地证明全部普通 Note 输出;提现也可具有操作认可记录
混合公开入金和普通 Note 输入的 transact公开来源筛查与私密输入来源证明两类条件全部满足后的全部输出
Credit draw每个实际 payer 的 gross 扣款与来源筛查唯一普通 Note 输出
Credit create、update、revoke无需普通 Note 输入来源证明Credit 状态不写入认可树

Credit 状态代表扣款权限,不是已入金的普通 Note。服务费属于公开账本,不因这套流程获得完整的私密资金来源证明。聚合成员各有自己的操作定位与证明,单个成员认可不代表整笔交易认可。没有合法 Note 输出的直接转币捐赠不会产生认可叶子。

先建立信任,再接受结果​

Merkle 根承诺一个集合。签名认证签发者对该集合的声明,无法数学证明外部供应者的风险判断真实。通过独立可信的部署与发布流程配置以下信息:

  • 预期网络身份、chainId、Core 实例地址与部署代码身份。
  • Provenance 签发者 providerId、初始 Ed25519 签名公钥、可接受的密钥历史与已签轮换记录。
  • 可接受的筛查规则、必需外部来源身份、能力、链覆盖范围、适用阈值与时效限制。
  • 独立来源证明 manifest 的 SHA-256,以及认证过的产物、验证密钥和兼容本地证明资源。

签发者的 providerId 和签名密钥与外部筛查来源身份不同。将响应共同字段 scope、chainGeneration、providerId、signingKeyId、manifestSha256 与你的信任配置核对。getRules 提供规则与密钥历史供比较;直接信任同一个未知端点返回的公钥不能建立信任。发现接口与版本字符串只是兼容性信息。

按规定的规范编码验证根签名与密钥轮换,再核对 scope、generation、已发布状态及规范链 finalized 区块锚点。历史证书不一定需要刚刚签发,但当前链与 generation 上下文必须足够新,才能检测失效。

理解来源策略​

服务只消费配置的外部来源,不调查地址、维护或发布黑名单。必需来源采用 all-required 规则:每个必需来源必须允许每一笔适用的公开资金。rejected 表示明确拒绝;unavailable 表示缺乏覆盖、没有结论、过期或技术/信任校验失败。两者均不能允许认可。来源可用也不表示判断结果为允许。

地址名单检查只说明地址是否匹配特定数据集,不代表上游资金追踪或完整资金历史。即使适配器标记为 transaction-risk,实际能力也可能仅为 payer 地址暴露分析,而非本笔交易、token 或金额分析。向用户描述结果前,应核对声明的能力与覆盖范围。

来源版本和评估时间属于证据。读取时间不表示上游获知事实的时间。存在适配器不代表运营者已具备凭证、覆盖范围或商业授权。确认所选来源的数据仍在维护,并读取部署服务经过认证的声明;不要假定默认供应商集合或把已停止维护的数据当作当前风险判断。

最终性与持续有效性​

正式认可要求独立读取 primary chain 的原生 finalized 区块并核验规范区块 hash,不支持按确认深度或等待时长降级。某条链即使出现在发现接口且显示执行结果,认可仍可能等待原生最终性支持与可用性。FINALITY_UNSUPPORTED、FINALITY_UNAVAILABLE 和 FINALITY_INCONSISTENT 必须分别处理。

资金最终认可且仍属于规范链后,不会仅因后来的风险名单更新撤销认可。链重组属于链上事实纠正,可能提升 chainGeneration,旧 generation 根不再允许新证明。私密后继操作可能需要在重建后的认可树上重新证明;原付款方保存的本地输入可能不可或缺,仅持有输出 Note 的收款方不保证能完成恢复。

认可树成员关系独立于 Core Note Tree,也不证明 Note 尚未花费。余额与界面应分别表达已收到/链上资产、来源已认可、符合代发选币条件这几种属性。