quicknode_sdk 0.1.0.pre.alpha.14

data/lib/quicknode_sdk/clients/admin.rb

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

data/lib/quicknode_sdk/clients/kvstore.rb

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

data/lib/quicknode_sdk/clients/streams.rb

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

data/lib/quicknode_sdk/clients/webhooks.rb

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

data/lib/quicknode_sdk/native_delegator.rb

@@ -0,0 +1,43 @@
+module QuicknodeSdk
+  # Shared base class for the user-facing client wrappers (Admin, Streams,
+  # Webhooks, KvStore). Each Magnus-bound native client is held in @native and
+  # all method calls are forwarded through method_missing.
+  #
+  # The native side exposes two kinds of methods: arity-0 (e.g. list_chains)
+  # and arity-1 taking a single positional Hash of options (e.g.
+  # get_endpoints). To support all three Ruby call styles documented in the
+  # README and examples — bare (qn.admin.get_endpoints), kwargs
+  # (qn.admin.get_endpoints(limit: 5)), and positional hash
+  # (qn.streams.list_streams({})) — we coerce whatever the caller passed into
+  # a single options hash, then dispatch on the native arity. Arity-0 methods
+  # reject any argument (Magnus enforces this), so we must call them with no
+  # args; arity-1 methods always need a Hash passed POSITIONALLY (Magnus's
+  # RHash is a positional arg, and Ruby 3 treats `**{}` as zero arguments —
+  # so we must not splat the options).
+  class NativeDelegator
+    def initialize(native)
+      @native = native
+    end
+
+    def method_missing(name, *args, **kwargs)
+      return super unless @native.respond_to?(name)
+      opts = if !kwargs.empty?
+               kwargs
+             elsif args.length == 1 && args[0].is_a?(Hash)
+               args[0]
+             else
+               {}
+             end
+      result = if @native.method(name).arity == 0
+                 @native.public_send(name)
+               else
+                 @native.public_send(name, opts)
+               end
+      QuicknodeSdk.wrap(result)
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      @native.respond_to?(name, include_private) || super
+    end
+  end
+end

data/lib/quicknode_sdk/sdk.rb

@@ -0,0 +1,27 @@
+module QuicknodeSdk
+  class SDK
+    def self.from_env
+      new(Native::SDK.from_env)
+    end
+
+    def initialize(native)
+      @native = native
+    end
+
+    def admin
+      Admin.new(@native.admin)
+    end
+
+    def streams
+      Streams.new(@native.streams)
+    end
+
+    def webhooks
+      Webhooks.new(@native.webhooks)
+    end
+
+    def kvstore
+      KvStore.new(@native.kvstore)
+    end
+  end
+end

data/lib/quicknode_sdk/wrap.rb

@@ -0,0 +1,16 @@
+require "hashie"
+
+module QuicknodeSdk
+  class IndifferentHash < Hash
+    include Hashie::Extensions::MergeInitializer
+    include Hashie::Extensions::IndifferentAccess
+  end
+
+  def self.wrap(v)
+    case v
+    when Hash  then IndifferentHash.new(v).tap { |h| h.each { |k, val| h[k] = wrap(val) } }
+    when Array then v.map { |x| wrap(x) }
+    else v
+    end
+  end
+end

data/lib/quicknode_sdk.rb

