solana-ruby-kit 7.1.1.1 → 8.2.0

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

@@ -4,6 +4,7 @@
 require_relative '../addresses/address'
 require_relative '../instructions/instruction'
 require_relative 'transaction_message'
+require_relative 'resource_limit_validation'
 
 module Solana::Ruby::Kit
   module TransactionMessages
@@ -63,16 +64,17 @@ module Solana::Ruby::Kit
     # SetComputeUnitLimit instruction. Mirrors `setTransactionMessageComputeUnitLimit`.
     sig { params(limit: Integer, message: TransactionMessage).returns(TransactionMessage) }
     def set_transaction_message_compute_unit_limit(limit, message)
+      assert_is_valid_compute_unit_limit(limit)
       existing_idx = message.instructions.index { |i| set_compute_unit_limit_instruction?(i) }
       new_ix = get_set_compute_unit_limit_instruction(limit)
 
       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 +129,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/transaction_messages/resource_limit_validation.rb

@@ -0,0 +1,70 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative '../errors'
+
+module Solana::Ruby::Kit
+  # NOTE: `MAX_COMPUTE_UNIT_LIMIT` lives in `compute_budget.rb`, which requires this file, so it
+  # is referenced from a method body rather than at load time to keep the two files acyclic.
+  module TransactionMessages
+    # The smallest heap frame size that a transaction may request (32 KiB).
+    MIN_HEAP_SIZE = T.let(32 * 1024, Integer)
+
+    # The largest heap frame size that a transaction may request (256 KiB).
+    MAX_HEAP_SIZE = T.let(256 * 1024, Integer)
+
+    # A requested heap frame size must be a whole number of KiB.
+    HEAP_SIZE_MULTIPLE_OF = T.let(1024, Integer)
+
+    module_function
+
+    # Raises if the given compute unit limit is one the runtime will not honor as written.
+    #
+    # A transaction may request at most MAX_COMPUTE_UNIT_LIMIT compute units. Requesting more
+    # does not fail the transaction; the runtime clamps the request down to that maximum, so
+    # the budget the transaction runs with is silently not the one that was asked for. Values
+    # that are not integers are a separate hazard, since they cannot be encoded as a `u32` and
+    # are not clamped. Failing here surfaces both at the point the value is set.
+    #
+    # Mirrors `assertIsValidComputeUnitLimit` from @solana/transaction-messages.
+    sig { params(compute_unit_limit: T.untyped).void }
+    def assert_is_valid_compute_unit_limit(compute_unit_limit)
+      return if compute_unit_limit.is_a?(Integer) &&
+                compute_unit_limit >= 0 &&
+                compute_unit_limit <= MAX_COMPUTE_UNIT_LIMIT
+
+      Kernel.raise SolanaError.new(
+        SolanaError::TRANSACTION__COMPUTE_UNIT_LIMIT_OUT_OF_RANGE,
+        { compute_unit_limit: compute_unit_limit, max_compute_unit_limit: MAX_COMPUTE_UNIT_LIMIT }
+      )
+    end
+
+    # Raises if the given heap frame size is one the runtime will not accept.
+    #
+    # The requested heap size must be a multiple of HEAP_SIZE_MULTIPLE_OF bytes and lie between
+    # MIN_HEAP_SIZE and MAX_HEAP_SIZE inclusive. This mirrors the transaction sanitization check
+    # performed by the runtime.
+    #
+    # Mirrors `assertIsValidHeapSize` from @solana/transaction-messages. Ruby has no heap-size
+    # setter of its own — the `RequestHeapFrame` instruction and the version 1 transaction config
+    # are both untranslated — so this is offered as a standalone check for callers building that
+    # instruction themselves.
+    sig { params(heap_size: T.untyped).void }
+    def assert_is_valid_heap_size(heap_size)
+      return if heap_size.is_a?(Integer) &&
+                heap_size >= MIN_HEAP_SIZE &&
+                heap_size <= MAX_HEAP_SIZE &&
+                (heap_size % HEAP_SIZE_MULTIPLE_OF).zero?
+
+      Kernel.raise SolanaError.new(
+        SolanaError::TRANSACTION__INVALID_HEAP_SIZE,
+        {
+          heap_size:     heap_size,
+          max_heap_size: MAX_HEAP_SIZE,
+          min_heap_size: MIN_HEAP_SIZE,
+          multiple_of:   HEAP_SIZE_MULTIPLE_OF
+        }
+      )
+    end
+  end
+end

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

@@ -3,4 +3,5 @@
 
 # Transaction message construction utilities — mirrors @solana/transaction-messages.
 require_relative 'transaction_messages/transaction_message'
+require_relative 'transaction_messages/resource_limit_validation'
 require_relative 'transaction_messages/compute_budget'

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

