支持的区块链网络与测试网
Chaingateway 支持七条区块链:Ethereum、TRON、BNB Smart Chain、Bitcoin、Polygon、Arbitrum 和 Solana。每条链都有 mainnet 和 testnet。你通过 X-Network header 为每个请求选择网络,它的取值为 mainnet 或 testnet,而路径段用来选择链,例如 /api/v2/tron/...。
通过 API 可以访问哪些网络?
Section titled “通过 API 可以访问哪些网络?”所有请求都发往 https://app.chaingateway.io/api/v2/{chain}/...。下表列出了每种链与 X-Network 取值组合所对应的网络。
| 网络类型 | 区块链 | 网络 | X-Network Header 值 |
|---|---|---|---|
| Mainnet | Ethereum | mainnet | mainnet |
| Testnet | Ethereum | sepolia | testnet |
| Mainnet | Tron | mainnet | mainnet |
| Testnet | Tron | nile | testnet |
| Mainnet | Binance Smart Chain | mainnet | mainnet |
| Testnet | Binance Smart Chain | testnet | testnet |
| Mainnet | Bitcoin | mainnet | mainnet |
| Testnet | Bitcoin | testnet3 | testnet |
| Mainnet | Polygon | mainnet | mainnet |
| Testnet | Polygon | amoy | testnet |
| Mainnet | Arbitrum | mainnet | mainnet |
| Testnet | Arbitrum | arbitrum sepolia | testnet |
| Mainnet | Solana | mainnet | mainnet |
| Testnet | Solana | devnet | testnet |
如何在 mainnet 和 testnet 之间切换?
Section titled “如何在 mainnet 和 testnet 之间切换?”添加 header X-Network: testnet,请求就会在测试网络上运行。删除该 header 或发送 mainnet,则使用主网络。OpenAPI 文件把该 header 定义为可选,默认值为 mainnet,所以没有它的请求会在主网络上运行。下面的调用读取 Ethereum Sepolia 的最新区块。
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。
各条链之间有什么区别?
Section titled “各条链之间有什么区别?”各类端点相似,但每条链都有自己的交易模型,所以部分参数不同。下表概括了 OpenAPI 文件对每条链的定义。
| 区块链 | API 中的原生币 | 代币标准 | Webhook | 备注 |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | 有 | gasprice,以及 NFT 所有者和 URI 查询 |
| Binance Smart Chain | BNB | BEP20, BEP721 | 有 | 端点集合与 Ethereum 相同,位于 /bsc 之下 |
| Polygon | MATIC | ERC20, ERC721 | 有 | 端点集合与 Ethereum 相同,位于 /polygon 之下 |
| Arbitrum | ETH | ERC20, ERC721 | 有 | 端点集合与 Ethereum 相同,位于 /arbitrum 之下 |
| Tron | TRX | TRC10, TRC20, TRC721 | 有 | 质押、资源委托,以及自签名交易的构建与广播 |
| Bitcoin | BTC | 无 | 有 | 钱包包含地址,交易需指明钱包以及 fast、medium 或 slow 之一的 speed |
| Solana | SOL | SPL | 无 | 每个交易请求都要携带私钥 |
Solana 没有 Webhook 端点。要发现 Solana 上的充值,请轮询余额或列出交易。在 EVM 链和 Tron 上,你可以改为创建 Webhook。
各条链的地址是什么格式?
Section titled “各条链的地址是什么格式?”API 在处理请求之前会校验每个地址的格式。格式有误时,它会返回状态码 422,并在 errors 中给出字段名。下面的格式是 OpenAPI 文件定义的模式。
| 区块链 | 地址格式 |
|---|---|
| Ethereum、BNB Smart Chain、Polygon、Arbitrum | 0x 后跟 40 个十六进制字符 |
| Tron | T 后跟 33 个字母数字字符 |
| Bitcoin | 以 bc1、tb1、1 或 3 开头,后跟 25 到 39 个字符 |
| Solana | 32 到 44 个 base58 字符 |
如何确认某个网络可以访问?
Section titled “如何确认某个网络可以访问?”针对你想测试的链和网络,调用 GET /api/v2/{chain}/blocks/number。该端点适用于全部七条链,并返回最新区块号。响应为 ok: true,说明你的令牌、路径和 X-Network header 都正确。401 响应并带有 Unauthenticated.,说明问题出在令牌上;404 则说明路径有误。修改配置后,请对 mainnet 调用一次,再带上 X-Network: testnet 调用一次。
在哪里获取测试币和区块浏览器?
Section titled “在哪里获取测试币和区块浏览器?”测试币来自各条链社区运营的水龙头,而不是 Chaingateway。每条链的开发者文档都列出了当前的水龙头、区块浏览器和网络参数。测试前请先查看这些页面,因为测试网会不时被重置或替换。
- Ethereum:网络概览,包含测试网和水龙头。
- TRON:网络文档,涵盖主网和 Nile 测试网。
- BNB Smart Chain:开发者文档和 JSON-RPC 端点列表。
- Polygon:Amoy 的 RPC 端点参考。
- Arbitrum:Arbitrum One 和 Arbitrum Sepolia 的链信息。
- Bitcoin:testnet 和 regtest 的测试指南。
- Solana:devnet 的集群文档。