quicknode_sdk 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b85847f1d533f89fbc37e749f0830aad04ac633f1a80aad5d9cd488e452f67aa
-  data.tar.gz: 7adc3bba6eec5e903e35f772d26cf8810e6cf2b0bb88b0921d8fdca9f67f4070
+  metadata.gz: 6854af9a50a833f341a2f5c5a4e57f5bdbf586414de74b1107e89bba71a8b3ff
+  data.tar.gz: 62b51fca74bcb9f937cc63faf7bc823b2d4028571ef7d1368739d34b005b32ba
 SHA512:
-  metadata.gz: 756f968b07df41efe62122822895063111299766f6500ee61a25a55df6bd34a4b8a86c171b67bb550fce4fc2fe478e37a890e1dccd181ee7995cc56c5a4b8b95
-  data.tar.gz: 15db415f082c81a1a677916981596d9659f77b2ab80962efb05f85d47cfd7d4fd0fc2fc3e53d80c31ee4dc2c701a9952d770596af8c2db83dd69fabf61c7210c
+  metadata.gz: 162e7b181523fc76b03609dc1e57e8fd49162d623367118f1a2119ddf173b304d2c257477ba0bf21c66a630c680d2a66c2e12aa7161140019a702c28bb762420
+  data.tar.gz: bbaafd016f844ef53e6f82901af7d32022a4946091b5189b7ded26b8a11d1f63c0e1fe1e857a9f1fc8a3fc98660d66934d55951eeba1bce7affc77efa992916a

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)
@@ -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.
 
 ```ruby
 # Ruby
@@ -94,6 +96,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`
@@ -926,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`
@@ -1613,6 +1644,44 @@ Deletes a list and all of its items.
 qn.kvstore.delete_list(key: "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** (Hash): `query:` (String, required), `cluster_id:` (String, required).
+
+**Returns** a Hash with `meta` (column metadata, each with `name` and `type`), `data` (rows as Hashes keyed by column name), `rows`, `rows_before_limit_at_least`, `statistics` (`elapsed`, `rows_read`, `bytes_read`), and `credits`. Access with `[]` or `dig`.
+
+```ruby
+# Ruby
+resp = qn.sql.query(
+  query: "SELECT action_type, user FROM hyperliquid_system_actions ORDER BY block_time DESC LIMIT 100",
+  cluster_id: "hyperliquid-core-mainnet"
+)
+puts resp[:rows]
+puts resp[:data].first
+```
+
+##### `get_schema`
+
+Fetches the database schema for a cluster: table names, columns, types, sort keys, and partition strategies.
+
+**Parameters** (Hash): `cluster_id:` (String, required).
+
+**Returns** a Hash with `chain`, `cluster_id`, and `tables` (each with `name`, `engine`, `total_rows`, `partition_key`, `sorting_key`, and `columns` of `{ name, type }`).
+
+```ruby
+# Ruby
+schema = qn.sql.get_schema(cluster_id: "hyperliquid-core-mainnet")
+puts schema[:tables].length
+```
+
 ## Error Handling
 
 Every binding exposes a typed exception hierarchy derived from the core `SdkError`

data/lib/quicknode_sdk/clients/sql.rb

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

data/lib/quicknode_sdk/sdk.rb

@@ -34,5 +34,9 @@ module QuicknodeSdk
     def kvstore
       KvStore.new(@native.kvstore)
     end
+
+    def sql
+      Sql.new(@native.sql)
+    end
   end
 end

data/lib/quicknode_sdk.rb

@@ -13,4 +13,5 @@ require_relative "quicknode_sdk/clients/admin"
 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/sdk"

data/sig/quicknode_sdk.rbs

@@ -33,6 +33,7 @@ module QuicknodeSdk
     def streams: () -> Streams
     def webhooks: () -> Webhooks
     def kvstore: () -> KvStore
+    def sql: () -> Sql
   end
 
   class DestinationAttributes
@@ -90,6 +91,8 @@ 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 list_invoices: () -> untyped
     def list_payments: () -> untyped
     def list_teams: () -> untyped
@@ -158,4 +161,11 @@ module QuicknodeSdk
     def delete_list_item: (key: String, item: String) -> void
     def delete_list: (key: String) -> void
   end
+
+  class Sql
+    def initialize: (untyped native) -> void
+
+    def query: (query: String, cluster_id: String) -> untyped
+    def get_schema: (cluster_id: String) -> untyped
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quicknode_sdk
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Quicknode
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-07-07 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/sql.rb
 - lib/quicknode_sdk/clients/streams.rb
 - lib/quicknode_sdk/clients/webhooks.rb
 - lib/quicknode_sdk/native_delegator.rb