Skip to main content

​
Кредиты и ограничения частоты запросов

До 100 000 адресов при использовании API.
Да, изменение вебхука через API или панель управления стоит 100 кредитов за запрос. Это относится к любым изменениям, включая смену URL, добавление или удаление адресов и обновление типов транзакций.
Каждое событие вебхука стоит 1 кредит, когда Helius обрабатывает и отправляет событие на вашу конечную точку. Плата взимается независимо от того, успешно ли ваша конечная точка обработала вебхук или вернула ошибку.
Все операции управления вебхуками (создание, изменение и удаление), выполняемые через API, стоят 100 кредитов за запрос. Эта стоимость покрывает обработку, необходимую для обновления конфигураций вебхуков.

​
Поддерживаемые сети

Да. Если вы создаете вебхук через пользовательский интерфейс, выберите «devnet» в поле «Сеть». Если вы создаете его через Webhook API, задайте для параметра «webhookType» значение “rawDevnet”, “enhancedDevnet” или «discordDevnet» в зависимости от нужного типа вебхука.
Нет — URL должен быть общедоступен по протоколу HTTPS. Helius не может обращаться к локальным серверам разработки через URL-адреса localhost.

​
Использование вебхуков

Задайте заголовок авторизации при создании или обновлении вебхука. При отправке данных на конечную точку вашего вебхука Helius возвращает это значение в заголовке Authorization, что позволяет проверить подлинность запроса.
Необработанные вебхуки возвращают обычные данные транзакций Solana непосредственно из блокчейна. Когда для отслеживаемых адресов происходит транзакция, необработанные данные транзакции отправляются на URL вашего вебхука.Расширенные вебхуки предоставляют типы транзакций, интерпретированные Helius. Мы анализируем более 100 типов транзакций Solana (размещение NFT, обмены DeFi, переводы и т. д.) и преобразуем их в собственную схему.Используйте необработанные вебхуки, если вам нужны все данные транзакций без абстракций, или расширенные вебхуки, если вам нужны встроенные определение и анализ типов транзакций.
Вебхуки отправляют уведомления сразу после подтверждения соответствующей транзакции в блокчейне.

​
Повторные попытки

Чтобы подтвердить успешное получение, ваша конечная точка должна вернуть код состояния 200 в течение 1 секунды. Рекомендуется немедленно отвечать кодом 200 и выполнять всю обработку асинхронно — это предотвращает истечение времени ожидания из-за медленной бизнес-логики.
Helius повторяет доставку, если ваша конечная точка возвращает ошибку 5xx, ошибку 4xx (кроме 403), превышает время ожидания либо завершается сбоем из-за ошибки подключения или DNS. Мы выполняем до 3 повторных попыток с интервалом в 1 секунду между ними.Если все повторные попытки завершаются неудачно, событие безвозвратно теряется — оно не добавляется в очередь повторно и второй цикл доставки не запускается.Отслеживайте журналы вебхуков в панели управления Helius, чтобы выявлять сбои доставки и исследовать проблемы с конечной точкой.Для корпоративных тарифов мы также предлагаем настраиваемые политики повторных попыток.
Helius может доставить одно и то же событие вебхука несколько раз. Это может произойти из-за логики повторных попыток или проблем с сетью.Ваш обработчик вебхуков должен корректно обрабатывать дубликаты — многократная обработка одного события должна давать тот же результат, что и однократная.Для обработки дубликатов используйте подпись транзакции или уникальный идентификатор события, чтобы отслеживать уже обработанные события.
Это зависит от типа вебхука. Расширенные вебхуки не отправляют неуспешные транзакции, а необработанные вебхуки включают как успешные, так и неуспешные транзакции.

​
Автоматическое отключение

Helius отслеживает состояние конечных точек и автоматически отключает вебхуки с долей сбоев доставки ≥ 95%. Платные тарифы (Dev и выше) оцениваются за 7-дневный период, а вебхуки бесплатного тарифа — за 24-часовой период. Это предотвращает бесполезные попытки доставки на недоступные конечные точки.К распространенным причинам относятся недоступный URL конечной точки, постоянный возврат сервером ответов с ошибками и проблемы с сетью или межсетевым экраном, блокирующие доставку от Helius.
  1. Устраните основную проблему с конечной точкой.
  2. Войдите в панель управления Helius.
  3. Найдите отключенный вебхук и снова включите его.
Вебхуки также можно повторно включить программно через конечную точку API для переключения вебхука, отправив запрос PATCH с { "active": true }.
Нет. После повторного включения вебхука начинается 24-часовой льготный период, в течение которого он не будет отключен автоматически. Это дает вам время убедиться в исправности конечной точки до следующей проверки.
Да — пользователи тарифа Dev и выше получают уведомление по электронной почте, когда вебхук автоматически отключается. Пользователи бесплатного тарифа могут отслеживать состояние вебхуков в панели управления Helius.
Да. Вебхуки можно включать и отключать в панели управления Helius или через конечную точку API для переключения вебхука. Это позволяет временно приостановить доставку, не теряя конфигурацию вебхука.

​
Устранение неполадок вебхуков

Потеря данных обычно происходит, когда ваша конечная точка сталкивается с ошибкой, из-за чего начинаются повторные попытки доставки вебхука, которые в итоге завершаются неудачно и приводят к потере данных. Проверьте журналы вебхука в панели управления, убедитесь, что на стороне клиента ведется достаточно подробное журналирование, и обратитесь в службу поддержки, если проблема сохраняется.
Убедитесь, что выбранный тип транзакции соответствует отслеживаемым транзакциям. Начните с типа транзакции “ANY”, чтобы определить, связана ли проблема с общим сбоем или несоответствием типа. Используйте webhook.site, чтобы проверить, не связана ли проблема с конфигурацией вашей конечной точки.
Вебхук TOKEN_MINT срабатывает только для определенных программ, таких как Candy Machine V1 и Solana Program Library. Он не охватывает все события выпуска токенов во всем блокчейне. Для более широкого мониторинга рассмотрите возможность использования более общей подписки на учетную запись или программу через вебхуки с фильтрацией по типу транзакции “ANY”.

​
Нужна дополнительная помощь?

Contact Support

Получите помощь нашей команды через Discord, чат или электронную почту.

Status Page

Проверьте доступность сервисов и сведения об их производительности в реальном времени.