quicknode_sdk 0.6.0-aarch64-linux → 0.7.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2616f4fa4188dd16880a9320b248220ad593cc20ec969fee94c597d6419d808
-  data.tar.gz: fdd2ecf9b82a870515feab735c2ad27e242c2adc42800ad9d584151efae02b8a
+  metadata.gz: 06e3a0f527e826702bfc52209cac02cefb8608f330b9ca4a5ecd3a27dbf8ca62
+  data.tar.gz: 0a658eb08f59aa60dbe0f9369fc46cd58b33404d760f0edd41f52a190a45d3ec
 SHA512:
-  metadata.gz: db149fe5acb0957676f301abf8beef8d5f78f3f01c0a2bd321621710783fa96c8ff8b374b5894f95bc9aa13dd1b3a8e9e0258130682bfdddb2a68f23574c6541
-  data.tar.gz: 64d34507518bb16dfc21930036080ae63afaf6d8bdcdfcd6b183a9f8a3bcfa3efe05262549a47530de41bc6d0ea7a3af41c470ce937c57e54517d501db0fd76d
+  metadata.gz: 81f32c2ec74049ed4da7d7355272f40d26f3b884ecb9b723abfa16808230afce375d4e850572c6607474ca9578d41fe1df05a968660defd9354b6341e7724707
+  data.tar.gz: ac1bc5eafc7bae1e5316b9a6deaf26960044af59c4a2ac9247c7a968ec669ff5c91f08259d82ed55229361f3f0eb68a2da49ddf7d5762fe1976dbbe7e39511ad

data/README.md

@@ -1682,6 +1682,54 @@ schema = qn.sql.get_schema(cluster_id: "hyperliquid-core-mainnet")
 puts schema[:tables].length
 ```
 
+---
+
+### RPC & Tooling Access
+
+Tooling Access provisions a single multichain, read-only endpoint per account and
+mints short-lived session JWTs. `qn.rpc` makes JSON-RPC calls directly against that
+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`:
+
+```ruby
+# Ruby
+status = qn.admin.tooling_access_status
+qn.admin.enable_tooling_access unless status["enabled"] # idempotent; admin role required
+
+# Make on-chain calls. params defaults to []; pass an Array (positional) or Hash.
+block_number = qn.rpc.call(method: "eth_blockNumber")
+balance = qn.rpc.call(method: "eth_getBalance", params: ["0xabc...", "latest"])
+
+# Multichain: select a network by its multichain_urls key. Seed the map first
+# (from admin.get_endpoint_urls), then pass network:.
+urls = qn.admin.get_endpoint_urls(id: endpoint_id)
+map = (urls.dig("data", "multichain_urls") || {}).transform_values { |v| v["http_url"] }
+qn.rpc.set_networks(networks: map)
+slot = qn.rpc.call(method: "getSlot", network: "solana-mainnet")
+
+# Custom endpoint URL: send to a fully-formed HTTP URL, bypassing Tooling Access
+# and the JWT (no Authorization header). Per-call via endpoint_url:, or client-wide
+# via the rpc: { endpoint_url: ... } config key. endpoint_url and network are
+# mutually exclusive (a custom URL is not multichain-routed).
+block = qn.rpc.call(method: "eth_blockNumber", endpoint_url: "https://my-endpoint.example/rpc")
+
+# A JSON-RPC error member is raised as QuicknodeSdk::RpcError (with #code, #message).
+begin
+  qn.rpc.call(method: "eth_getBalance", params: ["bad"])
+rescue QuicknodeSdk::RpcError => e
+  warn "#{e.code}: #{e.message}"
+end
+```
+
+Responses are wrapped in `QuicknodeSdk::IndifferentHash` — access with `[]`. A host that
+persists across processes can snapshot the cached token with `qn.rpc.current_token` and
+re-seed it via the `rpc: { seed: ... }` config key; `refresh_margin_secs` (default 60)
+tunes how early the token is refreshed. Set `rpc: { endpoint_url: ... }` to route every
+call to a custom HTTP URL by default (no JWT minted); a per-call `endpoint_url` overrides it.
+
 ## Error Handling
 
 Every binding exposes a typed exception hierarchy derived from the core `SdkError`
