跳到主要内容

协议集成快速开始

这条路径面向第一次接入的钱包或 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 已核销,更不等于你的业务订单应重复履约。