← 博客
10 分钟阅读
|
发布于
|
更新于

企业区块链 API:涵盖哪些内容、限制与价格

Chaingateway 区块链 API 涵盖的内容:七条链、测试网、签名 Webhook、密码保护钱包,以及每月 49 欧元起的套餐。文章同时列出各套餐的限制、Webhook 的签名与重试方式、私钥保护方式和起步步骤。

章节
C
Chaingateway Team
区块链专家

审核: Maurice Sobiera

企业区块链 API 是一种网络服务,让公司无需运行节点,即可通过 HTTPS 请求创建钱包、收发加密货币并读取链上数据。Chaingateway 就是这样一种 API。它覆盖七条区块链,所有链都支持测试网,其中六条链会为充值发送已签名的 Webhook。

本文列出该 API 涵盖的内容、它的限制以及费用。

Chaingateway 支持哪些区块链?

Chaingateway 支持 Bitcoin、Ethereum、BNB Smart Chain、Polygon、Arbitrum、Tron 和 Solana。所有链使用相同的身份验证、相同的 X-Network 请求头和相同的响应格式。只有地址格式和代币标准有所不同。

链代币标准Webhook
Bitcoin无,仅原生 BTC是
EthereumERC-20、ERC-721是
BNB Smart ChainBEP-20、BEP-721是
PolygonERC-20、ERC-721是
ArbitrumERC-20、ERC-721是
TronTRC-10、TRC-20、TRC-721是
SolanaSPL 代币否

该表依据 OpenAPI 定义整理。Solana 不支持 Webhook,因此 Solana 集成必须轮询到账转账。

单一 API 并不能消除各链之间的差异。手续费、确认时间和最终性规则因链而异,你的代码仍需处理这些差异。关于两条链的对比,见 Solana 与 Tron 对比。

能否不使用真实资金进行测试?

可以。在请求中添加请求头 X-Network: testnet,即可在该链的测试网上运行。不带该请求头的请求会发送到主网。各链对应的测试网如下:

链测试网
EthereumSepolia
TronNile
BNB Smart ChainBSC testnet
BitcoinTestnet3
PolygonAmoy
ArbitrumArbitrum Sepolia
SolanaDevnet

测试网代币没有价值,因此无需花钱即可完整运行一次充值和付款周期。测试网在负载和手续费方面与主网不同,因此测试网上通过并不能证明手续费设置在主网上同样有效。以太坊关于网络的文档解释了什么是测试网,以及如何获取测试币。

充值通知如何工作?

你需要创建一个 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 数请求数
Plus49 欧元50075037550k
Pro99 欧元2,0003,0001,500200k
Premium249 欧元20,00030,0007,5002M
Enterprise499 欧元100,000100,00025,000200M

优先支持从 Premium 套餐起提供,Enterprise 套餐包含专属客户经理和服务等级协议(SLA)。GET /api/account 返回的 quotas_left 对象显示剩余配额。

从哪里开始?

创建账户,从控制台复制令牌,然后在测试网上调用一个只读端点。快速入门介绍了前几次请求,支持的网络页面列出了各链及请求头的取值。

我们如何撰写这些文章

准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 区块链 API 获取完整的 endpoint 参考。

C
Chaingateway Team
区块链专家

Chaingateway 团队致力于为全球开发者简化区块链集成。