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

読了時間：5分

概要​

Quicknode Webhooks is a real-time blockchain event delivery service that sends filtered on-chain data directly to your HTTP endpoints. It makes it easy to get the data you care about like token transfers or contract events, without constantly polling or building complex infrastructure.

This guide walks you through creating and testing your first webhook.

主な業務内容​


  • Explore the Webhooks UI and its guided wizard
  • Create a new webhook from scratch to get notified of new events you want to track
  • Test delivery to your own URL and verify the payload

必要なもの​


What is Webhooks?​

Webhooks is a simple yet powerful product enabling you to receive real-time notifications of onchain events with advanced filtering, compression, and delivery guarantees. It consumes live blockchain data, applies a filter you define in the UI, then POSTs each matching event to the URL you provide.

Built on the same robust infrastructure powering enterprise applications, Webhooks simplifies the experience by exposing only essential configurations, making it perfect for developers who need real-time data without complex infrastructure requirements.

一般的な利用例​

Webhooksは、次のようなものの構築に最適です：


  • トレーディングボット：DEXでのスワップや流動性の変化をリアルタイムで監視
  • 分析ダッシュボード：トークンの動き、大口投資家の動向、プロトコルの指標を追跡
  • 通知システム：オンチェーン上のアクティビティについてユーザーにアラートを送信する
  • ウォレットの追跡：トークンの送金など、特定のウォレットの取引状況を追跡する
  • スマートコントラクトのイベント追跡：新規ミント、承認、関数呼び出しなど、スマートコントラクトによって発生する特定のイベントを監視します
  • DeFiモニタリング：貸付ポジション、イールドファーミングの報酬、清算イベントを監視する
  • NFTトラッカー：コレクションのミント、譲渡、マーケットプレイスでの動向を追跡

主な機能​


  • リアルタイム配信：イベントがブロックチェーン上に記録された直後に受信
  • Guided wizard: Pick a chain, select a no-code template or request a new template based on your use case, set your URL, and that's it
  • テンプレート：ワンクリックで作成できるノーコードフォームは、トークンの送金や契約イベントなど、一般的なパターンをサポートしています。
  • Dynamic address filtering: Link a Key-Value Store list to your Webhook to track addresses dynamically. Add or remove addresses through the dashboard or REST API, and the Webhook picks up changes immediately with no restarts.
  • 再試行ロジック：200以外のレスポンスに対する自動再試行
  • 圧縮：gzip を使用してペイロードを圧縮し、ペイロードのサイズを縮小する
  • 再編成の処理：ブロックチェーンの再編成を自動的に処理し、データの整合性を確保します
  • Streams へのアップグレード：過去のデータの補完、バッチ処理、あるいは別の送信先が必要ですか？Streams をぜひご確認ください

Quicknode Webhooks の始め方​

Setting up a webhook is a straightforward process. Here’s how you can get started:

手順 1：Webhooks ダッシュボードにアクセスする​

Log in to your Quicknode account and navigate to the Webhooks section in your dashboard. If you don't have an account yet, you can sign up for one here.

Webhooks Dashboard

ステップ 2：最初の Webhook を作成する​

「Webhookを作成」をクリックすると、ガイド付きウィザードが起動し、すぐに設定を開始できます。このウィザードでは、ネットワークの選択からフィルタの定義、ターゲットURLの設定に至るまで、Webhookの設定プロセスを順を追って案内します。

ステップ 3: Webhook の設定​

チェーンの選定​

監視したいブロックチェーンネットワークを選択してください。これは、Webhooksにイベントをどこで受信待機するかを指定するための最初のステップです。

Filter and List Selection​

Next, you'll define what kind of events you want to receive.


Select a template: Webhooks provides one-click starters for common patterns like "Wallet transfers" or "Contract events." These templates pre-configure the necessary filters and just require you to specify the relevant parameters, such as wallet addresses or contract addresses.

Webhooks Select a Template

