solana-ruby-kit 7.1.1 → 7.1.1.2

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,6 +2,7 @@
 # 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'
@@ -17,6 +18,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,6 +45,8 @@ module Solana::Ruby::Kit
     class Client
       extend T::Sig
 
+      include Api::HasTransport
+
       include Api::GetSlot
       include Api::GetBalance
       include Api::GetLatestBlockhash
@@ -58,6 +62,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 +72,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(

data/lib/solana/ruby/kit/rpc_types/sol.rb

@@ -40,7 +40,9 @@ module Solana::Ruby::Kit
 
       sig { params(other: T.untyped).returns(T::Boolean) }
       def ==(other)
-        other.is_a?(Sol) && @raw == other.raw
+        return false unless other.is_a?(Sol)
+
+        @raw == other.raw
       end
 
       sig { returns(Integer) }
@@ -50,8 +52,8 @@ module Solana::Ruby::Kit
     end
 
     SOL_DECIMALS    = T.let(9,         Integer)
-    SOL_SCALE       = T.let(10**9,     Integer)
-    SOL_RAW_MAX     = T.let(2**64 - 1, Integer)
+    SOL_SCALE       = T.let(1_000_000_000, Integer)
+    SOL_RAW_MAX     = T.let(Kernel.Integer(2**64 - 1), Integer)
 
     module_function
 
@@ -66,17 +68,17 @@ module Solana::Ruby::Kit
     # Mirrors TypeScript's sol(value, rounding?).
     sig { params(value: String).returns(Sol) }
     def sol(value)
-      bd = BigDecimal(value)
+      bd = Kernel.BigDecimal(value)
       Kernel.raise SolanaError.new(SolanaError::FIXED_POINTS__STRICT_MODE_PRECISION_LOSS) if bd < 0
 
       scaled = bd * SOL_SCALE
       raw    = scaled.to_i
 
-      unless scaled == BigDecimal(raw.to_s)
+      unless scaled == Kernel.BigDecimal(raw.to_s)
         Kernel.raise SolanaError.new(SolanaError::FIXED_POINTS__STRICT_MODE_PRECISION_LOSS)
       end
 
-      Kernel.raise SolanaError.new(SolanaError::SOLANA_ERROR__LAMPORTS_OUT_OF_RANGE) if raw > SOL_RAW_MAX
+      Kernel.raise SolanaError.new(SolanaError::LAMPORTS_OUT_OF_RANGE) if raw > SOL_RAW_MAX
 
       Sol.new(raw)
     end

data/lib/solana/ruby/kit/subscribable/reactive_action_store.rb

@@ -82,8 +82,8 @@ module Solana::Ruby::Kit
       # most recent call's result updates state; superseded threads are ignored.
       sig { params(args: T.untyped).void }
       def dispatch(*args)
-        gen        = nil
-        prev_data  = nil
+        gen        = T.let(nil, T.nilable(Integer))
+        prev_data  = T.let(nil, T.untyped)
         @mutex.synchronize do
           @current_gen += 1
           gen       = @current_gen
@@ -94,7 +94,7 @@ module Solana::Ruby::Kit
 
         Thread.new do
           begin
-            result  = @fn.call(*args)
+            result  = @fn.call(*T.unsafe(args))
             active  = @mutex.synchronize do
               if @current_gen == gen
                 @state = ReactiveActionState.new(status: 'success', data: result)
@@ -125,8 +125,8 @@ module Solana::Ruby::Kit
       # by a concurrent dispatch or reset().
       sig { params(args: T.untyped).returns(T.untyped) }
       def dispatch_async(*args)
-        gen        = nil
-        prev_data  = nil
+        gen        = T.let(nil, T.nilable(Integer))
+        prev_data  = T.let(nil, T.untyped)
         @mutex.synchronize do
           @current_gen += 1
           gen       = @current_gen
@@ -135,7 +135,7 @@ module Solana::Ruby::Kit
         end
         _notify
 
-        result = @fn.call(*args)
+        result = @fn.call(*T.unsafe(args))
 
         active = @mutex.synchronize do
           if @current_gen == gen

data/lib/solana/ruby/kit/subscribable/reactive_stream_store.rb

@@ -108,7 +108,7 @@ module Solana::Ruby::Kit
       # Internal: transition state and notify all subscribers.
       sig { params(new_state: ReactiveState).void }
       def _set_state(new_state)
-        subs = nil
+        subs = T.let(nil, T.nilable(T::Array[T.proc.void]))
         @mutex.synchronize do
           return if @state.equal?(new_state)
           @state = new_state
@@ -167,7 +167,7 @@ module Solana::Ruby::Kit
         return if @mutex.synchronize { @stopped }
 
         # Fresh active flag for this connection window
-        active = [true]
+        active = T.let([true], T::Array[T::Boolean])
         @mutex.synchronize { @conn_active = active }
 
         # inner_signal fires (raises) once this connection is superseded or errors out,
@@ -193,8 +193,8 @@ module Solana::Ruby::Kit
         publisher.on(@error_channel, signal: inner_signal) do |err|
           next unless active[0] && get_unified_state.status != 'error'
           active[0] = false
-          stale_data = get_unified_state.data
-          _set_state(ReactiveState.new(status: 'error', data: stale_data, error: err))
+          last_data = get_unified_state.data
+          _set_state(ReactiveState.new(status: 'error', data: last_data, error: err))
         end
       end
     end

data/lib/solana/ruby/kit/transaction_messages/compute_budget.rb

@@ -68,11 +68,11 @@ module Solana::Ruby::Kit
 
       if existing_idx.nil?
         append_instructions(message, [new_ix])
-      elsif compute_unit_limit_from_instruction_data(T.must(message.instructions[existing_idx].data)) == limit
+      elsif compute_unit_limit_from_instruction_data(T.must(T.must(message.instructions[existing_idx]).data)) == limit
         message
       else
         new_instructions = message.instructions.dup
-        new_instructions[T.must(existing_idx)] = new_ix
+        new_instructions[existing_idx] = new_ix
         TransactionMessage.new(
           version:               message.version,
           instructions:          new_instructions,
@@ -127,11 +127,11 @@ module Solana::Ruby::Kit
 
       if existing_idx.nil?
         append_instructions(message, [new_ix])
-      elsif loaded_accounts_data_size_limit_from_instruction_data(T.must(message.instructions[existing_idx].data)) == limit
+      elsif loaded_accounts_data_size_limit_from_instruction_data(T.must(T.must(message.instructions[existing_idx]).data)) == limit
         message
       else
         new_instructions = message.instructions.dup
-        new_instructions[T.must(existing_idx)] = new_ix
+        new_instructions[existing_idx] = new_ix
         TransactionMessage.new(
           version:               message.version,
           instructions:          new_instructions,

data/lib/solana/ruby/kit/version.rb

@@ -4,7 +4,7 @@
 module Solana
   module Ruby
     module Kit
-      VERSION = '7.1.1'
+      VERSION = '7.1.1.2'
     end
   end
 end

data/lib/solana/ruby/kit/wallet_standard.rb

@@ -115,7 +115,7 @@ module Solana::Ruby::Kit
           reason: 'message section is missing'
         )
       end
-      message_bytes = T.must(msg_slice).b
+      message_bytes = msg_slice.b
 
       # 4. Determine version and locate the message header.
       #    Legacy transactions:   first byte = num_required_signatures (0..127)
@@ -139,14 +139,14 @@ module Solana::Ruby::Kit
 
       account_addrs = T.let([], T::Array[String])
       num_accounts.times do
-        account_addrs << Addresses.encode_address(message_bytes[msg_pos, 32].b)
+        account_addrs << Addresses.encode_address(T.must(message_bytes[msg_pos, 32]).b)
         msg_pos += 32
       end
 
       # 6. Build the signatures map.
       #    The first +num_required_sigs+ accounts in the account table are the
       #    signers; their raw_sigs slots are positionally aligned.
-      signer_addrs = account_addrs[0, num_required_sigs]
+      signer_addrs = T.must(account_addrs[0, num_required_sigs])
       signatures   = T.let({}, T::Hash[String, T.nilable(String)])
       signer_addrs.each_with_index { |addr, i| signatures[addr] = raw_sigs[i] }
 
@@ -234,7 +234,7 @@ module Solana::Ruby::Kit
     def decode_compact_u16(bytes, offset)
       value = 0
       shift = 0
-      loop do
+      Kernel.loop do
         byte = bytes.getbyte(offset)
         if byte.nil?
           Kernel.raise SolanaError.new(