What is Key-Value Store?

Key-Value Store is Quicknode's account-level store for the small pieces of state a data pipeline depends on, organized as lists and values. Streams filters, Webhooks, and external applications all read and write the same data, through qnLib functions inside filters and a REST API everywhere else. A list such as watched_wallets drives membership checks. A value such as lastProcessedBlock holds one data point a pipeline updates over time.

How do I update a Streams filter's address list without redeploying the filter?

Store the list in Key-Value Store instead of hardcoding it in filter code. The filter checks membership with qnLib.qnContainsListItems, and an update through the REST API, or with qnLib.qnUpsertList, changes what that check sees. The running filter reads the current version of the list, so the pipeline keeps processing while the watchlist changes.

Can Webhooks read the same list as my Streams filter?

Yes. A list in Key-Value Store is account-scoped, so the same watched_wallets list a Streams filter checks with qnLib.qnContainsListItems is available to every Webhook on the account. There is no per-product copy to create or keep in sync. Update the list once through the REST API, and both surfaces read the current version.

What is the difference between a list and a value?

A list is a named collection of string items stored under one key, built for membership checks, like matching senders against watched_wallets with qnLib.qnContainsListItems. A value stores one data point under one key, tracked over time, like lastProcessedBlock. Lists answer whether an item belongs to a collection. Values answer what one tracked data point currently holds.

Is there a cost for lookups inside Streams filters and Webhooks?

qnLib.qnContainsListItems usage inside your Streams filter, and using your list in Webhooks are included at no cost, on every Quicknode plan. That applies to those lookups, not to writes or storage, so a Streams filter can check a large list as often as it runs. For current terms on everything else, check the Quicknode pricing page.

What does Key-Value Store cost?

Key-Value Store is available on every Quicknode plan with nothing separate to buy or provision. qnLib.qnContainsListItems usage inside your Streams filter, and using your list in Webhooks are included at no cost. For current terms on writes and storage, check the Quicknode pricing page.

How do the REST API and the qnLib functions relate?

The REST API and the qnLib functions are two ways into the same underlying data. A Streams filter calls functions like qnLib.qnGetValue natively while it runs. A backend, script, or agent calls the REST API with the same Quicknode API key. Update a list through either surface, and anything reading it, filter or application, reads the current version.

Is Key-Value Store data shared across my whole account?

Yes. Key-Value Store data is account-scoped: it lives at the Quicknode account level, not inside one project or endpoint. Every Streams filter and every Webhook on the account reads the same lists and values, and the REST API reaches the same data with the account's API key. Create watched_wallets once, and each pipeline checks one current copy instead of maintaining its own.

Is there a limit on how much Key-Value Store holds?

Key-Value Store can hold millions of items, so a large watchlist fits in one list like watched_wallets. No need to shard it across systems. Membership checks with qnLib.qnContainsListItems read that same list from inside Streams filters. For current specifics on storage and item counts, check the Key-Value Store docs before sizing a workload.

Are Key-Value Store items case-sensitive?

Yes, items in Key-Value Store are case-sensitive, so 0xAbC1 and 0xabc1 are two different entries. This matters most with blockchain addresses. Store an address in the same case a Streams filter uses when it calls qnLib.qnContainsListItems, or a checksummed entry will not match its lowercase twin. Consistent casing at write time keeps membership checks accurate.

Are there working examples of Key-Value Store with Streams?

Yes. Two sample apps in the Quicknode Sample App Library are built on the dynamic-watchlist pattern this page describes. Wallet Tracking monitors wallet addresses on Solana and Ethereum, with the watchlist held in Key-Value Store and updated through a simple UI. HyperCore Order Monitor tracks trading orders on Hyperliquid Core, with watched addresses and order statuses in Key-Value Store lists. Both ship with source code you can clone.

Key-Value-Store: Aktualisierung der Filterlisten für „ Streams “ ohne erneute Bereitstellung

Inhalt wird geladen...

// FAQ

Häufig gestellte Fragen

Kosten, Einschränkungen, Umfang und wie die Oberflächen zusammenpassen. Die Dokumentation zum Key-Value-Store behandelt alle „ endpoint “ und Funktionen.

Der Key-Value-Store ist der Speicher auf Kontoebene v Quicknode, der die kleinen Zustandsdaten enthält, auf die eine Datenpipeline angewiesen ist. Diese Daten sind als Listen und Werte organisiert. Streams -Filter, Webhooks sowie externe Anwendungen lesen und schreiben alle dieselben Daten – über qnLib-Funktionen innerhalb der Filter und über eine REST-API in allen anderen Fällen. Eine Liste wie „watched_wallets“ steuert die Überprüfung der Mitgliedschaft. Ein Wert wie „lastProcessedBlock“ enthält einen Datenpunkt, den eine Pipeline im Laufe der Zeit aktualisiert.

Speichern Sie die Liste im Schlüssel-Wert-Speicher, anstatt sie fest im Filtercode zu hinterlegen. Der Filter überprüft die Zugehörigkeit mit `qnLib.qnContainsListItems`, und eine Aktualisierung über die REST-API oder mit `qnLib.qnUpsertList` verändert die Ergebnisse dieser Überprüfung. Der ausgeführte Filter liest die aktuelle Version der Liste, sodass die Pipeline die Verarbeitung fortsetzt, während sich die Beobachtungsliste ändert.

Ja. Eine Liste im Key-Value-Store ist auf das Konto beschränkt, sodass dieselbe „watched_wallets“-Liste, die ein „ Streams “-Filter mit „qnLib.qnContainsListItems“ überprüft, für jeden Webhook des Kontos verfügbar ist. Es muss keine produktbezogene Kopie erstellt oder synchronisiert werden. Aktualisieren Sie die Liste einmal über die REST-API, und beide Oberflächen lesen die aktuelle Version.

