quicknode_sdk 0.8.2 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 212f5944841570b973f2b7483897f2723c53cb0ab3999d16665bcca450031c52
-  data.tar.gz: 460f381265c70c4025737ba138caeada1f9c674d2313e283cc28c9522a3194a1
+  metadata.gz: 45c4453f935c90393ad4bc2e82c806445c0f0568d3824a41fc2eefdd2002c474
+  data.tar.gz: ffc9912512afc9f9dbf4c723d54bf3894fd2f8db7bdce39cb8fd33bceb5219b9
 SHA512:
-  metadata.gz: 0e2df3cb64cde2cd56046362e4430456d0a22e6d5a9fde66d0a198a15a43f70538a15f6a6efb6f278e706bdddd47986b8b69a595dfb9358b3a913149d1516360
-  data.tar.gz: 3dc0324ef51f45bb0dcf508f430b5ad73ae618443ba1dc95be925b5970708700fe1eb4a8ace301e345300d911fc8819ee7b983f0c0d64c9ef8836f6cdd01ffe7
+  metadata.gz: d18023ccf0c124aaa8349d90ac3a112363a937f7f088d05fb5c8cb171aa3a40e43f24284f0d14b676b014d4bc4d04fa57b9f726943c43409fa7d6687e83501a3
+  data.tar.gz: bc12b2ba35d56bb034e280af624e595cefa3890dec71916131bb302b96c9f74ff180a44a69ad282b1ec26ea1b34837db769226ab7a841d925371c1fb1dcc0425

data/README.md

