跳到主要内容

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 不应按普通精确到账资产接入;预先模拟也不能保证稍后执行一定成功。

从输出构造到可花费​

  1. 根据完整收款材料构造 Note 输出,验证网络、实例、token 与最小单位金额。
  2. 完成对应入金或私密消费操作。
  3. 从成功规范回执核对承诺及实际树位置,认证解密交付材料。
  4. 检查成员路径与当前消费状态,并与本地在途预留对账。

历史根仍被接受,不代表 Note 尚未消费。收款金额、发现库存与可用余额应分别展示。参阅会话同步与恢复。