Chaingateway V2.1 Beta: тестовые сети и вебхуки
Chaingateway V2.1 beta, выпущена 16 сентября 2024 года: тестовые сети, переписанная система вебхуков, новая панель управления и шаги миграции с V2.
Проверил(а) Maurice Sobiera
Chaingateway V2.1 — переработка API и панели управления Chaingateway 2024 года. Она добавила поддержку тестовых сетей через заголовок X-Network, переписанную систему вебхуков и новый интерфейс. Базовый URL API сменился с api.chaingateway.io/v2 на app.chaingateway.io/api/v2. В этой заметке перечислены изменения и шаги миграции из объявления бета-версии от 16 сентября 2024 года.
Обновление, 5 ноября 2026 года: V2.1 — текущая версия API. С момента релиза добавлены Solana и Arbitrum (у Solana нет вебхуков), Tron Paymaster, описанный ниже, объявлен устаревшим, а криптоплатежи за тарифы изменились в апреле 2025 года (см. Новый процесс оплаты). Список эндпоинтов находится в файле OpenAPI.
Как получить доступ к V2.1?
V2.1 доступна всем клиентам и пользователям пробного периода на app.chaingateway.io. Она спроектирована совместимой с V2, поэтому большинству интеграций нужен только новый базовый URL. Шаги миграции находятся в конце этой заметки.
Если пробный период закончился, создайте аккаунт или свяжитесь с нами, чтобы продлить его. У беты также было сообщество в Telegram.
Что нового в V2.1?
Релиз содержал следующие изменения:
- Поддержка тестовых сетей в каждом блокчейне.
- Tron Paymaster, сервис оплаты комиссий за переводы TRC-20. Сейчас он устарел.
- Документация API с примерами запросов и ответов.
- Переработанный портал для разработчиков.
- Переработанная панель управления.
- Мгновенная смена тарифа при оплате картой.
- Переписанная система вебхуков и новая обработка комиссий.
Какие тестовые сети поддерживаются?
Добавьте в запрос заголовок X-Network: testnet, чтобы использовать тестовую сеть блокчейна. Для mainnet отправьте X-Network: mainnet или не передавайте заголовок. Всё, что работает в mainnet, работает и в тестовой сети. Сеть также можно переключить в шапке панели управления.
| Блокчейн | Тестовая сеть в V2.1 | Источник |
|---|---|---|
| Ethereum | Sepolia | ethereum.org: сети |
| Tron | Nile | TRON developer hub: сети |
| BNB Smart Chain | BSC testnet | Документация BNB Chain |
| Polygon | Amoy | Документация Polygon |
| Bitcoin | Testnet3 | Примеры для разработчиков Bitcoin: тестирование |
Актуальный список, в котором также есть Arbitrum Sepolia и Solana devnet, находится в документации поддерживаемых сетей.

Что такое Tron Paymaster?
Paymaster оплачивал комиссии Energy и Bandwidth за переводы TRC-20, поэтому кошельку не нужно было держать TRX. Оплата шла отдельно от подписки, а в тестовой сети была бесплатной. Paymaster устарел. Вместо него используйте TronFuel. Старое руководство по Paymaster сохранено для справки.
Что изменилось в документации и панели управления?
В документации API появилось больше примеров запросов и ответов. В портале для разработчиков появилось новое руководство по началу работы и учебные материалы по основным функциям. Панель управления переработана. Монитор вебхуков позволяет просматривать отправленные данные (payload) и фильтровать их по значению.

Что изменилось в биллинге?
Клиенты, платящие картой через Stripe, могут сразу перейти на более дорогой тариф, не дожидаясь следующего платёжного цикла. Если вы исчерпали лимиты API, нажмите «Change Plan» на странице биллинга, и лимиты сразу вырастут. В счёте указана только разница в цене между старым и новым тарифом. В объявлении говорилось, что то же самое будет и для криптоплатежей. Они появились вместе с процессом оплаты апреля 2025 года.
Что изменилось технически?
API работает на новом технологическом стеке. В объявлении отмечалось, что некоторые ответы могут немного отличаться от V2. Пользователей попросили сообщать о таких различиях в поддержку.
Обработка комиссий переработана. Если ваши запросы передают gasPrice, maxFeePerGas или maxPriorityFeePerGas, в V2.1 их больше не нужно отправлять. Поля gas остаются необязательными в текущем OpenAPI-описании.
Система вебхуков переписана после сбоев сервиса вебхуков в недели перед релизом. Из-за них часть блоков не обрабатывалась. Монитор вебхуков в панели управления показывает отправленные данные. Вебхуки не повторяются автоматически. Неудачные уведомления перечислены по каждой сети, например в GET /api/v2/tron/webhooks/notifications/failed, и вы повторно отправляете их через эндпоинт повторной отправки.
Что планировалось после V2.1?
В объявлении назвали три следующих шага: поддержку Solana, Paymaster для большего числа сетей и исправления ответов API. Поддержка Solana уже выпущена. Paymaster не расширили, а объявили устаревшим.
Как перейти с V2 на V2.1?
- Измените базовый URL с
api.chaingateway.io/v2наapp.chaingateway.io/api/v2. - Необязательно, но рекомендуется: добавьте префикс
Bearerк вашему API-ключу, чтобы заголовок выглядел так:Authorization: Bearer <token>. - Протестируйте интеграцию на новом URL.
- Пока миграция не завершена полностью, управляйте подпиской в старой панели управления.
Данные пользователей, адреса и API-ключи копировались из V2 в V2.1 каждую минуту на время перехода. Адреса, созданные в V2.1, нельзя использовать в V2. Вебхуки копировались каждые 10 минут и во время копирования не запускали уведомления. Если нужна помощь с миграцией вебхуков, свяжитесь с поддержкой.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.