パイプラインの監視対象を変更します。再デプロイをスキップします。

キーバリューストアは、Quicknode が提供するアカウントレベルのストアであり、データパイプラインが依存する小さな状態情報を、リストと値として整理して格納します。Streams のフィルター、Webhooks 、および外部アプリケーションはすべて、フィルター内のqnLib関数や、その他の場所ではREST APIを通じて、同じデータを読み書きします。watched_walletsのようなリストは、メンバーシップチェックを駆動します。lastProcessedBlockのような値は、パイプラインが時間の経過とともに更新する1つのデータポイントを保持します。

リストをフィルタコードにハードコーディングするのではなく、キーバリューストアに保存してください。フィルタは qnLib.qnContainsListItems を使用してメンバーシップを確認しますが、REST API 経由の更新や qnLib.qnUpsertList による更新が行われると、その確認対象の内容が変更されます。実行中のフィルタはリストの最新バージョンを読み取るため、ウォッチリストが変更されてもパイプラインは処理を継続します。

はい。キーバリューストア内のリストはアカウント単位で管理されるため、Streams フィルターがqnLib.qnContainsListItemsでチェックする同じ「watched_wallets」リストが、そのアカウント内のすべてのWebhookで利用可能です。製品ごとにリストのコピーを作成したり、同期を維持したりする必要はありません。REST APIを通じてリストを一度更新すれば、両方のインターフェースで最新のバージョンが読み込まれます。

リストとは、1つのキーの下に格納された文字列項目の名前付き集合であり、qnLib.qnContainsListItems を使用して送信者と監視対象ウォレットを照合するなど、所属確認を行うために作成されます。値とは、1つのキーの下に1つのデータポイントを格納し、lastProcessedBlock のように経時的に追跡されるものです。リストは、ある項目がコレクションに属しているかどうかを判定します。値は、追跡対象のデータポイントが現在どのような値を持っているかを示します。

Streams フィルター内でのqnLib.qnContainsListItemsの使用、およびWebhooks でのリストの使用は、すべてのQuicknode プランにおいて無料で利用できます。これはルックアップ操作にのみ適用され、書き込みやストレージには適用されません。したがって、Streams フィルターでは、実行されるたびに大規模なリストを何度でも確認することができます。その他の項目に関する最新の利用規約については、Quicknode の料金ページをご確認ください。

キーバリューストアは、Quicknode のすべてのプランで利用可能であり、別途購入やプロビジョニングを行う必要はありません。Streams フィルター内でのqnLib.qnContainsListItemsの使用、およびWebhooks でのリストの利用は、無料で含まれています。書き込みおよびストレージに関する現在の利用規約については、Quicknode の料金ページをご確認ください。

REST API と qnLib 関数は、同じ基盤データにアクセスするための 2 つの方法です。Streams フィルターは、実行中に qnLib.qnGetValue などの関数をネイティブに呼び出します。バックエンド、スクリプト、または エージェント は、同じQuicknode APIキーを使用してREST APIを呼び出します。いずれのインターフェースを通じてリストを更新しても、それを読み取るもの（フィルターやアプリケーションなど）はすべて、最新のバージョンを読み取ります。

Quicknode はい。キーバリューストアのデータはアカウントスコープです。つまり、特定のプロジェクトや エンドポイント。アカウント内のすべてのStreams フィルターおよびWebhookは、同じリストと値を読み取り、REST APIもアカウントのAPIキーを使用して同じデータにアクセスします。watched_walletsを一度作成すれば、各パイプラインは独自のコピーを維持するのではなく、最新のコピーを1つ確認するだけです。

キーバリューストアは数百万件のアイテムを格納できるため、大規模なウォッチリストも「watched_wallets」のような単一のリストに収まります。システム間でシャード分割する必要はありません。qnLib.qnContainsListItems によるメンバーシップチェックは、Streams のフィルタ内部から、その同じリストを読み取ります。ストレージやアイテム数に関する最新の詳細については、ワークロードの規模を決定する前に、キーバリューストアのドキュメントをご確認ください。

はい、キーバリューストア内の項目は大文字と小文字が区別されるため、0xAbC1 と 0xabc1 は別々のエントリとなります。これは特に、ブロックチェーン のアドレスにおいて重要です。Streams フィルターが qnLib.qnContainsListItems を呼び出す際に使用するのと同じ大文字・小文字の形式でアドレスを保存してください。そうしないと、チェックサムが計算されたエントリが、小文字で表記された対応するエントリと一致しなくなります。書き込み時に大文字・小文字の表記を統一することで、メンバーシップチェックの精度を維持できます。

はい。「Quicknode 」サンプルアプリライブラリに含まれる 2 つのサンプル（アプリ ）は、このページで説明している「動的ウォッチリスト」パターンに基づいて構築されています。「Wallet Tracking」は、Solana およびEthereum 上のウォレットアドレスを監視し、ウォッチリストはキーバリューストアに保持され、シンプルな UI を通じて更新されます。「HyperCore Order Monitor」は、Hyperliquid Core 上の取引 の注文を追跡し、監視対象のアドレスと注文ステータスはキーバリューストアのリストに格納されます。どちらのサンプルも、クローン可能なソースコードが付属しています。