Перейти к содержимому

Поддерживаемые сети и testnet'ы Chaingateway

Chaingateway поддерживает семь блокчейнов: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum и Solana. У каждого есть mainnet и testnet. Сеть выбирается отдельно для каждого запроса с помощью заголовка X-Network, который принимает значение mainnet или testnet. Нужный блокчейн задаёт сегмент пути в адресе запроса, например /api/v2/tron/....

Выбор сети: сегмент пути выбирает блокчейн, заголовок X-Network выбирает mainnet или testnet Запрос к /api/v2/{chain}/... chain: ethereum, tron, bsc, bitcoin, polygon,arbitrum или solana Заголовок X-Network testnet или mainnet (по умолчанию, еслизаголовка нет) Отвечает сеть например Ethereum Sepolia или Ethereum mainnet
Сеть выбирают два параметра: путь и заголовок.

Все запросы отправляются на https://app.chaingateway.io/api/v2/{chain}/.... Таблица показывает сеть для каждого сочетания блокчейна и значения X-Network.

Тип сетиБлокчейнСетьЗначение заголовка X-Network
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

Добавьте заголовок 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Стандарты токеновВебхукиПримечания
EthereumETHERC20, ERC721даgasprice и поиск владельцев NFT и URI
Binance Smart ChainBNBBEP20, BEP721датот же набор эндпоинтов, что у Ethereum, под /bsc
PolygonMATICERC20, ERC721датот же набор эндпоинтов, что у Ethereum, под /polygon
ArbitrumETHERC20, ERC721датот же набор эндпоинтов, что у Ethereum, под /arbitrum
TronTRXTRC10, TRC20, TRC721дастейкинг, делегирование ресурсов, сборка и отправка самостоятельно подписанных транзакций
BitcoinBTCнетдакошельки содержат адреса, транзакция указывает кошелёк и speed со значением fast, medium или slow
SolanaSOLSPLнетприватный ключ передаётся в каждом запросе транзакции

У Solana нет эндпоинтов для вебхуков. Чтобы обнаружить депозит в Solana, опрашивайте баланс или список транзакций. В сетях EVM и в Tron вместо этого можно создать вебхук.

API проверяет формат каждого адреса до обработки запроса и при неверном формате отвечает статусом 422 с именем поля в errors. Ниже приведены форматы, которые определяет файл OpenAPI.

БлокчейнФормат адреса
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x и 40 шестнадцатеричных символов
TronT и 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’ы время от времени сбрасывают или заменяют.

Быстрый старт показывает полный первый запрос. Справочник API перечисляет все эндпоинты по блокчейнам, а Управление кошельками объясняет, как в каждой сети обрабатываются адреса и ключи.