Note 与资金流
Note 是单一资产的私密资金凭证。应用持有金额、所有者、随机化材料和必要的恢复数据;链上登记承诺,花费时检查成员关系并登记消费标记(nullifier),阻止重复消费。
三条资金路径
公开入金:Shield
shield 接受 1–10 张公开金额输出,不需要零知识证明或旧 Note 输入。它公开入金者与金额相关信息,将资金转入实例并登记 Note 承诺。生成加密输出本身不会入金,只有成功执行后才存在链上资金凭证。
私密结算:Transact
transact 可消费旧 Note、加入公开资金、创建新 Note,或向公开地址提现。单请求只处理一种 token;SDK 金额使用 token 最小单位整数。
输入 Note 总额 + 公开入金
= 新 Note 总额 + 公开提现 + 同 token 服务费
每个选中的输入都会被全额消费。部分支付需要生成找零 Note,不能把原 Note 的金额原地减小。选择跨树输入时,每棵来源树都有自己的成员根与路径。
全额归集到原所有者
持有完整 Note 原像或可恢复它的查看材料,可证明将该 Note 全额归集到原 owner 地址。该路径不需要 owner 的自由花费签名,但禁止创建私密找零、加入公开资金、改收款人或从凭证扣费。
这使完整凭证披露与传统“只读查看”不同:披露方无法重定向资金,却可能公开提现金额、改变执行时间并与 owner 的待提交支付竞争。
入金授权
| 材料 | 作用 | 不能替代什么 |
|---|---|---|
| ERC-20 allowance / Permit | 允许 token 合约转移资金 | 不等于具体付款业务的授权 |
| 直接 payer 调用 | 由实际出资者提交受约束入金 | 不授予其他人任意从 payer 拉款的权限 |
| 独立入金签名 | 允许中继执行绑定好的入金 | 不等于 Note 私密花费授权 |
| Wallet 授权 | 绑定私密操作、金额、目的地、费用与 deadline | 不提供 ERC-20 allowance 或网络 gas |
合约校验实际到账差额。收转账手续费或自动变基的 token 不应按普通精确到账资产接入;预先模拟也不能保证稍后执行一定成功。
从输出构造到可花费
- 根据完整收款材料构造 Note 输出,验证网络、实例、token 与最小单位金额。
- 完成对应入金或私密消费操作。
- 从成功规范回执核对承诺及实际树位置,认证解密交付材料。
- 检查成员路径与当前消费状态,并与本地在途预留对账。
历史根仍被接受,不代表 Note 尚未消费。收款金额、发现库存与可用余额应分别展示。参阅会话同步与恢复。