quicknode-sdk 0.1.0a25__tar.gz → 0.1.0a29__tar.gz

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/Cargo.lock

@@ -156,9 +156,9 @@ dependencies = [
 
 [[package]]
 name = "bumpalo"
-version = "3.20.2"
+version = "3.20.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d20789868f4b01b2f2caec9f5c4e0213b41e3e5702a50157d699ae31ced2fcb"
+checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
 
 [[package]]
 name = "bytes"
@@ -420,9 +420,9 @@ dependencies = [
 
 [[package]]
 name = "displaydoc"
-version = "0.2.5"
+version = "0.2.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0"
+checksum = "1ac70aa55017e108007fbaf5aa0f54b021c98f92ff8af59d42eda9da96e3dd4f"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -712,9 +712,9 @@ checksum = "fc0fef456e4baa96da950455cd02c081ca953b141298e41db3fc7e36b1da849c"
 
 [[package]]
 name = "http"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3ba2a386d7f85a81f119ad7498ebe444d2e22c2af0b86b069416ace48b3311a"
+checksum = "8be7462df143984c4598a256ef469b251d7d7f9e271135073e78fc535414f3d0"
 dependencies = [
  "bytes",
  "itoa",
@@ -757,9 +757,9 @@ checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
 
 [[package]]
 name = "hyper"
-version = "1.9.0"
+version = "1.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6299f016b246a94207e63da54dbe807655bf9e00044f73ded42c3ac5305fbcca"
+checksum = "eb92f162bf56536459fc83c79b974bb12837acfed43d6bc370a7916d0ae15ecc"
 dependencies = [
  "atomic-waker",
  "bytes",
@@ -1088,9 +1088,9 @@ dependencies = [
 
 [[package]]
 name = "js-sys"
-version = "0.3.98"
+version = "0.3.99"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "67df7112613f8bfd9150013a0314e196f4800d3201ae742489d999db2f979f08"
+checksum = "142bc4740e452c1e57ade0cbc129f139c9093e354346f0872ef985f4f5cf5f11"
 dependencies = [
  "cfg-if",
  "futures-util",
@@ -1155,9 +1155,9 @@ checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0"
 
 [[package]]
 name = "log"
-version = "0.4.29"
+version = "0.4.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897"
+checksum = "616ec5685824bcc94416c6d4a7a446eea774a31efd7062c8480ba6fd06d7a6e5"
 
 [[package]]
 name = "lru-slab"
@@ -1206,9 +1206,9 @@ dependencies = [
 
 [[package]]
 name = "memchr"
-version = "2.8.0"
+version = "2.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+checksum = "6b947ae49db0d222b1dbc6b113ce7248a3fc3a6ca21b696717bfc000ba4484d8"
 
 [[package]]
 name = "memoffset"
@@ -1700,7 +1700,7 @@ dependencies = [
 
 [[package]]
 name = "quicknode-sdk"
-version = "0.1.0-alpha.25"
+version = "0.1.0-alpha.29"
 dependencies = [
  "bon",
  "config",
@@ -1917,9 +1917,9 @@ checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
 
 [[package]]
 name = "reqwest"
-version = "0.13.3"
+version = "0.13.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "62e0021ea2c22aed41653bc7e1419abb2c97e038ff2c33d0e1309e49a97deec0"
+checksum = "219c5811de6525e5416c7d5d53bb656d3afdbc6c5af816e0802bcfa42dbdc1c3"
 dependencies = [
  "base64",
  "bytes",
@@ -2177,7 +2177,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-node"
-version = "0.1.0-alpha.25"
+version = "0.1.0-alpha.29"
 dependencies = [
  "napi",
  "napi-build",
@@ -2189,7 +2189,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python"
-version = "0.1.0-alpha.25"
+version = "0.1.0-alpha.29"
 dependencies = [
  "pyo3",
  "pyo3-async-runtimes",
@@ -2200,7 +2200,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python-stubs"
-version = "0.1.0-alpha.25"
+version = "0.1.0-alpha.29"
 dependencies = [
  "pyo3-stub-gen",
  "sdk-python",
@@ -2208,7 +2208,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-ruby"
-version = "0.1.0-alpha.25"
+version = "0.1.0-alpha.29"
 dependencies = [
  "magnus",
  "quicknode-sdk",
@@ -2917,9 +2917,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.121"
+version = "0.2.122"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49ace1d07c165b0864824eee619580c4689389afa9dc9ed3a4c75040d82e6790"
+checksum = "3ed04576f974d2b2fba0f38c51dbc5518011e38c36bf1143164be765528fd409"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -2930,9 +2930,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-futures"
-version = "0.4.71"
+version = "0.4.72"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96492d0d3ffba25305a7dc88720d250b1401d7edca02cc3bcd50633b424673b8"
+checksum = "9473dbd2991ae90b6291c3c32c30c6187ac49aa32f9905d1cce280ec1e110b0f"
 dependencies = [
  "js-sys",
  "wasm-bindgen",
@@ -2940,9 +2940,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.121"
+version = "0.2.122"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e68e6f4afd367a562002c05637acb8578ff2dea1943df76afb9e83d177c8578"
+checksum = "916151b09da36bd82f6615cbf3a419e2f0ba23a03c6160e8e92eb6bd4aa1dec6"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -2950,9 +2950,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.121"
+version = "0.2.122"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d95a9ec35c64b2a7cb35d3fead40c4238d0940c86d107136999567a4703259f2"
+checksum = "299047362ccbfce148b67ab7e73349f77748e00c8296f9542adfad2ad82c5c5e"
 dependencies = [
  "bumpalo",
  "proc-macro2",
@@ -2963,18 +2963,18 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.121"
+version = "0.2.122"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4e0100b01e9f0d03189a92b96772a1fb998639d981193d7dbab487302513441"
+checksum = "9a929b2c61f11ba3e9bc35b50c1f25cb38e0e892c0c231ae2b8cf78d5dad4437"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "web-sys"
-version = "0.3.98"
+version = "0.3.99"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4b572dff8bcf38bad0fa19729c89bb5748b2b9b1d8be70cf90df697e3a8f32aa"
+checksum = "6d621441cfc37b84979402712047321980c178f299193a3589d05b99e8763436"
 dependencies = [
  "js-sys",
  "wasm-bindgen",
@@ -3303,18 +3303,18 @@ dependencies = [
 
 [[package]]
 name = "zerocopy"
-version = "0.8.48"
+version = "0.8.49"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eed437bf9d6692032087e337407a86f04cd8d6a16a37199ed57949d415bd68e9"
+checksum = "bce33a6288fa3f072a8c2c7d0f2fdbb90e28298f0135c1f99b96c3db2efcc60b"
 dependencies = [
  "zerocopy-derive",
 ]
 
 [[package]]
 name = "zerocopy-derive"
-version = "0.8.48"
+version = "0.8.49"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "70e3cd084b1788766f53af483dd21f93881ff30d7320490ec3ef7526d203bad4"
+checksum = "8fd425244944f4ab65ccff928e7323354c5a018c75838362fdce749dfad2ee1e"
 dependencies = [
  "proc-macro2",
  "quote",

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/Cargo.toml

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

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quicknode-sdk
-Version: 0.1.0a25
+Version: 0.1.0a29
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
@@ -33,6 +33,7 @@ This is one of four language bindings published from the same Rust core. See the
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
+- [Platform Support](#platform-support)
 - [API Reference](#api-reference)
   - [Admin Client](#admin-client)
     - [Endpoints](#endpoints)
@@ -121,6 +122,45 @@ Environment variables (prefix `QN_SDK__`, separator `__`):
 | `QN_SDK__STREAMS__BASE_URL` | no | `https://api.quicknode.com/streams/rest/v1/` | Override streams base URL |
 | `QN_SDK__WEBHOOKS__BASE_URL` | no | `https://api.quicknode.com/webhooks/rest/v1/` | Override webhooks base URL |
 | `QN_SDK__KVSTORE__BASE_URL` | no | `https://api.quicknode.com/kv/rest/v1/` | Override KV store base URL |
+| `QN_SDK__HTTP__HEADERS__<NAME>` | no | — | Custom HTTP header sent on every request. Overrides SDK-managed headers (see below). |
+
+### Custom headers and `User-Agent`
+
+Every outbound HTTP request includes an auto-generated `User-Agent` of the form:
+
+```
+quicknode-sdk-<language>/<sdk-version> (<os>-<arch>; <language>-<runtime-version>)
+```
+
+You can attach arbitrary headers via `HttpConfig.headers`. **These headers OVERRIDE any SDK-managed header with the same name**, including `User-Agent`, `x-api-key`, `Accept`, and `Content-Type`. Use this to inject correlation IDs, proxy auth, or to replace the default `User-Agent`. Header names are matched case-insensitively.
+
+```python
+from sdk import QuicknodeSdk, SdkFullConfig, HttpConfig
+
+qn = QuicknodeSdk(
+    SdkFullConfig(
+        api_key="your-key",
+        http=HttpConfig(headers={
+            "X-Correlation-Id": "abc-123",
+            "User-Agent": "my-app/1.0",  # overrides SDK default
+        }),
+    )
+)
+```
+
+## Platform Support
+
+Precompiled wheels are published for:
+
+| Platform | Targets |
+|---|---|
+| Linux (glibc) | `x86_64`, `aarch64` — glibc **2.17+** (manylinux2014) |
+| Linux (musl) | `x86_64`, `aarch64` — Alpine and other musl distros |
+| macOS | Apple Silicon (`arm64`) |
+
+Linux glibc wheels are built against glibc 2.17 so they load on any distro from 2014 onward — RHEL 7+, Ubuntu 14.04+, Debian 8+, Amazon Linux 2+, SLES 12+, Fedora 19+. If `pip install quicknode-sdk` resolves to a source distribution on your platform, you're on something we don't have a prebuilt wheel for — see the matrix above.
+
+**Not supported:** RHEL/CentOS 6 (glibc 2.12), Debian 7 (glibc 2.13), Ubuntu 12.04 (glibc 2.15), SLES 11 (glibc 2.11), Intel macOS, Windows.
 
 ## API Reference
 

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/Cargo.toml

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

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/README.md

@@ -9,6 +9,7 @@ This is one of four language bindings published from the same Rust core. See the
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
+- [Platform Support](#platform-support)
 - [API Reference](#api-reference)
   - [Admin Client](#admin-client)
     - [Endpoints](#endpoints)
@@ -96,6 +97,39 @@ Environment variables (prefix `QN_SDK__`, separator `__`):
 | `QN_SDK__STREAMS__BASE_URL` | no | `https://api.quicknode.com/streams/rest/v1/` | Override streams base URL |
 | `QN_SDK__WEBHOOKS__BASE_URL` | no | `https://api.quicknode.com/webhooks/rest/v1/` | Override webhooks base URL |
 | `QN_SDK__KVSTORE__BASE_URL` | no | `https://api.quicknode.com/kv/rest/v1/` | Override KV store base URL |
+| `QN_SDK__HTTP__HEADERS__<NAME>` | no | — | Custom HTTP header sent on every request. Overrides SDK-managed headers (see below). |
+
+### Custom headers and `User-Agent`
+
+Every outbound HTTP request includes an auto-generated `User-Agent` of the form:
+
+```
+quicknode-sdk-<language>/<sdk-version> (<os>-<arch>; <language>-<runtime-version>)
+```
+
+You can attach arbitrary headers via `HttpConfig.headers`. **These headers OVERRIDE any SDK-managed header with the same name**, including `User-Agent`, `x-api-key`, `Accept`, and `Content-Type`. Use this to inject correlation IDs, proxy auth, or to replace the default `User-Agent`. Header names are matched case-insensitively.
+
+```rust
+use std::collections::HashMap;
+use quicknode_sdk::{HttpConfig, QuicknodeSdk, SdkFullConfig};
+
+let mut headers = HashMap::new();
+headers.insert("X-Correlation-Id".to_string(), "abc-123".to_string());
+headers.insert("User-Agent".to_string(), "my-app/1.0".to_string()); // overrides SDK default
+
+let qn = QuicknodeSdk::new(
+    &SdkFullConfig::builder()
+        .api_key("your-key")
+        .http(HttpConfig { headers: Some(headers), ..Default::default() })
+        .build(),
+)?;
+```
+
+## Platform Support
+
+`quicknode-sdk` is a pure-Rust source crate — it builds wherever `rustc` and `reqwest` are supported. It is regularly tested on Linux (glibc) and macOS (Apple Silicon). Windows is not tested.
+
+If you are using one of the language bindings (`quicknode-sdk` on PyPI, `@quicknode/sdk` on npm, `quicknode_sdk` on RubyGems), see that package's README for the precompiled-binary platform matrix.
 
 ## API Reference
 

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/examples/admin_e2e.rs

@@ -857,6 +857,34 @@ async fn main() {
         other => eprintln!("expected Api 404 from delete_rate_limit_override, got {other:?}"),
     }
 
+    // Custom headers smoke test — construct an SDK that overrides User-Agent
+    // and adds a correlation header. We don't verify what reaches the wire
+    // here; we just confirm the config is accepted and an API call succeeds.
+    let mut custom_headers = std::collections::HashMap::new();
+    custom_headers.insert("User-Agent".to_string(), "qn-e2e-rust/1.0".to_string());
+    custom_headers.insert("X-E2E-Correlation".to_string(), "rust-smoke".to_string());
+    let with_headers = SdkFullConfig {
+        api_key: config.api_key.clone(),
+        http: Some(HttpConfig {
+            timeout_secs: None,
+            pool_max_idle_per_host: None,
+            headers: Some(custom_headers),
+        }),
+        admin: config.admin.clone(),
+        streams: None,
+        webhooks: None,
+        kvstore: None,
+    };
+    let headered = QuicknodeSdk::new(&with_headers).expect("build sdk with custom headers");
+    match headered
+        .admin
+        .get_endpoints(&GetEndpointsRequest::builder().limit(1).build())
+        .await
+    {
+        Ok(_) => println!("custom-headers smoke: ok"),
+        Err(e) => eprintln!("custom-headers smoke error: {e}"),
+    }
+
     // 2) Timeout path — unreachable base URL + 1s timeout forces a timeout
     // from reqwest, which maps to SdkError::Http with http_kind() == Timeout.
     let blackhole = SdkFullConfig {
@@ -864,6 +892,7 @@ async fn main() {
         http: Some(HttpConfig {
             timeout_secs: Some(1),
             pool_max_idle_per_host: None,
+            headers: None,
         }),
         admin: Some(AdminConfig {
             base_url: Some("http://10.255.255.1/".to_string()),

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/src/admin/mod.rs

@@ -3667,6 +3667,7 @@ mod tests {
             http: Some(HttpConfig {
                 timeout_secs: Some(-1),
                 pool_max_idle_per_host: None,
+                headers: None,
             }),
             admin: None,
             streams: None,

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/src/config.rs

@@ -17,6 +17,13 @@ use crate::errors::SdkError;
 pub struct HttpConfig {
     pub timeout_secs: Option<i64>,
     pub pool_max_idle_per_host: Option<i32>,
+    /// Custom HTTP headers added to every outbound request.
+    ///
+    /// **These headers OVERRIDE any SDK-managed header with the same name**,
+    /// including `User-Agent`, `x-api-key`, `Accept`, and `Content-Type`.
+    /// Header names are matched case-insensitively. Use this to override the
+    /// auto-generated User-Agent or inject correlation IDs, proxy auth, etc.
+    pub headers: Option<std::collections::HashMap<String, String>>,
 }
 
 #[cfg(feature = "python")]
@@ -24,15 +31,35 @@ pub struct HttpConfig {
 #[pymethods]
 impl HttpConfig {
     #[new]
-    #[pyo3(signature = (timeout_secs=None, pool_max_idle_per_host=None))]
-    pub fn new(timeout_secs: Option<i64>, pool_max_idle_per_host: Option<i32>) -> Self {
+    #[pyo3(signature = (timeout_secs=None, pool_max_idle_per_host=None, headers=None))]
+    pub fn new(
+        timeout_secs: Option<i64>,
+        pool_max_idle_per_host: Option<i32>,
+        headers: Option<std::collections::HashMap<String, String>>,
+    ) -> Self {
         HttpConfig {
             timeout_secs,
             pool_max_idle_per_host,
+            headers,
         }
     }
 }
 
+/// Identifies the language and runtime making SDK calls. Each binding crate
+/// (Python, Node, Ruby) constructs this and passes it through
+/// [`SdkConfig::new_with_client_info`] so the SDK's auto-generated
+/// `User-Agent` reflects the actual caller, not the underlying Rust core.
+#[derive(Debug, Clone)]
+pub struct ClientInfo {
+    /// Short language identifier, e.g. `"python"`, `"node"`, `"ruby"`, `"rust"`.
+    pub language: String,
+    /// Runtime version of the language, e.g. `"3.12.4"`, `"20.10.0"`, `"3.3.0"`.
+    pub language_version: String,
+    /// Version string of the language-specific SDK package — read from the
+    /// language's own manifest (PyPI version, npm version, gem version).
+    pub sdk_version: String,
+}
+
 #[cfg_attr(feature = "python", gen_stub_pyclass)]
 #[cfg_attr(feature = "python", pyclass(get_all, set_all))]
 #[cfg_attr(feature = "node", napi(object))]
@@ -238,4 +265,23 @@ mod tests {
             Err(SdkError::Config(_))
         ));
     }
+
+    #[test]
+    fn from_env_headers_round_trip() {
+        let cfg = build_config(&[
+            ("api_key", "k"),
+            ("http.headers.x-correlation-id", "abc"),
+            ("http.headers.user-agent", "custom-ua/1.0"),
+        ]);
+        let config = SdkFullConfig::from_config(cfg).unwrap();
+        let headers = config.http.unwrap().headers.unwrap();
+        assert_eq!(
+            headers.get("x-correlation-id").map(String::as_str),
+            Some("abc")
+        );
+        assert_eq!(
+            headers.get("user-agent").map(String::as_str),
+            Some("custom-ua/1.0")
+        );
+    }
 }

{quicknode_sdk-0.1.0a25 → quicknode_sdk-0.1.0a29}/crates/core/src/kvstore/mod.rs

@@ -77,6 +77,7 @@ pub struct GetSetsParams {
 #[cfg_attr(feature = "node", napi(object))]
 #[cfg_attr(not(feature = "node"), derive(Clone))]
 #[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
 pub struct BulkSetsParams {
     /// Key/value pairs to add.
     #[serde(skip_serializing_if = "Option::is_none")]
@@ -131,6 +132,7 @@ pub struct GetListParams {
 #[cfg_attr(feature = "node", napi(object))]
 #[cfg_attr(not(feature = "node"), derive(Clone))]
 #[derive(Debug, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
 pub struct UpdateListParams {
     /// Items to add to the list.
     #[serde(skip_serializing_if = "Option::is_none")]
@@ -947,7 +949,7 @@ mod tests {
         Mock::given(method("POST"))
             .and(path("/sets/bulk"))
             .and(body_json(serde_json::json!({
-                "add_sets": {"k1": "v1"}
+                "addSets": {"k1": "v1"}
             })))
             .respond_with(
                 ResponseTemplate::new(201)
@@ -973,7 +975,7 @@ mod tests {
         Mock::given(method("POST"))
             .and(path("/sets/bulk"))
             .and(body_json(serde_json::json!({
-                "delete_sets": ["k1", "k2"]
+                "deleteSets": ["k1", "k2"]
             })))
             .respond_with(
                 ResponseTemplate::new(201)
@@ -1254,8 +1256,8 @@ mod tests {
         Mock::given(method("PATCH"))
             .and(path("/lists/my-list"))
             .and(body_json(serde_json::json!({
-                "add_items": ["c"],
-                "remove_items": ["a"]
+                "addItems": ["c"],
+                "removeItems": ["a"]
             })))
             .respond_with(
                 ResponseTemplate::new(200)