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 尚未花费。余额与界面应分别表达已收到/链上资产、来源已认可、符合代发选币条件这几种属性。