跳到主要内容

开放协议开发指南

将隐私资金与可验证支付集成到钱包、DApp 或自建服务。先理解资产与权限,再完成一条收款、花费和结果恢复的完整路径。

按目标开始​

你的目标推荐阅读路径
第一次集成架构 → 快速开始 → TypeScript
构建钱包地址与信任边界 → SDK → 会话同步与恢复
直接调用合约Core → Note / Credit → 事件确认
查询状态与确认收款RPC → 查询与分页 → 原生确认
通过中继发送交易Broadcaster → 接入流程 → 定时与取消
接入原生支付会话IPP → Facilitator → HTTP 接入
证明资金来源Provenance → 服务接入 → 证据与恢复

两类资产模型​

Note 是已经结算到协议中的资金凭证,可在规则内转移或提现。Credit 是从 owner 钱包后续扣款的授权,不是已锁定的余额。两者共用部分存储与证明基础设施,但权限、资金来源、生命周期和恢复方式不同。

谁负责什么​

应用保管密钥、展示用户授权、认证解密和管理库存。Core 执行链上结算;RPC 提供候选与状态;Broadcaster 可选代发;Facilitator 实现 IPP 会话;Provenance 对限定的来源声明提供证据。

服务返回成功、交易已入块和业务请求已核销是不同事实。使用前明确自己的信任边界,并核对版本兼容性。

如果只需使用托管 API 为商户收款,从商业支付开始,不需要先运行这些服务。