solana-ruby-kit 0.1.8 → 7.0.0

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

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+# Helpers for inspecting confirmed Solana transactions and walking their
+# outer and inner instructions.
+# Mirrors @solana/transaction-introspection.
+require_relative 'transaction_introspection/loaded_addresses'
+require_relative 'transaction_introspection/compiled_transaction_message'
+require_relative 'transaction_introspection/types'
+require_relative 'transaction_introspection/get_instructions'
+require_relative 'transaction_introspection/get_inner_instructions'
+require_relative 'transaction_introspection/walk_instructions'
+require_relative 'transaction_introspection/decode_rpc_transaction'

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

@@ -0,0 +1,145 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative '../addresses/address'
+require_relative '../instructions/instruction'
+require_relative 'transaction_message'
+
+module Solana::Ruby::Kit
+  module TransactionMessages
+    # Address of the Compute Budget program.
+    COMPUTE_BUDGET_PROGRAM_ADDRESS = T.let(
+      Addresses::Address.new('ComputeBudget111111111111111111111111111111'),
+      Addresses::Address
+    )
+
+    # Maximum compute unit limit per transaction (from Agave execution_budget.rs).
+    MAX_COMPUTE_UNIT_LIMIT = T.let(1_400_000, Integer)
+
+    # Maximum loaded accounts data size limit per transaction (64 MiB, from Agave).
+    MAX_LOADED_ACCOUNTS_DATA_SIZE_LIMIT = T.let(64 * 1024 * 1024, Integer)
+
+    SET_COMPUTE_UNIT_LIMIT_DISCRIMINATOR             = T.let(2, Integer)
+    SET_LOADED_ACCOUNTS_DATA_SIZE_LIMIT_DISCRIMINATOR = T.let(4, Integer)
+
+    module_function
+
+    # ---------------------------------------------------------------------------
+    # SetComputeUnitLimit instruction helpers
+    # ---------------------------------------------------------------------------
+
+    sig { params(units: Integer).returns(Instructions::Instruction) }
+    def get_set_compute_unit_limit_instruction(units)
+      data = ([SET_COMPUTE_UNIT_LIMIT_DISCRIMINATOR].pack('C') + [units].pack('V')).b
+      Instructions::Instruction.new(
+        program_address: COMPUTE_BUDGET_PROGRAM_ADDRESS,
+        accounts:        nil,
+        data:            data
+      )
+    end
+
+    sig { params(instruction: Instructions::Instruction).returns(T::Boolean) }
+    def set_compute_unit_limit_instruction?(instruction)
+      instruction.program_address == COMPUTE_BUDGET_PROGRAM_ADDRESS &&
+        !instruction.data.nil? &&
+        T.must(instruction.data).bytesize == 5 &&
+        T.must(instruction.data).getbyte(0) == SET_COMPUTE_UNIT_LIMIT_DISCRIMINATOR
+    end
+
+    sig { params(data: String).returns(Integer) }
+    def compute_unit_limit_from_instruction_data(data)
+      T.must(data[1, 4]).unpack1('V')
+    end
+
+    # Returns the compute unit limit set on a transaction message, or nil if none is set.
+    # Mirrors `getTransactionMessageComputeUnitLimit` from @solana/transaction-messages.
+    sig { params(message: TransactionMessage).returns(T.nilable(Integer)) }
+    def get_transaction_message_compute_unit_limit(message)
+      ix = message.instructions.find { |i| set_compute_unit_limit_instruction?(i) }
+      ix ? compute_unit_limit_from_instruction_data(T.must(ix.data)) : nil
+    end
+
+    # Sets the compute unit limit on a transaction message, appending or replacing the
+    # SetComputeUnitLimit instruction. Mirrors `setTransactionMessageComputeUnitLimit`.
+    sig { params(limit: Integer, message: TransactionMessage).returns(TransactionMessage) }
+    def set_transaction_message_compute_unit_limit(limit, message)
+      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
+        message
+      else
+        new_instructions = message.instructions.dup
+        new_instructions[T.must(existing_idx)] = new_ix
+        TransactionMessage.new(
+          version:               message.version,
+          instructions:          new_instructions,
+          fee_payer:             message.fee_payer,
+          lifetime_constraint:   message.lifetime_constraint,
+          address_table_lookups: message.address_table_lookups
+        )
+      end
+    end
+
+    # ---------------------------------------------------------------------------
+    # SetLoadedAccountsDataSizeLimit instruction helpers
+    # ---------------------------------------------------------------------------
+
+    sig { params(limit: Integer).returns(Instructions::Instruction) }
+    def get_set_loaded_accounts_data_size_limit_instruction(limit)
+      data = ([SET_LOADED_ACCOUNTS_DATA_SIZE_LIMIT_DISCRIMINATOR].pack('C') + [limit].pack('V')).b
+      Instructions::Instruction.new(
+        program_address: COMPUTE_BUDGET_PROGRAM_ADDRESS,
+        accounts:        nil,
+        data:            data
+      )
+    end
+
+    sig { params(instruction: Instructions::Instruction).returns(T::Boolean) }
+    def set_loaded_accounts_data_size_limit_instruction?(instruction)
+      instruction.program_address == COMPUTE_BUDGET_PROGRAM_ADDRESS &&
+        !instruction.data.nil? &&
+        T.must(instruction.data).bytesize == 5 &&
+        T.must(instruction.data).getbyte(0) == SET_LOADED_ACCOUNTS_DATA_SIZE_LIMIT_DISCRIMINATOR
+    end
+
+    sig { params(data: String).returns(Integer) }
+    def loaded_accounts_data_size_limit_from_instruction_data(data)
+      T.must(data[1, 4]).unpack1('V')
+    end
+
+    # Returns the loaded accounts data size limit set on a transaction message, or nil.
+    # Mirrors `getTransactionMessageLoadedAccountsDataSizeLimit`.
+    sig { params(message: TransactionMessage).returns(T.nilable(Integer)) }
+    def get_transaction_message_loaded_accounts_data_size_limit(message)
+      ix = message.instructions.find { |i| set_loaded_accounts_data_size_limit_instruction?(i) }
+      ix ? loaded_accounts_data_size_limit_from_instruction_data(T.must(ix.data)) : nil
+    end
+
+    # Sets the loaded accounts data size limit on a transaction message.
+    # Mirrors `setTransactionMessageLoadedAccountsDataSizeLimit`.
+    sig { params(limit: Integer, message: TransactionMessage).returns(TransactionMessage) }
+    def set_transaction_message_loaded_accounts_data_size_limit(limit, message)
+      existing_idx = message.instructions.index { |i| set_loaded_accounts_data_size_limit_instruction?(i) }
+      new_ix = get_set_loaded_accounts_data_size_limit_instruction(limit)
+
+      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
+        message
+      else
+        new_instructions = message.instructions.dup
+        new_instructions[T.must(existing_idx)] = new_ix
+        TransactionMessage.new(
+          version:               message.version,
+          instructions:          new_instructions,
+          fee_payer:             message.fee_payer,
+          lifetime_constraint:   message.lifetime_constraint,
+          address_table_lookups: message.address_table_lookups
+        )
+      end
+    end
+  end
+end

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

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

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

