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

Оповещения в реальном времени: ценовые алерты и вебхуки

Оповещения о криптовалюте бывают двух видов: ценовые уведомления для трейдеров и события вебхуков для приложений. Что вам нужно и как построить второе.

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

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

Изометрический контраст между двумя типами криптооповещений

Оповещения о криптовалюте в реальном времени — это уведомления о криптоактивности, и они бывают двух видов. Ценовые оповещения сообщают человеку, что актив пересёк определённый уровень. Оповещения о транзакциях, которые приходят через вебхук, сообщают вашему серверу в тот момент, когда поступил депозит. Это руководство описывает оба вида, а затем подробно разбирает второй: как работают оповещения на основе событий, что проверять и как избежать двойного зачисления.

Кратко

  • Ценовые оповещения нужны людям, которые следят за рынками. Они носят информационный характер и побуждают человека посмотреть на экран.
  • Оповещения о транзакциях нужны программам. Вебхук передаёт событие на ваш бэкенд, чтобы он мог зачислить средства на счёт, разблокировать заказ или отметить перевод без участия человека.
  • Подписанный вебхук доказывает, кто его отправил, но не то, что он новый. Нужны также временные метки, ID событий и идемпотентная обработка.
  • Рассматривайте каждое оповещение как подсказку и подтверждайте текущее состояние через чтение API, прежде чем перемещать деньги или отправлять товар.
  • Chaingateway отправляет подписанные HMAC вебхуки для Ethereum, Bitcoin, Tron, Polygon, BNB Chain и Arbitrum через единый REST API. Solana вебхуков не поддерживает.

Содержание

Что такое оповещения о криптовалюте в реальном времени?

Этот термин используют два очень разных читателя, поэтому у него два значения.

Первый — трейдер или держатель. Ему нужны push-уведомление, письмо или SMS, когда актив достигает уровня. Большинство приложений бирж предлагают это. Оповещение привязано к списку наблюдения и заранее заданному ценовому условию, а приходит оно через push, сообщение в приложении или письмо. Оно информирует человека и ничего не запускает автоматически.

Второй читатель — разработчик или владелец продукта. Его вопрос другой: «Как моё приложение за несколько секунд узнает, что на адрес, который я создал для этого клиента, пришли 150 USDT?» Ни одно ценовое приложение на это не ответит. Ответ — лента событий блокчейна, которая отправляет данные на эндпоинт, контролируемый вами.

Если вы из первой группы, задайте порог в приложении, которым уже пользуетесь, и дальше можно не читать. Если вы из второй, остальная часть статьи для вас.

Ценовые и транзакционные оповещения в сравнении

Потребительские ценовые оповещенияТранзакционные оповещения через вебхуки
АудиторияТрейдеры, держателиРазработчики, продуктовые команды
ТриггерЦена пересекла уровеньПеревод, депозит или событие токена или NFT на отслеживаемом адресе
Куда доставляетсяНа телефон или в почтуНа ваш HTTPS-эндпоинт
Какое действиеРешает человекРешает ваш код
Режим сбояВы пропустили движениеВы зачислили дважды или не зачислили вовсе
Проблема безопасностиНебольшаяПодлинность, повторы, порядок событий

Последние две строки и объясняют, почему вторая категория заслуживает серьёзного инженерного внимания. Пропущенное ценовое оповещение стоит упущенной возможности. Неправильно обработанное оповещение о платеже стоит денег.

Как работают оповещения на основе событий?

Механику просто описать, а запустить самостоятельно — непросто.

  1. Вы регистрируете адрес или набор адресов. Обычно вы создаёте один адрес для депозита на клиента или на заказ.
  2. Провайдер следит за сетью. Кто-то должен читать новые блоки, находить переводы, которые касаются ваших адресов, и интерпретировать их.
  3. Провайдер декодирует событие. Сырая транзакция — это байты. Перевод токена в сети EVM — это лог контракта, который нужно разобрать на отправителя, получателя, токен и сумму. Декодированные данные избавляют вас от поддержки ABI и парсеров для каждой сети.
  4. Провайдер отправляет POST на ваш эндпоинт. Ваш сервер получает JSON с описанием события.
  5. Ваш код проверяет, устраняет дубликаты и действует.

