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.

키-값 저장소: Streams 필터 목록 업데이트, 재배포 불필요

콘텐츠 불러오는 중...

// FAQ

자주 묻는 질문

비용, 제한 사항, 적용 범위, 그리고 각 요소가 어떻게 서로 연동되는지. 키-값 저장소(Key-Value Store) 문서에는 모든 키-값 쌍( endpoint )과 함수가 상세히 설명되어 있습니다.

키-값 저장소(Key-Value Store)는 Quicknode 에서 데이터 파이프라인이 의존하는 작은 상태 정보들을 리스트와 값의 형태로 구성하여 저장하는 계정 수준의 저장소입니다. Streams 필터, Webhooks 및 외부 애플리케이션은 모두 필터 내부의 qnLib 함수와 그 외 모든 곳의 REST API를 통해 동일한 데이터를 읽고 씁니다. watched_wallets와 같은 리스트는 멤버십 확인을 처리합니다. lastProcessedBlock과 같은 값은 파이프라인이 시간이 지남에 따라 업데이트하는 하나의 데이터 포인트를 포함합니다.

필터 코드에 목록을 하드코딩하지 말고 키-값 저장소에 저장하십시오. 필터는 qnLib.qnContainsListItems를 사용하여 목록 포함 여부를 확인하며, REST API를 통한 업데이트나 qnLib.qnUpsertList를 사용하면 해당 확인 대상이 변경됩니다. 실행 중인 필터는 목록의 최신 버전을 읽기 때문에, 감시 목록이 변경되는 동안에도 파이프라인은 계속 처리됩니다.

네. 키-값 저장소(Key-Value Store)의 목록은 계정 단위로 적용되므로, Streams 필터가 qnLib.qnContainsListItems를 통해 확인하는 동일한 watched_wallets 목록을 해당 계정의 모든 웹훅에서 사용할 수 있습니다. 제품별로 별도의 복사본을 생성하거나 동기화할 필요가 없습니다. REST API를 통해 목록을 한 번만 업데이트하면, 두 인터페이스 모두 최신 버전을 읽게 됩니다.

리스트는 하나의 키 아래에 저장된 문자열 항목들의 이름이 지정된 모음으로, qnLib.qnContainsListItems를 사용하여 발신자를 watched_wallets와 대조하는 것과 같이 소속 여부를 확인하기 위해 만들어집니다. 값은 하나의 키 아래에 하나의 데이터 포인트를 저장하며, lastProcessedBlock과 같이 시간 경과에 따라 추적됩니다. 리스트는 항목이 모음에 속하는지 여부를 알려줍니다. 값은 추적 중인 하나의 데이터 포인트가 현재 어떤 값을 가지고 있는지를 알려줍니다.

Streams 필터 내에서 qnLib.qnContainsListItems를 사용하는 기능과 Webhooks 에서 목록을 사용하는 기능은 모든 Quicknode 요금제에 무료로 포함됩니다. 이는 조회 작업에만 적용되며, 쓰기 작업이나 저장 공간에는 적용되지 않으므로, Streams 필터는 실행될 때마다 대용량 목록을 자유롭게 확인할 수 있습니다. 그 외 모든 항목에 대한 최신 이용 약관은 Quicknode 요금제 페이지에서 확인하시기 바랍니다.

키-값 스토어(Key-Value Store)는 모든 Quicknode 요금제에서 이용할 수 있으며, 별도로 구매하거나 프로비저닝할 필요가 없습니다. Streams 필터 내의 qnLib.qnContainsListItems 사용 및 Webhooks 에서 목록을 사용하는 기능은 무료로 제공됩니다. 쓰기 및 저장 공간에 대한 최신 이용 약관은 Quicknode 요금 페이지에서 확인하시기 바랍니다.

