@quicknode/sdk 3.4.0 → 3.6.0

package/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)
@@ -46,6 +47,7 @@ This is one of four language bindings published from the same Rust core. See the
   - [KV Store Client](#kv-store-client)
     - [Sets](#sets)
     - [Lists](#lists)
+  - [SQL Client](#sql-client)
 - [Error Handling](#error-handling)
 - [License](#license)
 
@@ -55,7 +57,7 @@ This is one of four language bindings published from the same Rust core. See the
 
 ## Quick Start
 
-Construct the SDK once, then reach into the four sub-clients (`admin`, `streams`, `webhooks`, `kvstore`). Subsequent API Reference snippets assume you have a `qn` handle from one of these blocks.
+Construct the SDK once, then reach into the five sub-clients (`admin`, `streams`, `webhooks`, `kvstore`, `sql`). Subsequent API Reference snippets assume you have a `qn` handle from one of these blocks.
 
 ```typescript
 // Node.js
@@ -96,6 +98,7 @@ Environment variables (prefix `QN_SDK__`, separator `__`):
 | `QN_SDK__STREAMS__BASE_URL` | no | `https://api.quicknode.com/streams/rest/v1/` | Override streams base URL |
 | `QN_SDK__WEBHOOKS__BASE_URL` | no | `https://api.quicknode.com/webhooks/rest/v1/` | Override webhooks base URL |
 | `QN_SDK__KVSTORE__BASE_URL` | no | `https://api.quicknode.com/kv/rest/v1/` | Override KV store base URL |
+| `QN_SDK__SQL__BASE_URL` | no | `https://api.quicknode.com/sql/rest/v1/` | Override SQL Explorer base URL |
 | `QN_SDK__HTTP__HEADERS__<NAME>` | no | — | Custom HTTP header sent on every request. Overrides SDK-managed headers (see below). |
 
 ### Custom headers and `User-Agent`
@@ -930,6 +933,34 @@ Lists the blockchains supported by Quicknode along with their networks.
 const resp = await qn.admin.listChains();
 ```
 
+#### 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`).
+
+```typescript
+// Node.js
+const resp = await qn.admin.accountInfo();
+```
+
+##### `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 rejects with `ApiError` (status 404).
+
+**Parameters**: `chain` (string, required) — the chain slug.
+
+**Returns**: `GetApiCreditsResponse` with `data: ApiCredit[]`, where each `ApiCredit` has `method` and `credits`.
+
+```typescript
+// Node.js
+const resp = await qn.admin.getApiCredits("ethereum");
+```
+
 #### Billing
 
 ##### `list_invoices` / `listInvoices`
@@ -1606,6 +1637,43 @@ Deletes a list and all of its items.
 await qn.kvstore.deleteList("my-list");
 ```
 
+---
+
+### SQL Client
+
+Accessed as `qn.sql`. Runs SQL queries against indexed blockchain data and fetches the database schema. Backed by `https://api.quicknode.com/sql/rest/v1/`.
+
+##### `query`
+
+Executes a SQL query against a cluster and returns the result set. Paginate by writing `LIMIT`/`OFFSET` into the SQL.
+
+**Parameters**: `query` (string, required), `cluster_id` / `clusterId` (string, required).
+
+**Returns**: a query result — `meta` (column metadata, each with `name` and `type`), `data` (rows as objects keyed by column name), `rows`, `rows_before_limit_at_least` / `rowsBeforeLimitAtLeast`, `statistics` (`elapsed`, `rows_read`/`rowsRead`, `bytes_read`/`bytesRead`), and `credits`.
+
+```typescript
+// Node.js
+const resp = await qn.sql.query(
+  "SELECT action_type, user FROM hyperliquid_system_actions ORDER BY block_time DESC LIMIT 100",
+  "hyperliquid-core-mainnet",
+);
+console.log(resp.rows, resp.data[0]);
+```
+
+##### `get_schema` / `getSchema`
+
+Fetches the database schema for a cluster: table names, columns, types, sort keys, and partition strategies.
+
+**Parameters**: `cluster_id` / `clusterId` (string, required).
+
+**Returns**: a chain schema — `chain`, `cluster_id` / `clusterId`, and `tables` (each with `name`, `engine`, `total_rows` / `totalRows`, `partition_key` / `partitionKey`, `sorting_key` / `sortingKey`, and `columns` of `{ name, type }`).
+
+```typescript
+// Node.js
+const schema = await qn.sql.getSchema("hyperliquid-core-mainnet");
+console.log(schema.tables.length);
+```
+
 ## Error Handling
 
 Every binding exposes a typed exception hierarchy derived from the core `SdkError`

package/index.d.ts

@@ -1,5 +1,37 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/** Details about a Quicknode account. */
+export interface AccountInfo {
+  /** Numeric account id. */
+  id: number
+  /** Account name. */
+  name: string
+  /** ISO 8601 timestamp of when the account was created. */
+  createdAt: string
+  /** Billing version (e.g. `v6`). */
+  billingVersion?: string
+  /** The account's current subscription, when present. */
+  subscription?: AccountSubscription
+}
+
+/** Response from `account_info`. */
+export interface AccountInfoResponse {
+  /** Account details, when the request succeeded. */
+  data?: AccountInfo
+  /** Error message when the request did not succeed. */
+  error?: string
+}
+
+/** The account's current subscription. */
+export interface AccountSubscription {
+  /** Plan name (e.g. `Accelerate`). */
+  planName?: string
+  /** Subscription status (e.g. `active`). */
+  status?: string
+  /** Billing interval (e.g. `monthly`). */
+  interval?: string
+}
+
 /** An account-level tag, shared across endpoints. */
 export interface AccountTag {
   /** Tag identifier. */
@@ -39,6 +71,14 @@ export interface AdminConfig {
   baseUrl?: string
 }
 
+/** The API credit cost of a single RPC method on a chain. */
+export interface ApiCredit {
+  /** RPC method name (e.g. `eth_chainId`). */
+  method: string
+  /** Number of API credits the method costs. */
+  credits: number
+}
+
 /** Configuration for delivering stream batches to Azure Blob Storage. */
 export interface AzureAttributes {
   /** Azure storage account name. */
@@ -201,6 +241,16 @@ export interface ChainNetwork {
   chainId?: number
 }
 
+/** Response from `get_schema`: the schema for a single chain/cluster. */
+export interface ChainSchema {
+  /** Human-readable chain name (e.g. `"Hyperliquid (HyperCore)"`). */
+  chain: string
+  /** Cluster identifier the schema belongs to. */
+  clusterId: string
+  /** Tables available in this cluster. */
+  tables: Array<TableSchema>
+}
+
 /** Per-chain usage row. */
 export interface ChainUsage {
   /** Chain name or slug. */
@@ -209,6 +259,22 @@ export interface ChainUsage {
   creditsUsed: number
 }
 
+/** Metadata describing a single column in a query result set. */
+export interface ColumnMeta {
+  /** Column name as it appears in the result set. */
+  name: string
+  /** Column data type (e.g. `"DateTime('UTC')"`, `"LowCardinality(String)"`). */
+  columnType: string
+}
+
+/** A single column in a table schema. */
+export interface ColumnSchema {
+  /** Column name. */
+  name: string
+  /** Column data type (e.g. `"UInt64"`, `"FixedString(42)"`). */
+  columnType: string
+}
+
 /** Parameters for `create_domain_mask`. */
 export interface CreateDomainMaskRequest {
   /** Custom domain that will mask the endpoint's Quicknode URL. */
@@ -701,6 +767,17 @@ export interface GetAccountMetricsResponse {
   error?: string
 }
 
+/** Response from `get_api_credits`. */
+export interface GetApiCreditsResponse {
+  /**
+   * Per-method API credit costs for the chain, when the request succeeded.
+   * `None` for an unknown chain slug.
+   */
+  data?: Array<ApiCredit>
+  /** Error message when the request did not succeed. */
+  error?: string
+}
+
 /** Parameters for `get_endpoint_logs`. */
 export interface GetEndpointLogsRequest {
   /** Start of the query window (timestamp). */
@@ -1301,6 +1378,27 @@ export declare const enum ProductType {
   Webhook = 'Webhook'
 }
 
+/** Parameters for `query`. */
+export interface QueryParams {
+  /**
+   * The SQL query to execute. Pagination is expressed in the SQL itself via
+   * `LIMIT`/`OFFSET`; the API caps results at 1000 rows per request.
+   */
+  query: string
+  /** The blockchain network identifier (e.g. `"hyperliquid-core-mainnet"`). */
+  clusterId: string
+}
+
+/** Execution statistics returned alongside query results. */
+export interface QueryStatistics {
+  /** Total query execution time in seconds. */
+  elapsed: number
+  /** Total number of rows scanned during execution. */
+  rowsRead: number
+  /** Total data scanned in bytes. */
+  bytesRead: number
+}
+
 /**
  * A single rate-limit row returned by `get_rate_limits`, identifying the
  * bucket (`rps`/`rpm`/`rpd`), the value enforced, and whether the value comes
@@ -1398,6 +1496,7 @@ export interface SdkFullConfig {
   streams?: StreamsConfig
   webhooks?: WebhooksConfig
   kvstore?: KvStoreConfig
+  sql?: SqlConfig
 }
 
 /** A single security feature's name, status, and optional value. */
@@ -1484,6 +1583,10 @@ export interface SolanaWalletFilterTemplate {
   accounts: Array<string>
 }
 
+export interface SqlConfig {
+  baseUrl?: string
+}
+
 /** ByList form of `StellarWalletTransactionsFilterTemplate`. */
 export interface StellarWalletTransactionsFilterByListTemplate {
   /** Name of the pre-created wallets list. */
@@ -1557,6 +1660,22 @@ export declare const enum StreamStatus {
   Blocked = 'Blocked'
 }
 
+/** Schema for a single table. */
+export interface TableSchema {
+  /** Table name. */
+  name: string
+  /** Storage engine backing the table. */
+  engine: string
+  /** Approximate total number of rows in the table. */
+  totalRows: number
+  /** Partition key expression; empty string for views. */
+  partitionKey: string
+  /** Sorting key columns; empty for views. */
+  sortingKey: Array<string>
+  /** Columns in the table. */
+  columns: Array<ColumnSchema>
+}
+
 /** Per-tag usage row. */
 export interface TagUsage {
   /** Tag identifier. */
@@ -2134,6 +2253,18 @@ export declare class AdminApiClient {
    * Each entry includes the chain slug and its network slugs and names.
    */
   listChains(): Promise<ListChainsResponse>
+  /**
+   * Returns details about the account, including its id, name, creation
+   * timestamp, billing version, and current subscription.
+   */
+  accountInfo(): Promise<AccountInfoResponse>
+  /**
+   * Returns the per-method API credit costs for a chain, identified by its
+   * slug (the same slugs returned by `list_chains`, e.g. `ethereum`). Each
+   * item carries the RPC `method` name and its `credits` cost. An unknown
+   * chain slug rejects with `ApiError` (status 404).
+   */
+  getApiCredits(chain: string): Promise<GetApiCreditsResponse>
   /**
    * Returns the account's invoices, including id, status, billing reason,
    * amounts due and paid, line items with descriptions and billing periods,
@@ -2291,10 +2422,22 @@ export declare class QuicknodeSdk {
   get webhooks(): WebhooksApiClient
   /** Returns the kvstore sub-client. */
   get kvstore(): KvStoreApiClient
+  /** Returns the sql sub-client. */
+  get sql(): SqlApiClient
   /** Creates a new SDK instance using configuration from environment variables. */
   static fromEnv(): QuicknodeSdk
 }
 
+export declare class SqlApiClient {
+  /** Executes a SQL query against the given cluster and returns the result set. */
+  query(query: string, clusterId: string): Promise<QueryResponseNode>
+  /**
+   * Fetches the database schema for a cluster, including table names,
+   * columns, types, sort keys, and partition strategies.
+   */
+  getSchema(clusterId: string): Promise<ChainSchemaNode>
+}
+
 export declare class StreamsApiClient {
   /**
    * Creates a new Stream on a given blockchain network and dataset, delivering
@@ -2419,6 +2562,29 @@ export declare class WebhooksApiClient {
   updateWebhookTemplate(webhookId: string, params: UpdateWebhookTemplateParamsNode): Promise<Webhook>
 }
 
+export interface ChainSchemaNode {
+  /** Human-readable chain name. */
+  chain: string
+  /** Cluster identifier the schema belongs to. */
+  clusterId: string
+  /** Tables available in this cluster. */
+  tables: Array<TableSchemaNode>
+}
+
+export interface ColumnMetaNode {
+  /** Column name as it appears in the result set. */
+  name: string
+  /** Column data type (e.g. `"DateTime('UTC')"`). */
+  type: string
+}
+
+export interface ColumnSchemaNode {
+  /** Column name. */
+  name: string
+  /** Column data type (e.g. `"UInt64"`, `"FixedString(42)"`). */
+  type: string
+}
+
 export interface CreateStreamParamsNode {
   name: string
   region: StreamRegion
@@ -2460,6 +2626,33 @@ export interface ListStreamsResponseNode {
   pageInfo: PageInfo
 }
 
+export interface QueryResponseNode {
+  /** Column metadata for each column in the result set. */
+  meta: Array<ColumnMetaNode>
+  /**
+   * Result rows. Each row is an object keyed by the selected columns; shape
+   * varies per query.
+   */
+  data: Array<any>
+  /** Number of rows returned in this response. */
+  rows: number
+  /** Total rows that matched the query before applying `LIMIT`. */
+  rowsBeforeLimitAtLeast: number
+  /** Query execution statistics. */
+  statistics: QueryStatisticsNode
+  /** Credits consumed by the query. */
+  credits: number
+}
+
+export interface QueryStatisticsNode {
+  /** Total query execution time in seconds. */
+  elapsed: number
+  /** Total number of rows scanned during execution. */
+  rowsRead: number
+  /** Total data scanned in bytes. */
+  bytesRead: number
+}
+
 export interface StreamNode {
   id: string
   name: string
@@ -2495,6 +2688,21 @@ export interface StreamNode {
   extraDestinations?: Array<any>
 }
 
+export interface TableSchemaNode {
+  /** Table name. */
+  name: string
+  /** Storage engine backing the table. */
+  engine: string
+  /** Approximate total number of rows in the table. */
+  totalRows: number
+  /** Partition key expression; empty string for views. */
+  partitionKey: string
+  /** Sorting key columns; empty for views. */
+  sortingKey: Array<string>
+  /** Columns in the table. */
+  columns: Array<ColumnSchemaNode>
+}
+
 export interface UpdateStreamParamsNode {
   name?: string
   region?: StreamRegion

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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      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.`)
       }
       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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.4.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.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         return binding
       } catch (e) {
@@ -588,5 +588,6 @@ module.exports.WebhookTemplateId = nativeBinding.WebhookTemplateId
 module.exports.AdminApiClient = nativeBinding.AdminApiClient
 module.exports.KvStoreApiClient = nativeBinding.KvStoreApiClient
 module.exports.QuicknodeSdk = nativeBinding.QuicknodeSdk
+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.4.0",
+  "version": "3.6.0",
   "description": "Quicknode SDK",
   "repository": {
     "type": "git",
@@ -54,10 +54,10 @@
   },
   "license": "MIT",
   "optionalDependencies": {
-    "@quicknode/sdk-linux-x64-gnu": "3.4.0",
-    "@quicknode/sdk-linux-arm64-gnu": "3.4.0",
-    "@quicknode/sdk-linux-x64-musl": "3.4.0",
-    "@quicknode/sdk-linux-arm64-musl": "3.4.0",
-    "@quicknode/sdk-darwin-arm64": "3.4.0"
+    "@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"
   }
 }

package/sdk.d.ts

@@ -134,6 +134,13 @@ export type {
   ChainNetwork,
   Chain,
   ListChainsResponse,
+  // account
+  AccountSubscription,
+  AccountInfo,
+  AccountInfoResponse,
+  // api credits
+  ApiCredit,
+  GetApiCreditsResponse,
   // metrics
   GetEndpointMetricsRequest,
   GetAccountMetricsRequest,
@@ -310,6 +317,15 @@ export type {
   UpdateListParams,
   AddListItemParams,
   ListContainsItemResponse,
+  // sql
+  SqlConfig,
+  SqlApiClient,
+  QueryResponseNode,
+  ColumnMetaNode,
+  QueryStatisticsNode,
+  ChainSchemaNode,
+  TableSchemaNode,
+  ColumnSchemaNode,
 } from "./index";
 
 // const enums must use `export` (not `export type`) so they are usable as values
@@ -363,6 +379,19 @@ export interface WebhooksApiClientTyped {
   ): Promise<import("./index").Webhook>;
 }
 
+// Retypes the query response `data` rows from napi's `any[]` to
+// `Record<string, unknown>[]` (rows are objects keyed by the selected columns;
+// shape varies per query). Keep method signatures in sync with the
+// napi-generated SqlApiClient in ./index.d.ts.
+export interface QueryResult extends Omit<QueryResponseNode, "data"> {
+  data: Array<Record<string, unknown>>;
+}
+
+export interface SqlApiClientTyped {
+  query(query: string, clusterId: string): Promise<QueryResult>;
+  getSchema(clusterId: string): Promise<ChainSchemaNode>;
+}
+
 export class QuicknodeSdk {
   constructor(config: SdkFullConfig);
   static fromEnv(): QuicknodeSdk;
@@ -370,6 +399,7 @@ export class QuicknodeSdk {
   streams: StreamsApiClientTyped;
   webhooks: WebhooksApiClientTyped;
   kvstore: _QuicknodeSdk["kvstore"];
+  sql: SqlApiClientTyped;
 }
 
 // Typed static factory methods producing each discriminated variant of

package/sdk.js

@@ -15,6 +15,7 @@ class QuicknodeSdk {
     this.streams = errors.wrapClient(this._inner.streams);
     this.webhooks = errors.wrapClient(this._inner.webhooks);
     this.kvstore = errors.wrapClient(this._inner.kvstore);
+    this.sql = errors.wrapClient(this._inner.sql);
   }
 
   static fromEnv() {
@@ -28,6 +29,7 @@ class QuicknodeSdk {
     instance.streams = errors.wrapClient(instance._inner.streams);
     instance.webhooks = errors.wrapClient(instance._inner.webhooks);
     instance.kvstore = errors.wrapClient(instance._inner.kvstore);
+    instance.sql = errors.wrapClient(instance._inner.sql);
     return instance;
   }
 }

package/sdk.mjs

@@ -24,6 +24,7 @@ export const {
   StreamsApiClient,
   WebhooksApiClient,
   KvStoreApiClient,
+  SqlApiClient,
   QuicknodeError,
   ConfigError,
   HttpError,