协议集成快速开始
这条路径面向第一次接入的钱包或 DApp 开发者:先离线构造输出,再在测试环境完成入金、发现、支付和恢复。它不依赖托管商户 API。
1. 明确应用目标
直接管理隐私资金时,从 SDK开始。只需对接标准付款会话时,先阅读 IPP并采用 Facilitator 接入。后者仍需由付款钱包选择和授权实际执行方式。
2. 准备匹配环境
| 配置 | 从哪里取得 | 为什么必须固定 |
|---|---|---|
| chain ID 与链 RPC | 你选定的测试网络 | 独立核对区块、回执与原生最终性 |
| Core 地址、代码身份与部署起点 | 受信部署配置 | 避免向错误实例入金,确定扫描范围 |
Protocol RPC /v1 入口 | 受信服务提供者或自建服务 | 读取索引与候选、发现部署 |
| token 地址及 decimals | 目标资产配置与合约读取 | 正确换算最小单位 |
| SDK / ABI / 证明资源 | 兼容的发布包与认证资源 | 同一个版本号不能代替兼容性校验 |
| 账户签名与认证解密 | 应用的钱包能力 | 密钥留在宿主,授权内容可供审阅 |
核对版本与兼容性,先验证读操作与部署匹配,再使用测试资金。
3. 离线构造输出
运行 TypeScript 离线示例,或使用 Go / Rust。这一步只验证收款材料与输出编码,不创建资金或发起交易。
4. 完成第一次入金
用真实测试实例及 token 替换演示地址,使用公开入金函数准备 Shield。核对出资钱包、金额、Core allowance 和 gas;通过应用自己的交易签名器提交,保存哈希。
只在规范成功回执中确认实际插入位置。按产品要求等待确认等级,不能将请求受理或交易广播当成到账。
5. 发现并花费 Note
创建带持久化 Store 的 WalletSession,完成 refresh() 与认证解密。核对扫描完整性与可用余额,再准备 Note 支付。选择输入后保留预留,最终授权、证明、提交及对账按同一操作进行。
若使用 Broadcaster,先取得最终报价,再签名和证明;需要来源证据时按 Provenance的绑定要求处理。
6. 验证恢复
在测试环境主动验证:用户拒绝签名、网络中断、交易发送后应用重启、RPC 未追上链头、重组和原生最终性不可用。用原操作 ID 与哈希恢复,确认不会重复付款或过早释放预留。
7. 接入应用层请求
需要标准化收款或授信时,用 IPP把请求、实际付款与证据回执关联。Core 产生 Note 不等于某个 IPP Request 已核销,更不等于你的业务订单应重复履约。