Блокчейн-API для бизнеса: что он охватывает
Что входит в Chaingateway blockchain API: семь сетей, тестовые сети, подписанные вебхуки, кошельки с паролем и тарифы от 49 € в месяц.
Проверил(а) Maurice Sobiera
Блокчейн-API для бизнеса — веб-сервис, который позволяет компании создавать кошельки, отправлять и получать криптовалюту и читать данные блокчейна через HTTPS-запросы, без собственных нод. Chaingateway — один из таких API. Он охватывает семь блокчейнов, поддерживает тестовые сети во всех из них и отправляет подписанные вебхуки о депозитах для шести.
В этой статье перечислено, что охватывает API, где его ограничения и сколько он стоит.
Какие блокчейны поддерживает Chaingateway?
Chaingateway поддерживает Bitcoin, Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron и Solana. Все блокчейны используют одну аутентификацию, один заголовок X-Network и один формат ответа. Различаются только форматы адресов и стандарты токенов.
| Блокчейн | Стандарты токенов | Вебхуки |
|---|---|---|
| Bitcoin | нет, только собственный BTC | да |
| Ethereum | ERC-20, ERC-721 | да |
| BNB Smart Chain | BEP-20, BEP-721 | да |
| Polygon | ERC-20, ERC-721 | да |
| Arbitrum | ERC-20, ERC-721 | да |
| Tron | TRC-10, TRC-20, TRC-721 | да |
| Solana | токены SPL | нет |
Таблица составлена по определению OpenAPI. У Solana нет вебхуков, поэтому интеграция с Solana должна опрашивать сеть на входящие переводы.
Один API не убирает различия между сетями. Комиссии, время подтверждения и правила финальности отличаются у каждой сети, и ваш код всё равно должен с ними справляться. Сравнение двух сетей см. в статье Solana и Tron.
Можно ли тестировать без реальных средств?
Да. Добавьте в запрос заголовок X-Network: testnet, и он выполнится в тестовой сети блокчейна. Без заголовка запрос уходит в mainnet. Блокчейнам соответствуют такие тестовые сети:
| Блокчейн | Тестовая сеть |
|---|---|
| Ethereum | Sepolia |
| Tron | Nile |
| BNB Smart Chain | BSC testnet |
| Bitcoin | Testnet3 |
| Polygon | Amoy |
| Arbitrum | Arbitrum Sepolia |
| Solana | Devnet |
Монеты тестовых сетей ничего не стоят, поэтому полный цикл приёма и выплаты можно прогнать без трат. Тестовые сети отличаются от mainnet нагрузкой и комиссиями. Поэтому успешный прогон в тестовой сети не доказывает, что настройки комиссий будут работать в mainnet. В документации Ethereum по сетям объясняется, что такое тестовые сети и как получить тестовые монеты.
Как работают уведомления о депозитах?
Вы создаёте вебхук с callback-URL и фильтром, например с адресом получения или контрактом токена. Когда найдена подходящая транзакция, Chaingateway отправляет HTTP-запрос POST на ваш URL с данными транзакции. Это заменяет опрос цепочки.
В продакшене важны две детали:
- Подпись: как только вы задали личный секрет в профиле, каждый вебхук несёт заголовок
X-Signature. Это HMAC (RFC 2104), построенный по ID транзакции и вашему секрету. Проверяйте его, прежде чем доверять данным. В руководстве по подписи есть код для Python, Java, PHP и JavaScript. - Повторы: вебхуки не повторяются автоматически. Неудачные уведомления перечислены в
/webhooks/notifications/failedкаждой сети, и вы повторно отправляете их через эндпоинт повтора.
Сделайте свой эндпоинт идемпотентным, чтобы уведомление, полученное дважды, зачисляло средства на аккаунт только один раз.
Как защищены приватные ключи?
Chaingateway работает по модели non-custodial. При создании адреса можно задать пароль. Приватный ключ хранится зашифрованным этим паролем, а с каждой транзакцией вы отправляете пароль, а не ключ. Chaingateway не хранит пароли и не может восстановить кошелёк, если вы потеряете пароль. Кроме того, можно импортировать существующий приватный ключ и подписывать транзакции на своей стороне.
Кошельки с паролем — удобство, но не замена управлению ключами. Если пароли хранятся на вашем бэкенде, злоумышленник, взломавший бэкенд, может тратить средства с этих кошельков. Храните пароли в менеджере секретов и ограничивайте сумму, которая лежит в кошельках, открываемых вашим бэкендом.
Сколько это стоит?
Тарифы начинаются с 49 € в месяц или 490 € в год за Plus. Pro стоит 99 € в месяц, Premium — 249 €, Enterprise — 499 €. Каждый тариф начинается с 7-дневного бесплатного пробного периода, который не требует карты и KYC. Актуальные цены и лимиты указаны на странице тарифов.
Каковы лимиты каждого тарифа?
Каждый тариф задаёт месячные лимиты. Значения ниже указаны на странице тарифов на момент написания. Актуальные цифры смотрите на странице.
| Тариф | Цена в месяц | Транзакций в месяц | Кошельков | Вебхуков | Запросов |
|---|---|---|---|---|---|
| Plus | 49 € | 500 | 750 | 375 | 50 тыс. |
| Pro | 99 € | 2 000 | 3 000 | 1 500 | 200 тыс. |
| Premium | 249 € | 20 000 | 30 000 | 7 500 | 2 млн |
| Enterprise | 499 € | 100 000 | 100 000 | 25 000 | 200 млн |
Приоритетная поддержка начинается с Premium. Персональный менеджер аккаунта и соглашение об уровне сервиса (SLA) входят в Enterprise. Объект quotas_left в ответе GET /api/account показывает, сколько квоты осталось.
С чего начать?
Создайте аккаунт, скопируйте токен из панели управления и вызовите один эндпоинт чтения в тестовой сети. Быстрый старт проведёт через первые запросы. На странице поддерживаемых сетей перечислены блокчейны и значения заголовков.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.