quicknode-sdk 0.1.0a15__tar.gz → 0.1.0a17__tar.gz

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/Cargo.lock

@@ -441,9 +441,9 @@ checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
 
 [[package]]
 name = "either"
-version = "1.15.0"
+version = "1.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "48c757948c5ede0e46177b7add2e67155f70e33c07fea8284df6576da70b3719"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
 
 [[package]]
 name = "encoding_rs"
@@ -1679,7 +1679,7 @@ dependencies = [
 
 [[package]]
 name = "quicknode-sdk"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 dependencies = [
  "bon",
  "config",
@@ -2156,7 +2156,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-node"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 dependencies = [
  "napi",
  "napi-build",
@@ -2168,7 +2168,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 dependencies = [
  "pyo3",
  "pyo3-async-runtimes",
@@ -2179,7 +2179,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-python-stubs"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 dependencies = [
  "pyo3-stub-gen",
  "sdk-python",
@@ -2187,7 +2187,7 @@ dependencies = [
 
 [[package]]
 name = "sdk-ruby"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 dependencies = [
  "magnus",
  "quicknode-sdk",

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/Cargo.toml

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

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quicknode-sdk
-Version: 0.1.0a15
+Version: 0.1.0a17
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
@@ -52,6 +52,7 @@ This is one of four language bindings published from the same Rust core. See the
     - [IP Custom Headers](#ip-custom-headers)
     - [Method Rate Limits](#method-rate-limits)
     - [Endpoint Rate Limits](#endpoint-rate-limits)
+    - [Endpoint URLs](#endpoint-urls)
     - [Metrics](#metrics)
     - [Chains](#chains)
     - [Billing](#billing)
@@ -807,7 +808,7 @@ await qn.admin.delete_method_rate_limit("ep-123", "rl-1")
 
 ##### `update_rate_limits` / `updateRateLimits`
 
-Updates the endpoint-level RPS / RPM / RPD caps.
+Partial update of the endpoint-level RPS / RPM / RPD caps. Only buckets included in the request are modified — omitted buckets are left unchanged. Values are capped by the account's plan tier. Sends `PATCH`.
 
 **Parameters**: `id` (endpoint id, required); `rate_limits`: `RateLimitSettings` (`rps`, `rpm`, `rpd`, all optional).
 
@@ -818,6 +819,53 @@ Updates the endpoint-level RPS / RPM / RPD caps.
 await qn.admin.update_rate_limits("ep-123", rps=100, rpm=5000)
 ```
 
+##### `get_rate_limits` / `getRateLimits`
+
+Returns the rate-limit rows currently enforced on the endpoint, each identifying its `bucket` (`"rps"` / `"rpm"` / `"rpd"`), `rate_limit`, and `source` (`"plan_default"` or `"user_override"`). User-set overrides expose an `id` (camelCased `id` in Node) you can pass to `delete_rate_limit_override`.
+
+**Parameters**: `id` (endpoint id, required).
+
+**Returns**: `GetRateLimitsResponse` with `data.rate_limits: RateLimitEntry[]`.
+
+```python
+# Python
+resp = await qn.admin.get_rate_limits("123")
+for row in resp.data.rate_limits:
+    print(row.bucket, row.rate_limit, row.source, row.id)
+```
+
+##### `delete_rate_limit_override` / `deleteRateLimitOverride`
+
+Deletes a user-set rate-limit override by UUID. Plan defaults are not deletable — passing a UUID that does not match a user-set override on the endpoint returns 404.
+
+**Parameters**: `id` (endpoint id, required); `override_id` / `overrideId` (UUID returned by `get_rate_limits`, required).
+
+**Returns**: nothing.
+
+```python
+# Python
+await qn.admin.delete_rate_limit_override("123", "ovr-uuid")
+```
+
+#### Endpoint URLs
+
+##### `get_endpoint_urls` / `getEndpointUrls`
+
+Returns the HTTP and WebSocket URLs for the endpoint without fetching the full endpoint record. For multichain endpoints, `multichain_urls` / `multichainUrls` is a per-network map of additional URLs; for single-chain endpoints it is `None` / `null`.
+
+**Parameters**: `id` (endpoint id, required).
+
+**Returns**: `GetEndpointUrlsResponse` with `data.http_url`, `data.wss_url`, and `data.multichain_urls`.
+
+```python
+# Python
+resp = await qn.admin.get_endpoint_urls("123")
+print(resp.data.http_url)
+if resp.data.multichain_urls:
+    for network, urls in resp.data.multichain_urls.items():
+        print(network, urls.http_url)
+```
+
 #### Metrics
 
 ##### `get_endpoint_metrics` / `getEndpointMetrics`
@@ -826,7 +874,7 @@ Returns metric series for an endpoint over a time period.
 
 **Parameters**: `id` (endpoint id, required); body: `period` (`"hour"` | `"day"` | `"week"` | `"month"`), `metric` (e.g. `"method_calls_over_time"`, `"response_status_breakdown"`).
 
-**Returns**: `GetEndpointMetricsResponse` with `data: EndpointMetric[]`.
+**Returns**: `GetEndpointMetricsResponse` with `data: list[EndpointMetric]`. Each `EndpointMetric` has a `tag: list[str]` and a `data: list[list[int]]` of `[timestamp, value]` pairs. Single-axis series (e.g. `response_time_over_time` with a percentile) come back as a one-element tag like `["p95"]`; multi-axis series come back as `["network", "arbitrum-mainnet"]`.
 
 ```python
 # Python
@@ -843,7 +891,7 @@ Returns account-level metric series. Supports an optional `percentile` (e.g. `"p
 
 **Parameters**: `period` (required), `metric` (required), `percentile` (string, optional).
 
-**Returns**: `GetAccountMetricsResponse` with `data: EndpointMetric[]`.
+**Returns**: `GetAccountMetricsResponse` with `data: list[EndpointMetric]`. See `get_endpoint_metrics` above for the `tag: list[str]` shape.
 
 ```python
 # Python

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/crates/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "quicknode-sdk"
-version = "0.1.0-alpha.15"
+version = "0.1.0-alpha.17"
 edition.workspace = true
 license.workspace = true
 description = "Core library for quicknode sdk"
@@ -47,6 +47,10 @@ required-features = ["rust"]
 name = "streams"
 required-features = ["rust"]
 
+[[example]]
+name = "streams_e2e"
+required-features = ["rust"]
+
 [[example]]
 name = "webhooks_e2e"
 required-features = ["rust"]

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/crates/core/README.md

@@ -28,6 +28,7 @@ This is one of four language bindings published from the same Rust core. See the
     - [IP Custom Headers](#ip-custom-headers)
     - [Method Rate Limits](#method-rate-limits)
     - [Endpoint Rate Limits](#endpoint-rate-limits)
+    - [Endpoint URLs](#endpoint-urls)
     - [Metrics](#metrics)
     - [Chains](#chains)
     - [Billing](#billing)
@@ -815,7 +816,7 @@ qn.admin.delete_method_rate_limit("ep-123", "rl-1").await?;
 
 ##### `update_rate_limits` / `updateRateLimits`
 
-Updates the endpoint-level RPS / RPM / RPD caps.
+Partial update of the endpoint-level RPS / RPM / RPD caps. Only buckets included in the request are modified — omitted buckets are left unchanged. Values are capped by the account's plan tier. Sends `PATCH`.
 
 **Parameters**: `id` (endpoint id, required); `rate_limits`: `RateLimitSettings` (`rps`, `rpm`, `rpd`, all optional).
 
@@ -828,6 +829,58 @@ let params = UpdateRateLimitsRequest { rate_limits };
 qn.admin.update_rate_limits("ep-123", &params).await?;
 ```
 
+##### `get_rate_limits` / `getRateLimits`
+
+Returns the rate-limit rows currently enforced on the endpoint, each identifying its `bucket` (`"rps"` / `"rpm"` / `"rpd"`), `rate_limit`, and `source` (`"plan_default"` or `"user_override"`). User-set overrides expose an `id` you can pass to `delete_rate_limit_override`.
+
+**Parameters**: `id` (endpoint id, required).
+
+**Returns**: `GetRateLimitsResponse` with `data.rate_limits: Vec<RateLimitEntry>`.
+
+```rust
+// Rust
+let resp = qn.admin.get_rate_limits("123").await?;
+for row in resp.data.unwrap().rate_limits {
+    println!("{} {} {} {:?}", row.bucket, row.rate_limit, row.source, row.id);
+}
+```
+
+##### `delete_rate_limit_override` / `deleteRateLimitOverride`
+
+Deletes a user-set rate-limit override by UUID. Plan defaults are not deletable — passing a UUID that does not match a user-set override on the endpoint returns 404.
+
+**Parameters**: `id` (endpoint id, required); `override_id` (UUID returned by `get_rate_limits`, required).
+
+**Returns**: nothing.
+
+```rust
+// Rust
+qn.admin.delete_rate_limit_override("123", "ovr-uuid").await?;
+```
+
+#### Endpoint URLs
+
+##### `get_endpoint_urls` / `getEndpointUrls`
+
+Returns the HTTP and WebSocket URLs for the endpoint without fetching the full endpoint record. For multichain endpoints, `multichain_urls` is a per-network map of additional URLs; for single-chain endpoints it is `None`.
+
+**Parameters**: `id` (endpoint id, required).
+
+**Returns**: `GetEndpointUrlsResponse` with `data.http_url`, `data.wss_url`, and `data.multichain_urls`.
+
+```rust
+// Rust
+let resp = qn.admin.get_endpoint_urls("123").await?;
+if let Some(data) = resp.data {
+    println!("{}", data.http_url);
+    if let Some(mc) = data.multichain_urls {
+        for (network, urls) in mc {
+            println!("{network} {}", urls.http_url);
+        }
+    }
+}
+```
+
 #### Metrics
 
 ##### `get_endpoint_metrics` / `getEndpointMetrics`
@@ -836,7 +889,7 @@ Returns metric series for an endpoint over a time period.
 
 **Parameters**: `id` (endpoint id, required); body: `period` (`"hour"` | `"day"` | `"week"` | `"month"`), `metric` (e.g. `"method_calls_over_time"`, `"response_status_breakdown"`).
 
-**Returns**: `GetEndpointMetricsResponse` with `data: EndpointMetric[]`.
+**Returns**: `GetEndpointMetricsResponse` with `data: Vec<EndpointMetric>`. Each `EndpointMetric` has `tag: Vec<String>` and `data: Vec<Vec<i64>>` of `[timestamp, value]` pairs. Single-axis series (e.g. `response_time_over_time` with a percentile) come back as a one-element tag like `vec!["p95"]`; multi-axis series come back as `vec!["network", "arbitrum-mainnet"]`.
 
 ```rust
 // Rust
@@ -853,7 +906,7 @@ Returns account-level metric series. Supports an optional `percentile` (e.g. `"p
 
 **Parameters**: `period` (required), `metric` (required), `percentile` (string, optional).
 
-**Returns**: `GetAccountMetricsResponse` with `data: EndpointMetric[]`.
+**Returns**: `GetAccountMetricsResponse` with `data: Vec<EndpointMetric>`. See `get_endpoint_metrics` above for the `tag: Vec<String>` shape.
 
 ```rust
 // Rust

quicknode_sdk-0.1.0a17/crates/core/examples/admin.rs

@@ -0,0 +1,59 @@
+use quicknode_sdk::{admin::GetEndpointsRequest, QuicknodeSdk, SdkFullConfig};
+
+#[tokio::main]
+#[allow(clippy::unwrap_used, clippy::expect_used)]
+async fn main() {
+    let config = SdkFullConfig::from_env().expect("Config from env failed");
+    let qn = QuicknodeSdk::new(&config).expect("sdk failed to initialize");
+
+    let params = GetEndpointsRequest::builder()
+        .limit(20)
+        .sort_by("created_at".to_string())
+        .sort_direction("desc".to_string())
+        .build();
+
+    let first_endpoint_id = match qn.admin.get_endpoints(&params).await {
+        Ok(resp) => {
+            if let Some(p) = &resp.pagination {
+                println!(
+                    "{} of {} (offset {}, limit {})",
+                    resp.data.len(),
+                    p.total,
+                    p.offset,
+                    p.limit
+                );
+            }
+            for ep in &resp.data {
+                println!(
+                    "{} | {} | {} | {} | dedicated={} flat={} multichain={}",
+                    ep.id,
+                    ep.name,
+                    ep.status,
+                    ep.chain,
+                    ep.is_dedicated,
+                    ep.is_flat_rate,
+                    ep.is_multichain
+                );
+            }
+            resp.data.first().map(|ep| ep.id.clone())
+        }
+        Err(e) => {
+            eprintln!("get_endpoints error: {e}");
+            None
+        }
+    };
+
+    let Some(endpoint_id) = first_endpoint_id else {
+        return;
+    };
+
+    match qn.admin.get_rate_limits(&endpoint_id).await {
+        Ok(resp) => println!("get_rate_limits: {:?}", resp.data),
+        Err(e) => eprintln!("get_rate_limits error: {e}"),
+    }
+
+    match qn.admin.get_endpoint_urls(&endpoint_id).await {
+        Ok(resp) => println!("get_endpoint_urls: {:?}", resp.data),
+        Err(e) => eprintln!("get_endpoint_urls error: {e}"),
+    }
+}

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/crates/core/examples/admin_e2e.rs

@@ -97,7 +97,17 @@ async fn main() {
         })
         .await
     {
-        Ok(resp) => println!("get_account_metrics: {} series", resp.data.len()),
+        Ok(resp) => {
+            let first = resp
+                .data
+                .first()
+                .map(|m| m.tag.join(":"))
+                .unwrap_or_else(|| "<none>".to_string());
+            println!(
+                "get_account_metrics: {} series, first tag: {first}",
+                resp.data.len()
+            );
+        }
         Err(e) => eprintln!("get_account_metrics error: {e}"),
     }
 
@@ -254,7 +264,17 @@ async fn main() {
         )
         .await
     {
-        Ok(resp) => println!("get_endpoint_metrics: {} series", resp.data.len()),
+        Ok(resp) => {
+            let first = resp
+                .data
+                .first()
+                .map(|m| m.tag.join(":"))
+                .unwrap_or_else(|| "<none>".to_string());
+            println!(
+                "get_endpoint_metrics: {} series, first tag: {first}",
+                resp.data.len()
+            );
+        }
         Err(e) => eprintln!("get_endpoint_metrics error: {e}"),
     }
 
@@ -534,6 +554,11 @@ async fn main() {
 
     // --- Rate limits ---
 
+    match qn.admin.get_rate_limits(&endpoint_id).await {
+        Ok(resp) => println!("get_rate_limits before PATCH: {:?}", resp.data),
+        Err(e) => eprintln!("get_rate_limits error: {e}"),
+    }
+
     match qn
         .admin
         .update_rate_limits(
@@ -551,6 +576,16 @@ async fn main() {
         Err(e) => eprintln!("update_rate_limits error: {e}"),
     }
 
+    match qn.admin.get_rate_limits(&endpoint_id).await {
+        Ok(resp) => println!("get_rate_limits after PATCH: {:?}", resp.data),
+        Err(e) => eprintln!("get_rate_limits error: {e}"),
+    }
+
+    match qn.admin.get_endpoint_urls(&endpoint_id).await {
+        Ok(resp) => println!("get_endpoint_urls: {:?}", resp.data),
+        Err(e) => eprintln!("get_endpoint_urls error: {e}"),
+    }
+
     match qn.admin.get_method_rate_limits(&endpoint_id).await {
         Ok(resp) => println!("get_method_rate_limits: {:?}", resp.data),
         Err(e) => eprintln!("get_method_rate_limits error: {e}"),
@@ -806,6 +841,22 @@ async fn main() {
         other => eprintln!("expected Api 404, got {other:?}"),
     }
 
+    // 1b) Rate-limit override delete with a bogus override id — also a 404.
+    match qn
+        .admin
+        .delete_rate_limit_override("does-not-exist", "00000000-0000-0000-0000-000000000000")
+        .await
+    {
+        Err(SdkError::Api { status, body }) => {
+            println!(
+                "delete_rate_limit_override api error {status}: {}",
+                &body[..body.len().min(80)]
+            );
+            assert_eq!(status.as_u16(), 404);
+        }
+        other => eprintln!("expected Api 404 from delete_rate_limit_override, got {other:?}"),
+    }
+
     // 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 {

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/crates/core/examples/streams_e2e.rs

@@ -33,7 +33,7 @@ async fn main() {
         network: "ethereum-mainnet".to_string(),
         dataset: StreamDataset::Block,
         block: "17811625".to_string(),
-        filter_function: Some("ZnVuY3Rpb24gbWFpbihkYXRhKSB7IHJldHVybiBkYXRhOyB9".to_string()),
+        filter_function: "ZnVuY3Rpb24gbWFpbihkYXRhKSB7IHJldHVybiBkYXRhOyB9".to_string(),
         filter_language: None,
         address_book_config: None,
     };

quicknode_sdk-0.1.0a17/crates/core/src/admin/endpoint_metrics.rs

@@ -0,0 +1,148 @@
+#[cfg(feature = "node")]
+use napi_derive::napi;
+#[cfg(feature = "python")]
+use pyo3::pyclass;
+#[cfg(feature = "python")]
+use pyo3_stub_gen::derive::gen_stub_pyclass;
+use serde::{Deserialize, Deserializer, Serialize};
+
+// The metrics endpoints return `tag` as either a plain string (single-axis
+// series like `"total"` or `"p95"`) or a tuple like `["network", "mainnet"]`
+// (multi-axis series). Normalise both to a `Vec<String>` so callers always
+// see an array.
+fn tag_as_vec<'de, D>(deserializer: D) -> Result<Vec<String>, D::Error>
+where
+    D: Deserializer<'de>,
+{
+    use serde::de::Error;
+    match serde_json::Value::deserialize(deserializer)? {
+        serde_json::Value::String(s) => Ok(vec![s]),
+        serde_json::Value::Array(items) => items
+            .into_iter()
+            .map(|v| match v {
+                serde_json::Value::String(s) => Ok(s),
+                other => Err(D::Error::custom(format!(
+                    "expected string in tag array, got {other}"
+                ))),
+            })
+            .collect(),
+        serde_json::Value::Null => Ok(Vec::new()),
+        other => Err(D::Error::custom(format!(
+            "expected string or array of strings for tag, got {other}"
+        ))),
+    }
+}
+
+/// Parameters for `get_endpoint_metrics`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Default, Serialize)]
+pub struct GetEndpointMetricsRequest {
+    /// Time period (`hour`, `day`, `week`, or `month`).
+    pub period: String,
+    /// Metric name (e.g. `method_calls_over_time`, `response_status_breakdown`).
+    pub metric: String,
+}
+
+/// Parameters for `get_account_metrics`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Default, Serialize)]
+pub struct GetAccountMetricsRequest {
+    /// Time period (`hour`, `day`, `week`, or `month`).
+    pub period: String,
+    /// Metric name (e.g. `method_calls_over_time`, `credits_over_time`).
+    pub metric: String,
+    /// Optional percentile for latency metrics (e.g. `p50`, `p95`, `p99`).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub percentile: Option<String>,
+}
+
+/// A single metric series, consisting of a descriptive tag and timestamped data points.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct EndpointMetric {
+    /// Data points, each as `[timestamp, value]`.
+    pub data: Vec<Vec<i64>>,
+    /// Tag identifying the series. Single-axis metrics return a one-element
+    /// vector (e.g. `["total"]`, `["p95"]`); multi-axis metrics return the
+    /// key/value pair (e.g. `["network", "arbitrum-mainnet"]`).
+    #[serde(deserialize_with = "tag_as_vec")]
+    pub tag: Vec<String>,
+}
+
+/// Response from `get_endpoint_metrics`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetEndpointMetricsResponse {
+    /// Metric series returned for the endpoint.
+    #[serde(default)]
+    pub data: Vec<EndpointMetric>,
+    /// Error message when the request did not succeed.
+    pub error: Option<String>,
+}
+
+/// Response from `get_account_metrics`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetAccountMetricsResponse {
+    /// Metric series returned for the account.
+    #[serde(default)]
+    pub data: Vec<EndpointMetric>,
+    /// Error message when the request did not succeed.
+    pub error: Option<String>,
+}
+
+#[cfg(test)]
+#[allow(clippy::unwrap_used, clippy::expect_used, clippy::panic)]
+mod tests {
+    use super::EndpointMetric;
+
+    #[test]
+    fn tag_deserializes_from_string() {
+        let m: EndpointMetric =
+            serde_json::from_str(r#"{"data": [[1, 2]], "tag": "total"}"#).unwrap();
+        assert_eq!(m.tag, vec!["total".to_string()]);
+    }
+
+    #[test]
+    fn tag_deserializes_from_tuple() {
+        let m: EndpointMetric =
+            serde_json::from_str(r#"{"data": [[1, 2]], "tag": ["network", "arbitrum-mainnet"]}"#)
+                .unwrap();
+        assert_eq!(
+            m.tag,
+            vec!["network".to_string(), "arbitrum-mainnet".to_string()]
+        );
+    }
+
+    #[test]
+    fn tag_deserializes_from_null() {
+        let m: EndpointMetric = serde_json::from_str(r#"{"data": [[1, 2]], "tag": null}"#).unwrap();
+        assert!(m.tag.is_empty());
+    }
+
+    #[test]
+    fn tag_rejects_mixed_array() {
+        let err =
+            serde_json::from_str::<EndpointMetric>(r#"{"data": [], "tag": ["x", 5]}"#).unwrap_err();
+        assert!(err.to_string().contains("expected string in tag array"));
+    }
+
+    #[test]
+    fn tag_rejects_object() {
+        let err = serde_json::from_str::<EndpointMetric>(r#"{"data": [], "tag": {"k": "v"}}"#)
+            .unwrap_err();
+        assert!(err
+            .to_string()
+            .contains("expected string or array of strings for tag"));
+    }
+}

{quicknode_sdk-0.1.0a15 → quicknode_sdk-0.1.0a17}/crates/core/src/admin/endpoint_rate_limits.rs

@@ -137,3 +137,47 @@ pub struct UpdateRateLimitsRequest {
     /// Rate limit values to apply.
     pub rate_limits: RateLimitSettings,
 }
+
+/// A single rate-limit row returned by `get_rate_limits`, identifying the
+/// bucket (`rps`/`rpm`/`rpd`), the value enforced, and whether the value comes
+/// from the plan default or a user-set override.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct RateLimitEntry {
+    /// Which bucket this row applies to: `rps`, `rpm`, or `rpd`.
+    pub bucket: String,
+    /// The enforced value for this bucket.
+    pub rate_limit: i32,
+    /// Where the value comes from: `plan_default` or `user_override`.
+    pub source: String,
+    /// Row identifier. Present on `user_override` rows — pass it to
+    /// `delete_rate_limit_override` to remove the override. May be absent on
+    /// `plan_default` rows and cannot be deleted there.
+    #[serde(default)]
+    pub id: Option<String>,
+}
+
+/// Inner data for `get_rate_limits`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetRateLimitsData {
+    /// One row per enforced bucket.
+    #[serde(default)]
+    pub rate_limits: Vec<RateLimitEntry>,
+}
+
+/// Response from `get_rate_limits`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetRateLimitsResponse {
+    /// Rate-limit rows with their source.
+    pub data: Option<GetRateLimitsData>,
+    /// Error message when the request did not succeed.
+    pub error: Option<String>,
+}

quicknode_sdk-0.1.0a17/crates/core/src/admin/endpoint_urls.rs

@@ -0,0 +1,47 @@
+#[cfg(feature = "node")]
+use napi_derive::napi;
+#[cfg(feature = "python")]
+use pyo3::pyclass;
+#[cfg(feature = "python")]
+use pyo3_stub_gen::derive::gen_stub_pyclass;
+use serde::{Deserialize, Serialize};
+use std::collections::HashMap;
+
+/// HTTP/WSS URL pair for a single network on a multichain endpoint.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct EndpointUrl {
+    /// HTTP RPC URL.
+    pub http_url: String,
+    /// WebSocket RPC URL, when available.
+    pub wss_url: Option<String>,
+}
+
+/// Inner data for `get_endpoint_urls` — the http/wss URLs for the endpoint and,
+/// when the endpoint is multichain, a per-network map of additional URLs.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetEndpointUrlsData {
+    /// HTTP RPC URL.
+    pub http_url: String,
+    /// WebSocket RPC URL, when available.
+    pub wss_url: Option<String>,
+    /// Per-network URLs for multichain endpoints; `None` for single-chain endpoints.
+    pub multichain_urls: Option<HashMap<String, EndpointUrl>>,
+}
+
+/// Response from `get_endpoint_urls`.
+#[cfg_attr(feature = "python", gen_stub_pyclass)]
+#[cfg_attr(feature = "python", pyclass(get_all, set_all))]
+#[cfg_attr(feature = "node", napi(object))]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GetEndpointUrlsResponse {
+    /// URLs for the endpoint.
+    pub data: Option<GetEndpointUrlsData>,
+    /// Error message when the request did not succeed.
+    pub error: Option<String>,
+}