quicknode-sdk 0.2.0__tar.gz → 0.2.1__tar.gz

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/Cargo.lock

@@ -113,9 +113,9 @@ dependencies = [
 
 [[package]]
 name = "bitflags"
-version = "2.11.1"
+version = "2.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4512299f36f043ab09a583e57bceb5a5aab7a73db1805848e8fef3c9e8c78b3"
+checksum = "84d7ced0ae9557296835c32bf1b1e02b44c746701f898460fb000d7eaa84f00a"
 dependencies = [
  "serde_core",
 ]
@@ -1155,9 +1155,9 @@ checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0"
 
 [[package]]
 name = "log"
-version = "0.4.30"
+version = "0.4.31"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "616ec5685824bcc94416c6d4a7a446eea774a31efd7062c8480ba6fd06d7a6e5"
+checksum = "113b30b4cd05f7c06868fdb2854f66a7b9fece9a48425351cd532e810d74024f"
 
 [[package]]
 name = "lru-slab"
@@ -1700,7 +1700,7 @@ dependencies = [
 
 [[package]]
 name = "quicknode-sdk"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "bon",
  "config",
@@ -2029,9 +2029,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-native-certs"
-version = "0.8.3"
+version = "0.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "612460d5f7bea540c490b2b6395d8e34a953e52b491accd6c86c8164c5932a63"
+checksum = "dab5152771c58876a2146916e53e35057e1a4dfa2b9df0f0305b07f611fdea4d"
 dependencies = [
  "openssl-probe",
  "rustls-pki-types",
@@ -2177,7 +2177,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-node"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "napi",
  "napi-build",
@@ -2189,7 +2189,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "pyo3",
  "pyo3-async-runtimes",
@@ -2200,7 +2200,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python-stubs"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "pyo3-stub-gen",
  "sdk-python",
@@ -2208,7 +2208,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-ruby"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "magnus",
  "quicknode-sdk",
@@ -2819,9 +2819,9 @@ checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
 
 [[package]]
 name = "unicode-segmentation"
-version = "1.13.2"
+version = "1.13.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9629274872b2bfaf8d66f5f15725007f635594914870f65218920345aa11aa8c"
+checksum = "c6f5d3c3b1bf09027a88a6bc961fc00497d651009560b5463668dc81b0fa87a8"
 
 [[package]]
 name = "unicode-width"

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/Cargo.toml

@@ -3,7 +3,7 @@ resolver = "2"
 members = ["crates/core", "crates/python"]
 
 [workspace.package]
-version = "0.2.0"
+version = "0.2.1"
 edition = "2021"
 license = "MIT"
 

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quicknode-sdk
-Version: 0.2.0
+Version: 0.2.1
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
@@ -1276,20 +1276,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 template supports two input forms — inline values (`*Args(*Template(...))`) or a reference to a pre-created list by name (`*ByListArgs(*ByListTemplate(...))`):
 
-| Factory | Argument struct | Fields |
+| Template | Inline class (fields) | ByList class (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[]` |
+| EVM wallet filter | `EvmWalletFilterArgs(EvmWalletFilterTemplate(wallets=[...]))` | `EvmWalletFilterByListArgs(EvmWalletFilterByListTemplate(wallets_list_name=...))` |
+| EVM contract events | `EvmContractEventsArgs(EvmContractEventsTemplate(contracts=[...], event_hashes=[...]))` | `EvmContractEventsByListArgs(EvmContractEventsByListTemplate(contracts_list_name=..., event_hashes_list_name=...))` |
+| EVM ABI filter | `EvmAbiFilterArgs(EvmAbiFilterTemplate(abi="...", contracts=[...]))` | `EvmAbiFilterByListArgs(EvmAbiFilterByListTemplate(abi_json="...", contracts_list_name=...))` |
+| Solana wallet filter | `SolanaWalletFilterArgs(SolanaWalletFilterTemplate(accounts=[...]))` | `SolanaWalletFilterByListArgs(SolanaWalletFilterByListTemplate(accounts_list_name=...))` |
+| Bitcoin wallet filter | `BitcoinWalletFilterArgs(BitcoinWalletFilterTemplate(wallets=[...]))` | `BitcoinWalletFilterByListArgs(BitcoinWalletFilterByListTemplate(wallets_list_name=...))` |
+| XRPL wallet filter | `XrplWalletFilterArgs(XrplWalletFilterTemplate(wallets=[...]))` | `XrplWalletFilterByListArgs(XrplWalletFilterByListTemplate(wallets_list_name=...))` |
+| Hyperliquid wallet events | `HyperliquidWalletEventsFilterArgs(HyperliquidWalletEventsFilterTemplate(wallets=[...]))` | `HyperliquidWalletEventsFilterByListArgs(HyperliquidWalletEventsFilterByListTemplate(wallets_list_name=...))` |
+| Stellar wallet transactions | `StellarWalletTransactionsFilterArgs(StellarWalletTransactionsFilterTemplate(wallets=[...]))` | `StellarWalletTransactionsFilterByListArgs(StellarWalletTransactionsFilterByListTemplate(wallets_list_name=...))` |
 
-`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).
 
@@ -1338,7 +1338,10 @@ from quicknode_sdk import EvmWalletFilterArgs, EvmWalletFilterTemplate, WebhookD
 webhook = await qn.webhooks.create_webhook_from_template(
     name="Wallet Webhook",
     network="ethereum-mainnet",
-    destination_attributes=WebhookDestinationAttributes(url="https://webhook.site/..."),
+    destination_attributes=WebhookDestinationAttributes(
+        url="https://webhook.site/...",
+        compression="none",
+    ),
     template_args=EvmWalletFilterArgs(
         EvmWalletFilterTemplate(wallets=["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"])
     ),

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/crates/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "quicknode-sdk"
-version = "0.2.0"
+version = "0.2.1"
 edition.workspace = true
 license.workspace = true
 description = "Core library for quicknode sdk"

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/crates/core/README.md

@@ -1309,20 +1309,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 template supports two input forms — inline values or a reference to a pre-created list by name. Construct one per template via the variant + the appropriate input enum (`<Template>Input::Inline | ByList`):
 
-| Factory | Argument struct | Fields |
+| Variant | Inline struct (fields) | ByList struct (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 { wallets_list_name: string }` |
+| `EvmContractEvents` | `EvmContractEventsTemplate { contracts: string[], event_hashes: string[] }` | `EvmContractEventsByListTemplate { contracts_list_name: string, event_hashes_list_name?: string }` |
+| `EvmAbiFilter` | `EvmAbiFilterTemplate { abi: string, contracts: string[] }` | `EvmAbiFilterByListTemplate { abi_json: string, contracts_list_name?: string }` |
+| `SolanaWalletFilter` | `SolanaWalletFilterTemplate { accounts: string[] }` | `SolanaWalletFilterByListTemplate { accounts_list_name: string }` |
+| `BitcoinWalletFilter` | `BitcoinWalletFilterTemplate { wallets: string[] }` | `BitcoinWalletFilterByListTemplate { wallets_list_name: string }` |
+| `XrplWalletFilter` | `XrplWalletFilterTemplate { wallets: string[] }` | `XrplWalletFilterByListTemplate { wallets_list_name: string }` |
+| `HyperliquidWalletEventsFilter` | `HyperliquidWalletEventsFilterTemplate { wallets: string[] }` | `HyperliquidWalletEventsFilterByListTemplate { wallets_list_name: string }` |
+| `StellarWalletTransactionsSourceAccountFilter` | `StellarWalletTransactionsFilterTemplate { wallets: string[] }` | `StellarWalletTransactionsFilterByListTemplate { wallets_list_name: 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).
 
@@ -1376,7 +1376,7 @@ let params = CreateWebhookFromTemplateParams {
     destination_attributes: WebhookDestinationAttributes {
         url: "https://webhook.site/...".to_string(),
         security_token: None,
-        compression: None,
+        compression: "none".to_string(),
     },
     template_args,
 };

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/crates/core/examples/webhooks_e2e.rs

@@ -2,9 +2,9 @@ use std::{thread, time::Duration};
 
 use quicknode_sdk::{
     webhooks::{
-        ActivateWebhookParams, CreateWebhookFromTemplateParams, EvmWalletFilterTemplate,
-        GetWebhooksParams, TemplateArgs, UpdateWebhookParams, WebhookDestinationAttributes,
-        WebhookStartFrom,
+        ActivateWebhookParams, CreateWebhookFromTemplateParams, EvmContractEventsTemplate,
+        EvmWalletFilterTemplate, GetWebhooksParams, TemplateArgs, UpdateWebhookParams,
+        WebhookDestinationAttributes, WebhookStartFrom,
     },
     QuicknodeSdk, SdkFullConfig,
 };
@@ -44,7 +44,7 @@ async fn main() {
         destination_attributes: WebhookDestinationAttributes {
             url: "https://webhook.site/ae19071a-2dcc-4035-9cdf-406dcb4719ef".to_string(),
             security_token: None,
-            compression: None,
+            compression: "none".to_string(),
         },
         template_args,
     };
@@ -98,6 +98,42 @@ async fn main() {
     println!("deleted: {id}");
     thread::sleep(Duration::from_secs(1));
 
+    // Exercise the evm-contract-events template, which carries the multi-word
+    // `event_hashes` field. The API expects `eventHashes` on the wire.
+    let contract_events_args = TemplateArgs::EvmContractEvents(EvmContractEventsTemplate {
+        contracts: vec!["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48".to_string()],
+        event_hashes: vec![
+            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef".to_string(),
+        ],
+    });
+    let contract_events_params = CreateWebhookFromTemplateParams {
+        name: "E2E Test Webhook (evmContractEvents)".to_string(),
+        network: "ethereum-mainnet".to_string(),
+        notification_email: None,
+        destination_attributes: WebhookDestinationAttributes {
+            url: "https://webhook.site/ae19071a-2dcc-4035-9cdf-406dcb4719ef".to_string(),
+            security_token: None,
+            compression: "none".to_string(),
+        },
+        template_args: contract_events_args,
+    };
+    let ce_webhook = qn
+        .webhooks
+        .create_webhook_from_template(&contract_events_params)
+        .await
+        .expect("create_webhook_from_template (evmContractEvents) failed");
+    println!(
+        "created (evmContractEvents): {} | {}",
+        ce_webhook.id, ce_webhook.status
+    );
+    thread::sleep(Duration::from_secs(1));
+    qn.webhooks
+        .delete_webhook(&ce_webhook.id)
+        .await
+        .expect("delete_webhook (evmContractEvents) failed");
+    println!("deleted (evmContractEvents): {}", ce_webhook.id);
+    thread::sleep(Duration::from_secs(1));
+
     let after = qn
         .webhooks
         .list_webhooks(&GetWebhooksParams::default())

{quicknode_sdk-0.2.0 → quicknode_sdk-0.2.1}/crates/core/src/webhooks/mod.rs

@@ -1,13 +1,19 @@
 pub mod webhook;
 
 pub use webhook::{
-    ActivateWebhookParams, BitcoinWalletFilterTemplate, CreateWebhookFromTemplateParams,
-    EvmAbiFilterTemplate, EvmContractEventsTemplate, EvmWalletFilterTemplate, GetWebhooksParams,
-    HyperliquidWalletEventsFilterTemplate, ListWebhooksResponse, SolanaWalletFilterTemplate,
+    ActivateWebhookParams, BitcoinWalletFilterByListTemplate, BitcoinWalletFilterInput,
+    BitcoinWalletFilterTemplate, CreateWebhookFromTemplateParams, EvmAbiFilterByListTemplate,
+    EvmAbiFilterInput, EvmAbiFilterTemplate, EvmContractEventsByListTemplate,
+    EvmContractEventsInput, EvmContractEventsTemplate, EvmWalletFilterByListTemplate,
+    EvmWalletFilterInput, EvmWalletFilterTemplate, GetWebhooksParams,
+    HyperliquidWalletEventsFilterByListTemplate, HyperliquidWalletEventsFilterInput,
+    HyperliquidWalletEventsFilterTemplate, ListWebhooksResponse, SolanaWalletFilterByListTemplate,
+    SolanaWalletFilterInput, SolanaWalletFilterTemplate,
+    StellarWalletTransactionsFilterByListTemplate, StellarWalletTransactionsFilterInput,
     StellarWalletTransactionsFilterTemplate, TemplateArgs, UpdateWebhookParams,
     UpdateWebhookTemplateParams, Webhook, WebhookDestinationAttributes,
     WebhookEnabledCountResponse, WebhookPageInfo, WebhookStartFrom, WebhookTemplateId,
-    XrplWalletFilterTemplate,
+    XrplWalletFilterByListTemplate, XrplWalletFilterInput, XrplWalletFilterTemplate,
 };
 
 use crate::{config::WebhooksConfig, errors::SdkError, SdkConfig};
@@ -255,8 +261,8 @@ impl 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.
@@ -633,9 +639,10 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmWalletFilter(EvmWalletFilterTemplate {
-            wallets: vec!["0xabc".to_string()],
-        });
+        let template_args =
+            TemplateArgs::EvmWalletFilter(EvmWalletFilterInput::Inline(EvmWalletFilterTemplate {
+                wallets: vec!["0xabc".to_string()],
+            }));
         let params = CreateWebhookFromTemplateParams {
             name: "test-webhook".to_string(),
             network: "ethereum-mainnet".to_string(),
@@ -643,7 +650,7 @@ mod tests {
             destination_attributes: WebhookDestinationAttributes {
                 url: "https://example.com/hook".to_string(),
                 security_token: None,
-                compression: None,
+                compression: "none".to_string(),
             },
             template_args,
         };
@@ -664,9 +671,10 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmWalletFilter(EvmWalletFilterTemplate {
-            wallets: vec!["0xabc".to_string()],
-        });
+        let template_args =
+            TemplateArgs::EvmWalletFilter(EvmWalletFilterInput::Inline(EvmWalletFilterTemplate {
+                wallets: vec!["0xabc".to_string()],
+            }));
         let params = CreateWebhookFromTemplateParams {
             name: "test-webhook".to_string(),
             network: "ethereum-mainnet".to_string(),
@@ -674,7 +682,7 @@ mod tests {
             destination_attributes: WebhookDestinationAttributes {
                 url: "https://example.com/hook".to_string(),
                 security_token: None,
-                compression: None,
+                compression: "none".to_string(),
             },
             template_args,
         };
@@ -695,9 +703,10 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmWalletFilter(EvmWalletFilterTemplate {
-            wallets: vec!["0xabc".to_string()],
-        });
+        let template_args =
+            TemplateArgs::EvmWalletFilter(EvmWalletFilterInput::Inline(EvmWalletFilterTemplate {
+                wallets: vec!["0xabc".to_string()],
+            }));
         let params = UpdateWebhookTemplateParams {
             name: None,
             notification_email: None,
@@ -725,9 +734,10 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmWalletFilter(EvmWalletFilterTemplate {
-            wallets: vec!["0xabc".to_string()],
-        });
+        let template_args =
+            TemplateArgs::EvmWalletFilter(EvmWalletFilterInput::Inline(EvmWalletFilterTemplate {
+                wallets: vec!["0xabc".to_string()],
+            }));
         let params = UpdateWebhookTemplateParams {
             name: Some("new-name".to_string()),
             notification_email: None,
@@ -758,10 +768,12 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmContractEvents(EvmContractEventsTemplate {
-            contracts: vec!["0xa0b8".to_string()],
-            event_hashes: Some(vec!["0xabcd".to_string()]),
-        });
+        let template_args = TemplateArgs::EvmContractEvents(EvmContractEventsInput::Inline(
+            EvmContractEventsTemplate {
+                contracts: vec!["0xa0b8".to_string()],
+                event_hashes: vec!["0xabcd".to_string()],
+            },
+        ));
         let params = CreateWebhookFromTemplateParams {
             name: "test-webhook".to_string(),
             network: "ethereum-mainnet".to_string(),
@@ -769,7 +781,7 @@ mod tests {
             destination_attributes: WebhookDestinationAttributes {
                 url: "https://example.com/hook".to_string(),
                 security_token: None,
-                compression: None,
+                compression: "none".to_string(),
             },
             template_args,
         };
@@ -788,9 +800,10 @@ mod tests {
             .mount(&server)
             .await;
         let sdk = make_sdk(format!("{}/", server.uri()));
-        let template_args = TemplateArgs::EvmWalletFilter(EvmWalletFilterTemplate {
-            wallets: vec!["0xabc".to_string()],
-        });
+        let template_args =
+            TemplateArgs::EvmWalletFilter(EvmWalletFilterInput::Inline(EvmWalletFilterTemplate {
+                wallets: vec!["0xabc".to_string()],
+            }));
         let params = UpdateWebhookTemplateParams {
             name: None,
             notification_email: None,