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

Блокчейн-API: что он делает и зачем его использовать

Блокчейн-API позволяет ПО читать данные сетей и отправлять транзакции по HTTPS без собственных нод. Что он покрывает, как работает доступ и где его границы.

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

Проверил(а) Maurice Sobiera

Блокчейн-API — это веб-интерфейс, который позволяет вашему ПО читать данные блокчейна и отправлять транзакции без запуска ноды. Вы отправляете HTTPS-запросы и получаете JSON вместо того, чтобы работать с нативным протоколом каждой сети. API Chaingateway охватывает Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum и Solana за одной схемой аутентификации.

Зачем блокчейнам нужен слой API?

У каждой сети есть собственный нативный интерфейс, и ни один из них не создан для разработчиков приложений. Нода открывает низкоуровневые методы, сырые кодировки и собственный формат адресов. В таблице показано, с чем разработчик сталкивается без слоя API.

Семейство сетейНативный интерфейсЧто приходится обрабатывать самому
Ethereum, BNB Smart Chain, Polygon, ArbitrumJSON-RPC на собственной ноде или размещённом эндпоинтеЗакодированные в hex величины, декодирование ABI переводов токенов, настройки газа
BitcoinRPC 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:

Terminal window
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 — это способ, которым ваш сервер взаимодействует с сетью вокруг них.

Как выглядит интеграция?

Интеграция платежей состоит из пяти шагов, и каждый выполняется одним запросом:

  1. Создайте адрес для заказа или пользователя: POST /api/v2/ethereum/addresses с password. В ответе находится новый адрес.
  2. Зарегистрируйте вебхук для этого адреса через POST /api/v2/ethereum/webhooks, указав URL получателя в url.
  3. Покажите адрес плательщику.
  4. Ваш получатель получает POST с ID транзакции, отправителем, получателем, номером блока и типом. Он отвечает кодом успеха.
  5. Отправьте средства дальше через POST /api/v2/ethereum/transactions или .../transactions/erc20 для токена.

Сначала протестируйте все пять шагов с X-Network: testnet. У монет тестовой сети нет стоимости, поэтому ошибка ничего не стоит.

Что блокчейн-API не делает?

Он не меняет работу сети. Ограничения, которые нужно учесть:

  • Транзакция всё ещё может не пройти, например из-за нехватки газа. Время подтверждения задаёт сеть, а не API.
  • Вебхуки не повторяются автоматически. Неудачные уведомления выводятся списком, и вы запрашиваете их повторную отправку.
  • С ключами нужна осторожность. Кошелёк, созданный без пароля, возвращает приватный ключ в ответе. С паролем ключ хранится на стороне Chaingateway в зашифрованном виде. Chaingateway не хранит пароль, поэтому при его утрате кошелёк восстановить нельзя.
  • Провайдер остаётся зависимостью. Ведите собственный учёт каждого ID транзакции, который вы создаёте.

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

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

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

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