跳转到内容

支持的区块链网络与测试网

Chaingateway 支持七条区块链:Ethereum、TRON、BNB Smart Chain、Bitcoin、Polygon、Arbitrum 和 Solana。每条链都有 mainnet 和 testnet。你通过 X-Network header 为每个请求选择网络,它的取值为 mainnet 或 testnet,而路径段用来选择链,例如 /api/v2/tron/...。

网络选择:路径段决定区块链,X-Network header 决定 mainnet 还是 testnet 发往 /api/v2/{chain}/... 的请求 chain:ethereum、tron、bsc、bitcoin、polygon、arbitrum 或 solana X-Network header testnet,或 mainnet(缺少该 header 时的默认值) 网络作出响应 例如 Ethereum Sepolia 或 Ethereum mainnet
两个输入共同决定网络:路径和 header。

所有请求都发往 https://app.chaingateway.io/api/v2/{chain}/...。下表列出了每种链与 X-Network 取值组合所对应的网络。

网络类型区块链网络X-Network Header 值
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

如何在 mainnet 和 testnet 之间切换?

Section titled “如何在 mainnet 和 testnet 之间切换?”

添加 header X-Network: testnet,请求就会在测试网络上运行。删除该 header 或发送 mainnet,则使用主网络。OpenAPI 文件把该 header 定义为可选,默认值为 mainnet,所以没有它的请求会在主网络上运行。下面的调用读取 Ethereum Sepolia 的最新区块。

Terminal window
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'X-Network: testnet'

Webhook 通知列表的范围限定在一条区块链和一个网络上。因此读取它们时,请发送与创建 Webhook 时相同的 X-Network 值。两个网络可以共用一个 API 令牌,并在客户端配置中设置该 header,这样测试环境就不会意外访问 mainnet。

各类端点相似,但每条链都有自己的交易模型,所以部分参数不同。下表概括了 OpenAPI 文件对每条链的定义。

区块链API 中的原生币代币标准Webhook备注
EthereumETHERC20, ERC721有gasprice,以及 NFT 所有者和 URI 查询
Binance Smart ChainBNBBEP20, BEP721有端点集合与 Ethereum 相同,位于 /bsc 之下
PolygonMATICERC20, ERC721有端点集合与 Ethereum 相同,位于 /polygon 之下
ArbitrumETHERC20, ERC721有端点集合与 Ethereum 相同,位于 /arbitrum 之下
TronTRXTRC10, TRC20, TRC721有质押、资源委托,以及自签名交易的构建与广播
BitcoinBTC无有钱包包含地址,交易需指明钱包以及 fast、medium 或 slow 之一的 speed
SolanaSOLSPL无每个交易请求都要携带私钥

Solana 没有 Webhook 端点。要发现 Solana 上的充值,请轮询余额或列出交易。在 EVM 链和 Tron 上,你可以改为创建 Webhook。

API 在处理请求之前会校验每个地址的格式。格式有误时,它会返回状态码 422,并在 errors 中给出字段名。下面的格式是 OpenAPI 文件定义的模式。

区块链地址格式
Ethereum、BNB Smart Chain、Polygon、Arbitrum0x 后跟 40 个十六进制字符
TronT 后跟 33 个字母数字字符
Bitcoin以 bc1、tb1、1 或 3 开头,后跟 25 到 39 个字符
Solana32 到 44 个 base58 字符

针对你想测试的链和网络,调用 GET /api/v2/{chain}/blocks/number。该端点适用于全部七条链,并返回最新区块号。响应为 ok: true,说明你的令牌、路径和 X-Network header 都正确。401 响应并带有 Unauthenticated.,说明问题出在令牌上;404 则说明路径有误。修改配置后,请对 mainnet 调用一次,再带上 X-Network: testnet 调用一次。

在哪里获取测试币和区块浏览器?

Section titled “在哪里获取测试币和区块浏览器?”

测试币来自各条链社区运营的水龙头,而不是 Chaingateway。每条链的开发者文档都列出了当前的水龙头、区块浏览器和网络参数。测试前请先查看这些页面,因为测试网会不时被重置或替换。

快速入门展示了完整的第一个请求。API 参考文档按链列出了每个端点,钱包管理则说明了各个网络上如何处理地址和密钥。