In this guide, we'll use the Wallet transfers template on Ethereum Mainnet as an example to get alerted when a new activity across ETH, ERC-20, and ERC-721 transfers occurs for a specific wallet address (e.g., 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 which is Vitalik Buterin's wallet).

Webhooks templates use Key-Value Store lists. When configuring the template, you can select an existing KV Store list, create a new one by adding addresses one by one, or import from a file. All three options create or reference a KV Store list, so you can add or remove addresses at any time through the dashboard or REST API with no Webhook changes needed. See the Build a Live Wallet Watchlist guide for a step-by-step walkthrough.


Couldn't find a template that fits your use case?

You can request a new template for your specific use case. Alternatively, if you need advanced filtering capabilities like custom JavaScript filters, check out Quicknode Streams which offers full flexibility for complex filtering scenarios.

ステップ4：フィルターのテスト​

Webhook を有効にする前に、フィルターが正しく動作し、意図したイベントを確実に捕捉していることを確認するために、フィルターのテストを行うことが極めて重要です。フィルターをテストするには：


  • テストするブロック番号を選択してください
  • テストブロック番号の入力フィールドの横にある「実行」をクリックしてください
  • サンプルペイロードを確認し、すべてが期待通りに動作しているかテストしてください

Webhooks - Test Your Filter

ステップ 5：Webhook URL の設定​

ペイロードを受信したいURLを入力してください。QuicknodeはこのURLにPOSTリクエストを送信します。ペイロードの形式はテスト用ペイロードと同じであるため、サーバー側で簡単に解析することができます。

In this guide, we'll use TypedWebhook to test our configuration easily. TypedWebhook is a free service that gives you a URL to send test payloads to. Follow these steps to set it up:


  • Visit TypedWebhook
  • Copy the URL and paste it in the Webhook URL field on the Webhooks dashboard
  • Click Send Test Payload to send a test payload to your destination URL

Webhooks - Results

If you need a sample code to build your own server, check out "Set Up A Backend Server with Express.js" section in our Visualizing Real-Time Blockchain Data With Streams and React guide.

After getting a successful response, you can create your webhook. However, before proceeding, let's explore some additional options you can configure.

検証トークン​

各Webhookには、そのWebhookの正当性を確認するために使用できる検証トークンがあります。このトークンは自動的に生成され、「Webhooks」ダッシュボードで確認できます。この検証トークンを使用することで、受信したWebhookメッセージの正当性を確認し、そのメッセージがご自身のWebhookから送信されたものであることを確認できます。

Check out How to Validate Incoming Streams Webhook Messages guide for more details.

圧縮​

Quicknode Webhooks には、データ配信を最適化するための圧縮オプションが用意されています。gzip を使用してペイロードを圧縮し、サイズを縮小することができます。

While the cost for Webhooks is based on the number of alerts received, using compression can still offer benefits for your infrastructure. Smaller payload sizes lead to:


  • 帯域幅の使用量の削減：データ転送量に応じて課金される場合、これによりデータ転送コストを削減できます。
  • 処理速度の向上：ペイロードが小さければ、送信が速くなり、受信サーバーでの処理もより効率的になるため、サーバーの負荷が軽減されます。

ステップ 6: Webhook を作成する​

最後に、後で識別できるよう、Webhookにわかりやすい名前を付け、ボタンをクリックしてWebhookを作成してください。これでWebhookが稼働し、条件フィルターが満たされるたびに、指定したURLへリアルタイムデータを配信するようになります。

Webhooks - Active Webhook

結論​

Congratulations! You've successfully set up your first Quicknode Webhook, enabling you to receive real-time blockchain data with ease. Webhooks provides a powerful, yet simplified, way to integrate on-chain events directly into your applications.

If you have any questions, feel free to use our dedicated channel on Discord or provide feedback using the form below. Stay up to date with the latest by following us on X and our Telegram announcement channel.

その他の参考資料​


皆様からのフィードバックを心よりお待ちしております！❤️

ご意見や新しいトピックに関するご要望などがありましたら、ぜひお知らせください。皆様からのご連絡を心よりお待ちしております。

最終更新日 on
このガイドをシェアする