TPWallet的 API 使用指南 TPWallet API 调用全流程：鉴权、签名、回调一次说清
做过 DApp 后端的人都知道，TPWallet 的 API 是连接链上钱包和用户操作的关键桥梁。它的接口覆盖了鉴权认证、交易签名、链上查询三大块TPWallet的 API 使用指南，但文档散落在不同页面，踩坑不少。我花了两周把主网和测试网的接口全跑了一遍，把几个最容易翻车的地方记下来，希望能省你不少时间。
申请 API Key 后，所有请求都要在 Header 里带上 Authorization 字段，格式是 Bearer 加你的密钥。一个容易忽略的点：TPWallet 的测试网和主网密钥不通用，混着用会直接返回 401。另外注意时间戳，请求里的 timestamp 和服务器时间差超过 5 分钟就会被拒绝，跨时区部署的同事务必统一用 UTC。
签名交易是核心操作。调用 /v1/tx/sign 接口时，body 里要传完整的 EIP-1559 参数——maxFeePerGas、maxPriorityFeePerGas 缺一不可。我踩过一个坑：nonce 字段如果传 0TPWallet的 API 使用指南 TPWallet API 调用全流程：鉴权、签名、回调一次说清，接口不会报错，但生成的签名在链上会被静默丢弃。正确做法是先查当前 pending nonce，再往上递增。
链上交易确认靠 Webhook 回调，配置地址必须是 HTTPS，且服务端响应 200 才算接收成功。TPWallet 最多重试 3 次，间隔分别是 30 秒、2 分钟、10 分钟。如果你的后端处理耗时超过 30 秒，建议先快速返回 200，把实际逻辑丢进消息队列异步跑，不然回调会全部丢失。
你在使用 TPWallet API 时遇到过最离谱的报错是什么？欢迎在评论区聊聊。
