solana-ruby-kit 8.2.0 → 8.3.0

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

@@ -95,6 +95,10 @@ module Solana::Ruby::Kit
     CODECS__INVALID_BYTE_LENGTH                          = :SOLANA_ERROR__CODECS__INVALID_BYTE_LENGTH
     CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR = :SOLANA_ERROR__CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR
     CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC = :SOLANA_ERROR__CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC
+    # context: { bytes:, offset: }
+    CODECS__INVALID_UTF8_BYTES                           = :SOLANA_ERROR__CODECS__INVALID_UTF8_BYTES
+    # context: { index:, value: }
+    CODECS__INVALID_UTF8_STRING                          = :SOLANA_ERROR__CODECS__INVALID_UTF8_STRING
 
     # ── RPC / JSON-RPC ────────────────────────────────────────────────────────
     RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER = :SOLANA_ERROR__RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER
@@ -244,6 +248,8 @@ module Solana::Ruby::Kit
         CODECS__INVALID_BYTE_LENGTH                      => 'Expected %{expected} bytes but got %{actual}',
         CODECS__EXPECTED_ZERO_VALUE_TO_MATCH_ITEM_FIXED_DISCRIMINATOR => 'Expected zero value to match fixed discriminator',
         CODECS__FIXED_NULLABLE_CANNOT_WRAP_VARIABLE_SIZE_CODEC => 'A fixed-size nullable codec cannot wrap a variable-size codec',
+        CODECS__INVALID_UTF8_BYTES                       => 'Invalid UTF-8 byte sequence at offset %{offset}',
+        CODECS__INVALID_UTF8_STRING                      => 'Invalid UTF-8 string at index %{index}',
 
         # RPC
         RPC__INTEGER_OVERFLOW_WHILE_SERIALIZING_LARGE_INTEGER   => 'Integer overflow while serializing large integer %{value}',

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

@@ -8,7 +8,7 @@ module Solana::Ruby::Kit
   module FastStableStringify
     extend T::Sig
 
-    module_function
+    extend self
 
     # Serialize +value+ to a deterministic JSON string.
     # Hash keys are sorted lexicographically at every level.

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

@@ -6,7 +6,7 @@ module Solana::Ruby::Kit
   # Mirrors the TypeScript package @solana/functional.
   module Functional
     extend T::Sig
-    module_function
+    extend self
 
     # Passes an initial value through a series of single-argument callables,
     # returning the final result.

data/lib/solana/ruby/kit/instruction_plans/instruction_plan.rb

@@ -97,7 +97,7 @@ module Solana::Ruby::Kit
 
     # ── Factory helpers ────────────────────────────────────────────────────────
 
-    module_function
+    extend self
 
     # Wraps a single instruction in a plan.
     # Mirrors `singleInstructionPlan(instruction)`.

data/lib/solana/ruby/kit/instruction_plans/max_instructions.rb

@@ -16,7 +16,7 @@ module Solana::Ruby::Kit
     # The hard maximum number of top-level instructions the transaction format can encode.
     TRANSACTION_INSTRUCTION_LIMIT = T.let(64, Integer)
 
-    module_function
+    extend self
 
     # Resolves the effective maximum number of instructions allowed in a transaction message,
     # falling back to the default when no value is provided.

data/lib/solana/ruby/kit/instruction_plans/transaction_plan.rb

@@ -41,7 +41,7 @@ module Solana::Ruby::Kit
       def kind = :parallel
     end
 
-    module_function
+    extend self
 
     # Creates a single-message plan.
     # Mirrors `singleTransactionPlan(transactionMessage)`.

data/lib/solana/ruby/kit/instruction_plans/transaction_plan_executor.rb

@@ -9,7 +9,7 @@ module Solana::Ruby::Kit
   module InstructionPlans
     extend T::Sig
 
-    module_function
+    extend self
 
     # Creates a TransactionPlanExecutor — a callable that traverses a TransactionPlan,
     # executing each single transaction message and collecting results.
@@ -111,7 +111,7 @@ module Solana::Ruby::Kit
 
     # ── Private helpers ────────────────────────────────────────────────────────
 
-    module_function
+    extend self
 
     sig { params(plan: T.untyped, execute_fn: T.untyped, state: T.untyped).returns(T.untyped) }
 

data/lib/solana/ruby/kit/instruction_plans/transaction_plan_result.rb

@@ -74,7 +74,7 @@ module Solana::Ruby::Kit
       def kind = :parallel
     end
 
-    module_function
+    extend self
 
     # ── Result factory helpers ────────────────────────────────────────────────
 

data/lib/solana/ruby/kit/instruction_plans/transaction_planner.rb

@@ -11,7 +11,7 @@ module Solana::Ruby::Kit
   module InstructionPlans
     extend T::Sig
 
-    module_function
+    extend self
 
     # Creates a TransactionPlanner — a callable that converts an InstructionPlan
     # into a TransactionPlan by packing instructions into transaction messages.
@@ -71,7 +71,7 @@ module Solana::Ruby::Kit
 
     # ── Private helpers ────────────────────────────────────────────────────────
 
-    module_function
+    extend self
 
     sig { params(plan: T.untyped, ctx: T.untyped).returns(T.untyped) }
 

data/lib/solana/ruby/kit/instructions/accounts.rb

@@ -19,7 +19,7 @@ module Solana::Ruby::Kit
 
     # AccountMeta subtypes — mirrors the four TypeScript convenience types.
 
-    module_function
+    extend self
 
     # Creates a read-only account reference.
     sig { params(address: Addresses::Address).returns(AccountMeta) }

data/lib/solana/ruby/kit/instructions/instruction.rb

@@ -18,7 +18,7 @@ module Solana::Ruby::Kit
       const :data,            T.nilable(String)  # binary String (Uint8Array equivalent)
     end
 
-    module_function
+    extend self
 
     # Returns true if the instruction targets the given program address.
     # Mirrors `isInstructionForProgram()`.

data/lib/solana/ruby/kit/instructions/roles.rb

@@ -19,7 +19,7 @@ module Solana::Ruby::Kit
 
       ALL = T.let([READONLY, WRITABLE, READONLY_SIGNER, WRITABLE_SIGNER].freeze, T::Array[Integer])
 
-      module_function
+      extend self
 
       # Returns true if the role requires the account to sign the transaction.
       sig { params(role: Integer).returns(T::Boolean) }

data/lib/solana/ruby/kit/keys/key_pair.rb

@@ -24,7 +24,7 @@ module Solana::Ruby::Kit
       const :verify_key,  T.untyped  # RbNaCl::VerifyKey
     end
 
-    module_function
+    extend self
 
     # Generates a fresh Ed25519 key pair using a cryptographically secure RNG.
     # Mirrors `generateKeyPair()` in TypeScript.

data/lib/solana/ruby/kit/keys/private_key.rb

@@ -7,7 +7,7 @@ require_relative '../errors'
 module Solana::Ruby::Kit
   module Keys
     extend T::Sig
-    module_function
+    extend self
 
     # Creates an Ed25519 signing key from a raw 32-byte private key seed.
     #

data/lib/solana/ruby/kit/keys/public_key.rb

@@ -7,7 +7,7 @@ require_relative '../errors'
 module Solana::Ruby::Kit
   module Keys
     extend T::Sig
-    module_function
+    extend self
 
     # Derives the Ed25519 verification (public) key from a signing (private) key.
     #

data/lib/solana/ruby/kit/keys/signatures.rb

@@ -60,7 +60,7 @@ module Solana::Ruby::Kit
     SIGNATURE_MIN_STR_LEN = 64
     SIGNATURE_MAX_STR_LEN = 88
 
-    module_function
+    extend self
 
     # Returns true if the string is a valid base58-encoded Ed25519 signature.
     # Mirrors `isSignature()` in TypeScript.

data/lib/solana/ruby/kit/offchain_messages/codec.rb

@@ -15,7 +15,7 @@ module Solana::Ruby::Kit
 
       MAGIC = T.let("\xFF\xFF".b.freeze, String)
 
-      module_function
+      extend self
 
       # Serialize a Message to its canonical binary form.
       sig { params(msg: Message).returns(String) }

data/lib/solana/ruby/kit/offchain_messages/message_v1.rb

@@ -36,7 +36,7 @@ module Solana::Ruby::Kit
       def version = 1
     end
 
-    module_function
+    extend self
 
     # Asserts that a version 1 offchain message received from an untrusted source is the
     # message it was expected to be.

data/lib/solana/ruby/kit/options/option.rb

@@ -57,7 +57,7 @@ module Solana::Ruby::Kit
     #   accepts Option<T>, T, or nil — useful for codec input.
     OptionOrNullable = T.type_alias { T.untyped }
 
