quicknode_sdk 0.4.0-aarch64-linux → 0.5.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0eb703c4c80633444bc8f7059c4134d8ab8861adce2d5ef2abe8ebb4ad67fa1
-  data.tar.gz: 24ede2fcdefcd8557253763c86e973722399e5d1b14f23e8e4ae62aaa3eb66db
+  metadata.gz: 1799801200a8bd2398578efea491e9752a76b471e7b3a2b7c746f38c295074c2
+  data.tar.gz: 404c3c0cd3246bb57155c62f86e8703561b3d82d17e7d6e81af996dedca43b0c
 SHA512:
-  metadata.gz: de6efa9a3d6e1166c1cf394333e216597a3376c13db6ac936dcee4dc934d52569ba4543957c0d4a04ea134ec69aa83aa75795bb84032a63e6b895996d4330141
-  data.tar.gz: 8cb96092600ba89552841b03d7a183d26ea25bbaf12ab4ec245c5e1bef7d24d2d39434fc02757cf9531c156e9074f245869c7f558f1f1a8db2d88bf977c931f7
+  metadata.gz: e823f53aa2599d86115b6be9df96ab1a58fdd98d250d0c26ab0f13e81195a24490e3c9a20def590144ce32d8e1b1591bd7a14e7b06b0456215447f9105dcb83e
+  data.tar.gz: 85de7cc321550af364578240366188a5491e7ae8f990f707e0c21d46d771c61cce13ad176d1a62856519ccbc2a0ae0d64c3197aa88c2f7fcae6207e8c8e38cd6

data/README.md

@@ -46,6 +46,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 +56,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 +95,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`
@@ -1613,6 +1615,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
@@ -158,4 +159,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.5.0
 platform: aarch64-linux
 authors:
 - Quicknode
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-06-25 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