@@ -43,6 +43,12 @@ This is one of four language bindings published from the same Rust core. See the
     - [Bulk Operations](#bulk-operations)
     - [Account Tags](#account-tags)
     - [Tag / delete method parameter quick-reference](#tag--delete-method-parameter-quick-reference)
+    - [Additional security operations](#additional-security-operations)
+    - [Mutation responses](#mutation-responses)
+    - [Usage and metrics summaries](#usage-and-metrics-summaries)
+    - [Activity logs](#activity-logs)
+    - [Transactions](#transactions)
+    - [Admin compatibility notes](#admin-compatibility-notes)
   - [Streams Client](#streams-client)
     - [Datasets, Regions, and Destinations](#datasets-regions-and-destinations)
     - [Streams methods](#streams-methods)
@@ -171,7 +177,7 @@ Accessed as `qn.admin`. Manages endpoints, tags, teams, billing, usage, metrics,
 
 ##### `get_endpoints` / `getEndpoints`
 
-Returns a paginated list of endpoints on the account with optional search, filters (networks, statuses, labels, tags, dedicated, flat-rate), sorting, and pagination.
+Returns a paginated list of endpoints on the account with optional search, filters (networks, statuses, labels, tags, dedicated, flat-rate), sorting, and pagination. The API caps `limit` at 100. Nonempty `tag_ids` and `tag_labels` filters are mutually exclusive.
 
 **Parameters** (all optional): `limit` (i32), `offset` (i32), `search` (string), `sort_by` (string), `sort_direction` (`"asc"` | `"desc"`), `networks` (string[]), `statuses` (string[]), `labels` (string[]), `dedicated` (bool), `is_flat_rate` (bool), `tag_ids` (i32[]), `tag_labels` (string[]).
 
@@ -186,7 +192,7 @@ resp = qn.admin.get_endpoints(limit: 20, sort_by: "created_at", sort_direction:
 
 Creates a new endpoint for the given blockchain and network.
 
-**Parameters**: `chain` (string, optional), `network` (string, optional).
+**Parameters**: `chain` and `network` are strings required by the API. The SDK retains its existing optional arguments for compatibility; supply both for a valid request.
 
 **Returns**: `CreateEndpointResponse` with `data: SingleEndpoint`.
 
@@ -212,7 +218,7 @@ resp = qn.admin.show_endpoint(id: "ep-123")
 
 Updates editable fields on an endpoint. Currently supports `label`.
 
-**Parameters**: `id` (string, required); body: `label` (string, optional).
+**Parameters**: `id` (string, required); `label` (string, required by the API). The SDK retains the optional label argument; omitting it produces an API error.
 
 **Returns**: nothing.
 
@@ -255,7 +261,7 @@ Per-endpoint tag add/remove. For account-wide tag management see [Account Tags](
 
 Tags an endpoint with the given label. Creates the tag on the account if it does not exist.
 
-**Parameters**: `id` (string, required); body: `label` (string, optional).
+**Parameters**: `id` (string, required); `label` (string, required by the API). Labels must be nonblank and contain 3 through 25 characters after trimming. The SDK retains its optional argument and does not trim values.
 
 **Returns**: nothing.
 
@@ -294,7 +300,7 @@ resp = qn.admin.list_teams
 
 ##### `create_team` / `createTeam`
 
-Creates a new team.
+Creates a new team. The name must contain at least four characters.
 
 **Parameters**: `name` (string, required).
 
@@ -361,7 +367,7 @@ qn.admin.update_team_endpoints(id: 42, endpoint_ids: ["ep-123", "ep-456"])
 
 Invites a user to a team. Existing users only need `email`; new users require `full_name` and `role`.
 
-**Parameters**: `id` (i64, required); body: `email` (string, required), `full_name` (string, optional), `role` (string, optional — `admin` | `viewer` | `billing`).
+**Parameters**: `id` (i64, required); body: `email` (string, required), `full_name` (string, optional), `role` (string, optional). Standard roles and account custom-role keys are accepted.
 
 **Returns**: `InviteTeamMemberResponse`.
 
@@ -398,7 +404,9 @@ qn.admin.resend_team_invite(id: 42, user_id: 7)
 
 #### Usage
 
-All usage methods accept optional `start_time` and `end_time` Unix timestamps. Omit both for account-to-date totals.
+Endpoint, chain, and tag usage rows include integer `rpc_credits`, `data_credits`, and `bytes`. Shared method rows, including methods nested under endpoints, include integer `bytes`. Existing nullable method metadata and null tag IDs for untagged usage remain nullable.
+
+All usage methods accept optional `start_time` and `end_time` Unix timestamps. Omit both to use the current billing-period default.
 
 ##### `get_usage` / `getUsage`
 
@@ -459,9 +467,9 @@ resp = qn.admin.get_usage_by_tag({})
 
 ##### `get_endpoint_logs` / `getEndpointLogs`
 
-Fetches a page of request logs for an endpoint. Set `include_details=true` for full request/response payloads (truncated at 2 KB each).
+Fetches a page of request logs for an endpoint. Use ISO 8601 timestamps for explicit bounds. The limit is 1 through 100 and defaults to 20. Set `include_details=true` for full request/response payloads (truncated at 2 KB each).
 
-**Parameters**: `id` (endpoint id, required); body: `from` (string timestamp, required), `to` (string timestamp, required), `include_details` (bool, optional), `limit` (i32, optional), `next_at` (string cursor, optional).
+**Parameters**: `id` (endpoint id, required); query: `from` (string timestamp, required), `to` (string timestamp, required), `include_details` (bool, optional), `limit` (i32, optional), `next_at` (string cursor, optional).
 
 **Returns**: `GetEndpointLogsResponse` — `{ data: EndpointLog[], next_at?: string }`.
 
@@ -492,7 +500,7 @@ resp = qn.admin.get_log_details(id: "ep-123", request_id: "req-abc")
 
 ##### `get_endpoint_security` / `getEndpointSecurity`
 
-Returns the full security configuration for an endpoint: tokens, JWTs, referrers, domain masks, IPs, request filters, and their per-feature toggles.
+Returns the full security configuration for an endpoint: tokens, JWTs, referrers, domain masks, IPs, blocked IPs (`blocked_ips`), request filters, and their per-feature toggles. Snapshot options include `hsts`, `cors`, and `response_logging` (wire key `responseLogging`). Structured filter matchers and `params` are preserved.
 
 **Parameters**: `id` (string, required).
 
@@ -522,13 +530,13 @@ resp = qn.admin.get_security_options(id: "ep-123")
 
 Enables or disables individual security features. Each field accepts `"enabled"` or `"disabled"`.
 
-**Parameters**: `id` (string, required); `options`: `SecurityOptionsUpdate` (`tokens`, `referrers`, `jwts`, `ips`, `domain_masks`, `hsts`, `cors`, `request_filters`, `ip_custom_header`).
+**Parameters**: `id` (string, required); `options`: `SecurityOptionsUpdate` (`tokens`, `referrers`, `jwts`, `ips`, `domain_masks`, `hsts`, `cors`, `request_filters`, `ip_custom_header`, `response_logging`). The `response_logging` option is sent as `responseLogging` and accepts `"enabled"` or `"disabled"`.
 
 **Returns**: `UpdateSecurityOptionsResponse` with updated `SecurityOption[]`.
 
 ```ruby
 # Ruby
-qn.admin.update_security_options(id: "ep-123", tokens: "enabled", jwts: "disabled")
+qn.admin.update_security_options(id: "ep-123", tokens: "enabled", jwts: "disabled", response_logging: "enabled")
 ```
 
 #### Tokens
@@ -621,7 +629,7 @@ resp = qn.admin.delete_ip(id: "ep-123", ip_id: "ip-1")
 
 Adds a custom domain mask to an endpoint.
 
-**Parameters**: `id` (endpoint id, required); body: `domain_mask` (string, optional).
+**Parameters**: `id` (endpoint id, required); body: `domain_mask` (string, required by the API). The SDK retains its optional argument, but supplies no default value.
 
 **Returns**: nothing.
 
@@ -636,7 +644,7 @@ Removes a domain mask.
 
 **Parameters**: `id` (endpoint id, required), `domain_mask_id` (string, required).
 
-**Returns**: nothing.
+**Returns**: `DeleteBoolResponse`.
 
 ```ruby
 # Ruby
@@ -698,7 +706,7 @@ resp = qn.admin.create_request_filter(
 
 **Parameters**: `id` (endpoint id, required), `request_filter_id` (string, required); body: `method` (string[], optional). Ruby's Hash keys are `request_filter_id` and `methods` (plural).
 
-**Returns**: nothing.
+**Returns**: nothing. Supply a method list for an update; an empty request produces an API error.
 
 ```ruby
 # Ruby
@@ -716,6 +724,25 @@ qn.admin.update_request_filter(id: "ep-123", request_filter_id: "f-1", methods:
 qn.admin.delete_request_filter(id: "ep-123", request_filter_id: "f-1")
 ```
 
+##### Structured patterns and filter listing
+
+`get_request_filters` returns list records with `id`, `pattern`, and `method_whitelist`. This differs from endpoint/security snapshots, where each filter has `id`, a `method` matcher array, and `params`. Snapshot `params` holds every top-level pattern key except `method`, not only a nested `params` matcher.
+
+Use `create_request_filter_pattern` and `update_request_filter_pattern` for a custom JSON object. The existing whitelist methods keep their current inputs, including Ruby's `methods:` keyword. Do not combine a whitelist and a custom pattern in one request or use an update to switch filter kinds. One whitelist and multiple custom filters can coexist. Updates and deletions continue to accept successful empty HTTP 204 responses.
+
+Nested objects, arrays, nulls, and keys such as `anything-but` remain intact. Pass a native object rather than a JSON string. Creation returns `data.id` and, when supplied by the API, `data.pattern`.
+
+```ruby
+pattern = {"method" => [{"prefix" => "eth_"}], "jsonrpc" => ["2.0"]}
+created = qn.admin.create_request_filter_pattern(id: "123", pattern: pattern)
+if created[:data]
+  qn.admin.update_request_filter_pattern(
+    id: "123", request_filter_id: created[:data][:id], pattern: pattern
+  )
+end
+filters = qn.admin.get_request_filters(id: "123")
+```
+
 #### Multichain
 
 ##### `enable_multichain` / `enableMultichain`
@@ -792,9 +819,9 @@ resp = qn.admin.get_method_rate_limits(id: "ep-123")
 
 ##### `create_method_rate_limit` / `createMethodRateLimit`
 
-Creates a new method-level rate limiter.
+Creates a new method-level rate limiter. `rate` must be positive; zero produces an API error. Optional `limit_by_ip` applies the limit per client IP and is returned on `MethodRateLimiter`.
 
-**Parameters**: `id` (endpoint id, required); body: `interval` (string, e.g. `"second"`), `methods` (string[]), `rate` (i32).
+**Parameters**: `id` (endpoint id, required); body: `interval` (string, e.g. `"second"`), `methods` (string[]), `rate` (i32), `limit_by_ip` (bool, optional).
 
 **Returns**: `CreateMethodRateLimitResponse` with `data: MethodRateLimiter`.
 
@@ -804,21 +831,22 @@ resp = qn.admin.create_method_rate_limit(
   id: "ep-123",
   interval: "second",
   methods: ["eth_call"],
-  rate: 10
+  rate: 10,
+  limit_by_ip: true
 )
 ```
 
 ##### `update_method_rate_limit` / `updateMethodRateLimit`
 
-Updates an existing rate limiter. Only provided fields change.
+Updates an existing rate limiter. Only provided fields change. Supply at least one supported field; an empty PATCH produces an API error. `limit_by_ip=false` is an explicit update, not an omitted value.
 
-**Parameters**: `id` (endpoint id, required), `method_rate_limit_id` (string, required); body: `methods` (string[], optional), `status` (`"enabled"` | `"disabled"`, optional), `rate` (i32, optional).
+**Parameters**: `id` (endpoint id, required), `method_rate_limit_id` (string, required); body: `methods` (string[], optional), `status` (`"enabled"` | `"disabled"`, optional), `rate` (i32, optional), `limit_by_ip` (bool, optional).
 
 **Returns**: `UpdateMethodRateLimitResponse`.
 
 ```ruby
 # Ruby
-qn.admin.update_method_rate_limit(id: "ep-123", method_rate_limit_id: "rl-1", rate: 50)
+qn.admin.update_method_rate_limit(id: "ep-123", method_rate_limit_id: "rl-1", rate: 50, limit_by_ip: false)
 ```
 
 ##### `delete_method_rate_limit` / `deleteMethodRateLimit`
@@ -838,15 +866,16 @@ qn.admin.delete_method_rate_limit(id: "ep-123", method_rate_limit_id: "rl-1")
 
 ##### `update_rate_limits` / `updateRateLimits`
 
-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`.
+Partial update of the endpoint-level RPS / RPM / RPD caps. Only supplied fields change. Values are capped by the account's plan tier. Sends `PATCH`. Set `limit_by_ip` (`limitByIp` in Node) to `true` to apply the caps per client IP or `false` to apply them to the whole endpoint. You can update this flag without sending caps. Supply at least one cap or the flag; an empty update returns an API error. Both update methods accept these options.
 
-**Parameters**: `id` (endpoint id, required); `rate_limits`: `RateLimitSettings` (`rps`, `rpm`, `rpd`, all optional).
+**Parameters**: `id` (endpoint id, required); `rps`, `rpm`, `rpd`: optional integers; `limit_by_ip`: optional boolean.
 
 **Returns**: nothing.
 
 ```ruby
 # Ruby
-qn.admin.update_rate_limits(id: "ep-123", rps: 100, rpm: 5000)
+qn.admin.update_rate_limits(id: "ep-123", rps: 100, rpm: 5000, limit_by_ip: true)
+qn.admin.update_rate_limits(id: "ep-123", limit_by_ip: false)
 ```
 
 ##### `get_rate_limits` / `getRateLimits`
@@ -901,9 +930,9 @@ end
 
 ##### `get_endpoint_metrics` / `getEndpointMetrics`
 
-Returns metric series for an endpoint over a time period.
+Returns metric series for an endpoint over a time period. Optional integer `percentile` ranges from 1 through 100 and is required for `response_time_over_time` and `method_response_time_max`. For example, use `95`. Metric and period strings remain open.
 
-**Parameters**: `id` (endpoint id, required); body: `period` (`"hour"` | `"day"` | `"week"` | `"month"`), `metric` (e.g. `"method_calls_over_time"`, `"response_status_breakdown"`).
+**Parameters**: `id` (endpoint id, required); query: `period` (`"hour"` | `"day"` | `"week"` | `"month"`), `metric` (e.g. `"method_calls_over_time"`, `"response_status_breakdown"`), `percentile` (integer, optional).
 
 **Returns**: `GetEndpointMetricsResponse` (as an `IndifferentHash`) with `data: Array<EndpointMetric>`. Each `EndpointMetric` has `tag: Array<String>` and `data: Array<Array<Integer>>` 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"]`.
 
@@ -912,13 +941,14 @@ Returns metric series for an endpoint over a time period.
 resp = qn.admin.get_endpoint_metrics(
   id: "ep-123",
   period: "day",
-  metric: "method_calls_over_time"
+  metric: "response_time_over_time",
+  percentile: 95
 )
 ```
 
 ##### `get_account_metrics` / `getAccountMetrics`
 
-Returns account-level metric series. Supports an optional `percentile` (e.g. `"p50"`, `"p95"`, `"p99"`) for latency metrics.
+Returns account-level metric series. The existing optional `percentile` argument remains for compatibility; the API currently ignores it. Endpoint latency percentile support belongs to `get_endpoint_metrics`.
 
 **Parameters**: `period` (required), `metric` (required), `percentile` (string, optional).
 
@@ -1002,6 +1032,8 @@ resp = qn.admin.list_payments
 
 #### Bulk Operations
 
+Each result can include an `error` string. Check individual results: HTTP 200 can contain both successes and failures. Successful rows can omit `error`.
+
 ##### `bulk_update_endpoint_status` / `bulkUpdateEndpointStatus`
 
 Activates or pauses many endpoints at once.
@@ -1058,7 +1090,7 @@ resp = qn.admin.list_tags
 
 ##### `rename_tag` / `renameTag`
 
-Renames an account-level tag.
+Renames an account-level tag. Labels must be nonblank and contain 3 through 25 characters after trimming. The SDK does not trim values.
 
 **Parameters**: `id` (i32, required — the tag id); body: `label` (string, required).
 
@@ -1100,6 +1132,158 @@ The pattern across the Admin client: `id:` always names the **parent** resource.
 | `delete_request_filter` | `id:`, `request_filter_id:` |
 | `delete_rate_limit_override` | `id:`, `override_id:` |
 
+#### Additional security operations
+
+All methods below take the numeric endpoint `id` as a string. Reads do not enable a security feature.
+
+| Method | Additional input | Returned `data` |
+| --- | --- | --- |
+| `get_client_certs` | None | `enabled`, `certs` |
+| `create_client_cert` | `certificate`, a PEM string | Full certificate state |
+| `update_client_certs` | `enabled`, a boolean | Full certificate state |
+| `delete_client_cert` | `fingerprint` | Full state after deletion |
+| `get_method_blacklist` | None | `methods` |
+| `update_method_blacklist` | `methods`, a string array | Replaced method list |
+| `get_range_limits` | None | `limits`, `supported_methods` |
+| `update_range_limits` | `limits`, a method-to-integer map | Replaced limits and supported methods |
+| `get_blocked_ips` | None | Array of string `id` and `ip` records |
+| `create_blocked_ip` | `ip`, an address or CIDR string | Created string `id` and `ip` |
+| `delete_blocked_ip` | `ip_id` | Boolean confirmation |
+
+Certificate records contain `fingerprint`, `subject`, `issuer`, and `expires_at`. Deleting the last certificate returns disabled state with an empty list; DELETE still has a response body. Invalid, expired, duplicate, or unknown certificates can return HTTP 422.
+
+Blacklist and range-limit updates replace the complete configuration. An empty array clears the blacklist; an empty object clears range limits. Range limits must be positive integers. Read `supported_methods` for the endpoint's supported methods instead of assuming one global list. Blocked-IP calls do not toggle IP security; visibility can depend on the endpoint's IP security setting.
+
+```ruby
+certificates = qn.admin.get_client_certs(id: "123")
+ranges = qn.admin.get_range_limits(id: "123")
+blocked = qn.admin.get_blocked_ips(id: "123")
+blacklist = qn.admin.update_method_blacklist(id: "123", methods: ["eth_sendRawTransaction"])
+```
+
+#### Mutation responses
+
+Existing mutation methods keep their original return values. Use these response-returning variants when you need the created record or effective limits. Each takes the same arguments as its existing counterpart.
+
+| Method | Returned `data` |
+| --- | --- |
+| `create_token_with_response` | Token `id` and `token` |
+| `create_referrer_with_response` | Referrer `id` and `url` |
+| `create_ip_with_response` | IP record `id` and `ip` |
+| `create_domain_mask_with_response` | Record `id` and `domain_mask` |
+| `create_jwt_with_response` | JWT `id`, `public_key`, `kid`, and `name` |
+| `create_tag_with_response` | `tags` containing association `id`, `tag_id`, `account_id`, `endpoint_id`, label, and timestamps |
+| `update_rate_limits_with_response` | `limits` with nullable `rps`, `rpm`, and `rpd` |
+
+Creation and snapshot fields differ: a created referrer uses `url`, while endpoint snapshots use `referrer`; a created domain mask uses `domain_mask`, while snapshots use `domain`. Tag association `id` differs from `tag_id`; these IDs are numeric. Rust Debug output redacts token and JWT credential values. Store returned credentials securely and do not log them.
+
+```ruby
+created = qn.admin.create_referrer_with_response(id: "123", referrer: "https://example.com")
+puts created[:data][:id]
+```
+
+#### Usage and metrics summaries
+
+These methods return a resolved time window, typed totals, optional grouped rows, and an optional continuation cursor.
+
+| Method | Grouping | Additional filters |
+| --- | --- | --- |
+| `get_usage_credits_summary` | None | None |
+| `get_usage_rpc_summary` | `method`, `endpoint`, `chain`, `network` | `endpoint_names`, `chains`, `networks`, `methods`, `tag_ids`, `addon_ids` |
+| `get_usage_streams_summary` | `stream` | `stream_id` |
+| `get_usage_webhooks_summary` | `webhook` | `webhook_id` |
+| `get_traffic_summary` | `method`, `endpoint` | Same filters as the RPC summary |
+| `get_errors_summary` | `code`, `endpoint`, `network`, `method` | `endpoints`, `networks`, `methods`, `codes`, `status_codes`, `kind` |
+| `get_endpoint_errors_summary` | `code`, `network`, `method` | Required endpoint `id`; error-summary filters except `endpoints` |
+
+| Summary | Totals fields |
+| --- | --- |
+| Credits | `credits` |
+| RPC | `requests`, `bytes`, `rpc_credits`, `data_credits`, `credits` |
+| Streams | `blocks`, `bytes`, `block_credits` |
+| Webhooks | `deliveries`, `credits` |
+| Traffic | `successful_requests`, `bytes`, `request_credits`, `bytes_credits`, `credits`, `active_methods` |
+| Account and endpoint errors | `rpc_errors`, `http_errors` |
+
+Error breakdown rows contain `kind` and `count`, plus the selected grouping dimensions. Other breakdown rows carry their summary metrics and selected dimensions.
+
+For the first page, supply `last` as a positive integer duration ending now (`s`, `m`, `h`, or `d`), or both `from_time` and `to_time` as ISO 8601 timestamps with timezones. Bare dates are not summary timestamps. Use `group_by` for grouping. Credits summaries have no grouping parameter. The limit is 1 through 1000 and defaults to 100.
+
+Pass native arrays for groups and array filters. The SDK encodes repeated bracketed query keys such as `group_by[]=method&group_by[]=endpoint`. Error codes and HTTP status-code filters remain strings. `endpoint_names` contains endpoint subdomains; RPC, traffic, and account-error result `endpoint` values are integer endpoint IDs. Account-error `endpoints` filters accept integer arrays, such as `[123, 456]`. `tag_ids` and `addon_ids` contain numeric IDs represented as strings. Endpoint error-summary `id` uses the numeric endpoint ID represented as a string.
+
+For error summaries, `kind` is `rpc` or `http`. Method filtering/grouping requires `rpc`; RPC kind rejects `status_codes`, and HTTP kind rejects `codes`. Feature access and retention can produce API errors, including HTTP 403.
+
+Continue with `cursor` alone. A cursor belongs to the original route, account, and query; any repeated parameters, including `limit`, must match. Keep the returned window values: the server can align summary windows to billing boundaries. Totals cover the full window on every page, not only the current rows. The SDK does not round windows or paginate automatically.
+
+Summary metrics use floating-point numbers, including count-like fields, and can contain fractions such as `7.5`. They do not promise arbitrary decimal precision. Legacy usage fields remain integers. RPC breakdown `requests` and traffic breakdown `successful_requests` can be null even though totals are non-null. A missing `breakdown` is not an empty grouped result.
+
+Endpoint grouping values are `Integer` or `nil`. An omitted grouping dimension has no Hash key; an explicit null value is `nil`. Use `row.key?(:method)` to check presence. An omitted breakdown has no key. Response window keys are `:from` and `:to`; request keywords are `from_time:` and `to_time:`.
+
+```ruby
+page = qn.admin.get_usage_rpc_summary(last: "1h", group_by: ["method", "endpoint"], limit: 20)
+puts page[:data][:totals][:credits]
+if page[:data][:next_cursor]
+  next_page = qn.admin.get_usage_rpc_summary(cursor: page[:data][:next_cursor])
+end
+```
+
+#### Activity logs
+
+Lists account changes, newest first. `list_activity_log_filters` returns the actor IDs and target types accepted by `list_activity_logs`; `get_activity_log` returns one entry by UUID.
+
+List filters are `q`, `actor`, `endpoint_id`, `target_type`, `from_time`, `to_time`, `limit`, and `offset`. `endpoint_id` is a numeric endpoint ID represented as a string. `target_type` is sent as `type`. The limit is 0 through 100 and defaults to 20. Offset pagination returns `total`, `limit`, and `offset`; pin `to_time` when exporting because new entries shift offsets. Bare dates are accepted: `from_time` starts at midnight UTC, and `to_time` includes the entire day.
+
+Responses keep actor and target metadata typed. Actor IDs, names, and emails can be null, including for deleted users. Feature access can return HTTP 403; a missing detail entry returns HTTP 404.
+
+```ruby
+filters = qn.admin.list_activity_log_filters
+page = qn.admin.list_activity_logs(limit: 20)
+if (entry = page[:data].first)
+  detail = qn.admin.get_activity_log(id: entry[:id])
+end
+```
+
+#### Transactions
+
+`list_transactions` returns retained transactions and an optional continuation cursor. A first page needs `last` (for example, `1h`), or both `from_time` and `to_time` as ISO 8601 timestamps with timezones. A cursor alone continues the same resolved window.
+
+Optional filters are `network`, `method`, `state`, `transaction_hash`, and `endpoints`. States are `submitted`, `succeeded`, and `failed`. Endpoint filters accept integer endpoint IDs, such as `[123, 456]`, and use repeated `endpoints[]` query keys. The limit is 1 through 1000 and defaults to 100.
+
+`get_transaction` takes a network, a transaction hash, and optional `include_payloads`. It returns an outer `data` containing `exists` and a second `data` value. An absent or expired transaction can return `exists: false` and `data: null`. Payloads default to excluded; set `include_payloads` to true to request retained request and response text. The SDK preserves that text without parsing it. Feature access can return HTTP 403.
+
+Transaction `endpoint_ids` arrays contain integer endpoint IDs or null elements; the detail array itself can be absent or null. Each attempt has a required integer `endpoint_id`. Block heights remain decimal strings, including values such as `9007199254740993`. Other detail metadata can be absent or null. Attempts retain the order returned by the API.
+
+```ruby
+page = qn.admin.list_transactions(last: "1h", endpoints: [123, 456], limit: 20)
+if (transaction = page[:data][:transactions].first)
+  result = qn.admin.get_transaction(
+    network: transaction[:network], hash: transaction[:transaction_hash],
+    include_payloads: false
+  )
+  if result[:data][:exists] && result[:data][:data]
+    puts result[:data][:data][:height] # String or nil
+  end
+end
+if page[:data][:next_cursor]
+  next_page = qn.admin.list_transactions(cursor: page[:data][:next_cursor])
+end
+```
+
+#### Admin compatibility notes
+
+Summary endpoint dimensions and transaction endpoint IDs use `Integer` values. Pass integer arrays to account-error and transaction `endpoints` filters. Transaction endpoint-ID arrays can contain `nil`; attempt `endpoint_id` is required. Update callers that used UUID strings.
+
+Existing methods retain their return values and optional argument requiredness. Required API inputs are documented above; omitted or invalid values still produce API errors. Use the response-returning methods when you need created records.
+
+Rust callers must update affected full struct literals for the added fields, even when those fields are optional. This includes security snapshots/options, filter responses, usage rows, bulk results, method-rate-limit requests/responses, and endpoint metric requests. Request structs with `Default` can use `..Default::default()` for omitted fields; builders avoid full-literal updates where available.
+
+`EndpointRequestFilter.method` changed from `Vec<String>` to `Vec<serde_json::Value>` so it can preserve structured matchers. Convert strings with `.into()` or `serde_json::json!`, and use `as_str()` when reading a string matcher. Match object values as JSON rather than assuming every matcher is a string. Snapshot `params` and custom `pattern` are object maps containing JSON values.
+
+Python endpoint/security response wrappers keep their public class names, getters, and setters. Filter values are native lists and dictionaries; assign through the setter after editing a returned value. Node uses `unknown[]` for matcher arrays and `Record<string, unknown>` for open pattern objects. Ruby continues to return `IndifferentHash` values. JSON object keys are preserved without recursive case conversion.
+
+New summary, activity, and transaction window fields use `from_time` and `to_time` in Rust/Python. Node fields and serialized response keys remain `from` and `to`; Python/Ruby client arguments use `from_time` and `to_time`. Existing endpoint-log arguments do not change.
+
+
 ---
 
 ### Streams Client
@@ -1706,8 +1890,9 @@ mints short-lived session JWTs. `qn.rpc` makes JSON-RPC calls directly against t
 endpoint, minting and refreshing the JWT automatically — no endpoint URL or token to
 manage.
 
-Tooling Access must be enabled once (admin role + eligible plan). The control-plane
-methods live on `qn.admin`:
+Tooling Access must be enabled once (admin role + eligible plan). Status reads can
+return HTTP 403 when feature access is unavailable; successful authentication alone
+does not guarantee access. The control-plane methods live on `qn.admin`:
 
 ```ruby
 # Ruby

data/sig/quicknode_sdk.rbs

@@ -102,7 +102,7 @@ module QuicknodeSdk
     def get_endpoint_logs: (id: String, from_time: String, to_time: String, ?include_details: bool, ?limit: Integer, ?next_at: String) -> untyped
     def get_log_details: (id: String, request_id: String) -> untyped
     def get_security_options: (id: String) -> untyped
-    def update_security_options: (id: String, ?tokens: String, ?referrers: String, ?jwts: String, ?ips: String, ?domain_masks: String, ?hsts: String, ?cors: String, ?request_filters: String, ?ip_custom_header: String) -> untyped
+    def update_security_options: (id: String, ?tokens: String, ?referrers: String, ?jwts: String, ?ips: String, ?domain_masks: String, ?hsts: String, ?cors: String, ?request_filters: String, ?ip_custom_header: String, ?response_logging: String) -> untyped
     def create_token: (id: String) -> void
     def delete_token: (id: String, token_id: String) -> untyped
     def create_referrer: (id: String, referrer: String) -> void
@@ -113,6 +113,39 @@ module QuicknodeSdk
     def delete_domain_mask: (id: String, domain_mask_id: String) -> untyped
     def create_jwt: (id: String, kid: String, public_key: String, name: String) -> void
     def delete_jwt: (id: String, jwt_id: String) -> void
+    def get_request_filters: (id: String) -> untyped
+    def create_request_filter_pattern: (id: String, pattern: Hash[String, untyped]) -> untyped
+    def update_request_filter_pattern: (id: String, request_filter_id: String, pattern: Hash[String, untyped]) -> void
+    def get_client_certs: (id: String) -> untyped
+    def create_client_cert: (id: String, certificate: String) -> untyped
+    def update_client_certs: (id: String, enabled: bool) -> untyped
+    def delete_client_cert: (id: String, fingerprint: String) -> untyped
+    def get_method_blacklist: (id: String) -> untyped
+    def update_method_blacklist: (id: String, methods: Array[String]) -> untyped
+    def get_range_limits: (id: String) -> untyped
+    def update_range_limits: (id: String, limits: Hash[String, Integer]) -> untyped
+    def get_blocked_ips: (id: String) -> untyped
+    def create_blocked_ip: (id: String, ip: String) -> untyped
+    def delete_blocked_ip: (id: String, ip_id: String) -> untyped
+    def list_activity_logs: (?q: String, ?actor: String, ?endpoint_id: String, ?target_type: String, ?from_time: String, ?to_time: String, ?limit: Integer, ?offset: Integer) -> untyped
+    def list_activity_log_filters: () -> untyped
+    def get_activity_log: (id: String) -> untyped
+    def list_transactions: (?last: String, ?from_time: String, ?to_time: String, ?network: String, ?method: String, ?state: String, ?transaction_hash: String, ?cursor: String, ?endpoints: Array[Integer], ?limit: Integer) -> untyped
+    def get_transaction: (network: String, hash: String, ?include_payloads: bool) -> untyped
+    def get_usage_credits_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer) -> untyped
+    def get_usage_rpc_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?endpoint_names: Array[String], ?chains: Array[String], ?networks: Array[String], ?methods: Array[String], ?tag_ids: Array[String], ?addon_ids: Array[String]) -> untyped
+    def get_usage_streams_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?stream_id: String) -> untyped
+    def get_usage_webhooks_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?webhook_id: String) -> untyped
+    def get_traffic_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?endpoint_names: Array[String], ?chains: Array[String], ?networks: Array[String], ?methods: Array[String], ?tag_ids: Array[String], ?addon_ids: Array[String]) -> untyped
+    def get_errors_summary: (?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?endpoints: Array[Integer], ?networks: Array[String], ?methods: Array[String], ?codes: Array[String], ?status_codes: Array[String], ?kind: String) -> untyped
+    def get_endpoint_errors_summary: (id: String, ?last: String, ?from_time: String, ?to_time: String, ?cursor: String, ?limit: Integer, ?group_by: Array[String], ?networks: Array[String], ?methods: Array[String], ?codes: Array[String], ?status_codes: Array[String], ?kind: String) -> untyped
+    def create_token_with_response: (id: String) -> untyped
+    def create_referrer_with_response: (id: String, referrer: String) -> untyped
+    def create_ip_with_response: (id: String, ip: String) -> untyped
+    def create_domain_mask_with_response: (id: String, ?domain_mask: String) -> untyped
+    def create_jwt_with_response: (id: String, kid: String, public_key: String, name: String) -> untyped
+    def create_tag_with_response: (id: String, ?label: String) -> untyped
+    def update_rate_limits_with_response: (id: String, ?rps: Integer, ?rpm: Integer, ?rpd: Integer, ?limit_by_ip: bool) -> untyped
     def create_request_filter: (id: String, methods: Array[String]) -> untyped
     def update_request_filter: (id: String, request_filter_id: String, ?methods: Array[String]) -> void
     def delete_request_filter: (id: String, request_filter_id: String) -> void
@@ -121,14 +154,14 @@ module QuicknodeSdk
     def create_or_update_ip_custom_header: (id: String, header_name: String) -> untyped
     def delete_ip_custom_header: (id: String) -> untyped
     def get_method_rate_limits: (id: String) -> untyped
-    def create_method_rate_limit: (id: String, interval: String, methods: Array[String], rate: Integer) -> untyped
-    def update_method_rate_limit: (id: String, method_rate_limit_id: String, ?methods: Array[String], ?status: String, ?rate: Integer) -> untyped
+    def create_method_rate_limit: (id: String, interval: String, methods: Array[String], rate: Integer, ?limit_by_ip: bool) -> untyped
+    def update_method_rate_limit: (id: String, method_rate_limit_id: String, ?methods: Array[String], ?status: String, ?rate: Integer, ?limit_by_ip: bool) -> untyped
     def delete_method_rate_limit: (id: String, method_rate_limit_id: String) -> void
-    def update_rate_limits: (id: String, ?rps: Integer, ?rpm: Integer, ?rpd: Integer) -> void
+    def update_rate_limits: (id: String, ?rps: Integer, ?rpm: Integer, ?rpd: Integer, ?limit_by_ip: bool) -> void
     def get_rate_limits: (id: String) -> untyped
     def delete_rate_limit_override: (id: String, override_id: String) -> void
     def get_endpoint_urls: (id: String) -> untyped
-    def get_endpoint_metrics: (id: String, period: String, metric: String) -> untyped
+    def get_endpoint_metrics: (id: String, period: String, metric: String, ?percentile: Integer) -> untyped
     def get_account_metrics: (period: String, metric: String, ?percentile: String) -> untyped
     def list_chains: () -> untyped
     def account_info: () -> untyped

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quicknode_sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Quicknode
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie