solace 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 378cd7a1cb5958d12bfbe371485f60c12c72e04141bb557a7ef61dde617b0dfe
-  data.tar.gz: e36f6aa0189ff832b3ca440a1a38690984d69081dcde8b9613d632320d481cf5
+  metadata.gz: ab3415933c7875971ad410ecc1d8d7487233a7eb58e9c3701f23babdaae9fbd5
+  data.tar.gz: a9ef2bbb03d7988487ae48bff51122dc45670e5ad6ef8c8d6154fa386d0a1281
 SHA512:
-  metadata.gz: 9c15791a7b1967d19f676e594556f19fb29ea1b431c97e9a5f6ddb0c8344b87b4301e402116bd8896da7c14ba50a5f5de1eb5a5791b41df7c4134ee89f397926
-  data.tar.gz: cb1add67763169e8bb498987f3f760def67a5c92e647852f8e5e4308a5a1a41cb046df0aa8a720202d32b7c82bbe6541e945815e6e45738fd63215b23080e2bc
+  metadata.gz: 869108bf70f8a9143e28dae425a5e843135aedfd78642c39683fd214ab4a3d1c847125e0e2f0fc60b1766ac45970dc8f14bfc512861db95b89cdaaedc593226d
+  data.tar.gz: 8ff9bcac1403007eb3dcc340587c76f4acb5dff266390621f16708589153644db16a16cdb0f08936f3d3a690c2943d78edd570735e9f0692eac6ffb62ee3c969

data/lib/solace/composers/compute_budget_program_set_compute_unit_limit_composer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composer for creating a compute budget set compute unit limit instruction.
+    #
+    # This composer resolves and orders the required accounts for a `SetComputeUnitLimit`
+    # instruction, sets up their access permissions, and delegates construction to the
+    # appropriate instruction builder (`Instructions::ComputeBudget::SetComputeUnitLimitInstruction`).
+    #
+    # It is used for capping the compute units a transaction may consume.
+    #
+    # Required accounts:
+    # - **Program**: Compute Budget program (readonly, non-signer)
+    #
+    # @example Compose and build a set compute unit limit instruction
+    #   composer = ComputeBudgetProgramSetComputeUnitLimitComposer.new(
+    #     units: 200_000
+    #   )
+    #
+    # @see Instructions::ComputeBudget::SetComputeUnitLimitInstruction
+    # @since 0.1.7
+    class ComputeBudgetProgramSetComputeUnitLimitComposer < Base
+      # Extracts the compute unit limit from the params
+      #
+      # @return [Integer] The compute unit limit
+      def units
+        params[:units]
+      end
+
+      # Returns the compute budget program id
+      #
+      # @return [String] The compute budget program id
+      def compute_budget_program
+        Constants::COMPUTE_BUDGET_PROGRAM_ID.to_s
+      end
+
+      # Setup accounts required for set compute unit limit instruction
+      # Called automatically during initialization
+      #
+      # @return [void]
+      def setup_accounts
+        account_context.add_readonly_nonsigner(compute_budget_program)
+      end
+
+      # Build instruction with resolved account indices
+      #
+      # @param account_context [Utils::AccountContext] The account context
+      # @return [Solace::Instruction]
+      def build_instruction(account_context)
+        Instructions::ComputeBudget::SetComputeUnitLimitInstruction.build(
+          units:         units,
+          program_index: account_context.index_of(compute_budget_program)
+        )
+      end
+    end
+  end
+end