REST API와 qnLib 함수는 동일한 기본 데이터에 접근하는 두 가지 방법입니다. Streams 필터는 실행 중에 qnLib.qnGetValue와 같은 함수를 네이티브 방식으로 호출합니다. 백엔드, 스크립트 또는 agent 은 동일한 Quicknode API 키를 사용하여 REST API를 호출합니다. 두 인터페이스 중 하나를 통해 목록을 업데이트하면, 이를 읽는 모든 대상(필터 또는 애플리케이션)은 최신 버전을 읽게 됩니다.

네. 키-값 저장소(Key-Value Store) 데이터는 계정 단위로 관리됩니다. 즉, 특정 프로젝트나 endpoint 내부가 아닌 Quicknode 계정 수준에 저장됩니다. 계정 내의 모든 Streams 필터와 모든 웹훅은 동일한 목록과 값을 읽으며, REST API도 해당 계정의 API 키를 사용하여 동일한 데이터에 접근합니다. watched_wallets를 한 번만 생성하면, 각 파이프라인은 자체적으로 복사본을 관리할 필요 없이 하나의 최신 복사본을 확인합니다.

키-값 저장소(Key-Value Store)는 수백만 개의 항목을 저장할 수 있으므로, 대규모 감시 목록도 watched_wallets와 같은 단일 목록에 모두 담을 수 있습니다. 이를 여러 시스템에 분산할 필요가 없습니다. qnLib.qnContainsListItems를 사용한 멤버십 확인은 Streams 필터 내부에서 동일한 목록을 읽어옵니다. 저장소 및 항목 수에 대한 최신 세부 정보는 워크로드 규모를 결정하기 전에 키-값 저장소 문서를 확인하시기 바랍니다.

네, 키-값 저장소(Key-Value Store)의 항목은 대소문자를 구분하므로 0xAbC1과 0xabc1은 서로 다른 항목입니다. 이는 특히 블록체인 주소에서 중요합니다. 주소를 저장할 때는 Streams 필터가 qnLib.qnContainsListItems를 호출할 때 사용하는 것과 동일한 대소문자 표기법을 사용해야 합니다. 그렇지 않으면 체크섬이 적용된 항목이 소문자로 표기된 항목과 일치하지 않을 수 있습니다. 쓰기 시점에 대소문자 표기법을 일관되게 유지해야 멤버십 확인이 정확하게 이루어집니다.

네. ‘ Quicknode ’ 샘플 앱 라이브러리에 포함된 두 가지 샘플 앱은 이 페이지에서 설명하는 동적 감시 목록(dynamic-watchlist) 패턴을 기반으로 제작되었습니다. ‘Wallet Tracking’은 Solana 및 Ethereum 에서 지갑 주소를 모니터링하며, 감시 목록은 키-값 저장소(Key-Value Store)에 저장되고 간단한 UI를 통해 업데이트됩니다. ‘HyperCore Order Monitor’는 Hyperliquid Core에서 거래 주문을 추적하며, 감시 대상 주소와 주문 상태는 키-값 저장소 목록에 저장됩니다. 두 앱 모두 클론할 수 있는 소스 코드가 함께 제공됩니다.

최신 소식을 받아보시겠습니까?

개발자 도구

문서 및 가이드

실행할 새로운 작업이 없습니다. 현재 계획대로 잘 진행되고 있습니다 .

목록을 만드세요.

파이프라인에서 읽어보세요.

어디서든 업데이트할 수 있습니다.

파이프라인이 모니터링하는 대상을 변경하세요.재배포를 건너뛰세요.

목록이 다시 변경되었습니다. 하지만 귀하의 필터는 변경되지 않았습니다.

모든 PATCH마다 변경 사항이 있습니다.

절대 변하지 않는다.

대규모 동적 목록과 전역 변수.작업별로 선택하세요.

전역적으로 사용 가능한 목록과 값을 통해 Streams, Webhooks 및 앱 간의 데이터를 동기화할 수 있습니다.

이미 두 개의 앱이 이 패턴을 따르고 있습니다. 그중 하나를 복제하세요.

지갑 추적

HyperCore 주문 모니터

키-값 저장소 문서

가격

첫 번째 목록을 실제로 활용해 보세요.

자주 묻는 질문