钱包与 DApp 集成
本组指南面向构建钱包前端、DApp 和支付入口的开发者。先明确要控制的账户、资产和支付路径,再选择 SDK 或商业收款接口。这里的产品行为说明不构成新的接口契约,也不代表每个发布版本都具备全部入口。
选择正确的接入层
| 目标 | 使用的文档 | 应用承担的责任 |
|---|---|---|
| 商户创建托管收款会话 | 商业支付快速开始 | 保存订单和幂等键、服务端确认、幂等履约 |
| 钱包管理 Note 库存并构造交易 | SDK 钱包会话 | 解锁、认证解密、持久化、签名授权、对账 |
| 钱包处理原生 IPP 支付 | IPP 支付 | 校验固定 Request、遵循认证 links、保存原操作 |
| 查询公开协议数据 | Protocol RPC | 认证链事实,不将候选查询当作私密余额 |
| 展示公开资金来源信息 | Provenance | 保留认可范围,不推导现实身份或法律结论 |
不要把旧收款码解析器、App 的内部业务接口或演示页面当作稳定的第三方接入接口。商业 API 的币种单位十进制字符串,与 SDK/Core/原生 IPP 的最小单位金额不可混用。
集成顺序
- 固定部署、网络、token 地址与精度,确认当前协议和 SDK 版本。
- 建立账户边界,区分连接、解锁、查看和签名能力。
- 分别同步公开余额和经过验证的私密库存,展示各自的新鲜度。
- 在确认页冻结资产、收款目标、金额、找零和费用。
- 在发送前保存操作,发送后保存哈希,恢复时对账原操作。
- 测试拒签、RPC 故障、重复点击、重启、余额不足与确认回滚。
按任务阅读
- 账户、连接与签名:站点会话、账户切换和授权边界。
- 内置浏览器 DApp 发现与连接:EIP-6963 发现、账户授权、事件与取消处理。
- 双余额与凭证选择:可用、预留、未知与找零。
- 地址与收款码:区分普通地址、隐私地址和支付请求。
- 交易状态与恢复:已广播、已执行和业务完成。
- 估值、网络与费用:资产标识、缺价和 Gas 展示。
产品设计稿中的示例网络、币种和费用只用于说明界面。实际执行以选定部署、接口能力与最终签名条款为准。