solace 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21862a029b8b0922fa42fd3798e86d11c69900255bb92a035c806d83a8c985c1
-  data.tar.gz: 10eb8a0433c9907b7e75a7a3bb71637f1e41f0012e7cb695afcb91f2115d3f3f
+  metadata.gz: 4c4e4949dfaad369b5fbe6db182896b73fce66456fa04b480a394753bd76f3d8
+  data.tar.gz: e0fc2a7292a0ef3688555b419a534b7d8aa64fae214cc5f0317aebcd2af767e1
 SHA512:
-  metadata.gz: 813efcb0fae947ac7a93bb88d6984ca4b4369390b807d08eb11e9ff7d49b7742c53de1e2a9d0ffd6c2fd98b07dcd3cd8161e477ec91e9b0b5574ebdb54dd5ebc
-  data.tar.gz: a7a077c4af7e7379364bec45ef965eafcab28c58cca0588f9f2c0854a99bb5e4f5bf7a4262e4f5c64d57bd02f311c03bb98146b500e0d6a6621a528fe297a782
+  metadata.gz: a1653573d2cabf8c0253157a03b7bb5ebfadedf0eeeb6dea1eefa89c0b79aa01250637bab175f0d91e3072bcf7fd18a43b082d40851cb9b5d5bc7759971d54fe
+  data.tar.gz: 718ea842339b67b89b99f9c1a674148b510e3ed6bdd4921a9fa574cd83525452e8ff7e17d8138a97821d9885cdb54a8b09037b3826666c7db59328bdfc25f67c

data/CHANGELOG

@@ -18,7 +18,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 ### Fixed
 ```
 
-Got it — here’s your changelog tidied up for clarity and consistency without changing any of the substance. I only fixed grammar/typos and tightened phrasing.
+---
+
+## 0.1.3 - 2025-06-11
+
+### Added
+
+1. Added `Solace::Instructions::AssociatedTokenAccount::CreateIdempotentAccountInstruction`
+2. Added `Solace::Composers::AssociatedTokenAccountCreateIdempotentAccountComposer`
+
+### Changed
+
+1. Renamed `Solace::Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction` to `Solace::Instructions::AssociatedTokenAccount::CreateAccountInstruction` with backwards compatibility
 
 ---
 

data/lib/solace/composers/associated_token_account_program_create_account_composer.rb

@@ -6,7 +6,7 @@ module Solace
     #
     # This composer resolves and orders the required accounts for a `CreateAssociatedTokenAccount` instruction,
     # sets up their access permissions, and delegates construction to the appropriate
-    # instruction builder (`Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction`).
+    # instruction builder (`Instructions::AssociatedTokenAccount::CreateAccountInstruction`).
     #
     # Required accounts:
     # - **Funder**: the account that will pay for fees and rent.
@@ -25,7 +25,7 @@ module Solace
     #     mint: mint_address
     #   )
     #
-    # @see Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction
+    # @see Instructions::AssociatedTokenAccount::CreateAccountInstruction
     # @since 0.0.7
     class AssociatedTokenAccountProgramCreateAccountComposer < Base
       # Extracts the owner address from the params
@@ -96,7 +96,7 @@ module Solace
       # @param account_context [Utils::AccountContext] The account context
       # @return [Solace::Instruction] The instruction
       def build_instruction(account_context)
-        Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction.build(
+        Instructions::AssociatedTokenAccount::CreateAccountInstruction.build(
           funder_index: account_context.index_of(funder),
           owner_index: account_context.index_of(owner),
           mint_index: account_context.index_of(mint),

data/lib/solace/composers/associated_token_account_program_create_idempotent_account_composer.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Solace
+  module Composers
+    # Composer for creating an associated token account program create account instruction with idempotency
+    #
+    # This composer resolves and orders the required accounts for a `CreateIdempotentAssociatedTokenAccount` instruction,
+    # sets up their access permissions, and delegates construction to the appropriate
+    # instruction builder (`Instructions::AssociatedTokenAccount::CreateIdempotentAssociatedTokenAccountInstruction`).
+    #
+    # Required accounts:
+    # - **Funder**: the account that will pay for fees and rent.
+    # - **Owner**: the account that will own the new ATA.
+    # - **ATA**: the address of the new ATA.
+    # - **Mint**: the mint address of the token.
+    # - **System Program**: the system program id.
+    # - **Token Program**: the token program id.
+    # - **Associated Token Account Program**: the associated token account program id.
+    #
+    # @example Compose and build a create account instruction
+    #   composer = AssociatedTokenAccountProgramCreateAccountComposer.new(
+    #     funder: funder_address,
+    #     owner: owner_address,
+    #     ata_address: ata_address,
+    #     mint: mint_address
+    #   )
+    #
+    # @see Instructions::AssociatedTokenAccount::CreateAccountInstruction
+    # @since 0.1.3
+    #
+    # rubocop:disable Layout
+    class AssociatedTokenAccountProgramCreateIdempotentAccountComposer < AssociatedTokenAccountProgramCreateAccountComposer
+      # Builds the instruction for the associated token account program create account instruction
+      #
+      # @param account_context [Utils::AccountContext] The account context
+      # @return [Solace::Instruction] The instruction
+      def build_instruction(account_context)
+        Instructions::AssociatedTokenAccount::CreateIdempotentAccountInstruction.build(
+          funder_index: account_context.index_of(funder),
+          owner_index: account_context.index_of(owner),
+          mint_index: account_context.index_of(mint),
+          associated_token_account_index: account_context.index_of(ata_address),
+          system_program_index: account_context.index_of(system_program_id),
+          token_program_index: account_context.index_of(token_program_id),
+          program_index: account_context.index_of(associated_token_account_program_id)
+        )
+      end
+    end
+    # rubocop:enable Layout
+  end
+end

data/lib/solace/instructions/associated_token_account/{create_associated_token_account_instruction.rb → create_account_instruction.rb}

@@ -2,7 +2,7 @@
 
 module Solace
   module Instructions
-    # The AssociatedTokenAccount module contains instruction builders for the
+    # The Account module contains instruction builders for the
     # Associated Token Account Program.
     #
     # The Associated Token Account (ATA) Program provides a deterministic way to
@@ -17,8 +17,8 @@ module Solace
       # This is a special "all-in-one" instruction that creates and initializes the account. It
       # is used to create an Associated Token Account (ATA) for a given mint and owner.
       #
-      # @example Build a CreateAssociatedTokenAccount instruction
-      #   instruction = Solace::Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction.build(
+      # @example Build a CreateAccount instruction
+      #   instruction = Solace::Instructions::AssociatedTokenAccount::CreateAccountInstruction.build(
       #     funder_index: 0,
       #     associated_token_account_index: 1,
       #     owner_index: 2,
@@ -27,14 +27,14 @@ module Solace
       #     token_program_index: 5,
       #     program_index: 6
       #   )
-      class CreateAssociatedTokenAccountInstruction
+      class CreateAccountInstruction
         # !@const INSTRUCTION_INDEX
-        #   Instruction index for CreateAssociatedTokenAccount
+        #   Instruction index for CreateAccount
         #
         # @return [Array<Integer>]
         INSTRUCTION_INDEX = [0].freeze
 
-        # Builds a CreateAssociatedTokenAccount instruction.
+        # Builds a CreateAccount instruction.
         #
         # The on-chain program requires accounts in a specific order:
         # 1. [writable, signer] Funder: The account paying for the rent.
@@ -75,7 +75,7 @@ module Solace
           end
         end
 
-        # Data for a CreateAssociatedTokenAccount instruction
+        # Data for a CreateAccount instruction
         #
         # The BufferLayout is:
         #   - [Instruction Index (1 byte)]
@@ -85,6 +85,9 @@ module Solace
           INSTRUCTION_INDEX
         end
       end
+
+      # Alias for CreateAccountInstruction for backward compatibility
+      CreateAssociatedTokenAccountInstruction = CreateAccountInstruction
     end
   end
 end

data/lib/solace/instructions/associated_token_account/create_idempotent_account_instruction.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Solace
+  module Instructions
+    # The AssociatedTokenAccount module contains instruction builders for the
+    # Associated Token Account Program.
+    #
+    # The Associated Token Account (ATA) Program provides a deterministic way to
+    # derive token account addresses for a given wallet and mint. This ensures that
+    # each wallet has a single, predictable token account for each token type.
+    #
+    # @see https://spl.solana.com/associated-token-account
+    # @since 0.1.3
+    module AssociatedTokenAccount
+      # Instruction for creating an Associated Token Account idempotently.
+      #
+      # This instruction behaves like `CreateAccountInstruction`, but will not fail
+      # if the account already exists. This is useful for scenarios where the existence of the
+      # account is uncertain, and you want to ensure it exists without causing an error.
+      #
+      # @example Build a CreateIdempotentAccount instruction
+      #   instruction = Solace::Instructions::AssociatedTokenAccount::CreateIdempotentAccountInstruction.build(
+      #     funder_index: 0,
+      #     associated_token_account_index: 1,
+      #     owner_index: 2,
+      #     mint_index: 3,
+      #     system_program_index: 4,
+      #     token_program_index: 5,
+      #     program_index: 6
+      #   )
+      #
+      # @see CreateAccountInstruction
+      class CreateIdempotentAccountInstruction < CreateAccountInstruction
+        # !@const INSTRUCTION_INDEX
+        #   Instruction index for CreateIdempotentAccount
+        #
+        # @return [Array<Integer>]
+        INSTRUCTION_INDEX = [1].freeze
+
+        # Data for a CreateAccount instruction
+        #
+        # The BufferLayout is:
+        #   - [Instruction Index (1 byte)]
+        #
+        # @return [Array] 1-byte instruction index
+        def self.data
+          INSTRUCTION_INDEX
+        end
+      end
+    end
+  end
+end

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

@@ -9,7 +9,7 @@ module Solace
       #
       # This instruction is used to initialize a new token account for a given mint and owner. It
       # is used in conjunction with the CreateAccount instruction to create and initialize a new
-      # token account. Note that the AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction
+      # token account. Note that the AssociatedTokenAccount::CreateAccountInstruction
       # is a special "all-in-one" instruction that creates and initializes the account in a single
       # instruction.
       #
@@ -22,7 +22,7 @@ module Solace
       #     program_index: 4
       #   )
       #
-      # @see Solace::Instructions::AssociatedTokenAccount::CreateAssociatedTokenAccountInstruction
+      # @see Solace::Instructions::AssociatedTokenAccount::CreateAccountInstruction
       # @see Solace::Instructions::SystemProgram::CreateAccountInstruction
       # @since 0.0.2
       class InitializeAccountInstruction

data/lib/solace/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solace
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Sebastian Scholl
@@ -108,6 +108,7 @@ files:
 - lib/solace.rb
 - lib/solace/address_lookup_table.rb
 - 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/spl_token_program_close_account_composer.rb
 - lib/solace/composers/spl_token_program_initialize_mint_composer.rb
@@ -125,7 +126,8 @@ files:
 - lib/solace/errors/parse_error.rb
 - 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/associated_token_account/create_account_instruction.rb
+- lib/solace/instructions/associated_token_account/create_idempotent_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