quicknode_sdk 0.5.0-x86_64-linux → 0.7.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdd0567be01e72a476fed68f5fb0a298c7777c6048971c32218d78485ada5c61
-  data.tar.gz: 490893c43810b35f1240fcb792371f46960912fac3300cc5040ac68bc107b696
+  metadata.gz: 6016bd900bf6ea25d15a8a28c8ce88db001c333c6705e2cd4c4c5709eaa58871
+  data.tar.gz: a357ce106ce20c23950a6956e76ac13fd3a2bad9f09ac73ec2827866df825ad9
 SHA512:
-  metadata.gz: 92b6525f4e7cbf807118f8e904a9dd07671611d78ee5dbd38669580f9320a1cb433829454dc2da22855cbfeab3b131296b62b6d3a3664eea1d40905d92cae653
-  data.tar.gz: 668bd756854567423ad1f5a35d0efc48e0c61420b501734802a29e0a31ddbdcb32f012506ceafb499a2024d1838e87324dfe6d8b5bd85ef26d0119bb88abb43b
+  metadata.gz: c8936fcbcf8769cd461527d6b2606c2dc3557d0f13683b6778e004428bac5963ecafe1d9babd4fed87413b965b1178e7e9f828965d1853b39e0051b155aec1f4
+  data.tar.gz: 7fc3e7e441b0e1aaf633da16d793cef481a3a20653a273436748919a8ec48bb698575cf9239efc2d8ef7e2e78c06a21da9c140cb4cc743b6195e3ecb02a0c586

data/README.md

@@ -34,6 +34,7 @@ This is one of four language bindings published from the same Rust core. See the
     - [Endpoint URLs](#endpoint-urls)
     - [Metrics](#metrics)
     - [Chains](#chains)
+    - [Account](#account)
     - [Billing](#billing)
     - [Bulk Operations](#bulk-operations)
     - [Account Tags](#account-tags)
@@ -928,6 +929,34 @@ Lists the blockchains supported by Quicknode along with their networks.
 resp = qn.admin.list_chains
 ```
 
+#### Account
+
+##### `account_info` / `accountInfo`
+
+Returns details about the account, including its id, name, creation timestamp, billing version, and current subscription.
+
+**Parameters**: none.
+
+**Returns**: `AccountInfoResponse` with `data: AccountInfo` (including a nested `subscription: AccountSubscription`).
+
+```ruby
+# Ruby
+resp = qn.admin.account_info
+```
+
+##### `get_api_credits` / `getApiCredits`
+
+Returns the per-method API credit costs for a chain, identified by its slug (the same slugs returned by `list_chains`, e.g. `ethereum`). An unknown chain slug raises `ApiError` (status 404).
+
+**Parameters**: `chain` (string, required) — the chain slug.
+
+**Returns**: `GetApiCreditsResponse` with `data: [ApiCredit]`, where each `ApiCredit` has `method` and `credits`.
+
+```ruby
+# Ruby
+resp = qn.admin.get_api_credits(chain: "ethereum")
+```
+
 #### Billing
 
 ##### `list_invoices` / `listInvoices`
@@ -1653,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`
@@ -1668,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
@@ -91,6 +97,12 @@ module QuicknodeSdk
     def get_endpoint_metrics: (id: String, period: String, metric: String) -> untyped
     def get_account_metrics: (period: String, metric: String, ?percentile: String) -> untyped
     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
@@ -166,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.5.0
+  version: 0.7.0
 platform: x86_64-linux
 authors:
 - Quicknode
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-25 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