协议架构与工作原理
从公开资金到私密状态
Core 不为每个钱包维护可直接读取的私密余额。它登记 Note / Credit 承诺,并用零知识证明检查隐私条件。钱包通过认证解密、成员关系和消费状态维护自己的视图。
应用:账户、签名、查看解密、状态持久化
│
├─ SDK ── 本地 prover ── 授权后的证明与交易
│ │
│ 直接提交 / Broadcaster
│ │
└─ Protocol RPC ←── Core 合约与链上事件
IPP 请求与回执 ←── Facilitator 核对支付证据
资金来源声明 ←── Provenance 证据与认可
链 RPC 提供区块、代码、回执和状态调用;Protocol RPC 在这些事实之上提供协议索引、候选发现与成员数据。它们不是同一个 API,也不具有相同的信任作用。
承诺、成员关系与消费标记
Note 的私密原像包含资产、金额和收款身份等材料。承诺在实际实例的追加树中登记;花费时证明持有符合条件的成员,并发布 nullifier 防重复消费。历史根仍然有效,不代表对应输入仍可花费。
Credit 保存带有效期与限额的扣款权限。draw 消费旧状态并生成后继状态与付款 Note;撤销则独立修改原始授权槽位,不能靠旧成员根绕过已生效撤销。
链上会看到什么
公开入金来源、Shield 的公开金额信息、承诺、消费标记、公开提现、部分 Credit payer 与汇总扣款金额、交易时间及共同出现关系仍可被观察。私密原像不作为公开参数,并不意味着所有金额、时间和网络元数据都隐藏。
代发改变交易提交路径,不自动消除应用网络来源或付款人的主动披露;来源证明也不扩大为现实身份或法律结论。
三层状态
| 层 | 要回答的问题 | 核对方式 |
|---|---|---|
| 链执行 | 交易是否成功、是否仍在规范链 | 成功回执、区块身份与原生确认 |
| 钱包资产 | 凭证是否真实、未消费且未预留 | 认证解密、成员路径、nullifier、撤销位与日志 |
| 支付请求 | 是否在约定时间与绑定下完成 | IPP 请求、证据验证与回执 |
不要用某一层的成功替代其他层。快速开始按这三层组织第一次集成。