data/lib/solace/composers/compute_budget_program_set_compute_unit_price_composer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composer for creating a compute budget set compute unit price instruction.
+    #
+    # This composer resolves and orders the required accounts for a `SetComputeUnitPrice`
+    # instruction, sets up their access permissions, and delegates construction to the
+    # appropriate instruction builder (`Instructions::ComputeBudget::SetComputeUnitPriceInstruction`).
+    #
+    # It is used for attaching a priority fee to a transaction.
+    #
+    # Required accounts:
+    # - **Program**: Compute Budget program (readonly, non-signer)
+    #
+    # @example Compose and build a set compute unit price instruction
+    #   composer = ComputeBudgetProgramSetComputeUnitPriceComposer.new(
+    #     micro_lamports: 50_000
+    #   )
+    #
+    # @see Instructions::ComputeBudget::SetComputeUnitPriceInstruction
+    # @since 0.1.7
+    class ComputeBudgetProgramSetComputeUnitPriceComposer < Base
+      # Extracts the price per compute unit from the params
+      #
+      # @return [Integer] The price per compute unit (in micro-lamports)
+      def micro_lamports
+        params[:micro_lamports]
+      end
+
+      # Returns the compute budget program id
+      #
+      # @return [String] The compute budget program id
+      def compute_budget_program
+        Constants::COMPUTE_BUDGET_PROGRAM_ID.to_s
+      end
+
+      # Setup accounts required for set compute unit price instruction
+      # Called automatically during initialization
+      #
+      # @return [void]
+      def setup_accounts
+        account_context.add_readonly_nonsigner(compute_budget_program)
+      end
+
+      # Build instruction with resolved account indices
+      #
+      # @param account_context [Utils::AccountContext] The account context
+      # @return [Solace::Instruction]
+      def build_instruction(account_context)
+        Instructions::ComputeBudget::SetComputeUnitPriceInstruction.build(
+          micro_lamports: micro_lamports,
+          program_index:  account_context.index_of(compute_budget_program)
+        )
+      end
+    end
+  end
+end

data/lib/solace/connection.rb

@@ -157,6 +157,17 @@ module Solace
       [@last_fetched_blockhash, @last_fetched_block_height]
     end
 
+    # Get the current block height from the Solana node
+    #
+    # Defaults to the connection's commitment so comparisons against the
+    # +lastValidBlockHeight+ from {#get_latest_blockhash} stay consistent.
+    #
+    # @param commitment [String] The commitment level for the request
+    # @return [Integer] The current block height
+    def get_block_height(commitment: default_options[:commitment])
+      @rpc_client.rpc_request('getBlockHeight', [{ commitment: commitment }])['result']
+    end
+
     # Get the minimum required lamports for rent exemption
     #
     # @param space [Integer] Number of bytes to allocate for the account

data/lib/solace/instructions/compute_budget/set_compute_unit_limit_instruction.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Solace
+  module Instructions
+    module ComputeBudget
+      # Instruction for setting the compute unit limit.
+      #
+      # This instruction is used to set the maximum number of compute units a
+      # transaction may consume. Together with the compute unit price, it
+      # determines the priority fee the transaction pays.
+      #
+      # @example Build a SetComputeUnitLimit instruction
+      #   instruction = Solace::Instructions::ComputeBudget::SetComputeUnitLimitInstruction.build(
+      #     units: 200_000,
+      #     program_index: 1
+      #   )
+      #
+      # @since 0.1.7
+      class SetComputeUnitLimitInstruction
+        # @!attribute [Array<Integer>] INSTRUCTION_INDEX
+        #   Instruction index for the Compute Budget Program's SetComputeUnitLimit instruction.
+        INSTRUCTION_INDEX = [2].freeze
+
+        # Builds a Solace::Instruction for setting the compute unit limit
+        #
+        # @param units [Integer] Maximum compute units the transaction may consume
+        # @param program_index [Integer] Index of the Compute Budget program in the transaction's accounts
+        # @return [Solace::Instruction]
+        def self.build(units:, program_index:)
+          Solace::Instruction.new.tap do |ix|
+            ix.program_index = program_index
+            ix.accounts      = []
+            ix.data          = data(units)
+          end
+        end
+
+        # Instruction data for a set compute unit limit instruction
+        #
+        # The BufferLayout is:
+        #   - [Instruction Index (1 byte)]
+        #   - [Compute unit limit (4 bytes little-endian u32)]
+        #
+        # @param units [Integer] Maximum compute units the transaction may consume
+        # @return [Array<Integer>] 1-byte instruction index + 4-byte limit
+        def self.data(units)
+          INSTRUCTION_INDEX + Solace::Utils::Codecs.encode_le_u32(units).bytes
+        end
+      end
+    end
+  end
+end

