TypeScript SDK
在付款、收款和商户后端 SDK 之间选择,并保持清晰信任边界。
SDK 按角色拆分,避免钱包签名、收款操作和商户后端凭据混入同一个客户端。
| 包 | 运行位置 | 关键边界 |
|---|---|---|
x402-paysdk/pay | 浏览器、应用或钱包宿主 | 使用宿主提供的 signer,不接收私钥。 |
x402-paysdk/receive | 收款应用或受信工具 | 创建和管理引用,不签署付款。 |
x402-paysdk/merchant | 商户后端 | 持有商户 API/notify 凭据,不能运行在不可信浏览器。 |
| 内部协议核心 | 随包构建,不直接导入 | 协议解析、编码、校验、offer、签名和有界 HTTP 工具。 |
只引入当前信任域对应的包。结账前端通常使用 pay-sdk,后端则使用 merchant-sdk。