solana-ruby-kit 7.1.1.1 → 8.2.0

data/lib/solana/ruby/kit/rpc/api/get_epoch_info.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -22,6 +24,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's GetEpochInfoApi.getEpochInfo.
       module GetEpochInfo
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(commitment: T.nilable(Symbol)).returns(T.untyped)

data/lib/solana/ruby/kit/rpc/api/get_epoch_schedule.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -21,6 +23,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's GetEpochScheduleApi.getEpochSchedule.
       module GetEpochSchedule
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig { returns(T.untyped) }
         def get_epoch_schedule

data/lib/solana/ruby/kit/rpc/api/get_inflation_reward.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -24,6 +26,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's GetInflationRewardApi.getInflationReward.
       module GetInflationReward
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(
@@ -31,7 +36,7 @@ module Solana::Ruby::Kit
             commitment:       T.nilable(Symbol),
             epoch:            T.nilable(Integer),
             min_context_slot: T.nilable(Integer)
-          ).returns(T::Array[T.nilable(T.untyped)])
+          ).returns(T::Array[T.untyped])
         end
         def get_inflation_reward(addresses, commitment: nil, epoch: nil, min_context_slot: nil)
           addr_strings = addresses.map { |a| a.respond_to?(:value) ? a.value : a.to_s }

data/lib/solana/ruby/kit/rpc/api/get_latest_blockhash.rb

@@ -1,6 +1,7 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
 require_relative '../../rpc_types/account_info'
 
 module Solana::Ruby::Kit
@@ -21,6 +22,9 @@ module Solana::Ruby::Kit
       #   .value — LatestBlockhash
       module GetLatestBlockhash
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_minimum_balance_for_rent_exemption.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -9,6 +11,9 @@ module Solana::Ruby::Kit
       # Mirrors `GetMinimumBalanceForRentExemptionApi.getMinimumBalanceForRentExemption()`.
       module GetMinimumBalanceForRentExemption
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_multiple_accounts.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 require 'base64'
 
 module Solana::Ruby::Kit
@@ -10,6 +12,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's GetMultipleAccountsApi.getMultipleAccounts.
       module GetMultipleAccounts
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_program_accounts.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -10,6 +12,9 @@ module Solana::Ruby::Kit
       # Returns an Array of { pubkey:, account: AccountInfoWithBase64Data }.
       module GetProgramAccounts
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_signature_statuses.rb

@@ -1,6 +1,7 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
 require_relative '../../rpc_types/account_info'
 
 module Solana::Ruby::Kit
@@ -23,6 +24,9 @@ module Solana::Ruby::Kit
       #   .value — Array of SignatureStatus | nil (nil for unknown signatures)
       module GetSignatureStatuses
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_signatures_for_address.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -25,6 +27,9 @@ module Solana::Ruby::Kit
       # See https://solana.com/docs/rpc/http/getsignaturesforaddress
       module GetSignaturesForAddress
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_slot.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -8,6 +10,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's `GetSlotApi.getSlot()`.
       module GetSlot
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_token_account_balance.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -8,6 +10,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's GetTokenAccountBalanceApi.getTokenAccountBalance.
       module GetTokenAccountBalance
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_token_accounts_by_owner.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -10,6 +12,9 @@ module Solana::Ruby::Kit
       #   { 'programId' => program_id }
       module GetTokenAccountsByOwner
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_token_supply.rb

@@ -0,0 +1,43 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative 'has_transport'
+
+module Solana::Ruby::Kit
+  module Rpc
+    module Api
+      # Fetch the total supply of an SPL Token mint.
+      # Mirrors TypeScript's GetTokenSupplyApi.getTokenSupply.
+      module GetTokenSupply
+        extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
+
+        sig do
+          params(
+            token_mint: String,
+            commitment: T.nilable(Symbol)
+          ).returns(RpcTypes::RpcContextualValue)
+        end
+        def get_token_supply(token_mint, commitment: nil)
+          config = {}
+          config['commitment'] = commitment.to_s if commitment
+
+          result = transport.request('getTokenSupply', [token_mint, config].tap { |a| a.pop if a.last.empty? })
+          slot   = Kernel.Integer(result['context']['slot'])
+          raw    = result['value']
+
+          value = {
+            amount:           raw['amount'],
+            decimals:         Kernel.Integer(raw['decimals']),
+            ui_amount:        raw['uiAmount'],
+            ui_amount_string: raw['uiAmountString']
+          }
+
+          RpcTypes::RpcContextualValue.new(slot: slot, value: value)
+        end
+      end
+    end
+  end
+end

data/lib/solana/ruby/kit/rpc/api/get_transaction.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -9,6 +11,9 @@ module Solana::Ruby::Kit
       # Returns the raw JSON hash (nil if not found / not yet confirmed).
       module GetTransaction
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/get_transactions_for_address.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -54,6 +56,9 @@ module Solana::Ruby::Kit
       # See https://solana.com/docs/rpc/http/gettransactionsforaddress
       module GetTransactionsForAddress
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         # Maps the snake_case keys of a Ruby +filters+ hash onto the wire names.
         # Comparison operators (:eq, :gt, :gte, :lt, :lte) pass through as-is.

data/lib/solana/ruby/kit/rpc/api/get_vote_accounts.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -25,6 +27,9 @@ module Solana::Ruby::Kit
       # Returns { current: [], delinquent: [] }.
       module GetVoteAccounts
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/has_transport.rb

@@ -0,0 +1,25 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Solana::Ruby::Kit
+  module Rpc
+    module Api
+      # Interface supplying the JSON-RPC connection that every API mixin uses.
+      #
+      # The mixins in this namespace are not usable on their own — each one
+      # issues its request through `transport`, which is provided by the object
+      # they are mixed into (`Rpc::Client`).  Declaring that requirement here,
+      # and having each mixin `requires_ancestor { HasTransport }`, lets Sorbet
+      # resolve `transport` inside the mixins instead of reporting it missing.
+      module HasTransport
+        extend T::Sig
+        extend T::Helpers
+        interface!
+
+        # The HTTP connection used to issue JSON-RPC requests.
+        sig { abstract.returns(Transport) }
+        def transport; end
+      end
+    end
+  end
+end

data/lib/solana/ruby/kit/rpc/api/is_blockhash_valid.rb

@@ -1,6 +1,7 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
 require_relative '../../rpc_types/account_info'
 
 module Solana::Ruby::Kit
@@ -14,6 +15,9 @@ module Solana::Ruby::Kit
       #   .value — Boolean
       module IsBlockhashValid
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/request_airdrop.rb

@@ -1,6 +1,7 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
 require_relative '../../keys/signatures'
 
 module Solana::Ruby::Kit
@@ -13,6 +14,9 @@ module Solana::Ruby::Kit
       # Returns the transaction `Signature` of the airdrop.
       module RequestAirdrop
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/send_transaction.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 require 'base64'
 require_relative '../../keys/signatures'
 require_relative '../../transactions/compiler'
@@ -21,6 +23,9 @@ module Solana::Ruby::Kit
       # NOT wait for confirmation.  Use `get_signature_statuses` to poll for commitment.
       module SendTransaction
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/api/simulate_transaction.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module Rpc
     module Api
@@ -9,6 +11,9 @@ module Solana::Ruby::Kit
       # Returns an RpcContextualValue whose value is the simulation result hash.
       module SimulateTransaction
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc/client.rb

@@ -2,10 +2,12 @@
 # frozen_string_literal: true
 
 require_relative 'transport'
+require_relative 'api/has_transport'
 require_relative 'api/get_slot'
 require_relative 'api/get_balance'
 require_relative 'api/get_latest_blockhash'
 require_relative 'api/get_account_info'
+require_relative 'api/get_ag_genesis_cert'
 require_relative 'api/get_block_height'
 require_relative 'api/get_signature_statuses'
 require_relative 'api/send_transaction'
@@ -17,6 +19,7 @@ require_relative 'api/get_program_accounts'
 require_relative 'api/get_transaction'
 require_relative 'api/get_token_account_balance'
 require_relative 'api/get_token_accounts_by_owner'
+require_relative 'api/get_token_supply'
 require_relative 'api/get_epoch_info'
 require_relative 'api/get_vote_accounts'
 require_relative 'api/simulate_transaction'
@@ -43,10 +46,13 @@ module Solana::Ruby::Kit
     class Client
       extend T::Sig
 
+      include Api::HasTransport
+
       include Api::GetSlot
       include Api::GetBalance
       include Api::GetLatestBlockhash
       include Api::GetAccountInfo
+      include Api::GetAgGenesisCert
       include Api::GetBlockHeight
       include Api::GetSignatureStatuses
       include Api::SendTransaction
@@ -58,6 +64,7 @@ module Solana::Ruby::Kit
       include Api::GetTransaction
       include Api::GetTokenAccountBalance
       include Api::GetTokenAccountsByOwner
+      include Api::GetTokenSupply
       include Api::GetEpochInfo
       include Api::GetVoteAccounts
       include Api::SimulateTransaction
@@ -67,7 +74,7 @@ module Solana::Ruby::Kit
       include Api::GetSignaturesForAddress
       include Api::GetTransactionsForAddress
 
