SDK:选择接入层
SDK 把密码学与协议操作封装为可组合能力。应用负责选择账户、保管密钥、展示授权、认证解密与交易提交;SDK 不代替应用的钱包或支付后台。
选择语言与状态管理方式
| 接入方式 | 适合场景 | 说明 |
|---|---|---|
| TypeScript | Web、Node.js、钱包与 DApp | 原生 / WASM 本地证明,浏览器与服务端会话 |
| Go | 后端服务、工具与自建支付系统 | 按功能选择独立模块,注入链读写和本地 prover |
| Rust | 原生应用、服务与受控本地运行时 | 独立 crates,显式证明后端与可选持久化 |
| 无状态准备 | 已自行管理凭证库存的系统 | 显式提供输入;自行负责选择、预留与恢复 |
| WalletSession | 需要管理钱包库存的应用 | 同步、选择、预留、操作日志和恢复 |
按能力安装
TypeScript 包分别提供以下职责:
@invisi-labs/primitives:地址、凭证、哈希和交付编码,无网络或证明运行时。@invisi-labs/protocol:ABI、公开类型、签名消息和协议编码。@invisi-labs/rpc:Protocol RPC、Broadcaster 与 Provenance 传输。@invisi-labs/prover:显式本地证明与认证资源加载。@invisi-labs/sdk:无状态操作准备、外部授权和交易导出。@invisi-labs/session:持久化钱包操作与库存管理。
使用同一兼容发布组的包,不混用不同 ABI 或证明资源。本文示例使用 1.3.2 接口;安装前确认所选发行包包含这些方法,且匹配的证明资源可获取。安装前先查版本与兼容性。
金额与授权
SDK 使用 token 最小单位整数(TypeScript bigint、Go big.Int、Rust U256),不同于商业支付 API的币种十进制字符串。用 token 的实际 decimals 转换,不能把 10n 当成 10 USDC。
同一操作的费用报价应在最终授权与证明之前固定。修改金额、费用、收款方、deadline 或执行模式后,需要重新审阅相应授权。