@@ -4,7 +4,7 @@
 module Solana
   module Ruby
     module Kit
-      VERSION = '0.1.8'
+      VERSION = '7.0.0'
     end
   end
 end

data/lib/solana/ruby/kit.rb

@@ -50,6 +50,8 @@ require_relative 'kit/programs'
 require_relative 'kit/sysvars'
 require_relative 'kit/transaction_confirmation'
 require_relative 'kit/instruction_plans'
+require_relative 'kit/resource_limit_estimation'
+require_relative 'kit/transaction_introspection'
 
 # Solana::Ruby::Kit is a Ruby translation of @anza-xyz/kit — the JavaScript SDK for
 # building Solana apps — into idiomatic Ruby with Sorbet static types.
@@ -79,6 +81,7 @@ require_relative 'kit/instruction_plans'
 #   Solana::Ruby::Kit::TransactionConfirmation — confirmation polling   (@solana/transaction-confirmation)
 #   Solana::Ruby::Kit::InstructionPlans      — multi-tx planning        (@solana/instruction-plans)
 #   Solana::Ruby::Kit::WalletStandard        — server-side sig verify   (@solana/wallet-standard)
+#   Solana::Ruby::Kit::TransactionIntrospection — decode/walk instructions (@solana/transaction-introspection)
 
 module Solana::Ruby::Kit
   extend T::Sig

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby-kit
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 7.0.0
 platform: ruby
 authors:
 - Paul Zupan, Idhra Inc.
@@ -209,6 +209,7 @@ files:
 - lib/solana/ruby/kit/functional.rb
 - lib/solana/ruby/kit/instruction_plans.rb
 - lib/solana/ruby/kit/instruction_plans/instruction_plan.rb
+- lib/solana/ruby/kit/instruction_plans/max_instructions.rb
 - lib/solana/ruby/kit/instruction_plans/plans.rb
 - lib/solana/ruby/kit/instruction_plans/transaction_plan.rb
 - lib/solana/ruby/kit/instruction_plans/transaction_plan_executor.rb
@@ -235,6 +236,7 @@ files:
 - lib/solana/ruby/kit/programs/system_program.rb
 - lib/solana/ruby/kit/promises.rb
 - lib/solana/ruby/kit/railtie.rb
+- 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_balance.rb
@@ -248,6 +250,7 @@ files:
 - lib/solana/ruby/kit/rpc/api/get_multiple_accounts.rb
 - lib/solana/ruby/kit/rpc/api/get_program_accounts.rb
 - lib/solana/ruby/kit/rpc/api/get_signature_statuses.rb
+- lib/solana/ruby/kit/rpc/api/get_signatures_for_address.rb
 - 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
@@ -296,7 +299,16 @@ files:
 - lib/solana/ruby/kit/sysvars/last_restart_slot.rb
 - lib/solana/ruby/kit/sysvars/rent.rb
 - lib/solana/ruby/kit/transaction_confirmation.rb
+- lib/solana/ruby/kit/transaction_introspection.rb
+- lib/solana/ruby/kit/transaction_introspection/compiled_transaction_message.rb
+- lib/solana/ruby/kit/transaction_introspection/decode_rpc_transaction.rb
+- lib/solana/ruby/kit/transaction_introspection/get_inner_instructions.rb
+- lib/solana/ruby/kit/transaction_introspection/get_instructions.rb
+- lib/solana/ruby/kit/transaction_introspection/loaded_addresses.rb
+- lib/solana/ruby/kit/transaction_introspection/types.rb
+- 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/transaction_message.rb
 - lib/solana/ruby/kit/transactions.rb
 - lib/solana/ruby/kit/transactions/compiler.rb