solace 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21862a029b8b0922fa42fd3798e86d11c69900255bb92a035c806d83a8c985c1
-  data.tar.gz: 10eb8a0433c9907b7e75a7a3bb71637f1e41f0012e7cb695afcb91f2115d3f3f
+  metadata.gz: 18aca49d63b09deffe93ba871b65d6b816a7c81863b0b0e2b2c2bd29ce709ce6
+  data.tar.gz: 810a45b1324aa282684e4a5d62ea48738ac2b33a6eb87538e2e0458ca2f54593
 SHA512:
-  metadata.gz: 813efcb0fae947ac7a93bb88d6984ca4b4369390b807d08eb11e9ff7d49b7742c53de1e2a9d0ffd6c2fd98b07dcd3cd8161e477ec91e9b0b5574ebdb54dd5ebc
-  data.tar.gz: a7a077c4af7e7379364bec45ef965eafcab28c58cca0588f9f2c0854a99bb5e4f5bf7a4262e4f5c64d57bd02f311c03bb98146b500e0d6a6621a528fe297a782
+  metadata.gz: 50eeac609077e873b361fdb8ed34459ccbed1b4e44d52ad911803350ea0d2f0e669fcfcb30bcddd6d20e9f54dade972a50907532a108dae7142ecca8475f42fb
+  data.tar.gz: 5fba491757746aa8fad865bae93941f3469148c6a5fc8cb5c984ebccb79934f1b1c3425184ab37ff2342f6215a1d5b1147a9d04f6d9225a96e7c6b34c38d8b0d

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/errors/confirmation_timeout.rb

@@ -17,7 +17,7 @@ module Solace
     #   end
     #
     # @since 0.0.1
-    class ConfirmationTimeout < StandardError
+    class ConfirmationTimeout < Error
       attr_reader :signature, :commitment, :timeout
 
       # @param [String] message The error message

data/lib/solace/errors/connection_error.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Solace
+  module Errors
+    # Base error class for connection-related failures.
+    #
+    # Both {Solace::Errors::HTTPError} and {Solace::Errors::RPCError} inherit
+    # from this class, allowing consumers to rescue all connection errors with
+    # a single clause:
+    #
+    # @example Rescuing all connection errors
+    #   begin
+    #     connection.send_transaction(transaction)
+    #   rescue Solace::Errors::ConnectionError => e
+    #     puts "Connection error: #{e.message}"
+    #   end
+    #
+    # @see Solace::Errors::HTTPError
+    # @see Solace::Errors::RPCError
+    # @since 0.1.4
+    class ConnectionError < Error; end
+  end
+end

data/lib/solace/errors/error.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Solace
+  module Errors
+    # Base error class for all Solace errors.
+    #
+    # All Solace-specific exceptions inherit from this class, allowing consumers
+    # to rescue all Solace errors with a single clause:
+    #
+    # @example Rescuing all Solace errors
+    #   begin
+    #     connection.get_account_info(address)
+    #   rescue Solace::Errors::Error => e
+    #     puts "Solace error: #{e.message}"
+    #   end
+    #
+    # @since 0.1.4
+    class Error < StandardError; end
+  end
+end

data/lib/solace/errors/http_error.rb

@@ -18,7 +18,7 @@ module Solace
     #
     # @see Solace::Errors::RPCError
     # @since 0.0.1
-    class HTTPError < StandardError
+    class HTTPError < ConnectionError
       attr_reader :code, :body
 
       # @param [String] message The error message

data/lib/solace/errors/parse_error.rb

@@ -17,7 +17,7 @@ module Solace
     #   end
     #
     # @since 0.0.1
-    class ParseError < StandardError
+    class ParseError < Error
       attr_reader :body
 
       # @param [String] message The error message

data/lib/solace/errors/rpc_error.rb

@@ -19,7 +19,7 @@ module Solace
     #
     # @see Solace::Errors::HTTPError
     # @since 0.0.1
-    class RPCError < StandardError
+    class RPCError < ConnectionError
       attr_reader :rpc_code, :rpc_message, :rpc_data
 
       # @param [String] message The error message

data/lib/solace/errors.rb

@@ -5,6 +5,8 @@ module Solace
   #
   # These exceptions provide specific error handling for various failure scenarios
   # when interacting with the Solana blockchain, including:
+  # - {Solace::Errors::Error} - Base class for all Solace errors
+  # - {Solace::Errors::ConnectionError} - Base class for connection-related errors
   # - {Solace::Errors::HTTPError} - HTTP communication failures
   # - {Solace::Errors::RPCError} - RPC method errors returned by the node
   # - {Solace::Errors::ParseError} - Data parsing and deserialization errors
@@ -13,7 +15,8 @@ module Solace
   # @see Solace::Connection
   # @since 0.0.8
   module Errors
-    # JSON-RPC Errors
+    require 'solace/errors/error'
+    require 'solace/errors/connection_error'
     require 'solace/errors/rpc_error'
     require 'solace/errors/http_error'
     require 'solace/errors/parse_error'

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/utils/curve25519_dalek.rb

@@ -24,8 +24,18 @@ module Solace
       # @return [String] The path to the native library
       # @raise [RuntimeError] If the platform is not supported
       libfile = case RUBY_PLATFORM
-                when /linux/ then 'libcurve25519_dalek-linux/libcurve25519_dalek.so'
-                when /darwin/ then 'libcurve25519_dalek-macos/libcurve25519_dalek.dylib'
+                when /linux/
+                  if RUBY_PLATFORM =~ /arm|aarch64/
+                    'libcurve25519_dalek-linux-arm64/libcurve25519_dalek.so'
+                  else
+                    'libcurve25519_dalek-linux/libcurve25519_dalek.so'
+                  end
+                when /darwin/
+                  if RUBY_PLATFORM =~ /arm64|aarch64/
+                    'libcurve25519_dalek-macos-arm64/libcurve25519_dalek.dylib'
+                  else
+                    'libcurve25519_dalek-macos/libcurve25519_dalek.dylib'
+                  end
                 when /mingw|mswin/ then 'libcurve25519_dalek-windows/curve25519_dalek.dll'
                 else raise 'Unsupported platform'
                 end

data/lib/solace/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solace
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 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
@@ -121,11 +122,14 @@ files:
 - lib/solace/constants.rb
 - lib/solace/errors.rb
 - lib/solace/errors/confirmation_timeout.rb
+- lib/solace/errors/connection_error.rb
+- lib/solace/errors/error.rb
 - lib/solace/errors/http_error.rb
 - 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
@@ -157,7 +161,9 @@ files:
 - lib/solace/utils/account_context.rb
 - lib/solace/utils/codecs.rb
 - lib/solace/utils/curve25519_dalek.rb
+- lib/solace/utils/libcurve25519_dalek-linux-arm64/libcurve25519_dalek.so
 - lib/solace/utils/libcurve25519_dalek-linux/libcurve25519_dalek.so
+- lib/solace/utils/libcurve25519_dalek-macos-arm64/libcurve25519_dalek.dylib
 - lib/solace/utils/libcurve25519_dalek-macos/libcurve25519_dalek.dylib
 - lib/solace/utils/libcurve25519_dalek-windows/curve25519_dalek.dll
 - lib/solace/utils/pda.rb
@@ -190,7 +196,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Solana ruby library
 test_files: []