-      sig { returns(Transport) }
+      sig { override.returns(Transport) }
       attr_reader :transport
 
       # @param cluster_url [RpcTypes::ClusterUrl, String]  endpoint to connect to.

data/lib/solana/ruby/kit/rpc_subscriptions/api/account_notifications.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
@@ -8,6 +10,9 @@ module Solana::Ruby::Kit
       # Mirrors TypeScript's AccountNotificationsApi.accountSubscribe.
       module AccountNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc_subscriptions/api/has_transport.rb

@@ -0,0 +1,35 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Solana::Ruby::Kit
+  module RpcSubscriptions
+    module Api
+      # Interface supplying the WebSocket connection and subscription plumbing
+      # that every notification mixin uses.
+      #
+      # The mixins in this namespace are not usable on their own — each one
+      # opens its subscription through `transport` and wraps it with
+      # `_build_subscription`, both provided by the object they are mixed into
+      # (`RpcSubscriptions::Client`).  Declaring that requirement here, and
+      # having each mixin `requires_ancestor { HasTransport }`, lets Sorbet
+      # resolve those calls inside the mixins instead of reporting them missing.
+      module HasTransport
+        extend T::Sig
+        extend T::Helpers
+        abstract!
+
+        # The WebSocket connection used to issue JSON-RPC subscription requests.
+        sig { abstract.returns(Transport) }
+        def transport; end
+
+        private
+
+        # Wrap a server-assigned subscription id in a `Subscription` that
+        # unsubscribes via `unsub_method` when closed.  Private, matching the
+        # visibility it has on `RpcSubscriptions::Client`.
+        sig { abstract.params(sub_id: T.untyped, unsub_method: String).returns(Subscription) }
+        def _build_subscription(sub_id, unsub_method); end
+      end
+    end
+  end
+end

data/lib/solana/ruby/kit/rpc_subscriptions/api/logs_notifications.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
@@ -8,6 +10,9 @@ module Solana::Ruby::Kit
       # +filter+ may be 'all', 'allWithVotes', or { 'mentions' => [pubkey] }.
       module LogsNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc_subscriptions/api/program_notifications.rb

@@ -1,12 +1,17 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
       # Subscribe to program account change notifications.
       module ProgramNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc_subscriptions/api/root_notifications.rb

@@ -1,12 +1,17 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
       # Subscribe to root change notifications.
       module RootNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig { returns(Subscription) }
         def root_subscribe

data/lib/solana/ruby/kit/rpc_subscriptions/api/signature_notifications.rb

@@ -1,6 +1,8 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
@@ -8,6 +10,9 @@ module Solana::Ruby::Kit
       # The subscription auto-unsubscribes once the signature is confirmed.
       module SignatureNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig do
           params(

data/lib/solana/ruby/kit/rpc_subscriptions/api/slot_notifications.rb

@@ -1,12 +1,17 @@
 # typed: strict
 # frozen_string_literal: true
 
+require_relative 'has_transport'
+
 module Solana::Ruby::Kit
   module RpcSubscriptions
     module Api
       # Subscribe to slot change notifications.
       module SlotNotifications
         extend T::Sig
+        extend T::Helpers
+
+        requires_ancestor { HasTransport }
 
         sig { returns(Subscription) }
         def slot_subscribe

data/lib/solana/ruby/kit/rpc_subscriptions/client.rb

@@ -3,6 +3,7 @@
 
 require_relative 'transport'
 require_relative 'subscription'
+require_relative 'api/has_transport'
 require_relative 'autopinger'
 require_relative 'api/account_notifications'
 require_relative 'api/logs_notifications'
@@ -23,6 +24,8 @@ module Solana::Ruby::Kit
     class Client
       extend T::Sig
 
+      include Api::HasTransport
+
       include Api::AccountNotifications
       include Api::LogsNotifications
       include Api::ProgramNotifications
@@ -30,7 +33,7 @@ module Solana::Ruby::Kit
       include Api::SignatureNotifications
       include Api::SlotNotifications
 
-      sig { returns(Transport) }
+      sig { override.returns(Transport) }
       attr_reader :transport
 
       sig do
@@ -56,7 +59,7 @@ module Solana::Ruby::Kit
 
       # Build a Subscription wrapping an AsyncIterable enumerator and
       # an auto-unsubscribe on close.
-      sig { params(sub_id: T.untyped, unsub_method: String).returns(Subscription) }
+      sig { override.params(sub_id: T.untyped, unsub_method: String).returns(Subscription) }
       def _build_subscription(sub_id, unsub_method)
         publisher  = @transport.publisher
         enumerator = Subscribable::AsyncIterable.from_publisher(