@quicknode/sdk 3.6.0 → 3.7.0

package/README.md

@@ -1674,6 +1674,59 @@ const schema = await qn.sql.getSchema("hyperliquid-core-mainnet");
 console.log(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`:
+
+```typescript
+// Node.js
+const status = await qn.admin.toolingAccessStatus();
+if (!status.enabled) {
+  await qn.admin.enableToolingAccess(); // idempotent; admin role required
+}
+
+// Make on-chain calls. params defaults to []; pass an array (positional) or object.
+const blockNumber = await qn.rpc.call("eth_blockNumber");
+const balance = await qn.rpc.call("eth_getBalance", ["0xabc...", "latest"]);
+
+// Multichain: select a network by its multichain_urls key. Seed the map first
+// (from admin.getEndpointUrls), then pass the network as the 3rd arg.
+const urls = await qn.admin.getEndpointUrls(endpointId);
+const map = Object.fromEntries(
+  Object.entries(urls.multichainUrls ?? {}).map(([k, v]) => [k, v.httpUrl]),
+);
+qn.rpc.setNetworks(map);
+const slot = await qn.rpc.call("getSlot", [], "solana-mainnet");
+
+// Custom endpoint URL: send to a fully-formed HTTP URL, bypassing Tooling Access
+// and the JWT (no Authorization header). Per-call via the 4th arg, or client-wide
+// via `new RpcConfig({ endpointUrl })`. endpointUrl and network are mutually
+// exclusive (a custom URL is not multichain-routed).
+const block = await qn.rpc.call("eth_blockNumber", [], undefined, "https://my-endpoint.example/rpc");
+
+// A JSON-RPC error member is thrown as RpcError (with .code and .message).
+import { RpcError } from "@quicknode/sdk";
+try {
+  await qn.rpc.call("eth_getBalance", ["bad"]);
+} catch (e) {
+  if (e instanceof RpcError) console.error(e.code, e.message);
+}
+```
+
+A host that persists across processes can snapshot the cached token with
+`qn.rpc.currentToken()` and re-seed it via `RpcConfig.seed` on the next construction;
+`refreshMarginSecs` (default 60) tunes how early the token is refreshed. Set
+`RpcConfig.endpointUrl` to route every call to a custom HTTP URL by default (no
+JWT minted); a per-call `endpointUrl` overrides it.
+
 ## Error Handling
 
 Every binding exposes a typed exception hierarchy derived from the core `SdkError`
@@ -1689,8 +1742,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: Importable from `@quicknode/sdk`: `QuicknodeError`, `ConfigError`, `HttpError`, `TimeoutError`, `ConnectionError`, `ApiError`, `DecodeError`. All extend `Error`.
+Class names: Importable from `@quicknode/sdk`: `QuicknodeError`, `ConfigError`, `HttpError`, `TimeoutError`, `ConnectionError`, `ApiError`, `DecodeError`, `RpcError`. All extend `Error`.
 
 ```typescript
 // Node.js

package/errors.js

@@ -54,7 +54,15 @@ class DecodeError extends QuicknodeError {
   }
 }
 
-const TAG_RE = /^\[(Config|Http|Timeout|Connect|Api|Decode)\|([^|]+)\|([^\]]+)\](.*)$/s;
+class RpcError extends QuicknodeError {
+  constructor(message, code) {
+    super(message);
+    this.name = "RpcError";
+    this.code = code;
+  }
+}
+
+const TAG_RE = /^\[(Config|Http|Timeout|Connect|Api|Decode|Rpc)\|([^|]+)\|([^\]]+)\](.*)$/s;
 
 function fromNapiError(err) {
   if (!(err instanceof Error)) return err;
@@ -82,6 +90,8 @@ function fromNapiError(err) {
     case "Http": return new HttpError(msg);
     case "Api": return new ApiError(msg, Number(statusStr), body);
     case "Decode": return new DecodeError(msg, body);
+    // For Rpc, statusStr is the JSON-RPC code and body is its message.
+    case "Rpc": return new RpcError(body || msg, Number(statusStr));
     default: return err;
   }
 }
@@ -116,6 +126,7 @@ module.exports = {
   ConnectionError,
   ApiError,
   DecodeError,
+  RpcError,
   fromNapiError,
   wrapClient,
 };

