solace 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9bca105aef6d20a1a5b6d5dc6b2fce8c7a8523c9a2a24afd3ad15bf36efbb55
-  data.tar.gz: e6a70370368a4822249bf7c912f70f54a02ce5389ef128e40acdc769b315ebae
+  metadata.gz: 21862a029b8b0922fa42fd3798e86d11c69900255bb92a035c806d83a8c985c1
+  data.tar.gz: 10eb8a0433c9907b7e75a7a3bb71637f1e41f0012e7cb695afcb91f2115d3f3f
 SHA512:
-  metadata.gz: 44fc38f19753ed736c05e1ba58bc7799fbe96d736553e3df220cfa38cae60a0dc2d2ecb3459990300efc108d56b9ec0ae8ce4fc552c39b31cf668e54878f52bd
-  data.tar.gz: 4ffe860837dc85e925f308fdff68129ba01cdc41fb192495af4926bbd91328c62847f862c2847a819c9615cd1b223d512910a421713ee64f9b038bee25def482
+  metadata.gz: 813efcb0fae947ac7a93bb88d6984ca4b4369390b807d08eb11e9ff7d49b7742c53de1e2a9d0ffd6c2fd98b07dcd3cd8161e477ec91e9b0b5574ebdb54dd5ebc
+  data.tar.gz: a7a077c4af7e7379364bec45ef965eafcab28c58cca0588f9f2c0854a99bb5e4f5bf7a4262e4f5c64d57bd02f311c03bb98146b500e0d6a6621a528fe297a782

data/CHANGELOG

@@ -22,6 +22,14 @@ Got it — here’s your changelog tidied up for clarity and consistency without
 
 ---
 
+## [0.1.2] - 2025-05-11
+
+### Added
+
+1. Added support for closing SPL token accounts with:
+  - `Solace::Composers::SystemProgramCreateAccountComposer`
+  - `Solace::Instructions::SystemProgram::CreateAccountInstruction`
+
 ## [0.1.1] - 2025-05-11
 
 ### Added

data/lib/solace/composers/spl_token_program_close_account_composer.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composer for creating a SPL Token Program CloseAccount instruction.
+    #
+    # This composer resolves and orders the required accounts for a `CloseAccount` instruction,
+    # sets up their access permissions, and delegates construction to the appropriate
+    # instruction builder.
+    #
+    # The CloseAccount instruction closes a token account and transfers remaining lamports
+    # to a destination account. The account must have a balance of zero tokens.
+    #
+    # Required accounts:
+    # - **Account**: token account to close (writable, non-signer)
+    # - **Destination**: account to receive lamports (writable, non-signer)
+    # - **Authority**: account authority (non-writable, signer)
+    #
+    # @example Compose and build a close account instruction
+    #   composer = SplTokenProgramCloseAccountComposer.new(
+    #     account: token_account_address,
+    #     destination: destination_address,
+    #     authority: authority_address
+    #   )
+    #
+    # @since 0.1.2
+    class SplTokenProgramCloseAccountComposer < Base
+      # Extracts the token account address from the params
+      #
+      # @return [String] The token account address
+      def account
+        params[:account].to_s
+      end
+
+      # Extracts the destination address from the params
+      #
+      # @return [String] The destination address
+      def destination
+        params[:destination].to_s
+      end
+
+      # Extracts the authority address from the params
+      #
+      # @return [String] The authority address
+      def authority
+        params[:authority].to_s
+      end
+
+      # Returns the spl token program id
+      #
+      # @return [String] The spl token program id
+      def spl_token_program
+        Constants::TOKEN_PROGRAM_ID.to_s
+      end
+
+      # Setup accounts required for close account instruction
+      # Called automatically during initialization
+      #
+      # @return [void]
+      def setup_accounts
+        account_context.add_writable_nonsigner(account)
+        account_context.add_writable_nonsigner(destination)
+        account_context.add_readonly_signer(authority)
+        account_context.add_readonly_nonsigner(spl_token_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::SplToken::CloseAccountInstruction.build(
+          account_index: account_context.index_of(account),
+          authority_index: account_context.index_of(authority),
+          destination_index: account_context.index_of(destination),
+          program_index: account_context.index_of(spl_token_program)
+        )
+      end
+    end
+  end
+end

data/lib/solace/instructions/spl_token/close_account_instruction.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Solace
+  module Instructions
+    module SplToken
+      # Instruction builder for SPL Token Program CloseAccount.
+      #
+      # The CloseAccount instruction closes a token account and transfers all remaining
+      # lamports to a destination account. The token account must have a balance of zero.
+      #
+      # Instruction discriminator: 9
+      #
+      # Accounts:
+      # 1. [writable] Token account to close
+      # 2. [writable] Destination account to receive lamports
+      # 3. [signer] Account authority
+      #
+      # @since 0.1.2
+      class CloseAccountInstruction
+        # Instruction discriminator for CloseAccount
+        INSTRUCTION_DISCRIMINATOR = [9].freeze
+
+        # Builds a CloseAccount instruction
+        #
+        # @param account_index [Integer] Index of the token account to close
+        # @param destination_index [Integer] Index of the destination account
+        # @param authority_index [Integer] Index of the account authority
+        # @param program_index [Integer] Index of the SPL Token program
+        # @return [Solace::Instruction] The constructed instruction
+        def self.build(account_index:, destination_index:, authority_index:, program_index:)
+          Solace::Instruction.new.tap do |ix|
+            ix.program_index = program_index
+            ix.accounts = [account_index, destination_index, authority_index]
+            ix.data = data
+          end
+        end
+
+        # Builds the data for a CloseAccount instruction
+        #
+        # The BufferLayout is:
+        #   - [Instruction Index (1 byte)]
+        #
+        # @return [Array] 1-byte instruction index
+        def self.data
+          INSTRUCTION_DISCRIMINATOR
+        end
+      end
+    end
+  end
+end

data/lib/solace/version.rb

@@ -2,6 +2,5 @@
 
 module Solace
   # Latest version of the Solace gem.
-  # @since 0.1.1
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solace
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Sebastian Scholl
@@ -109,6 +109,7 @@ files:
 - lib/solace/address_lookup_table.rb
 - lib/solace/composers/associated_token_account_program_create_account_composer.rb
 - lib/solace/composers/base.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
 - lib/solace/composers/spl_token_program_transfer_checked_composer.rb
@@ -125,6 +126,7 @@ files:
 - lib/solace/errors/rpc_error.rb
 - lib/solace/instruction.rb
 - lib/solace/instructions/associated_token_account/create_associated_token_account_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
 - lib/solace/instructions/spl_token/mint_to_instruction.rb