← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Chaingateway V2.1 Beta: тестовые сети и вебхуки

Chaingateway V2.1 beta, выпущена 16 сентября 2024 года: тестовые сети, переписанная система вебхуков, новая панель управления и шаги миграции с V2.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) 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?

Релиз содержал следующие изменения:

  1. Поддержка тестовых сетей в каждом блокчейне.
  2. Tron Paymaster, сервис оплаты комиссий за переводы TRC-20. Сейчас он устарел.
  3. Документация API с примерами запросов и ответов.
  4. Переработанный портал для разработчиков.
  5. Переработанная панель управления.
  6. Мгновенная смена тарифа при оплате картой.
  7. Переписанная система вебхуков и новая обработка комиссий.

Какие тестовые сети поддерживаются?

Добавьте в запрос заголовок X-Network: testnet, чтобы использовать тестовую сеть блокчейна. Для mainnet отправьте X-Network: mainnet или не передавайте заголовок. Всё, что работает в mainnet, работает и в тестовой сети. Сеть также можно переключить в шапке панели управления.

БлокчейнТестовая сеть в V2.1Источник
EthereumSepoliaethereum.org: сети
TronNileTRON developer hub: сети
BNB Smart ChainBSC testnetДокументация BNB Chain
PolygonAmoyДокументация Polygon
BitcoinTestnet3Примеры для разработчиков Bitcoin: тестирование

Актуальный список, в котором также есть Arbitrum Sepolia и Solana devnet, находится в документации поддерживаемых сетей.

Шапка панели управления Chaingateway с баннером «You are in TESTNET mode» и переключателем тестовой сети

Что такое Tron Paymaster?

Paymaster оплачивал комиссии Energy и Bandwidth за переводы TRC-20, поэтому кошельку не нужно было держать TRX. Оплата шла отдельно от подписки, а в тестовой сети была бесплатной. Paymaster устарел. Вместо него используйте TronFuel. Старое руководство по Paymaster сохранено для справки.

Что изменилось в документации и панели управления?

В документации API появилось больше примеров запросов и ответов. В портале для разработчиков появилось новое руководство по началу работы и учебные материалы по основным функциям. Панель управления переработана. Монитор вебхуков позволяет просматривать отправленные данные (payload) и фильтровать их по значению.

Панель управления Chaingateway со счётчиками запросов и транзакций, графиком запросов и списком неудачных вебхуков

Что изменилось в биллинге?

Клиенты, платящие картой через 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?

  1. Измените базовый URL с api.chaingateway.io/v2 на app.chaingateway.io/api/v2.
  2. Необязательно, но рекомендуется: добавьте префикс Bearer к вашему API-ключу, чтобы заголовок выглядел так: Authorization: Bearer <token>.
  3. Протестируйте интеграцию на новом URL.
  4. Пока миграция не завершена полностью, управляйте подпиской в старой панели управления.

Данные пользователей, адреса и API-ключи копировались из V2 в V2.1 каждую минуту на время перехода. Адреса, созданные в V2.1, нельзя использовать в V2. Вебхуки копировались каждые 10 минут и во время копирования не запускали уведомления. Если нужна помощь с миграцией вебхуков, свяжитесь с поддержкой.

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.