package/index.d.ts

@@ -221,6 +221,23 @@ export interface BulkUpdateEndpointStatusResponse {
   error?: string
 }
 
+/**
+ * A minted session JWT plus the endpoint it authenticates against and its
+ * wall-clock expiry. This is the unit cached by the RPC client and the unit a
+ * host persists between processes (e.g. the CLI's on-disk token cache).
+ *
+ * `exp_unix` is the JWT `exp` claim (unix seconds), used directly so it
+ * survives a process restart (unlike a monotonic `Instant`).
+ */
+export interface CachedToken {
+  /** The provisioned tooling-access endpoint URL the JWT authenticates against. */
+  endpointUrl: string
+  /** The minted ES256 session JWT, presented as a Bearer token. */
+  token: string
+  /** JWT `exp` claim in unix seconds. */
+  expUnix: number
+}
+
 /** A blockchain supported by Quicknode along with its networks. */
 export interface Chain {
   /** Chain slug (e.g. `ethereum`). */
@@ -1465,6 +1482,38 @@ export interface ResendTeamInviteResponse {
   error?: string
 }
 
+export interface RpcConfig {
+  /**
+   * Custom HTTP URL to send JSON-RPC calls to, bypassing the Tooling Access
+   * endpoint. When set, every `rpc.call` on this client goes straight to this
+   * URL with NO session token minted or attached — the URL is treated as a
+   * self-authenticating endpoint (e.g. a provisioned `.quiknode.pro` URL that
+   * already embeds its token, or a self-hosted node). A per-call
+   * `endpoint_url` overrides this default. Unset means tooling-JWT mode.
+   */
+  endpointUrl?: string
+  /**
+   * Optional pre-existing token to seed the in-memory cache (e.g. loaded
+   * from a host's on-disk cache). Advisory: a malformed or expired seed is
+   * treated as a cache miss and a fresh token is minted.
+   */
+  seed?: CachedToken
+  /**
+   * Seconds before `exp` at which the client proactively refreshes. The
+   * margin also absorbs clock skew between client and endpoint. Defaults to
+   * 60 when unset.
+   */
+  refreshMarginSecs?: number
+  /**
+   * Per-network URL map for multichain routing: network key (e.g.
+   * `"solana-mainnet"`, `"polygon"`) -> full http_url. Built from
+   * `admin.get_endpoint_urls(...).multichain_urls`. When set, `rpc.call` with
+   * a `network` resolves the target URL here. Optional; the default-network
+   * call path needs no map.
+   */
+  networks?: Record<string, string>
+}
+
 /** Configuration for delivering stream batches to an S3-compatible object store. */
 export interface S3Attributes {
   /** S3 service endpoint (e.g. `s3.amazonaws.com`). */
@@ -1497,6 +1546,7 @@ export interface SdkFullConfig {
   webhooks?: WebhooksConfig
   kvstore?: KvStoreConfig
   sql?: SqlConfig
+  rpc?: RpcConfig
 }
 
 /** A single security feature's name, status, and optional value. */
@@ -1778,6 +1828,23 @@ export interface TestFilterResponse {
   logs: Array<string>
 }
 
+/**
+ * Current Tooling Access status for the account. `enabled` is the source of
+ * truth — a previously-provisioned-but-disabled account may still report a
+ * non-null `endpoint_url`.
+ */
+export interface ToolingAccessStatus {
+  enabled: boolean
+  endpointUrl?: string
+  enabledAt?: string
+  /**
+   * The provisioned endpoint's id. Used to fetch the per-network URL map
+   * (`get_endpoint_urls`) for multichain routing. `None` on control planes
+   * that don't yet return it.
+   */
+  endpointId?: string
+}
+
 /** Parameters for `update_endpoint`. */
 export interface UpdateEndpointRequest {
   /** New human-readable label. */
@@ -2265,6 +2332,24 @@ export declare class AdminApiClient {
    * chain slug rejects with `ApiError` (status 404).
    */
   getApiCredits(chain: string): Promise<GetApiCreditsResponse>
+  /**
+   * Returns the current Tooling Access status for the account. Inspect
+   * `enabled` to decide whether to enable provisioning.
+   */
+  toolingAccessStatus(): Promise<ToolingAccessStatus>
+  /**
+   * Enables (provisions) Tooling Access. Idempotent. Requires an admin role
+   * and an eligible plan.
+   */
+  enableToolingAccess(): Promise<ToolingAccessStatus>
+  /** Disables Tooling Access, pausing the endpoint. Idempotent. */
+  disableToolingAccess(): Promise<ToolingAccessStatus>
+  /**
+   * Mints a short-lived session JWT for the provisioned Tooling Access
+   * endpoint. Returns the endpoint URL, the JWT, and its expiry. Requires
+   * Tooling Access to be enabled first.
+   */
+  mintToolingToken(): Promise<CachedToken>
   /**
    * Returns the account's invoices, including id, status, billing reason,
    * amounts due and paid, line items with descriptions and billing periods,
@@ -2424,10 +2509,48 @@ export declare class QuicknodeSdk {
   get kvstore(): KvStoreApiClient
   /** Returns the sql sub-client. */
   get sql(): SqlApiClient
+  /** Returns the JSON-RPC sub-client. */
+  get rpc(): RpcApiClient
   /** Creates a new SDK instance using configuration from environment variables. */
   static fromEnv(): QuicknodeSdk
 }
 
+export declare class RpcApiClient {
+  /**
+   * Makes a JSON-RPC call against the account's Tooling Access endpoint,
+   * authenticated with a short-lived session JWT (minted and refreshed
+   * automatically). `params` accepts an array (positional) or object
+   * (by-name) and defaults to `[]`. `network` selects a chain on the
+   * multichain endpoint (a key in the seeded network map, e.g.
+   * `"solana-mainnet"`); omit for the endpoint's default network.
+   *
+   * `endpointUrl` sends this call to a custom HTTP URL instead, bypassing the
+   * Tooling Access endpoint and the session JWT (no Authorization header is
+   * attached). It overrides the client-wide `RpcConfig.endpointUrl` default.
+   * Passing both `endpointUrl` and `network` throws (they are mutually
+   * exclusive). Returns the JSON-RPC `result`; a JSON-RPC error is thrown as
+   * `RpcError`.
+   */
+  call(method: string, params?: any | undefined | null, network?: string | undefined | null, endpointUrl?: string | undefined | null): Promise<any>
+  /**
+   * Seeds the per-network URL map for multichain routing (network key ->
+   * full http_url), typically built from
+   * `admin.getEndpointUrls(...).multichainUrls`.
+   */
+  setNetworks(networks: Record<string, string>): void
+  /**
+   * Discards the in-memory cached token, forcing the next call to mint a
+   * fresh one. Use when the cached token is known stale beyond expiry.
+   */
+  clearCachedToken(): void
+  /**
+   * Returns a snapshot of the currently cached session token, or `null` if
+   * no token has been minted or seeded yet. Hosts use this to persist the
+   * token between processes.
+   */
+  currentToken(): CachedToken | null
+}
+
 export declare class SqlApiClient {
   /** Executes a SQL query against the given cluster and returns the result set. */
   query(query: string, clusterId: string): Promise<QueryResponseNode>

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-android-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-android-arm64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-android-arm-eabi')
         const bindingPackageVersion = require('@quicknode/sdk-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-x64-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-x64-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-ia32-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-win32-arm64-msvc')
         const bindingPackageVersion = require('@quicknode/sdk-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@quicknode/sdk-darwin-universal')
       const bindingPackageVersion = require('@quicknode/sdk-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-darwin-x64')
         const bindingPackageVersion = require('@quicknode/sdk-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-darwin-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-freebsd-x64')
         const bindingPackageVersion = require('@quicknode/sdk-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-freebsd-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-x64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-x64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm-musleabihf')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@quicknode/sdk-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-loong64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-loong64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-riscv64-musl')
           const bindingPackageVersion = require('@quicknode/sdk-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@quicknode/sdk-linux-riscv64-gnu')
           const bindingPackageVersion = require('@quicknode/sdk-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-linux-ppc64-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-linux-s390x-gnu')
         const bindingPackageVersion = require('@quicknode/sdk-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-arm64')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-x64')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@quicknode/sdk-openharmony-arm')
         const bindingPackageVersion = require('@quicknode/sdk-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '3.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -588,6 +588,7 @@ module.exports.WebhookTemplateId = nativeBinding.WebhookTemplateId
 module.exports.AdminApiClient = nativeBinding.AdminApiClient
 module.exports.KvStoreApiClient = nativeBinding.KvStoreApiClient
 module.exports.QuicknodeSdk = nativeBinding.QuicknodeSdk
+module.exports.RpcApiClient = nativeBinding.RpcApiClient
 module.exports.SqlApiClient = nativeBinding.SqlApiClient
 module.exports.StreamsApiClient = nativeBinding.StreamsApiClient
 module.exports.WebhooksApiClient = nativeBinding.WebhooksApiClient

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicknode/sdk",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Quicknode SDK",
   "repository": {
     "type": "git",
@@ -54,10 +54,10 @@
   },
   "license": "MIT",
   "optionalDependencies": {
-    "@quicknode/sdk-linux-x64-gnu": "3.6.0",
-    "@quicknode/sdk-linux-arm64-gnu": "3.6.0",
-    "@quicknode/sdk-linux-x64-musl": "3.6.0",
-    "@quicknode/sdk-linux-arm64-musl": "3.6.0",
-    "@quicknode/sdk-darwin-arm64": "3.6.0"
+    "@quicknode/sdk-linux-x64-gnu": "3.7.0",
+    "@quicknode/sdk-linux-arm64-gnu": "3.7.0",
+    "@quicknode/sdk-linux-x64-musl": "3.7.0",
+    "@quicknode/sdk-linux-arm64-musl": "3.7.0",
+    "@quicknode/sdk-darwin-arm64": "3.7.0"
   }
 }

package/sdk.d.ts

@@ -326,6 +326,11 @@ export type {
   ChainSchemaNode,
   TableSchemaNode,
   ColumnSchemaNode,
+  // rpc / tooling access
+  RpcConfig,
+  CachedToken,
+  ToolingAccessStatus,
+  RpcApiClient,
 } from "./index";
 
 // const enums must use `export` (not `export type`) so they are usable as values
@@ -400,6 +405,7 @@ export class QuicknodeSdk {
   webhooks: WebhooksApiClientTyped;
   kvstore: _QuicknodeSdk["kvstore"];
   sql: SqlApiClientTyped;
+  rpc: _QuicknodeSdk["rpc"];
 }
 
 // Typed static factory methods producing each discriminated variant of
@@ -450,3 +456,6 @@ export class ApiError extends QuicknodeError {
 export class DecodeError extends QuicknodeError {
   body: string;
 }
+export class RpcError extends QuicknodeError {
+  code: number;
+}

package/sdk.js

@@ -16,6 +16,7 @@ class QuicknodeSdk {
     this.webhooks = errors.wrapClient(this._inner.webhooks);
     this.kvstore = errors.wrapClient(this._inner.kvstore);
     this.sql = errors.wrapClient(this._inner.sql);
+    this.rpc = errors.wrapClient(this._inner.rpc);
   }
 
   static fromEnv() {
@@ -30,6 +31,7 @@ class QuicknodeSdk {
     instance.webhooks = errors.wrapClient(instance._inner.webhooks);
     instance.kvstore = errors.wrapClient(instance._inner.kvstore);
     instance.sql = errors.wrapClient(instance._inner.sql);
+    instance.rpc = errors.wrapClient(instance._inner.rpc);
     return instance;
   }
 }
@@ -87,4 +89,5 @@ module.exports = {
   ConnectionError: errors.ConnectionError,
   ApiError: errors.ApiError,
   DecodeError: errors.DecodeError,
+  RpcError: errors.RpcError,
 };

package/sdk.mjs

@@ -25,6 +25,7 @@ export const {
   WebhooksApiClient,
   KvStoreApiClient,
   SqlApiClient,
+  RpcApiClient,
   QuicknodeError,
   ConfigError,
   HttpError,
@@ -32,4 +33,5 @@ export const {
   ConnectionError,
   ApiError,
   DecodeError,
+  RpcError,
 } = cjs;