quicknode_sdk 0.4.0-aarch64-linux → 0.6.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0eb703c4c80633444bc8f7059c4134d8ab8861adce2d5ef2abe8ebb4ad67fa1
-  data.tar.gz: 24ede2fcdefcd8557253763c86e973722399e5d1b14f23e8e4ae62aaa3eb66db
+  metadata.gz: a2616f4fa4188dd16880a9320b248220ad593cc20ec969fee94c597d6419d808
+  data.tar.gz: fdd2ecf9b82a870515feab735c2ad27e242c2adc42800ad9d584151efae02b8a
 SHA512:
-  metadata.gz: de6efa9a3d6e1166c1cf394333e216597a3376c13db6ac936dcee4dc934d52569ba4543957c0d4a04ea134ec69aa83aa75795bb84032a63e6b895996d4330141
-  data.tar.gz: 8cb96092600ba89552841b03d7a183d26ea25bbaf12ab4ec245c5e1bef7d24d2d39434fc02757cf9531c156e9074f245869c7f558f1f1a8db2d88bf977c931f7
+  metadata.gz: db149fe5acb0957676f301abf8beef8d5f78f3f01c0a2bd321621710783fa96c8ff8b374b5894f95bc9aa13dd1b3a8e9e0258130682bfdddb2a68f23574c6541
+  data.tar.gz: 64d34507518bb16dfc21930036080ae63afaf6d8bdcdfcd6b183a9f8a3bcfa3efe05262549a47530de41bc6d0ea7a3af41c470ce937c57e54517d501db0fd76d

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: aarch64-linux
 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