跳到主要内容

协议架构与工作原理

从公开资金到私密状态​

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 请求、证据验证与回执

不要用某一层的成功替代其他层。快速开始按这三层组织第一次集成。