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

Блокчейн-API для бизнеса: что он охватывает

Что входит в Chaingateway blockchain API: семь сетей, тестовые сети, подписанные вебхуки, кошельки с паролем и тарифы от 49 € в месяц.

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

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

Блокчейн-API для бизнеса — веб-сервис, который позволяет компании создавать кошельки, отправлять и получать криптовалюту и читать данные блокчейна через HTTPS-запросы, без собственных нод. Chaingateway — один из таких API. Он охватывает семь блокчейнов, поддерживает тестовые сети во всех из них и отправляет подписанные вебхуки о депозитах для шести.

В этой статье перечислено, что охватывает API, где его ограничения и сколько он стоит.

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

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

БлокчейнСтандарты токеновВебхуки
Bitcoinнет, только собственный BTCда
EthereumERC-20, ERC-721да
BNB Smart ChainBEP-20, BEP-721да
PolygonERC-20, ERC-721да
ArbitrumERC-20, ERC-721да
TronTRC-10, TRC-20, TRC-721да
Solanaтокены SPLнет

Таблица составлена по определению OpenAPI. У Solana нет вебхуков, поэтому интеграция с Solana должна опрашивать сеть на входящие переводы.

Один API не убирает различия между сетями. Комиссии, время подтверждения и правила финальности отличаются у каждой сети, и ваш код всё равно должен с ними справляться. Сравнение двух сетей см. в статье Solana и Tron.

Можно ли тестировать без реальных средств?

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

БлокчейнТестовая сеть
EthereumSepolia
TronNile
BNB Smart ChainBSC testnet
BitcoinTestnet3
PolygonAmoy
ArbitrumArbitrum Sepolia
SolanaDevnet

Монеты тестовых сетей ничего не стоят, поэтому полный цикл приёма и выплаты можно прогнать без трат. Тестовые сети отличаются от 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. Актуальные цены и лимиты указаны на странице тарифов.

Каковы лимиты каждого тарифа?

Каждый тариф задаёт месячные лимиты. Значения ниже указаны на странице тарифов на момент написания. Актуальные цифры смотрите на странице.

ТарифЦена в месяцТранзакций в месяцКошельковВебхуковЗапросов
Plus49 €50075037550 тыс.
Pro99 €2 0003 0001 500200 тыс.
Premium249 €20 00030 0007 5002 млн
Enterprise499 €100 000100 00025 000200 млн

Приоритетная поддержка начинается с Premium. Персональный менеджер аккаунта и соглашение об уровне сервиса (SLA) входят в Enterprise. Объект quotas_left в ответе GET /api/account показывает, сколько квоты осталось.

С чего начать?

Создайте аккаунт, скопируйте токен из панели управления и вызовите один эндпоинт чтения в тестовой сети. Быстрый старт проведёт через первые запросы. На странице поддерживаемых сетей перечислены блокчейны и значения заголовков.

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

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

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

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