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

Интеграция нескольких блокчейнов через REST API

Как подключить несколько блокчейнов через один REST API: сети, эндпоинты токенов для каждой цепочки, поток депозитов и выводов и различия, которые сохраняются.

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

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

Интеграция нескольких блокчейнов означает, что один бэкенд работает с несколькими сетями через единый интерфейс, а не через отдельную библиотеку для каждой сети. В Chaingateway вы вызываете REST-эндпоинты с bearer-токеном. Тот же подход работает для Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron, Bitcoin и Solana в пределах ограничений, которые задаёт каждая сеть.

Какие блокчейны и стандарты токенов поддерживает API?

API охватывает семь сетей, и у каждой есть тестовая сеть. Чтобы переключиться на тестовую сеть, передайте заголовок X-Network: testnet. На странице поддерживаемых сетей перечислены тестовые сети. Для переводов токенов есть отдельный эндпоинт для каждой сети:

СетьЭндпоинты токенов и NFT в файле OpenAPIТестовая сеть
Ethereumtransactions/erc20, transactions/erc721Sepolia
BNB Smart Chaintransactions/bep20, transactions/bep721BSC testnet
Polygontransactions/erc20, transactions/erc721Amoy
Arbitrumtransactions/erc20, transactions/erc721Arbitrum Sepolia
Trontransactions/trc20, transactions/trc721, transactions/trc10Nile
Solanatransactions/SPLDevnet
Bitcointransactions (только нативная монета)Testnet3

Каждый путь начинается с /api/v2/<chain>/. Полный список находится в файле OpenAPI.

Как построить на нём сервис депозитов и выводов?

Поток по типу кастодиального сервиса состоит из трёх частей: адрес для каждого клиента, вебхук для каждого адреса и вызов вывода. Каждая часть выполняется одним запросом, и в каждой сети, которая её поддерживает, она выглядит одинаково.

  1. Создайте адрес для депозита. В EVM-сетях и Tron это POST /api/v2/<chain>/addresses, а в ответе находится адрес. Передайте password, чтобы ключ хранился в зашифрованном виде. Без пароля ответ содержит приватный ключ, и его придётся хранить самостоятельно.
  2. Зарегистрируйте вебхук для адреса. POST /api/v2/<chain>/webhooks принимает url получателя, адрес в поле to, type вида ERC20 или TRC20 и, по желанию, contractaddress и reference длиной до 255 символов.
  3. Выполните выплату. Вывод токена ERC20 — это один запрос:
Terminal window
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": "0xHotWalletAddress",
"to": "0xCustomerAddress",
"contractaddress": "0xTokenContract",
"amount": 100,
"password": "hot-wallet-password"
}'

В BNB Smart Chain замените ethereum/transactions/erc20 на bsc/transactions/bep20. В Tron используйте tron/transactions/trc20: он принимает те же поля, кроме настроек газа. Solana устроена иначе: solana/transactions/SPL требует privatekey отправителя и не принимает пароль кошелька. Статья о персональных секретах объясняет, как проверять получаемые уведомления.

Что происходит, когда запрос не проходит?

API возвращает JSON с полями status, ok и message. Ответ 401 с сообщением «Wrong password provided» означает, что пароль кошелька не совпадает. Ответ 422 содержит собственную ошибку ноды, например insufficient funds for gas * price + value. Причина зависит от сети: перевод ERC20 в Ethereum требует ETH на адресе отправителя для газа, а перевод TRC20 требует energy и bandwidth или TRX для их оплаты. Проверьте балансы перед повтором, потому что повтор не устраняет нехватку комиссии.

Неудачные уведомления вебхуков не отправляются повторно автоматически. Получите их списком через GET /api/v2/<chain>/webhooks/notifications/failed и отправьте каждое заново через эндпоинт повтора. Повторное уведомление может прийти позже других, поэтому сделайте обработчик идемпотентным по txid.

Что остаётся различным между сетями?

Несколько вещей остаются различными, и API их не скрывает:

  • Комиссии: Ethereum, BNB Smart Chain, Polygon и Arbitrum используют газ, для каждой есть эндпоинт gasprice. Tron использует energy и bandwidth.
  • Вебхуки: поддерживаются во всех сетях, кроме Solana.
  • Кошельки: в Bitcoin работают именованные кошельки, в которых хранится несколько адресов. Они создаются через POST /api/v2/bitcoin/wallets.
  • Активы: один и тот же токен в двух сетях — это два разных актива, и API не выполняет между ними мост.

С какой сети начать?

Начните с той сети, которую уже используют ваши клиенты, а остальные добавьте, переиспользуя те же обработчики. В формах вывода бирж указана сеть, например ERC-20, BEP-20 или TRC-20. Прежде чем строить вторую интеграцию, спросите первых клиентов, в какой сети они хранят USDT.

Что сохранять для каждой сети?

Сервису с несколькими сетями нужна сеть в каждой записи, потому что одна и та же строка может быть валидной в нескольких сетях. Храните как минимум эти поля:

ПолеЗачем оно нужно
chain и networkАдреса 0x валидны в Ethereum, BNB Smart Chain, Polygon и Arbitrum, а мейннет и тестнет выглядят одинаково
address в формате сетиАдреса Tron в Base58 начинаются с T, а шестнадцатеричная запись с префиксом 41 встречается в сырых данных ноды
contractaddress и typeУ одного и того же токена в каждой сети свой контракт
txidКлюч для дедупликации уведомлений вебхуков и для поиска
referenceВаш номер заказа или клиента, задаётся при регистрации вебхука
Сумма в базовой единице сетиКоличество десятичных знаков различается у токенов, поэтому переводите значения только на уровне отображения

Добавьте уникальное ограничение на (chain, network, txid). Сверяйте данные по расписанию со вторым источником, например со списком неудачных уведомлений и обозревателем блоков.

Как начать?

Начните с тестовых сетей. Создайте адрес в Sepolia и один в Nile, зарегистрируйте вебхук для каждого, отправьте тестовый перевод и проверьте, что ваш обработчик принимает оба уведомления. Бесплатный пробный период на 7 дней не требует карты и KYC.

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

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

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

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