-    module_function
+    extend self
 
     # Wraps a value in Some.  Mirrors `some<T>(value)`.
     sig { params(value: T.untyped).returns(Solana::Ruby::Kit::Options::Some[T.untyped]) }

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

@@ -48,7 +48,7 @@ module Solana::Ruby::Kit
   module PluginCore
     extend T::Sig
 
-    module_function
+    extend self
 
     sig { returns(PluginClient) }
     def create_client

data/lib/solana/ruby/kit/programs/associated_token_account.rb

@@ -47,7 +47,7 @@ module Solana::Ruby::Kit
         Addresses::Address
       )
 
-      module_function
+      extend self
 
       # Derives the canonical Associated Token Account address (a PDA) for a
       # given wallet and mint.

data/lib/solana/ruby/kit/programs/stake_program.rb

@@ -40,7 +40,7 @@ module Solana::Ruby::Kit
       DISCRIMINATOR_INITIALIZE    = T.let(0, Integer)
       DISCRIMINATOR_DELEGATE      = T.let(2, Integer)
 
-      module_function
+      extend self
 
       # Builds the two instructions needed to create and initialise a new stake
       # account funded from +from+.

data/lib/solana/ruby/kit/programs/system_program.rb

@@ -27,7 +27,7 @@ module Solana::Ruby::Kit
       # Instruction discriminators (u32 little-endian).
       DISCRIMINATOR_TRANSFER = T.let(2, Integer)
 
-      module_function
+      extend self
 
       # Builds a System Program Transfer instruction that moves +lamports+ from
       # +sender+ to +recipient+.

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

@@ -13,7 +13,7 @@ module Solana::Ruby::Kit
   module Programs
     extend T::Sig
 
-    module_function
+    extend self
 
     # Returns true when +err+ is a custom program error, optionally matching
     # a specific error code.

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

@@ -10,7 +10,7 @@ module Solana::Ruby::Kit
   module Promises
     extend T::Sig
 
-    module_function
+    extend self
 
     # Run each callable in a dedicated thread and return the first result.
     # All losing threads are killed to avoid memory leaks — analogous to the

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

@@ -19,7 +19,7 @@ module Solana::Ruby::Kit
 
     PROVISORY_LIMIT = T.let(0, Integer)
 
-    module_function
+    extend self
 
     # Returns a callable that estimates the resource limits required by a transaction message
     # by simulating it with maximum limits set, then reading back the actual consumption.

data/lib/solana/ruby/kit/rpc_parsed_types/address_lookup_table.rb

@@ -14,7 +14,7 @@ module Solana::Ruby::Kit
       T.untyped
     )
 
-    module_function
+    extend self
 
     sig { params(raw: T::Hash[String, T.untyped]).returns(T.untyped) }
     def parse_address_lookup_table(raw)

data/lib/solana/ruby/kit/rpc_parsed_types/nonce_account.rb

@@ -14,7 +14,7 @@ module Solana::Ruby::Kit
       T.untyped
     )
 
-    module_function
+    extend self
 
     sig { params(raw: T::Hash[String, T.untyped]).returns(T.untyped) }
     def parse_nonce_account(raw)

data/lib/solana/ruby/kit/rpc_parsed_types/stake_account.rb

@@ -20,7 +20,7 @@ module Solana::Ruby::Kit
       T.untyped
     )
 
-    module_function
+    extend self
 
     sig { params(raw: T::Hash[String, T.untyped]).returns(T.untyped) }
     def parse_stake_account(raw)

data/lib/solana/ruby/kit/rpc_parsed_types/token_account.rb

@@ -22,7 +22,7 @@ module Solana::Ruby::Kit
       T.untyped
     )
 
-    module_function
+    extend self
 
     sig { params(raw: T::Hash[String, T.untyped]).returns(T.untyped) }
     def parse_token_account(raw)

data/lib/solana/ruby/kit/rpc_parsed_types/vote_account.rb

@@ -15,7 +15,7 @@ module Solana::Ruby::Kit
       T.untyped
     )
 
-    module_function
+    extend self
 
     sig { params(raw: T::Hash[String, T.untyped]).returns(T.untyped) }
     def parse_vote_account(raw)

data/lib/solana/ruby/kit/rpc_types/cluster_url.rb

@@ -24,7 +24,7 @@ module Solana::Ruby::Kit
       def to_s = @url
     end
 
-    module_function
+    extend self
 
     # Wraps a URL string and tags it as mainnet.
     # Mirrors `mainnet(url)`.

data/lib/solana/ruby/kit/rpc_types/commitment.rb

@@ -22,7 +22,7 @@ module Solana::Ruby::Kit
       T::Array[Symbol]
     )
 
-    module_function
+    extend self
 
     # Returns a numeric score for a commitment level (higher = more confirmed).
     # Mirrors `getCommitmentScore()`.

data/lib/solana/ruby/kit/rpc_types/lamports.rb

@@ -15,7 +15,7 @@ module Solana::Ruby::Kit
 
     LAMPORTS_U64_MAX = T.let(T.unsafe(2**64 - 1), Integer)
 
-    module_function
+    extend self
 
     # Returns true if the integer is a valid u64 lamport value.
     # Mirrors `isLamports()`.

data/lib/solana/ruby/kit/rpc_types/sol.rb

@@ -55,7 +55,7 @@ module Solana::Ruby::Kit
     SOL_SCALE       = T.let(1_000_000_000, Integer)
     SOL_RAW_MAX     = T.let(Kernel.Integer(2**64 - 1), Integer)
 
-    module_function
+    extend self
 
     # Parses a decimal string and returns a Sol value.
     # Raises FIXED_POINTS__STRICT_MODE_PRECISION_LOSS if the string has more

data/lib/solana/ruby/kit/signers/keypair_signer.rb

@@ -59,7 +59,7 @@ module Solana::Ruby::Kit
       end
     end
 
-    module_function
+    extend self
 
     # Creates a KeyPairSigner from an existing Keys::KeyPair.
     # Mirrors `createSignerFromKeyPair(keyPair)`.

data/lib/solana/ruby/kit/subscribable/async_iterable.rb

@@ -20,7 +20,7 @@ module Solana::Ruby::Kit
       # Sentinel value pushed into the queue when the stream is done.
       DONE = T.let(Object.new.freeze, Object)
 
-      module_function
+      extend self
 
       # @param publisher [DataPublisher]
       # @param data_channel channel name for data messages

data/lib/solana/ruby/kit/subscribable/bridge_store_to_async_iterable.rb

@@ -8,7 +8,7 @@ module Solana::Ruby::Kit
   module Subscribable
     extend T::Sig
 
-    module_function
+    extend self
 
     # Adapts a ReactiveStreamStore into an Enumerator, so a *push*-based
     # reactive store can be driven by *pull*-based code that consumes it with

data/lib/solana/ruby/kit/subscribable/reactive_action_store.rb

@@ -191,7 +191,7 @@ module Solana::Ruby::Kit
       end
     end
 
-    module_function
+    extend self
 
     # Wraps a callable in a ReactiveActionStore.
     # fn receives the arguments passed to dispatch/dispatch_async.

data/lib/solana/ruby/kit/subscribable/reactive_stream_store.rb

@@ -199,7 +199,7 @@ module Solana::Ruby::Kit
       end
     end
 
-    module_function
+    extend self
 
     # Creates a ReactiveStreamStore backed by a ready-made DataPublisher.
     # retry() is not supported — see create_reactive_store_from_data_publisher_factory.

data/lib/solana/ruby/kit/sysvars/clock.rb

@@ -17,7 +17,7 @@ module Solana::Ruby::Kit
 
     CLOCK_SIZE = T.let(40, Integer)
 
-    module_function
+    extend self
 
     sig { params(rpc: Rpc::Client).returns(SysvarClock) }
     def fetch_sysvar_clock(rpc)

data/lib/solana/ruby/kit/sysvars/epoch_schedule.rb

@@ -14,7 +14,7 @@ module Solana::Ruby::Kit
       const :first_normal_slot,            Integer
     end
 
-    module_function
+    extend self
 
     sig { params(rpc: Rpc::Client).returns(SysvarEpochSchedule) }
     def fetch_sysvar_epoch_schedule(rpc)

data/lib/solana/ruby/kit/sysvars/last_restart_slot.rb

@@ -8,7 +8,7 @@ module Solana::Ruby::Kit
       const :last_restart_slot, Integer
     end
 
-    module_function
+    extend self
 
     sig { params(rpc: Rpc::Client).returns(SysvarLastRestartSlot) }
     def fetch_sysvar_last_restart_slot(rpc)

data/lib/solana/ruby/kit/sysvars/rent.rb

@@ -11,7 +11,7 @@ module Solana::Ruby::Kit
       const :burn_percent,           Integer
     end
 
-    module_function
+    extend self
 
     sig { params(rpc: Rpc::Client).returns(SysvarRent) }
     def fetch_sysvar_rent(rpc)

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

@@ -11,7 +11,7 @@ module Solana::Ruby::Kit
   module Sysvars
     extend T::Sig
 
-    module_function
+    extend self
 
     # Decode base64 account data from an RpcContextualValue returned by
     # get_account_info(encoding: 'base64').

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

@@ -10,7 +10,7 @@ module Solana::Ruby::Kit
   module TransactionConfirmation
     extend T::Sig
 
-    module_function
+    extend self
 
     # Poll getSignatureStatuses until +signature+ reaches +commitment+ or
     # the blockheight/timeout deadline is exceeded.

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

@@ -39,7 +39,7 @@ module Solana::Ruby::Kit
       const :lifetime_token,  String  # base58-encoded blockhash or nonce value
     end
 
-    module_function
+    extend self
 
     # Decodes legacy or v0 compiled transaction message bytes (the
     # `message_bytes` of a `Transactions::Transaction`) into a

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

@@ -31,7 +31,7 @@ module Solana::Ruby::Kit
       const :transaction,      T.nilable(Transactions::Transaction)
     end
 
-    module_function
+    extend self
 
     # Decodes a confirmed-transaction RPC response (any of `encoding: 'base64'`,
     # `'base58'`, or `'json'`) into a CompiledTransactionMessage plus, for

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

@@ -10,7 +10,7 @@ module Solana::Ruby::Kit
   module TransactionIntrospection
     extend T::Sig
 
-    module_function
+    extend self
 
     # Returns the inner instructions in a transaction `meta` as
     # TracedInstructions.

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

@@ -11,7 +11,7 @@ module Solana::Ruby::Kit
   module TransactionIntrospection
     extend T::Sig
 
-    module_function
+    extend self
 
     # Builds the full ordered list of AccountMetas for a compiled transaction
     # message.

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

@@ -11,7 +11,7 @@ module Solana::Ruby::Kit
   module TransactionIntrospection
     extend T::Sig
 
-    module_function
+    extend self
 
     # Returns every instruction in a confirmed transaction as
     # TracedInstructions, in the order an explorer displays them: each outer

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

@@ -23,7 +23,7 @@ module Solana::Ruby::Kit
     SET_COMPUTE_UNIT_LIMIT_DISCRIMINATOR             = T.let(2, Integer)
     SET_LOADED_ACCOUNTS_DATA_SIZE_LIMIT_DISCRIMINATOR = T.let(4, Integer)
 
-    module_function
+    extend self
 
     # ---------------------------------------------------------------------------
     # SetComputeUnitLimit instruction helpers

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

@@ -16,7 +16,7 @@ module Solana::Ruby::Kit
     # A requested heap frame size must be a whole number of KiB.
     HEAP_SIZE_MULTIPLE_OF = T.let(1024, Integer)
 
-    module_function
+    extend self
 
     # Raises if the given compute unit limit is one the runtime will not honor as written.
     #

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

@@ -57,7 +57,7 @@ module Solana::Ruby::Kit
       const :address_table_lookups, T.nilable(T::Hash[String, T::Array[Integer]])
     end
 
-    module_function
+    extend self
 
     # Creates an empty transaction message at the given version.
     # Mirrors `createTransactionMessage({ version })`.

data/lib/solana/ruby/kit/transactions/compiler.rb

@@ -12,7 +12,7 @@ module Solana::Ruby::Kit
     # Maximum wire-encoded transaction size in bytes (Solana protocol limit).
     TRANSACTION_SIZE_LIMIT = T.let(1232, Integer)
 
-    module_function
+    extend self
 
     # Returns the compiled byte-size of a transaction message.
     # Mirrors `getTransactionMessageSize()` from @solana/transactions.
@@ -174,7 +174,7 @@ module Solana::Ruby::Kit
     #   [message bytes]
     #
     # The result is a binary String; base64-encode it before sending via HTTP.
-    sig { params(transaction: Transaction).returns(String) }
+    sig { params(transaction: AnyTransaction).returns(String) }
     def wire_encode_transaction(transaction)
       sigs    = transaction.signatures
       header  = encode_compact_u16(sigs.size)