开放协议开发指南
将隐私资金与可验证支付集成到钱包、DApp 或自建服务。先理解资产与权限,再完成一条收款、花费和结果恢复的完整路径。
按目标开始
| 你的目标 | 推荐阅读路径 |
|---|---|
| 第一次集成 | 架构 → 快速开始 → TypeScript |
| 构建钱包 | 地址与信任边界 → SDK → 会话同步与恢复 |
| 直接调用合约 | Core → Note / Credit → 事件确认 |
| 查询状态与确认收款 | RPC → 查询与分页 → 原生确认 |
| 通过中继发送交易 | Broadcaster → 接入流程 → 定时与取消 |
| 接入原生支付会话 | IPP → Facilitator → HTTP 接入 |
| 证明资金来源 | Provenance → 服务接入 → 证据与恢复 |
两类资产模型
Note 是已经结算到协议中的资金凭证,可在规则内转移或提现。Credit 是从 owner 钱包后续扣款的授权,不是已锁定的余额。两者共用部分存储与证明基础设施,但权限、资金来源、生命周期和恢复方式不同。
谁负责什么
应用保管密钥、展示用户授权、认证解密和管理库存。Core 执行链上结算;RPC 提供候选与状态;Broadcaster 可选代发;Facilitator 实现 IPP 会话;Provenance 对限定的来源声明提供证据。
服务返回成功、交易已入块和业务请求已核销是不同事实。使用前明确自己的信任边界,并核对版本兼容性。
如果只需使用托管 API 为商户收款,从商业支付开始,不需要先运行这些服务。