Chaingateway V2.1 Beta:测试网与 Webhook
Chaingateway V2.1 Beta 于 2024 年 9 月 16 日发布,内容包括测试网支持、重建的 Webhook 系统、重新设计的控制台,以及从 V2 迁移到 V2.1 的具体步骤,并列出后续变化与 2026 年的更新。
审核: Maurice Sobiera
Chaingateway V2.1 是 2024 年重写的 API 与控制台,新增 X-Network 请求头的测试网支持,重建了 Webhook 系统,并重新设计了用户界面。API 基础地址从 api.chaingateway.io/v2 改为 app.chaingateway.io/api/v2。本文列出变更与迁移步骤。
更新,2026 年 11 月 5 日: V2.1 是当前的 API。自发布以来,已新增 Solana 与 Arbitrum(Solana 不支持 Webhook)。下文所述的 Tron Paymaster 已停用,加密货币套餐付款于 2025 年 4 月改版(参见新支付流程)。端点列表见 OpenAPI 文件。
如何访问 V2.1?
V2.1 面向所有客户和试用用户开放,网址为 app.chaingateway.io。它设计为与 V2 兼容,因此大多数集成只需更换基础地址。迁移步骤见本文末尾。
如果您的试用已过期,请创建账户,或联系我们延长试用期。Beta 版还设有 Telegram 社区。
V2.1 有哪些新内容?
本次发布包含以下变更:
- 所有链均支持测试网。
- Tron Paymaster,一项为 TRC-20 转账支付手续费的服务。现已停用。
- 带有请求与响应示例的 API 文档。
- 重新设计的开发者门户。
- 重新设计的控制台。
- 信用卡支付可即时更改套餐。
- 重建的 Webhook 系统与新的手续费处理方式。
支持哪些测试网?
在请求中添加请求头 X-Network: testnet,即可使用该链的测试网。主网请发送 X-Network: mainnet,或省略该请求头。在主网上能做的一切,在测试网上同样可以。您也可以在控制台顶部切换网络。
| 链 | V2.1 中的测试网 | 参考 |
|---|---|---|
| Ethereum | Sepolia | ethereum.org:网络 |
| Tron | Nile | TRON 开发者中心:网络 |
| BNB Smart Chain | BSC testnet | BNB Chain 文档 |
| Polygon | Amoy | Polygon 文档 |
| Bitcoin | Testnet3 | Bitcoin 开发者示例:测试 |
最新列表还包括 Arbitrum Sepolia 和 Solana devnet,见支持的网络文档。

Tron Paymaster 是什么?
Paymaster 是一项服务,为 TRC-20 转账支付能量(Energy)和带宽(Bandwidth)费用,使钱包无需持有 TRX。它与订阅分开计费,在测试网上免费。Paymaster 已停用。 请改用 TronFuel。旧的 Paymaster 教程 仍保留供参考。
文档和控制台有哪些变化?
API 文档增加了更多请求与响应示例。开发者门户新增了入门指南,以及核心功能的教程。控制台已重新设计,Webhook 监控可查看已发送的载荷,并可按金额筛选。

计费有哪些变化?
通过 Stripe 以信用卡付款的客户,现在可以立即升级到更高的套餐,无需等待下一个计费周期。若达到 API 限额,可在计费页面点击 “Change Plan”,限额会立即提高。发票只显示新旧套餐之间的差价。公告称,加密货币付款也将采用同样的方式,该功能随 2025 年 4 月的新支付流程上线。
V2.1 在技术上有哪些变化?
API 运行在全新的技术栈上。公告指出,部分响应可能与 V2 略有不同,并请用户将差异反馈给支持团队。
手续费处理已重新设计。如果您的请求设置了 gasPrice、maxFeePerGas 或 maxPriorityFeePerGas,在 V2.1 中已无需再发送这些参数。当前的 OpenAPI 定义中,Gas 相关字段仍为可选。
Webhook 系统是在发布前数周 Webhook 服务出现中断之后重建的,中断期间有部分区块未被处理。控制台中的 Webhook 监控显示已发送的载荷。Webhook 不会自动重试。失败的通知按链列出,例如在 GET /api/v2/tron/webhooks/notifications/failed 下,您可以通过重试端点重新发送。
发布之后规划了什么?
公告提出了三项后续计划:Solana 支持、为更多链提供 Paymaster,以及修复 API 响应。Solana 支持已经上线。Paymaster 则被停用,而非扩展。
如何从 V2 迁移到 V2.1?
- 将基础地址从
api.chaingateway.io/v2改为app.chaingateway.io/api/v2。 - 可选但建议:在 API 密钥前加上
Bearer前缀,使请求头为Authorization: Bearer <token>。 - 使用新地址测试您的集成。
- 在完成全部迁移之前,请在旧控制台中管理您的订阅。
过渡期间,用户数据、地址和 API 密钥每分钟从 V2 复制到 V2.1。在 V2.1 中创建的地址无法在 V2 中使用。Webhook 每 10 分钟复制一次,复制期间不会触发通知。如需 Webhook 迁移方面的帮助,请联系支持团队。
准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 区块链 API 获取完整的 endpoint 参考。