Eine Liste ist eine benannte Sammlung von String-Elementen, die unter einem Schlüssel gespeichert sind und für Zugehörigkeitsprüfungen dient, beispielsweise zum Abgleichen von Absendern mit „watched_wallets“ mithilfe von `qnLib.qnContainsListItems`. Ein Wert speichert einen Datenpunkt unter einem Schlüssel, der im Zeitverlauf verfolgt wird, wie beispielsweise `lastProcessedBlock`. Listen geben Auskunft darüber, ob ein Element zu einer Sammlung gehört. Werte geben Auskunft darüber, welchen Wert ein verfolgter Datenpunkt aktuell hat.

Die Verwendung von `qnLib.qnContainsListItems` in Ihrem Filter unter Streams sowie die Nutzung Ihrer Liste unter Webhooks sind in jedem Quicknode -Tarif kostenlos enthalten. Dies gilt für diese Abfragen, nicht jedoch für Schreibvorgänge oder Speicherplatz. Daher kann ein Filter unter Streams eine große Liste so oft überprüfen, wie er ausgeführt wird. Die aktuellen Bedingungen für alle anderen Funktionen finden Sie auf der Preisseite unter Quicknode .

Die REST-API und die qnLib-Funktionen sind zwei Wege, um auf dieselben zugrunde liegenden Daten zuzugreifen. Ein „ Streams “-Filter ruft während seiner Ausführung Funktionen wie „qnLib.qnGetValue“ nativ auf. Ein Backend, ein Skript oder ein „ agent “ ruft die REST-API mit demselben API-Schlüssel „ Quicknode “ auf. Wenn Sie eine Liste über eine dieser Schnittstellen aktualisieren, lesen alle Elemente, die darauf zugreifen – sei es ein Filter oder eine Anwendung –, die aktuelle Version.

Ja. Die Daten im Key-Value-Store sind auf Kontoebene gespeichert: Sie befinden sich auf der Ebene des Quicknode -Kontos und nicht innerhalb eines Projekts oder unter endpoint. Jeder Streams -Filter und jeder Webhook auf dem Konto liest dieselben Listen und Werte, und die REST-API greift mit dem API-Schlüssel des Kontos auf dieselben Daten zu. Erstellen Sie „watched_wallets“ einmal, und jede Pipeline überprüft eine aktuelle Kopie, anstatt eine eigene zu verwalten.

Der Key-Value-Store kann Millionen von Elementen speichern, sodass eine umfangreiche Beobachtungsliste wie „watched_wallets“ in einer einzigen Liste Platz findet. Eine Aufteilung auf mehrere Systeme ist nicht erforderlich. Bei der Überprüfung der Mitgliedschaft mit „qnLib.qnContainsListItems“ wird dieselbe Liste aus den Filtern von „ Streams “ ausgelesen. Aktuelle Informationen zu Speicherplatz und Elementanzahlen finden Sie in der Dokumentation zum Key-Value-Store, bevor Sie die Größe einer Arbeitslast festlegen.

Ja, bei Einträgen im Schlüssel-Wert-Speicher wird zwischen Groß- und Kleinschreibung unterschieden, sodass 0xAbC1 und 0xabc1 zwei verschiedene Einträge sind. Dies ist vor allem bei Blockchain-Adressen von Bedeutung. Speichern Sie eine Adresse in derselben Schreibweise, die ein „ Streams “-Filter beim Aufruf von `qnLib.qnContainsListItems` verwendet, da sonst ein Eintrag mit Prüfsumme nicht mit seinem entsprechenden Eintrag in Kleinbuchstaben übereinstimmt. Eine einheitliche Schreibweise beim Speichern gewährleistet die Genauigkeit der Zugehörigkeitsprüfungen.

Ja. Zwei Beispiel-Apps in der „ Quicknode “-Beispiel-App-Bibliothek basieren auf dem auf dieser Seite beschriebenen „Dynamic-Watchlist“-Muster. „Wallet Tracking“ überwacht Wallet-Adressen auf Solana und Ethereum, wobei die Beobachtungsliste im Key-Value-Store gespeichert und über eine einfache Benutzeroberfläche aktualisiert wird. „HyperCore Order Monitor“ verfolgt Handelsaufträge auf Hyperliquid Core, wobei die beobachteten Adressen und der Status der Aufträge in Listen im Key-Value-Store gespeichert sind. Beide werden mit Quellcode ausgeliefert, den Sie klonen können.

Möchten Sie auf dem Laufenden bleiben?

Entwickler-Tools

Dokumente und Anleitungen

Ändern Sie, was Ihre Pipeline überwacht.Überspringen Sie die erneute Bereitstellung.

Die Liste hat sich erneut geändert. Dein Filter jedoch nicht.

Änderungen bei jedem PATCH.

Das ändert sich nie.

Globale Listen und Werte sorgen dafür, dass Ihre „ Streams “, „ Webhooks “ und Apps synchronisiert bleiben .

Große dynamische Listen und globale Werte.Auswahl nach Auftrag.

Setzen Sie Ihre erste Liste in die Tat um.

Häufig gestellte Fragen

Verfolgung von Geldbörsen

HyperCore-Auftragsüberwachung

Esgibt nichts Neues auszuführen.Es läuft nach dem Plan, den Sie haben.

Zwei Apps nutzen dieses Muster bereits. Klonen Sie eine davon.

Erstelle eine Liste.

Lies es in deiner Pipeline.

Aktualisieren Sie es von überall aus.

Dokumentation zum Schlüssel-Wert-Speicher

Preise