@@ -1697,8 +1745,9 @@ subclass to branch on transport vs. API semantics.
 | `ConnectionError`    | connection refused / DNS / TLS (subclass of `HttpError`)    | —                    |
 | `ApiError`           | non-2xx HTTP response                                       | `status`, `body`     |
 | `DecodeError`        | 2xx response but JSON parse failed                          | `body`               |
+| `RpcError`           | JSON-RPC call returned an `error` member                    | `code`, `message`    |
 
-Class names: `QuicknodeSdk::Error`, `QuicknodeSdk::ConfigError`, `QuicknodeSdk::HttpError`, `QuicknodeSdk::TimeoutError`, `QuicknodeSdk::ConnectionError`, `QuicknodeSdk::ApiError`, `QuicknodeSdk::DecodeError`. All extend `StandardError`. Hash-key validation still raises `ArgumentError`.
+Class names: `QuicknodeSdk::Error`, `QuicknodeSdk::ConfigError`, `QuicknodeSdk::HttpError`, `QuicknodeSdk::TimeoutError`, `QuicknodeSdk::ConnectionError`, `QuicknodeSdk::ApiError`, `QuicknodeSdk::DecodeError`, `QuicknodeSdk::RpcError`. All extend `StandardError`. Hash-key validation still raises `ArgumentError`.
 
 ```ruby
 # Ruby

data/lib/quicknode_sdk/clients/rpc.rb

@@ -0,0 +1,4 @@
+module QuicknodeSdk
+  class Rpc < NativeDelegator
+  end
+end

data/lib/quicknode_sdk/sdk.rb

@@ -38,5 +38,9 @@ module QuicknodeSdk
     def sql
       Sql.new(@native.sql)
     end
+
+    def rpc
+      Rpc.new(@native.rpc)
+    end
   end
 end

data/lib/quicknode_sdk.rb

@@ -14,4 +14,5 @@ require_relative "quicknode_sdk/clients/streams"
 require_relative "quicknode_sdk/clients/webhooks"
 require_relative "quicknode_sdk/clients/kvstore"
 require_relative "quicknode_sdk/clients/sql"
+require_relative "quicknode_sdk/clients/rpc"
 require_relative "quicknode_sdk/sdk"

data/sig/quicknode_sdk.rbs

@@ -25,6 +25,11 @@ module QuicknodeSdk
     attr_reader body: String
   end
 
+  class RpcError < Error
+    attr_reader code: Integer
+    attr_reader message: String
+  end
+
   class SDK
     def self.from_env: () -> SDK
     def self.from_config: (Hash[Symbol | String, untyped] opts) -> SDK
@@ -34,6 +39,7 @@ module QuicknodeSdk
     def webhooks: () -> Webhooks
     def kvstore: () -> KvStore
     def sql: () -> Sql
+    def rpc: () -> Rpc
   end
 
   class DestinationAttributes
@@ -93,6 +99,10 @@ module QuicknodeSdk
     def list_chains: () -> untyped
     def account_info: () -> untyped
     def get_api_credits: (chain: String) -> untyped
+    def tooling_access_status: () -> untyped
+    def enable_tooling_access: () -> untyped
+    def disable_tooling_access: () -> untyped
+    def mint_tooling_token: () -> untyped
     def list_invoices: () -> untyped
     def list_payments: () -> untyped
     def list_teams: () -> untyped
@@ -168,4 +178,13 @@ module QuicknodeSdk
     def query: (query: String, cluster_id: String) -> untyped
     def get_schema: (cluster_id: String) -> untyped
   end
+
+  class Rpc
+    def initialize: (untyped native) -> void
+
+    def call: (method: String, ?params: untyped, ?network: String, ?endpoint_url: String) -> untyped
+    def set_networks: (networks: Hash[String, String]) -> void
+    def clear_cached_token: () -> void
+    def current_token: () -> untyped
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quicknode_sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: aarch64-linux
 authors:
 - Quicknode
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-07 00:00:00.000000000 Z
+date: 2026-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -34,6 +34,7 @@ files:
 - lib/quicknode_sdk.rb
 - lib/quicknode_sdk/clients/admin.rb
 - lib/quicknode_sdk/clients/kvstore.rb
+- lib/quicknode_sdk/clients/rpc.rb
 - lib/quicknode_sdk/clients/sql.rb
 - lib/quicknode_sdk/clients/streams.rb
 - lib/quicknode_sdk/clients/webhooks.rb