Шаги 2 и 3 — то место, где собственная разработка становится дорогой. Либо вы запускаете ноды для каждой поддерживаемой сети, либо подписываетесь на ленты на уровне нод и сами пишете декодирование. В Ethereum черновик EIP-8072 предлагает расширение eth_subscribe, которое уведомляет клиентов о включении транзакции в блок. Но это только одна сеть. Модель UTXO в Bitcoin, система ресурсов Tron и модель аккаунтов Solana работают по-разному.

Если нужна карта вариантов, наше сравнение шести типов блокчейн-API и когда какой использовать показывает, где уместны доступ к нодам, индексированные данные и уведомления о событиях.

Практический пример: подтверждение депозита

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

  1. Ваш бэкенд создаёт адрес кошелька для заказа и сохраняет ожидаемую сумму, токен и сеть для ID заказа.
  2. Клиент отправляет средства.
  3. Ваш эндпоинт вебхуков получает событие для этого адреса.
  4. Обработчик проверяет подпись, затем свежесть, если провайдер подписывает временную метку, затем то, обрабатывали ли вы уже это событие, например по ID транзакции.
  5. Он находит заказ, сравнивает токен, сеть и сумму с ожидаемыми и читает канонический статус транзакции через API провайдера.
  6. В одной транзакции базы данных он отмечает заказ оплаченным и записывает ID события.
  7. Он быстро возвращает ответ 2xx, а медленную работу, например отправку писем, выполняет через очередь.

В этом списке нет ничего экзотического. Каждый шаг существует из-за конкретного способа, которым всё может пойти не так. Об этом рассказывают следующие разделы. Подробнее о случае с депозитом — в нашей статье об автоматической обработке депозитов через вебхуки.

Что доказывает подписанный вебхук?

Подписанный вебхук доказывает, что отправитель владеет общим секретом и что полезная нагрузка не изменена. Многие команды на этом останавливаются и думают: «Запрос подписан HMAC, значит, мы в безопасности». Подпись необходима, но недостаточна.

Подпись HMAC позволяет убедиться, что полезная нагрузка пришла от того, кто владеет общим секретом, и не была изменена в пути. Но она не говорит, что сообщение свежее. Злоумышленник или просто повторяющая отправку сеть может прислать одно и то же валидное сообщение дважды. Шпаргалка OWASP по безопасности вебхуков прямо на это указывает: проверка подписи не останавливает повторное воспроизведение. Поэтому её нужно сочетать с аутентифицированной временной меткой и ID события, а события обрабатывать идемпотентно, чтобы повторы не вызывали побочных эффектов, например дублирующих платежей.

На практике это означает следующее:

  • Проверяйте подпись по сырому телу запроса до разбора. Используйте сравнение за постоянное время.
  • Отклоняйте устаревшие временные метки, если провайдер их подписывает. Выберите окно допуска и отбрасывайте всё, что старше.
  • Храните ID событий. Для Chaingateway естественный ключ — ID транзакции. Если вы его уже видели, верните успешный ответ и ничего не делайте.
  • Делайте обработчик идемпотентным. Зачисление средств должно быть операцией, которую безопасно выполнить дважды.

Chaingateway подписывает вебхуки заголовком X-Signature, когда вы задаёте персональный секрет. Согласно руководству по безопасности вебхуков, подпись — это HMAC, построенный из ID транзакции и этого секрета. Временной метки в ней нет, поэтому проверка свежести выше к ней не применяется. Вместо этого выполняйте дедупликацию по ID транзакции вместе с получателем и токеном. О самой функции читайте в нашей статье о безопасности вебхуков. Какой бы провайдер вы ни использовали, эти проверки остаются на вашей стороне.

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

Многие провайдеры вебхуков доставляют сообщения как минимум один раз: тайм-аут на вашей стороне заставляет издателя повторить отправку, поэтому один перевод может породить две доставки. Chaingateway не повторяет неудачные вебхуки автоматически. Неудачные уведомления перечислены по адресу /webhooks/notifications/failed и отправляются повторно по вашему запросу, поэтому дубликаты всё равно могут появиться после ручного повтора. Два события о одном платеже могут прийти и в неправильном порядке.

Рекомендация OWASP — считать, что доставка может идти не по порядку и не строить переходы состояний на порядке прихода. Когда уведомление приходит, запрашивайте текущее состояние объекта через API провайдера, а не доверяйте одной полезной нагрузке. Та же шпаргалка рекомендует считать входящие вебхуки недоверенными данными, проверять их по своим записям и выполнять выполнение заказа в атомарных транзакциях базы данных, например с блокировкой строк, чтобы исключить гонки.

Рекомендации OWASP по интеграции сторонних платёжных шлюзов приходят к тому же: проверяйте статус платежа на сервере через API шлюза, прежде чем выполнять заказ, и сверяйте ожидаемую сумму, валюту и ID заказа. Для криптовалют добавьте в этот список сеть и адрес контракта токена. Перевод не того токена с таким же тикером — классический способ отметить заказ оплаченным, хотя он не должен быть оплачен.

Памятка по проверке вебхуков: запрашивайте текущее состояние через API провайдера и сверяйте с вашими записями, а не доверяйте одной полезной нагрузке

Взгляд: оповещение — это входные данные, а не вердикт

Мы создаём решения для разработчиков, которые встраивают криптоплатежи в продукты. Мы постоянно видим одну и ту же картину: команды воспринимают оповещение как ответ. Мы считаем его вопросом. Вебхук говорит: «На этом адресе что-то произошло». Ваша система всё равно должна решить, соответствует ли это что-то заказу, верны ли сумма и токен и не был ли этот платёж уже учтён.

Три шага обработки оповещения: оповещение сигнализирует об активности, проверка сверяет заказ, сумму, токен и статус, безопасность добавляет проверки идемпотентности

Поэтому мы сосредотачиваемся на частях, которые убирают рутину и не отнимают у вас контроль. Предварительно декодированные данные означают, что обработчик получает отправителя, получателя, токен и сумму, а не разбирает логи. Один API для нескольких сетей означает, что обработчик депозита в Ethereum выглядит так же, как обработчик депозита в Tron. Вебхуки с подписью HMAC дают основу, поверх которой вы строите собственные проверки идемпотентности.

Мы бы не стали обещать, что один только вебхук делает платёжную систему безопасной. Это не так, и любой провайдер, который намекает на обратное, пропускает самую сложную часть. Сначала постройте цикл проверки, а потом масштабируйте объём.

Где потребительские оповещения не подходят для продуктов

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

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

В криптовалютной части именно лента событий должна быть машиночитаемой от начала до конца.

Как выбрать схему оповещений?

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

Покрытие сетей

Перечислите сети и стандарты токенов, которые нужны сегодня, и те, которые вы можете добавить в следующем году. Если вы будете принимать стейблкоины в нескольких сетях, вам нужны ERC-20, BEP-20 и TRC-20, обрабатываемые одинаково. Chaingateway предлагает вебхуки для Ethereum, Bitcoin, Tron, Polygon, BNB Chain и Arbitrum и поддерживает стандарты токенов ERC-20, BEP-20, TRC-20 и ERC-721. Solana доступна через API, но вебхуков там нет.

Качество полезной нагрузки

Попросите показать пример события. Определён ли токен, нормализована ли сумма с учётом decimals, понятно ли направление? Чем больше вам нужно декодировать самостоятельно, тем больше кода вы поддерживаете и тестируете.

Модель безопасности

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

Операционная нагрузка

Собственные ноды означают обновления, синхронизацию, мониторинг и оплату хранилища для каждой сети. Размещённый API заменяет это подпиской. Честно решите, какую цену вы предпочли бы платить.

Ценообразование, которое соответствует использованию

Тарифы, которые растут вместе с объёмом API, прогнозировать легче, чем инфраструктуру, которую приходится держать с запасом. Тарифы Chaingateway начинаются от 49 € в месяц (490 € в год) и открываются 7-дневным бесплатным пробным периодом без карты. Все тарифы перечислены на странице цен.

Начало работы с вебхуками-оповещениями в Chaingateway

Если ваш сценарий — обнаружение платежей, мониторинг кошельков или уведомления о переводах токенов, вебхуки Chaingateway позволяют подписаться на события блокчейна и получать их как подписанные HTTP-вызовы. Лежащий в основе Blockchain API — это единый REST-интерфейс для создания кошельков, отправки переводов токенов и NFT и получения декодированных транзакций. Поэтому та же интеграция, которая слушает, может и действовать. Пробный период позволяет проверить процесс на вашем эндпоинте, прежде чем выбрать тариф.

Разумный план на первую неделю:

  1. Создайте тестовый кошелёк и подпишите на него тестовый эндпоинт.
  2. Логируйте сырые доставки с заголовками, прежде чем писать бизнес-логику.
  3. Реализуйте проверки подписи, временной метки и ID события.
  4. Добавьте шаг чтения через API и атомарное обновление заказа.
  5. Намеренно повторите одно и то же событие и убедитесь, что ничего не зачислено дважды.
  6. Намеренно отправьте события не по порядку и убедитесь, что итоговое состояние всё равно верное.

Если вы строите интернет-магазин, наш обзор блокчейн-API для e-commerce объясняет, как эти части соединяются вокруг чекаута.

Оповещения о комплаенсе и рисках — отдельный слой

Некоторые команды, которые ищут оповещения в реальном времени, имеют в виду нечто иное: проверку транзакций на связь с санкционными списками или на подозрительные схемы. Это функция комплаенса. Её обычно покупают у специализированных аналитических поставщиков и подключают к вашему процессу через API. Она существует рядом с уведомлениями о платежах, а не вместо них. Вебхуки о платежах сообщают, что перевод пришёл. Слой комплаенса сообщает, стоит ли его принимать.

Если ваш бизнес регулируется, планируйте оба. Обсудите требования вашей юрисдикции с юристом по комплаенсу или квалифицированным офицером AML, потому что правила различаются по странам и типам лицензий.

Если ваша забота — злоупотребления в вашем собственном продукте, например повторные регистрации или повторное использование платёжных инструментов, в шпаргалке OWASP по безопасности бизнес-логики есть полезный список шаблонов, по которым стоит создавать оповещения внутри приложения, отдельно от всего, что происходит в сети.

Частые ошибки

  • Выполнение медленной работы внутри обработчика. Быстро подтвердите получение, обрабатывайте через очередь, иначе отправитель повторит запрос, пока вы ещё работаете.
  • Доверие сумме из полезной нагрузки без сверки с заказом, который вы создали.
  • Игнорирование недоплат и переплат. Определите политику до запуска: зачислять частично, возвращать или удерживать для проверки.
  • Повторное использование одного адреса для многих заказов. Это делает сопоставление неоднозначным. Создавайте адреса на заказ или на клиента.
  • Отсутствие пути для недоставленных событий. Если ваш эндпоинт недоступен, сверяйте данные, запрашивая список неудачных уведомлений и читая последние транзакции через API.
  • Логирование секретов. Держите секрет HMAC вне логов и репозиториев и меняйте его по расписанию.

Источники

Рекомендуем

Часто задаваемые вопросы

Ценовое оповещение сообщает человеку, что актив пересёк уровень, обычно через push, письмо или сообщение в приложении. Оповещение о транзакции сообщает программе, что на конкретном адресе что-то произошло, обычно как подписанный HTTP-запрос. Первое помогает решить, торговать ли. Второе позволяет вашему приложению действовать по платежу.

Да. Размещённый блокчейн-API следит за сетями вместо вас и отправляет события на ваш эндпоинт. Проверка и бизнес-логика остаются за вами, но вы не занимаетесь эксплуатацией нод для каждой сети. Chaingateway предлагает вебхуки для Ethereum, Bitcoin, Tron, Polygon, BNB Chain и Arbitrum.

Нет. Подпись подтверждает отправителя и то, что полезная нагрузка не изменена, но не мешает повторно воспроизвести валидное сообщение. OWASP советует сочетать подписи с аутентифицированными временными метками, ID событий и идемпотентной обработкой, а перед действием заново считывать текущее состояние у провайдера.

Не рассчитывайте на это. Повторы и сетевые условия могут переставить или продублировать доставки. Спроектируйте обработчик так, чтобы итоговое состояние было верным независимо от порядка прихода. Для этого при получении уведомления запрашивайте канонический статус через API.

Для всего, что перемещает деньги или выполняет заказ, используйте оповещения о событиях через вебхуки. Ценовые оповещения подходят как вспомогательный сигнал для дашборда или казначейской команды, но подтвердить депозит они не могут.

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

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

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

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