Блокчейн-API: что он делает и зачем его использовать
Блокчейн-API позволяет ПО читать данные сетей и отправлять транзакции по HTTPS без собственных нод. Что он покрывает, как работает доступ и где его границы.
Проверил(а) Maurice Sobiera
Блокчейн-API — это веб-интерфейс, который позволяет вашему ПО читать данные блокчейна и отправлять транзакции без запуска ноды. Вы отправляете HTTPS-запросы и получаете JSON вместо того, чтобы работать с нативным протоколом каждой сети. API Chaingateway охватывает Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum и Solana за одной схемой аутентификации.
Зачем блокчейнам нужен слой API?
У каждой сети есть собственный нативный интерфейс, и ни один из них не создан для разработчиков приложений. Нода открывает низкоуровневые методы, сырые кодировки и собственный формат адресов. В таблице показано, с чем разработчик сталкивается без слоя API.
| Семейство сетей | Нативный интерфейс | Что приходится обрабатывать самому |
|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | JSON-RPC на собственной ноде или размещённом эндпоинте | Закодированные в hex величины, декодирование ABI переводов токенов, настройки газа |
| Bitcoin | RPC Bitcoin Core | Работа с UTXO, оценка комиссий, файлы кошельков |
| Tron | интерфейсы ноды java-tron, HTTP и плагины событий | Ресурсы energy и bandwidth, транзакции на основе protobuf |
Слой API приводит всё это к одному стилю запросов. Создание адреса выглядит как POST /api/v2/<chain>/addresses в Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron и Solana. Bitcoin использует кошельки, которые создаются через POST /api/v2/bitcoin/wallets. Переводы токенов следуют одному шаблону в каждой сети, где есть токены. Различия, которые сохраняются, — это реальные различия между сетями, например ресурсы Tron или комиссии Bitcoin. Статья блокчейн-API против ноды подробнее сравнивает оба варианта.
Что можно делать с блокчейн-API?
Можно создавать адреса, отправлять нативные монеты и токены, читать блоки и транзакции и получать уведомления. В справочнике API Chaingateway основные группы такие:
- Адреса: создание (с паролем, который шифрует ключ, или без него), импорт и список адресов
- Транзакции: отправка нативной валюты, токенов ERC20, TRC20, BEP20 и NFT ERC721, а также чтение транзакций
- Данные сети: номер последнего блока и цена газа в EVM-сетях
- Вебхуки: регистрация адреса и URL, после чего приходит POST при появлении подходящей транзакции
- Только для Tron: заморозка и делегирование ресурсов для energy и bandwidth
Не у каждой сети есть каждая группа. У Solana, например, нет вебхуков. В файле OpenAPI точно указано, какие эндпоинты существуют для какой сети.
Как работает аутентификация?
Каждый запрос несёт bearer-токен в заголовке Authorization, как описано в RFC 6750. По умолчанию используется мейннет. Чтобы работать с тестовой сетью, добавьте заголовок X-Network: testnet:
curl https://app.chaingateway.io/api/v2/ethereum/blocks/number \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "X-Network: testnet"Тот же вызов без второго заголовка вернёт последний блок мейннета. Тестовые сети: Sepolia для Ethereum, Nile для Tron, Amoy для Polygon и Devnet для Solana, а также другие. Полный список есть на странице поддерживаемых сетей. Храните токен на своём сервере. Любой, у кого он есть, может пользоваться вашим аккаунтом.
Для каких сценариев подходит блокчейн-API?
Чаще всего это приём платежей, мониторинг депозитов и распределение токенов. Магазин выдаёт каждому заказу собственный адрес и регистрирует для него вебхук. Биржа или сервис кошельков делает то же для депозитов пользователей. Проект, который выплачивает токены многим получателям, отправляет один запрос на перевод каждому. Статья о цепочках поставок описывает платёжный поток со ссылкой на счёт.
В более ранних версиях этой статьи среди возможностей API назывались также децентрализованные приложения, проверка личности и создание смарт-контрактов. API не развёртывает смарт-контракты, а проверка личности в него не входит. Логика dApp живёт в контрактах, которые вы развёртываете другими инструментами. API — это способ, которым ваш сервер взаимодействует с сетью вокруг них.
Как выглядит интеграция?
Интеграция платежей состоит из пяти шагов, и каждый выполняется одним запросом:
- Создайте адрес для заказа или пользователя:
POST /api/v2/ethereum/addressesсpassword. В ответе находится новый адрес. - Зарегистрируйте вебхук для этого адреса через
POST /api/v2/ethereum/webhooks, указав URL получателя вurl. - Покажите адрес плательщику.
- Ваш получатель получает POST с ID транзакции, отправителем, получателем, номером блока и типом. Он отвечает кодом успеха.
- Отправьте средства дальше через
POST /api/v2/ethereum/transactionsили.../transactions/erc20для токена.
Сначала протестируйте все пять шагов с X-Network: testnet. У монет тестовой сети нет стоимости, поэтому ошибка ничего не стоит.
Что блокчейн-API не делает?
Он не меняет работу сети. Ограничения, которые нужно учесть:
- Транзакция всё ещё может не пройти, например из-за нехватки газа. Время подтверждения задаёт сеть, а не API.
- Вебхуки не повторяются автоматически. Неудачные уведомления выводятся списком, и вы запрашиваете их повторную отправку.
- С ключами нужна осторожность. Кошелёк, созданный без пароля, возвращает приватный ключ в ответе. С паролем ключ хранится на стороне Chaingateway в зашифрованном виде. Chaingateway не хранит пароль, поэтому при его утрате кошелёк восстановить нельзя.
- Провайдер остаётся зависимостью. Ведите собственный учёт каждого ID транзакции, который вы создаёте.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.