@@ -0,0 +1,16 @@
+begin
+  require_relative "quicknode_sdk/quicknode_sdk"
+rescue LoadError => e
+  raise LoadError, <<~MSG
+    Could not load the quicknode_sdk native extension for this platform (#{RUBY_PLATFORM}).
+    Precompiled binaries are published for: x86_64-linux, aarch64-linux, arm64-darwin.
+    Original error: #{e.message}
+  MSG
+end
+require_relative "quicknode_sdk/wrap"
+require_relative "quicknode_sdk/native_delegator"
+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/sdk"

data/sig/quicknode_sdk.rbs

@@ -0,0 +1,162 @@
+module QuicknodeSdk
+  def self.wrap: (untyped v) -> untyped
+
+  class Error < StandardError
+  end
+
+  class ConfigError < Error
+  end
+
+  class HttpError < Error
+  end
+
+  class TimeoutError < HttpError
+  end
+
+  class ConnectionError < HttpError
+  end
+
+  class ApiError < Error
+    attr_reader status: Integer
+    attr_reader body: String
+  end
+
+  class DecodeError < Error
+    attr_reader body: String
+  end
+
+  class SDK
+    def self.from_env: () -> SDK
+    def initialize: (untyped native) -> void
+    def admin: () -> Admin
+    def streams: () -> Streams
+    def webhooks: () -> Webhooks
+    def kvstore: () -> KvStore
+  end
+
+  class DestinationAttributes
+    def self.webhook: (url: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?post_timeout_sec: Integer, ?security_token: String, compression: String) -> DestinationAttributes
+    def self.s3: (endpoint: String, access_key: String, secret_key: String, bucket: String, object_prefix: String, compression: String, file_type: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?use_ssl: bool) -> DestinationAttributes
+    def self.azure: (storage_account: String, sas_token: String, container: String, compression: String, file_type: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?blob_prefix: String) -> DestinationAttributes
+    def self.postgres: (host: String, ?port: Integer, database: String, username: String, password: String, table_name: String, sslmode: String, ?max_retry: Integer, ?retry_interval_sec: Integer) -> DestinationAttributes
+    def self.mysql: (host: String, ?port: Integer, database: String, username: String, password: String, table_name: String, ?max_retry: Integer, ?retry_interval_sec: Integer) -> DestinationAttributes
+    def self.mongo: (host: String, database: String, username: String, password: String, collection_name: String, ?max_retry: Integer, ?retry_interval_sec: Integer) -> DestinationAttributes
+    def self.clickhouse: (hosts: String, database: String, username: String, password: String, table_name: String, default_table_engine_opts: String, ?default_granularity: Integer, default_compression: String, default_index_type: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?disable_datetime_precision: bool, ?dont_support_rename_column: bool, ?dont_support_empty_default_value: bool, ?skip_initialize_with_version: bool) -> DestinationAttributes
+    def self.snowflake: (account: String, host: String, ?port: Integer, protocol: String, database: String, schema: String, warehouse: String, username: String, password: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?table_name: String) -> DestinationAttributes
+    def self.kafka: (bootstrap_servers: String, topic_name: String, compression_type: String, ?batch_size: Integer, ?linger_ms: Integer, ?max_request_size: Integer, ?timeout_sec: Integer, ?max_retry: Integer, ?retry_interval_sec: Integer, ?username: String, ?password: String, ?protocol: String, ?mechanisms: String) -> DestinationAttributes
+    def self.redis: (host: String, ?port: Integer, ?database: Integer, username: String, password: String, key_name: String, ?max_retry: Integer, ?retry_interval_sec: Integer, ?tls: bool) -> DestinationAttributes
+  end
+
+  class Admin
+    def initialize: (untyped native) -> void
+
+    def get_endpoints: (?limit: Integer, ?offset: Integer, ?search: String, ?sort_by: String, ?sort_direction: String, ?networks: Array[String], ?statuses: Array[String], ?labels: Array[String], ?dedicated: bool, ?is_flat_rate: bool, ?tag_ids: Array[Integer], ?tag_labels: Array[String]) -> untyped
+    def create_endpoint: (?chain: String, ?network: String) -> untyped
+    def show_endpoint: (id: String) -> untyped
+    def update_endpoint: (id: String, ?label: String) -> void
+    def archive_endpoint: (id: String) -> void
+    def update_endpoint_status: (id: String, status: String) -> untyped
+    def create_tag: (id: String, ?label: String) -> void
+    def delete_tag: (id: String, tag_id: String) -> void
+    def get_usage: (?start_time: Integer, ?end_time: Integer) -> untyped
+    def get_usage_by_endpoint: (?start_time: Integer, ?end_time: Integer) -> untyped
+    def get_usage_by_method: (?start_time: Integer, ?end_time: Integer) -> untyped
+    def get_usage_by_chain: (?start_time: Integer, ?end_time: Integer) -> untyped
+    def get_endpoint_logs: (id: String, from_time: String, to_time: String, ?include_details: bool, ?limit: Integer, ?next_at: String) -> untyped
+    def get_log_details: (id: String, request_id: String) -> untyped
+    def get_security_options: (id: String) -> untyped
+    def update_security_options: (id: String, ?tokens: String, ?referrers: String, ?jwts: String, ?ips: String, ?domain_masks: String, ?hsts: String, ?cors: String, ?request_filters: String, ?ip_custom_header: String) -> untyped
+    def create_token: (id: String) -> void
+    def delete_token: (id: String, token_id: String) -> untyped
+    def create_referrer: (id: String, ?referrer: String) -> void
+    def delete_referrer: (id: String, referrer_id: String) -> untyped
+    def create_ip: (id: String, ?ip: String) -> void
+    def delete_ip: (id: String, ip_id: String) -> untyped
+    def create_domain_mask: (id: String, ?domain_mask: String) -> void
+    def delete_domain_mask: (id: String, domain_mask_id: String) -> untyped
+    def create_jwt: (id: String, ?public_key: String, ?kid: String, ?name: String) -> void
+    def delete_jwt: (id: String, jwt_id: String) -> void
+    def create_request_filter: (id: String, ?methods: Array[String]) -> untyped
+    def update_request_filter: (id: String, request_filter_id: String, ?methods: Array[String]) -> void
+    def delete_request_filter: (id: String, request_filter_id: String) -> void
+    def enable_multichain: (id: String) -> void
+    def disable_multichain: (id: String) -> void
+    def create_or_update_ip_custom_header: (id: String, header_name: String) -> untyped
+    def delete_ip_custom_header: (id: String) -> untyped
+    def get_method_rate_limits: (id: String) -> untyped
+    def create_method_rate_limit: (id: String, interval: String, methods: Array[String], rate: Integer) -> untyped
+    def update_method_rate_limit: (id: String, method_rate_limit_id: String, ?methods: Array[String], ?status: String, ?rate: Integer) -> untyped
+    def delete_method_rate_limit: (id: String, method_rate_limit_id: String) -> void
+    def update_rate_limits: (id: String, ?rps: Integer, ?rpm: Integer, ?rpd: Integer) -> void
+    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 list_invoices: () -> untyped
+    def list_payments: () -> untyped
+    def list_teams: () -> untyped
+    def create_team: (name: String) -> untyped
+    def get_team: (id: Integer) -> untyped
+    def delete_team: (id: Integer) -> untyped
+    def list_team_endpoints: (id: Integer) -> untyped
+    def update_team_endpoints: (id: Integer, endpoint_ids: Array[String]) -> untyped
+    def invite_team_member: (id: Integer, email: String, ?full_name: String, ?role: String) -> untyped
+    def remove_team_member: (id: Integer, user_id: Integer, ?destroy_user: bool) -> untyped
+    def resend_team_invite: (id: Integer, user_id: Integer) -> untyped
+    def bulk_update_endpoint_status: (ids: Array[String], status: String) -> untyped
+    def bulk_add_tag: (ids: Array[String], label: String) -> untyped
+    def bulk_remove_tag: (ids: Array[String], tag_id: Integer) -> untyped
+    def list_tags: () -> untyped
+    def rename_tag: (id: Integer, label: String) -> untyped
+    def delete_account_tag: (id: Integer) -> untyped
+    def get_usage_by_tag: (?start_time: Integer, ?end_time: Integer) -> untyped
+    def get_endpoint_security: (id: String) -> untyped
+  end
+
+  class Streams
+    def initialize: (untyped native) -> void
+
+    def create_stream: (name: String, network: String, dataset: String, region: String, start_range: Integer, end_range: Integer, destination_attributes: DestinationAttributes, plan: String, threshold_fetch_buffer: Integer, ?dataset_batch_size: Integer, ?max_batch_size: Integer, ?max_buffer_range_size: Integer, ?max_buffer_processing_workers: Integer, ?keep_distance_from_tip: Integer, ?filter_function: String, ?filter_language: String, ?include_stream_metadata: String, ?product_type: String, ?status: String, ?notification_email: String, ?charge_min_cap: Integer, ?fix_block_reorgs: Integer, ?elastic_batch_enabled: bool, ?extra_destinations: Array[DestinationAttributes]) -> untyped
+    def list_streams: (?stream_type: String, ?offset: Integer, ?limit: Integer, ?order_by: String, ?order_direction: String) -> untyped
+    def delete_all_streams: () -> void
+    def get_stream: (id: String) -> untyped
+    def update_stream: (id: String, ?name: String, ?network: String, ?dataset: String, ?region: String, ?start_range: Integer, ?end_range: Integer, ?destination_attributes: DestinationAttributes, ?plan: String, ?threshold_fetch_buffer: Integer, ?dataset_batch_size: Integer, ?max_batch_size: Integer, ?max_buffer_range_size: Integer, ?max_buffer_processing_workers: Integer, ?keep_distance_from_tip: Integer, ?filter_function: String, ?filter_language: String, ?include_stream_metadata: String, ?notification_email: String, ?charge_min_cap: Integer, ?fix_block_reorgs: Integer, ?elastic_batch_enabled: bool, ?status: String, ?memo: String, ?extra_destinations: Array[DestinationAttributes]) -> untyped
+    def delete_stream: (id: String) -> void
+    def activate_stream: (id: String) -> void
+    def pause_stream: (id: String) -> void
+    def test_filter: (network: String, dataset: String, block: String, ?filter_function: String, ?filter_language: String) -> untyped
+    def get_enabled_count: (?stream_type: String) -> untyped
+  end
+
+  class Webhooks
+    def initialize: (untyped native) -> void
+
+    def list_webhooks: (?limit: Integer, ?offset: Integer) -> untyped
+    def delete_all_webhooks: () -> void
+    def get_webhook: (id: String) -> untyped
+    def update_webhook: (id: String, ?name: String, ?notification_email: String, ?destination_attributes_json: String) -> untyped
+    def delete_webhook: (id: String) -> void
+    def pause_webhook: (id: String) -> void
+    def activate_webhook: (id: String, start_from: String) -> void
+    def get_enabled_count: () -> untyped
+    def create_webhook_from_template: (name: String, network: String, destination_attributes_json: String, template_args_json: String, ?notification_email: String) -> untyped
+    def update_webhook_template: (webhook_id: String, template_args_json: String, ?name: String, ?notification_email: String) -> untyped
+  end
+
+  class KvStore
+    def initialize: (untyped native) -> void
+
+    def create_set: (key: String, value: String) -> void
+    def get_sets: (?limit: Integer, ?cursor: String) -> untyped
+    def get_set: (key: String) -> untyped
+    def bulk_sets: (?add_sets: Hash[String, String], ?delete_sets: Array[String]) -> void
+    def delete_set: (key: String) -> void
+    def create_list: (key: String, items: Array[String]) -> void
+    def get_lists: (?limit: Integer, ?cursor: String) -> untyped
+    def get_list: (key: String, ?limit: Integer, ?cursor: String) -> untyped
+    def update_list: (key: String, ?add_items: Array[String], ?remove_items: Array[String]) -> void
+    def add_list_item: (key: String, item: String) -> void
+    def list_contains_item: (key: String, item: String) -> untyped
+    def delete_list_item: (key: String, item: String) -> void
+    def delete_list: (key: String) -> void
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: quicknode_sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.alpha.14
+platform: ruby
+authors:
+- Quicknode
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/quicknode_sdk.rb
+- lib/quicknode_sdk/clients/admin.rb
+- lib/quicknode_sdk/clients/kvstore.rb
+- lib/quicknode_sdk/clients/streams.rb
+- lib/quicknode_sdk/clients/webhooks.rb
+- lib/quicknode_sdk/native_delegator.rb
+- lib/quicknode_sdk/sdk.rb
+- lib/quicknode_sdk/wrap.rb
+- sig/quicknode_sdk.rbs
+homepage:
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Quicknode SDK for Ruby
+test_files: []