@@ -4,7 +4,7 @@
 module Solana
   module Ruby
     module Kit
-      VERSION = '7.1.1.1'
+      VERSION = '8.2.0'
     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(

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby-kit
 version: !ruby/object:Gem::Version
-  version: 7.1.1.1
+  version: 8.2.0
 platform: ruby
 authors:
 - Paul Zupan, Idhra Inc.
@@ -205,8 +205,6 @@ extra_rdoc_files:
 files:
 - LICENSE
 - README.md
-- lib/core_extensions/tapioca/name_patch.rb
-- lib/core_extensions/tapioca/required_ancestors.rb
 - lib/generators/solana/ruby/kit/install/install_generator.rb
 - lib/generators/solana/ruby/kit/install/templates/solana_ruby_kit.rb.tt
 - lib/solana/ruby/kit.rb
@@ -264,6 +262,7 @@ files:
 - lib/solana/ruby/kit/resource_limit_estimation.rb
 - lib/solana/ruby/kit/rpc.rb
 - lib/solana/ruby/kit/rpc/api/get_account_info.rb
+- lib/solana/ruby/kit/rpc/api/get_ag_genesis_cert.rb
 - lib/solana/ruby/kit/rpc/api/get_balance.rb
 - lib/solana/ruby/kit/rpc/api/get_block_height.rb
 - lib/solana/ruby/kit/rpc/api/get_block_time.rb
@@ -279,9 +278,11 @@ files:
 - lib/solana/ruby/kit/rpc/api/get_slot.rb
 - lib/solana/ruby/kit/rpc/api/get_token_account_balance.rb
 - lib/solana/ruby/kit/rpc/api/get_token_accounts_by_owner.rb
+- lib/solana/ruby/kit/rpc/api/get_token_supply.rb
 - lib/solana/ruby/kit/rpc/api/get_transaction.rb
 - lib/solana/ruby/kit/rpc/api/get_transactions_for_address.rb
 - lib/solana/ruby/kit/rpc/api/get_vote_accounts.rb
+- lib/solana/ruby/kit/rpc/api/has_transport.rb
 - lib/solana/ruby/kit/rpc/api/is_blockhash_valid.rb
 - lib/solana/ruby/kit/rpc/api/request_airdrop.rb
 - lib/solana/ruby/kit/rpc/api/send_transaction.rb
@@ -296,6 +297,7 @@ files:
 - lib/solana/ruby/kit/rpc_parsed_types/vote_account.rb
 - lib/solana/ruby/kit/rpc_subscriptions.rb
 - lib/solana/ruby/kit/rpc_subscriptions/api/account_notifications.rb
+- lib/solana/ruby/kit/rpc_subscriptions/api/has_transport.rb
 - lib/solana/ruby/kit/rpc_subscriptions/api/logs_notifications.rb
 - lib/solana/ruby/kit/rpc_subscriptions/api/program_notifications.rb
 - lib/solana/ruby/kit/rpc_subscriptions/api/root_notifications.rb
@@ -336,6 +338,7 @@ files:
 - lib/solana/ruby/kit/transaction_introspection/walk_instructions.rb
 - lib/solana/ruby/kit/transaction_messages.rb
 - lib/solana/ruby/kit/transaction_messages/compute_budget.rb
+- lib/solana/ruby/kit/transaction_messages/resource_limit_validation.rb
 - lib/solana/ruby/kit/transaction_messages/transaction_message.rb
 - lib/solana/ruby/kit/transactions.rb
 - lib/solana/ruby/kit/transactions/compiler.rb

data/lib/core_extensions/tapioca/name_patch.rb

@@ -1,32 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module T
-  module Types
-    class Simple
-      module NamePatch
-        NAME_METHOD = T.let(::Module.instance_method(:name), UnboundMethod)
-
-        def name
-          # Sorbet memoizes this method into the `@name` instance variable but
-          # doing so means that types get memoized before this patch is applied
-          qualified_name_of(@raw_type)
-        end
-
-        def qualified_name_of(constant)
-          name = NAME_METHOD.bind_call(constant)
-          name = nil if name&.start_with?("#<")
-          return if name.nil?
-
-          if name.start_with?("::")
-            name
-          else
-            "::#{name}"
-          end
-        end
-      end
-
-      prepend NamePatch
-    end
-  end
-end

data/lib/core_extensions/tapioca/required_ancestors.rb

@@ -1,13 +0,0 @@
-module T
-  module Helpers
-    prepend(::Module.new do
-      def requires_ancestor(&block)
-        # We can't directly call the block since the ancestor might not be loaded yet.
-        # We save the block in the map and will resolve it later.
-        Tapioca::Runtime::Trackers::RequiredAncestor.register(self, block)
-
-        super
-      end
-    end)
-  end
-end