@quicknode/sdk 3.1.1 → 3.2.1

package/README.md

@@ -4,6 +4,8 @@ Node.js / TypeScript bindings for the Quicknode SDK.
 
 This is one of four language bindings published from the same Rust core. See the [project README](https://github.com/quicknode/sdk/blob/main/README.md) for the polyglot overview, development setup, and release process.
 
+> **Pre-1.0**: While on `0.x`, releases may contain breaking changes. Check the [release notes](https://github.com/quicknode/sdk/releases) before upgrading.
+
 ## Table of Contents
 
 - [Installation](#installation)
@@ -1255,20 +1257,20 @@ Accessed as `qn.webhooks`. Creates webhooks from filter templates and manages th
 | `HyperliquidWalletEventsFilter` | `hyperliquidWalletEventsFilter` |
 | `StellarWalletTransactionsSourceAccountFilter` | `stellarWalletTransactionsSourceAccountFilter` |
 
-`TemplateArgs` carries the arguments; construct one per template via the factory methods:
+`TemplateArgs` carries the arguments. Each factory method accepts either the inline template (with values) or the `*ByListTemplate` (with a pre-created list name):
 
-| Factory | Argument struct | Fields |
+| Factory | Inline template (fields) | ByList template (fields) |
 |---|---|---|
-| `evm_wallet_filter` | `EvmWalletFilterTemplate` | `wallets: string[]` |
-| `evm_contract_events` | `EvmContractEventsTemplate` | `contracts: string[]`, `event_hashes?: string[]` |
-| `evm_abi_filter` | `EvmAbiFilterTemplate` | `abi: string` (JSON), `contracts: string[]` |
-| `solana_wallet_filter` | `SolanaWalletFilterTemplate` | `accounts: string[]` |
-| `bitcoin_wallet_filter` | `BitcoinWalletFilterTemplate` | `wallets: string[]` |
-| `xrpl_wallet_filter` | `XrplWalletFilterTemplate` | `wallets: string[]` |
-| `hyperliquid_wallet_events_filter` | `HyperliquidWalletEventsFilterTemplate` | `wallets: string[]` |
-| `stellar_wallet_transactions_filter` | `StellarWalletTransactionsFilterTemplate` | `source_accounts: string[]` |
+| `evmWalletFilter` | `EvmWalletFilterTemplate { wallets: string[] }` | `EvmWalletFilterByListTemplate { walletsListName: string }` |
+| `evmContractEvents` | `EvmContractEventsTemplate { contracts: string[], eventHashes: string[] }` | `EvmContractEventsByListTemplate { contractsListName: string, eventHashesListName?: string }` |
+| `evmAbiFilter` | `EvmAbiFilterTemplate { abi: string, contracts: string[] }` | `EvmAbiFilterByListTemplate { abiJson: string, contractsListName?: string }` |
+| `solanaWalletFilter` | `SolanaWalletFilterTemplate { accounts: string[] }` | `SolanaWalletFilterByListTemplate { accountsListName: string }` |
+| `bitcoinWalletFilter` | `BitcoinWalletFilterTemplate { wallets: string[] }` | `BitcoinWalletFilterByListTemplate { walletsListName: string }` |
+| `xrplWalletFilter` | `XrplWalletFilterTemplate { wallets: string[] }` | `XrplWalletFilterByListTemplate { walletsListName: string }` |
+| `hyperliquidWalletEventsFilter` | `HyperliquidWalletEventsFilterTemplate { wallets: string[] }` | `HyperliquidWalletEventsFilterByListTemplate { walletsListName: string }` |
+| `stellarWalletTransactionsFilter` | `StellarWalletTransactionsFilterTemplate { wallets: string[] }` | `StellarWalletTransactionsFilterByListTemplate { walletsListName: string }` |
 
-`WebhookDestinationAttributes`: `url` (required), `security_token` (optional — auto-generated if omitted), `compression` (optional — `"none"` | `"gzip"`).
+`WebhookDestinationAttributes`: `url` (required), `compression` (required — `"none"` | `"gzip"`), `security_token` (optional — auto-generated if omitted).
 
 `WebhookStartFrom`: `Last` (resume from last delivered block) or `Latest` (start from newest).
 
@@ -1317,7 +1319,7 @@ import { TemplateArgs } from "quicknode-sdk";
 const webhook = await qn.webhooks.createWebhookFromTemplate({
   name: "Wallet Webhook",
   network: "ethereum-mainnet",
-  destinationAttributes: { url: "https://webhook.site/..." },
+  destinationAttributes: { url: "https://webhook.site/...", compression: "none" },
   templateArgs: TemplateArgs.evmWalletFilter({
     wallets: ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],
   }),

package/index.d.ts

@@ -59,6 +59,12 @@ export interface AzureAttributes {
   blobPrefix?: string
 }
 
+/** ByList form of `BitcoinWalletFilterTemplate`. */
+export interface BitcoinWalletFilterByListTemplate {
+  /** Name of the pre-created wallets list. */
+  walletsListName: string
+}
+
 /** Template arguments for a Bitcoin wallet filter. */
 export interface BitcoinWalletFilterTemplate {
   /** Bitcoin wallet addresses to match against. */
@@ -599,6 +605,22 @@ export interface EndpointUsage {
   requests?: number
 }
 
+/**
+ * ByList form of `EvmAbiFilterTemplate` — carries the ABI inline (the only
+ * non-list shape this template has) and optionally references a pre-created
+ * contracts list. Note the wire key is `abiJson`, distinct from the inline
+ * variant's `abi`.
+ */
+export interface EvmAbiFilterByListTemplate {
+  /** JSON-encoded contract ABI used to decode event data. */
+  abiJson: string
+  /**
+   * Optional name of a pre-created contracts list; when omitted, the ABI
+   * is applied to all contracts.
+   */
+  contractsListName?: string
+}
+
 /**
  * Template arguments for an EVM ABI filter: decodes and filters events for a
  * set of contracts using a provided ABI.
@@ -611,14 +633,38 @@ export interface EvmAbiFilterTemplate {
 }
 
 /**
- * Template arguments for filtering EVM contract events, optionally scoped to
- * a specific set of event topic hashes.
+ * ByList form of `EvmContractEventsTemplate` — references pre-created
+ * contract and (optionally) event-hash lists by name. Omitting
+ * `event_hashes_list_name` matches all events from the listed contracts.
+ */
+export interface EvmContractEventsByListTemplate {
+  /** Name of the pre-created contracts list. */
+  contractsListName: string
+  /**
+   * Optional name of a pre-created event-hashes list; when omitted, all
+   * events from the listed contracts match.
+   */
+  eventHashesListName?: string
+}
+
+/**
+ * Template arguments for filtering EVM contract events, scoped to a specific
+ * set of event topic hashes.
  */
 export interface EvmContractEventsTemplate {
   /** Contract addresses to watch for events. */
   contracts: Array<string>
-  /** Optional list of event topic hashes to restrict the filter to specific events. */
-  eventHashes?: Array<string>
+  /** Event topic hashes to restrict the filter to specific events. */
+  eventHashes: Array<string>
+}
+
+/**
+ * ByList form of `EvmWalletFilterTemplate` — references a pre-created
+ * wallets list by name instead of inlining the addresses.
+ */
+export interface EvmWalletFilterByListTemplate {
+  /** Name of the pre-created wallets list. */
+  walletsListName: string
 }
 
 /**
@@ -949,6 +995,12 @@ export interface HttpConfig {
   headers?: Record<string, string>
 }
 
+/** ByList form of `HyperliquidWalletEventsFilterTemplate`. */
+export interface HyperliquidWalletEventsFilterByListTemplate {
+  /** Name of the pre-created wallets list. */
+  walletsListName: string
+}
+
 /** Template arguments for a Hyperliquid wallet-events filter. */
 export interface HyperliquidWalletEventsFilterTemplate {
   /** Hyperliquid wallet addresses to match against. */
@@ -1417,6 +1469,12 @@ export interface SingleEndpoint {
   isMultichain: boolean
 }
 
+/** ByList form of `SolanaWalletFilterTemplate`. */
+export interface SolanaWalletFilterByListTemplate {
+  /** Name of the pre-created accounts list. */
+  accountsListName: string
+}
+
 /**
  * Template arguments for a Solana wallet filter: matches activity for a list
  * of Solana account addresses.
@@ -1426,6 +1484,12 @@ export interface SolanaWalletFilterTemplate {
   accounts: Array<string>
 }
 
+/** ByList form of `StellarWalletTransactionsFilterTemplate`. */
+export interface StellarWalletTransactionsFilterByListTemplate {
+  /** Name of the pre-created wallets list. */
+  walletsListName: string
+}
+
 /**
  * Template arguments for a Stellar wallet-transactions filter, matching
  * transactions where the given wallets are the source account.
@@ -1800,8 +1864,8 @@ export interface WebhookDestinationAttributes {
   url: string
   /** Optional token sent with each payload so the receiver can verify authenticity; generated automatically when omitted. */
   securityToken?: string
-  /** Optional payload compression (`gzip` or `none`). */
-  compression?: string
+  /** Payload compression (`gzip` or `none`). */
+  compression: string
 }
 
 /** Response from `get_enabled_count` for webhooks. */
@@ -1844,6 +1908,12 @@ export declare const enum WebhookTemplateId {
   StellarWalletTransactionsSourceAccountFilter = 'StellarWalletTransactionsSourceAccountFilter'
 }
 
+/** ByList form of `XrplWalletFilterTemplate`. */
+export interface XrplWalletFilterByListTemplate {
+  /** Name of the pre-created wallets list. */
+  walletsListName: string
+}
+
 /** Template arguments for an XRPL wallet filter. */
 export interface XrplWalletFilterTemplate {
   /** XRPL wallet addresses to match against. */
@@ -2331,8 +2401,8 @@ export declare class WebhooksApiClient {
   /**
    * Creates a new webhook from a predefined filter template. Requires a
    * descriptive name, a target blockchain network, and destination
-   * attributes (URL, optional security token — auto-generated when omitted,
-   * and optional compression — `gzip` or `none`). `template_args` carries
+   * attributes (URL, compression — `gzip` or `none`, and an optional
+   * security token — auto-generated when omitted). `template_args` carries
    * template-specific configuration such as wallet addresses or contract
    * filters. An optional `notification_email` receives alerts if the
    * webhook terminates.

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-android-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-android-arm64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-android-arm-eabi')
         const bindingPackageVersion = require('@quicknode/sdk-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-x64-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-x64-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-ia32-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-arm64-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@quicknode/sdk-darwin-universal')
       const bindingPackageVersion = require('@quicknode/sdk-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-darwin-x64')
         const bindingPackageVersion = require('@quicknode/sdk-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-darwin-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-freebsd-x64')
         const bindingPackageVersion = require('@quicknode/sdk-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-freebsd-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-x64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-x64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm-musleabihf')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-loong64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-loong64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-riscv64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-riscv64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-linux-ppc64-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-linux-s390x-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-x64')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-arm')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '3.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.2.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicknode/sdk",
-  "version": "3.1.1",
+  "version": "3.2.1",
   "description": "Quicknode SDK",
   "repository": {
     "type": "git",
@@ -52,12 +52,12 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.0"
   },
+  "license": "MIT",
   "optionalDependencies": {
-    "@quicknode/sdk-linux-x64-gnu": "3.1.1",
-    "@quicknode/sdk-linux-arm64-gnu": "3.1.1",
-    "@quicknode/sdk-linux-x64-musl": "3.1.1",
-    "@quicknode/sdk-linux-arm64-musl": "3.1.1",
-    "@quicknode/sdk-darwin-arm64": "3.1.1"
-  },
-  "license": "MIT"
+    "@quicknode/sdk-linux-x64-gnu": "3.2.1",
+    "@quicknode/sdk-linux-arm64-gnu": "3.2.1",
+    "@quicknode/sdk-linux-x64-musl": "3.2.1",
+    "@quicknode/sdk-linux-arm64-musl": "3.2.1",
+    "@quicknode/sdk-darwin-arm64": "3.2.1"
+  }
 }

package/sdk.d.ts

@@ -66,16 +66,28 @@ export type ListStreamsResponse = Omit<_ListStreamsResponseNode, "data"> & {
 // wire's `templateArgs` to avoid `templateArgs.templateArgs.wallets`; the
 // Node binding renames it back before the request.
 export type TemplateArgsInput =
-  | { templateId: "evmWalletFilter"; args: EvmWalletFilterTemplate }
-  | { templateId: "evmContractEvents"; args: EvmContractEventsTemplate }
-  | { templateId: "evmAbiFilter"; args: EvmAbiFilterTemplate }
-  | { templateId: "solanaWalletFilter"; args: SolanaWalletFilterTemplate }
-  | { templateId: "bitcoinWalletFilter"; args: BitcoinWalletFilterTemplate }
-  | { templateId: "xrplWalletFilter"; args: XrplWalletFilterTemplate }
-  | { templateId: "hyperliquidWalletEventsFilter"; args: HyperliquidWalletEventsFilterTemplate }
+  | { templateId: "evmWalletFilter"; args: EvmWalletFilterTemplate | EvmWalletFilterByListTemplate }
+  | {
+      templateId: "evmContractEvents";
+      args: EvmContractEventsTemplate | EvmContractEventsByListTemplate;
+    }
+  | { templateId: "evmAbiFilter"; args: EvmAbiFilterTemplate | EvmAbiFilterByListTemplate }
+  | {
+      templateId: "solanaWalletFilter";
+      args: SolanaWalletFilterTemplate | SolanaWalletFilterByListTemplate;
+    }
+  | {
+      templateId: "bitcoinWalletFilter";
+      args: BitcoinWalletFilterTemplate | BitcoinWalletFilterByListTemplate;
+    }
+  | { templateId: "xrplWalletFilter"; args: XrplWalletFilterTemplate | XrplWalletFilterByListTemplate }
+  | {
+      templateId: "hyperliquidWalletEventsFilter";
+      args: HyperliquidWalletEventsFilterTemplate | HyperliquidWalletEventsFilterByListTemplate;
+    }
   | {
       templateId: "stellarWalletTransactionsSourceAccountFilter";
-      args: StellarWalletTransactionsFilterTemplate;
+      args: StellarWalletTransactionsFilterTemplate | StellarWalletTransactionsFilterByListTemplate;
     };
 
 // Replace the napi-generated JSON-blob templateArgs with typed unions.
@@ -270,6 +282,14 @@ export type {
   XrplWalletFilterTemplate,
   HyperliquidWalletEventsFilterTemplate,
   StellarWalletTransactionsFilterTemplate,
+  EvmWalletFilterByListTemplate,
+  EvmContractEventsByListTemplate,
+  EvmAbiFilterByListTemplate,
+  SolanaWalletFilterByListTemplate,
+  BitcoinWalletFilterByListTemplate,
+  XrplWalletFilterByListTemplate,
+  HyperliquidWalletEventsFilterByListTemplate,
+  StellarWalletTransactionsFilterByListTemplate,
   WebhooksApiClient,
   // kvstore
   KvStoreConfig,
@@ -353,16 +373,37 @@ export class QuicknodeSdk {
 }
 
 // Typed static factory methods producing each discriminated variant of
-// TemplateArgsInput. Consumers can also construct the object literal directly.
+// TemplateArgsInput. Each template exposes both an inline form (passing the
+// value template) and a by-list form (passing a *ByList template referencing
+// a pre-created list by name). Consumers can also construct the object
+// literal directly.
 export const TemplateArgs: {
-  evmWalletFilter(attrs: EvmWalletFilterTemplate): Extract<TemplateArgsInput, { templateId: "evmWalletFilter" }>;
-  evmContractEvents(attrs: EvmContractEventsTemplate): Extract<TemplateArgsInput, { templateId: "evmContractEvents" }>;
-  evmAbiFilter(attrs: EvmAbiFilterTemplate): Extract<TemplateArgsInput, { templateId: "evmAbiFilter" }>;
-  solanaWalletFilter(attrs: SolanaWalletFilterTemplate): Extract<TemplateArgsInput, { templateId: "solanaWalletFilter" }>;
-  bitcoinWalletFilter(attrs: BitcoinWalletFilterTemplate): Extract<TemplateArgsInput, { templateId: "bitcoinWalletFilter" }>;
-  xrplWalletFilter(attrs: XrplWalletFilterTemplate): Extract<TemplateArgsInput, { templateId: "xrplWalletFilter" }>;
-  hyperliquidWalletEventsFilter(attrs: HyperliquidWalletEventsFilterTemplate): Extract<TemplateArgsInput, { templateId: "hyperliquidWalletEventsFilter" }>;
-  stellarWalletTransactionsFilter(attrs: StellarWalletTransactionsFilterTemplate): Extract<TemplateArgsInput, { templateId: "stellarWalletTransactionsSourceAccountFilter" }>;
+  evmWalletFilter(
+    attrs: EvmWalletFilterTemplate | EvmWalletFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "evmWalletFilter" }>;
+  evmContractEvents(
+    attrs: EvmContractEventsTemplate | EvmContractEventsByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "evmContractEvents" }>;
+  evmAbiFilter(
+    attrs: EvmAbiFilterTemplate | EvmAbiFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "evmAbiFilter" }>;
+  solanaWalletFilter(
+    attrs: SolanaWalletFilterTemplate | SolanaWalletFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "solanaWalletFilter" }>;
+  bitcoinWalletFilter(
+    attrs: BitcoinWalletFilterTemplate | BitcoinWalletFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "bitcoinWalletFilter" }>;
+  xrplWalletFilter(
+    attrs: XrplWalletFilterTemplate | XrplWalletFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "xrplWalletFilter" }>;
+  hyperliquidWalletEventsFilter(
+    attrs: HyperliquidWalletEventsFilterTemplate | HyperliquidWalletEventsFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "hyperliquidWalletEventsFilter" }>;
+  stellarWalletTransactionsFilter(
+    attrs:
+      | StellarWalletTransactionsFilterTemplate
+      | StellarWalletTransactionsFilterByListTemplate
+  ): Extract<TemplateArgsInput, { templateId: "stellarWalletTransactionsSourceAccountFilter" }>;
 };
 
 // Typed error hierarchy. Any SDK call can throw one of these; catch