data/lib/solace/instructions/compute_budget/set_compute_unit_price_instruction.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Solace
+  module Instructions
+    # The ComputeBudget module contains instruction builders for the Compute Budget Program.
+    #
+    # The Compute Budget program prices and provisions a transaction's execution. Its
+    # instructions take no accounts; each encodes a directive the runtime reads when
+    # scheduling and executing the transaction, such as the priority fee attached to it.
+    #
+    # This module contains classes that build the low-level instruction data required
+    # to interact with the Compute Budget Program.
+    #
+    # @see https://docs.solana.com/developing/programming-model/runtime#compute-budget
+    # @since 0.1.7
+    module ComputeBudget
+      # Instruction for setting the compute unit price.
+      #
+      # This instruction is used to set the price (in micro-lamports per compute unit)
+      # a transaction pays as a priority fee, which validators use to order it during
+      # congestion.
+      #
+      # @example Build a SetComputeUnitPrice instruction
+      #   instruction = Solace::Instructions::ComputeBudget::SetComputeUnitPriceInstruction.build(
+      #     micro_lamports: 50_000,
+      #     program_index: 1
+      #   )
+      #
+      # @since 0.1.7
+      class SetComputeUnitPriceInstruction
+        # @!attribute [Array<Integer>] INSTRUCTION_INDEX
+        #   Instruction index for the Compute Budget Program's SetComputeUnitPrice instruction.
+        INSTRUCTION_INDEX = [3].freeze
+
+        # Builds a Solace::Instruction for setting the compute unit price
+        #
+        # @param micro_lamports [Integer] Price per compute unit (in micro-lamports)
+        # @param program_index [Integer] Index of the Compute Budget program in the transaction's accounts
+        # @return [Solace::Instruction]
+        def self.build(micro_lamports:, program_index:)
+          Solace::Instruction.new.tap do |ix|
+            ix.program_index = program_index
+            ix.accounts      = []
+            ix.data          = data(micro_lamports)
+          end
+        end
+
+        # Instruction data for a set compute unit price instruction
+        #
+        # The BufferLayout is:
+        #   - [Instruction Index (1 byte)]
+        #   - [Price (8 bytes little-endian u64)]
+        #
+        # @param micro_lamports [Integer] Price per compute unit (in micro-lamports)
+        # @return [Array<Integer>] 1-byte instruction index + 8-byte price
+        def self.data(micro_lamports)
+          INSTRUCTION_INDEX + Solace::Utils::Codecs.encode_le_u64(micro_lamports).bytes
+        end
+      end
+    end
+  end
+end

data/lib/solace/version.rb

@@ -2,5 +2,5 @@
 
 module Solace
   # Latest version of the Solace gem.
-  VERSION = '0.1.6'
+  VERSION = '0.1.7'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solace
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Sebastian Scholl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-22 00:00:00.000000000 Z
+date: 2026-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base58
@@ -206,6 +206,8 @@ files:
 - lib/solace/composers/associated_token_account_program_create_account_composer.rb
 - lib/solace/composers/associated_token_account_program_create_idempotent_account_composer.rb
 - lib/solace/composers/base.rb
+- lib/solace/composers/compute_budget_program_set_compute_unit_limit_composer.rb
+- lib/solace/composers/compute_budget_program_set_compute_unit_price_composer.rb
 - lib/solace/composers/spl_token_program_close_account_composer.rb
 - lib/solace/composers/spl_token_program_initialize_mint_composer.rb
 - lib/solace/composers/spl_token_program_mint_to_composer.rb
@@ -231,6 +233,8 @@ files:
 - lib/solace/instruction.rb
 - lib/solace/instructions/associated_token_account/create_account_instruction.rb
 - lib/solace/instructions/associated_token_account/create_idempotent_account_instruction.rb
+- lib/solace/instructions/compute_budget/set_compute_unit_limit_instruction.rb
+- lib/solace/instructions/compute_budget/set_compute_unit_price_instruction.rb
 - lib/solace/instructions/spl_token/close_account_instruction.rb
 - lib/solace/instructions/spl_token/initialize_account_instruction.rb
 - lib/solace/instructions/spl_token/initialize_mint_instruction.rb