メインコンテンツへスキップ

Solana webhookとは何ですか?

Solana webhookは、オンチェーンイベントが発生したときにアプリケーションに送信されるリアルタイムのHTTP通知です。ブロックチェーンを継続的にポーリングする代わりに、Heliusはウォレットが資金を転送したり、NFTが売れたり、監視しているトランザクションタイプが発生したりすると、解析済みのトランザクションデータを直接エンドポイントにプッシュします。トレーディングボット、分析ダッシュボード、コンプライアンスパイプライン、イベント駆動の自動化を強化します。 ユーザーフレンドリーなインターフェース、プログラムAPI、SDKアクセスを提供して、webhookの作成と管理を容易にします。よくある質問については、Webhooks FAQを参照してください。
Heliusはサーバーが正常に応答しない場合、webhookの再配送を試みることがあり、重複したイベントを受け取ることがあります。再配送と重複処理の詳細については、Webhooks FAQを参照してください。

料金

Webhookイベントは、Heliusがイベントを処理してエンドポイントに送信すると1クレジットが課金されます。エンドポイントがwebhookを正常に処理したかどうかに関わらず、課金されます。APIを介してwebhookを編集、追加、または削除すると100クレジット/リクエストがかかります。

Webhookの種類

現在、さまざまなニーズに対応したいくつかの種類のwebhookを提供しています:

強化トランザクションWebhook

監視しているアドレスに関連する特定のトランザクションタイプ(例:NFT販売)の人間が読める解析データを提供します。フィルタリングされた実用的なインサイトが必要な場合に最適です。

ロートランザクションWebhook

監視しているアドレスに関与するすべてのトランザクションに対してロートランザクションデータを配信します。トランザクションタイプによるフィルタリングはできません。
ロートランザクションWebhookはイベントタイプの解析が含まれないため、低レイテンシーを提供します。

Discord Webhook

特定のトランザクションタイプのアップデートを指定されたDiscordチャンネルにフォーマットされたメッセージとして直接ストリームします。このオプションを使用するには、Discord Webhook URLを提出する必要があります。

イベントペイロード例

開始方法

Webhooks Quickstart

ダッシュボード、REST API、公式TypeScript / Rust SDKを通じて最初のwebhookを作成します。

失敗するWebhookの自動無効化

Heliusはwebhookエンドポイントの健康状態を監視し、一貫して受信が失敗するwebhookを自動的に無効にします。到達不能なエンドポイントに対する無駄な配送試行を防ぎます。

仕組み

  • 有料プラン(Dev以上): 7日間で失敗率が95%以上のwebhookは自動的に無効化されます。
  • 無料プラン: 同じ失敗基準で24時間のウィンドウで評価されます。
システムは4時間ごとにwebhookの健康状態をチェックします。webhookが無効化されると、数秒以内に配信が停止します。

メール通知

Devプラン以上のユーザーは、webhookが自動的に無効化されたときにメール通知を受け取ります。

無効化されたWebhookの再有効化

1

エンドポイントを修正する

配信失敗を引き起こしている問題を解決します(例:サーバーのダウンタイム、不正なURL、エンドポイントエラー)。
2

Heliusダッシュボードにログインする

Helius Dashboardにアクセスします。
3

webhookを再有効化する

無効化されたwebhookを見つけて再度オンにします。
webhookをToggle Webhook APIエンドポイントを通じてプログラムで再有効化することもできます。
再有効化後、webhookは24時間の猶予期間に入り、その間に再度自動無効化されることはありません。これにより、エンドポイントが正常であることを確認する時間が与えられます。

使用例

ボット

  • マーケットプレイスXでNFTがリストされたときに「NFT購入」アクションをトリガーします。
  • マージンポジションが不健全な場合、「清算」アクションをトリガーします。

監視とアラート

  • プログラムが特定のログを発行したときに、PagerDuty統合をトリガーします。
  • トークンアカウントの残高がX%以上変化した場合、Dialectを使用して警告アクションを伝えます。

イベント駆動のインデックス化

  • 指定されたプログラムの任意のトランザクションが発生したときに、それを直接データベースまたはバックエンドに送信します。

通知とアクティビティ追跡

  • ウォレットXからウォレットYへの転送時に、Slack通知またはメールを送信します。

分析とログ

  • イベントXが発生したときに、ETLパイプラインに送信するか、Heliusに直接保存して時間とともにトレンドを確認します。

ワークフローの自動化

  • イベントXが発生したときに、一連のアクションをトリガーします。