企业区块链 API:涵盖哪些内容、限制与价格
Chaingateway 区块链 API 涵盖的内容:七条链、测试网、签名 Webhook、密码保护钱包,以及每月 49 欧元起的套餐。文章同时列出各套餐的限制、Webhook 的签名与重试方式、私钥保护方式和起步步骤。
审核: Maurice Sobiera
企业区块链 API 是一种网络服务,让公司无需运行节点,即可通过 HTTPS 请求创建钱包、收发加密货币并读取链上数据。Chaingateway 就是这样一种 API。它覆盖七条区块链,所有链都支持测试网,其中六条链会为充值发送已签名的 Webhook。
本文列出该 API 涵盖的内容、它的限制以及费用。
Chaingateway 支持哪些区块链?
Chaingateway 支持 Bitcoin、Ethereum、BNB Smart Chain、Polygon、Arbitrum、Tron 和 Solana。所有链使用相同的身份验证、相同的 X-Network 请求头和相同的响应格式。只有地址格式和代币标准有所不同。
| 链 | 代币标准 | Webhook |
|---|---|---|
| Bitcoin | 无,仅原生 BTC | 是 |
| Ethereum | ERC-20、ERC-721 | 是 |
| BNB Smart Chain | BEP-20、BEP-721 | 是 |
| Polygon | ERC-20、ERC-721 | 是 |
| Arbitrum | ERC-20、ERC-721 | 是 |
| Tron | TRC-10、TRC-20、TRC-721 | 是 |
| Solana | SPL 代币 | 否 |
该表依据 OpenAPI 定义整理。Solana 不支持 Webhook,因此 Solana 集成必须轮询到账转账。
单一 API 并不能消除各链之间的差异。手续费、确认时间和最终性规则因链而异,你的代码仍需处理这些差异。关于两条链的对比,见 Solana 与 Tron 对比。
能否不使用真实资金进行测试?
可以。在请求中添加请求头 X-Network: testnet,即可在该链的测试网上运行。不带该请求头的请求会发送到主网。各链对应的测试网如下:
| 链 | 测试网 |
|---|---|
| Ethereum | Sepolia |
| Tron | Nile |
| BNB Smart Chain | BSC testnet |
| Bitcoin | Testnet3 |
| Polygon | Amoy |
| Arbitrum | Arbitrum Sepolia |
| Solana | Devnet |
测试网代币没有价值,因此无需花钱即可完整运行一次充值和付款周期。测试网在负载和手续费方面与主网不同,因此测试网上通过并不能证明手续费设置在主网上同样有效。以太坊关于网络的文档解释了什么是测试网,以及如何获取测试币。
充值通知如何工作?
你需要创建一个 Webhook,指定回调 URL 和过滤条件,例如收款地址或代币合约。检测到匹配的交易时,Chaingateway 会向你的 URL 发送一个携带交易数据的 HTTP POST 请求。这样就无需轮询链。
在生产环境中,有两个细节很重要:
- 签名:在个人资料中设置个人密钥后,每个 Webhook 都会带有
X-Signature请求头。它是由交易 ID 和你的密钥构成的 HMAC(RFC 2104)。在信任载荷之前先验证它。签名指南提供 Python、Java、PHP 和 JavaScript 的代码。 - 重试:Webhook 不会自动重试。失败的通知列在每条链的
/webhooks/notifications/failed下,你可以通过重试端点重新发送。
让你的端点具有幂等性,使同一通知即使收到两次,也只为账户入账一次。
私钥如何受到保护?
Chaingateway 为非托管服务。创建地址时,你可以设置一个密码。私钥会用该密码加密保存,每笔交易时你发送的是密码而非私钥。Chaingateway 不保存密码,如果你丢失密码,也无法恢复钱包。此外,你也可以导入已有的私钥,并在自己这一侧签名交易。
密码保护钱包是一种便利,并不能替代密钥管理。如果你的后端保存着这些密码,攻破后端的攻击者就可以从这些钱包中转出资金。请将密码保存在密钥管理服务中,并限制后端能够解锁的钱包中存放的资金量。
费用是多少?
Plus 套餐起价为每月 49 欧元,或每年 490 欧元。Pro 每月 99 欧元,Premium 每月 249 欧元,Enterprise 每月 499 欧元。每个套餐都从 7 天免费试用开始,无需银行卡,也无需 KYC 认证。当前价格与限额见价格页。
每个套餐的限额是多少?
每个套餐都设有月度限额。下表的数值是撰写本文时价格页上显示的数值,当前数字请以页面为准。
| 套餐 | 每月价格 | 每月交易数 | 钱包数 | Webhook 数 | 请求数 |
|---|---|---|---|---|---|
| Plus | 49 欧元 | 500 | 750 | 375 | 50k |
| Pro | 99 欧元 | 2,000 | 3,000 | 1,500 | 200k |
| Premium | 249 欧元 | 20,000 | 30,000 | 7,500 | 2M |
| Enterprise | 499 欧元 | 100,000 | 100,000 | 25,000 | 200M |
优先支持从 Premium 套餐起提供,Enterprise 套餐包含专属客户经理和服务等级协议(SLA)。GET /api/account 返回的 quotas_left 对象显示剩余配额。
从哪里开始?
创建账户,从控制台复制令牌,然后在测试网上调用一个只读端点。快速入门介绍了前几次请求,支持的网络页面列出了各链及请求头的取值。
准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 区块链 API 获取完整的 endpoint 参考。