Поддерживаемые сети и testnet'ы Chaingateway
Chaingateway поддерживает семь блокчейнов: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum и Solana. У каждого есть mainnet и testnet. Сеть выбирается отдельно для каждого запроса с помощью заголовка X-Network, который принимает значение mainnet или testnet. Нужный блокчейн задаёт сегмент пути в адресе запроса, например /api/v2/tron/....
Какие сети доступны через API?
Заголовок раздела «Какие сети доступны через API?»Все запросы отправляются на https://app.chaingateway.io/api/v2/{chain}/.... Таблица показывает сеть для каждого сочетания блокчейна и значения X-Network.
| Тип сети | Блокчейн | Сеть | Значение заголовка X-Network |
|---|---|---|---|
| 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?
Заголовок раздела «Как переключаться между mainnet и testnet?»Добавьте заголовок X-Network: testnet, чтобы выполнить запрос в тестовой сети. Уберите заголовок или отправьте mainnet, чтобы работать в основной сети. Файл OpenAPI определяет заголовок как необязательный со значением по умолчанию 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'Списки вебхук-уведомлений привязаны к одному блокчейну и одной сети, поэтому при чтении передавайте то же значение X-Network, с которым вы создавали вебхук. Используйте один API-токен для обеих сетей и задавайте заголовок в конфигурации клиента, чтобы тестовая среда случайно не обратилась к mainnet.
Чем различаются блокчейны?
Заголовок раздела «Чем различаются блокчейны?»Семейства эндпоинтов похожи, но у каждого блокчейна своя модель транзакций, поэтому часть параметров отличается. Таблица обобщает то, что определяет файл OpenAPI для каждого блокчейна.
| Блокчейн | Нативная монета в API | Стандарты токенов | Вебхуки | Примечания |
|---|---|---|---|---|
| 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 | нет | да | кошельки содержат адреса, транзакция указывает кошелёк и speed со значением fast, medium или slow |
| Solana | SOL | SPL | нет | приватный ключ передаётся в каждом запросе транзакции |
У Solana нет эндпоинтов для вебхуков. Чтобы обнаружить депозит в Solana, опрашивайте баланс или список транзакций. В сетях EVM и в Tron вместо этого можно создать вебхук.
Как выглядят адреса в каждом блокчейне?
Заголовок раздела «Как выглядят адреса в каждом блокчейне?»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 |
Как проверить, что сеть доступна?
Заголовок раздела «Как проверить, что сеть доступна?»Вызовите GET /api/v2/{chain}/blocks/number для нужного блокчейна и сети. Эндпоинт есть у всех семи блокчейнов и возвращает номер последнего блока. Ответ с ok: true показывает, что токен, путь и заголовок X-Network указаны верно. Ответ 401 с Unauthenticated. указывает на токен, а 404 — на неверный путь. После изменения конфигурации выполните вызов один раз для mainnet и один раз с X-Network: testnet.
Где взять тестовые монеты и обозреватели?
Заголовок раздела «Где взять тестовые монеты и обозреватели?»Тестовые монеты выдают faucet’ы, которые поддерживают сообщества блокчейнов, а не Chaingateway. Документация разработчика каждого блокчейна содержит актуальные faucet’ы, обозреватели и параметры сети. Проверьте эти страницы перед тестированием, потому что testnet’ы время от времени сбрасывают или заменяют.
- Ethereum: обзор сетей с testnet’ами и faucet’ами.
- TRON: документация по сетям для mainnet и testnet Nile.
- BNB Smart Chain: документация для разработчиков и список JSON-RPC-эндпоинтов.
- Polygon: справочник RPC-эндпоинтов для Amoy.
- Arbitrum: информация о сетях для Arbitrum One и Arbitrum Sepolia.
- Bitcoin: руководство по тестированию для testnet и regtest.
- Solana: документация по кластерам для devnet.
Где прочитать подробнее?
Заголовок раздела «Где прочитать подробнее?»Быстрый старт показывает полный первый запрос. Справочник API перечисляет все эндпоинты по блокчейнам, а Управление кошельками объясняет, как в каждой сети обрабатываются адреса и ключи.