solana-ruby-kit 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12771cac3706269f104b012ee691d4cd42856f61560d54b9e959308184c90be6
-  data.tar.gz: 52bc18d7dff9bce3c2f27115772275e8a2b0decd985faa4ef2f43723056030d9
+  metadata.gz: dddb792ac729b3981104e68f18131191f6775d864e785d25cd47ad5d169e94cc
+  data.tar.gz: 4fd955c2fb214186034906194a530ad62461ee7d3169b7e0718233de4331d4a8
 SHA512:
-  metadata.gz: c1f7feeaf404a2911bf4498377e2e2426f10357cd415cb70e4a57d70b05a81a73b51b817983e33bd1a9aa169ee9dcd9d80018c050964b0a51ada8afebba772d2
-  data.tar.gz: 6f3f9b4d8de10136120b08d4be8927ba13546edc902f81a3f46b64e89e5947b9623ef3645857c721c44bd5bc7d16c4ba13eee74d65bca03d09bee78fd0b3a932
+  metadata.gz: 9341acdd7f36e55078fa7a21989ec8e29aa00a351e52e3caa05a2f2b14ccee3fbe443f6b35d9914ccb4e53192e215e12659c4c7f83090bc2c027c9ff4fa52f87
+  data.tar.gz: 0dc330cd1fc6f3177d283eb6b251e0ad187c92f482c328aae1c72a9881bf338206ff2a9fadf7ab3c0a9f4744ce798244bac7368cb8517beee3cb89252abcea75

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

@@ -0,0 +1,162 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative '../addresses/address'
+require_relative '../encoding/base58'
+require_relative '../instructions/instruction'
+require_relative '../instructions/accounts'
+require_relative '../sysvars/addresses'
+require_relative 'system_program'
+
+module Solana::Ruby::Kit
+  module Programs
+    # Ruby interface for the Solana Stake Program.
+    #
+    # The Stake Program manages stake accounts used for delegating SOL to
+    # validators and earning staking rewards.  Instruction data uses
+    # little-endian encoding: a u32 discriminator followed by any
+    # instruction-specific fields.
+    #
+    # Reference: https://github.com/solana-labs/solana-web3.js/blob/master/packages/library-legacy/src/programs/stake.ts
+    module StakeProgram
+      extend T::Sig
+
+      # The Stake Program address.
+      PROGRAM_ID = T.let(
+        Addresses::Address.new('Stake11111111111111111111111111111111111111111'),
+        Addresses::Address
+      )
+
+      # The Stake Config sysvar / config account.
+      STAKE_CONFIG_ID = T.let(
+        Addresses::Address.new('StakeConfig11111111111111111111111111111111'),
+        Addresses::Address
+      )
+
+      # Number of bytes required to store a stake account on-chain.
+      STAKE_ACCOUNT_SPACE = T.let(200, Integer)
+
+      # Instruction discriminators (u32 little-endian).
+      DISCRIMINATOR_INITIALIZE    = T.let(0, Integer)
+      DISCRIMINATOR_DELEGATE      = T.let(2, Integer)
+
+      module_function
+
+      # Builds the two instructions needed to create and initialise a new stake
+      # account funded from +from+.
+      #
+      # Instruction 0 — System Program createAccount
+      #   Data layout (52 bytes):
+      #     [0..3]   u32 LE = 0          (CREATE_ACCOUNT discriminant)
+      #     [4..11]  u64 LE = lamports
+      #     [12..19] u64 LE = 200        (STAKE_ACCOUNT_SPACE)
+      #     [20..51] 32 bytes            (Stake Program ID — the owner to assign)
+      #   Pack string: 'VQ<Q<a32'
+      #
+      # Instruction 1 — Stake Program Initialize
+      #   Data layout (116 bytes):
+      #     [0..3]    u32 LE = 0          (Initialize discriminant)
+      #     [4..35]   32 bytes            (authorized staker pubkey)
+      #     [36..67]  32 bytes            (authorized withdrawer pubkey)
+      #     [68..75]  i64 LE = 0          (lockup unix_timestamp — no lockup)
+      #     [76..83]  u64 LE = 0          (lockup epoch — no lockup)
+      #     [84..115] 32 bytes = \x00*32  (lockup custodian — zero pubkey)
+      #   Pack string: 'Va32a32q<Q<a32'
+      #
+      # @param from          [Addresses::Address]  funding account (writable, signer)
+      # @param stake_account [Addresses::Address]  new stake account (writable, signer)
+      # @param authorized    [Addresses::Address]  pubkey set as both staker and withdrawer
+      # @param lamports      [Integer]             total lamports to fund the stake account
+      # @return [T::Array[Instructions::Instruction]]
+      sig do
+        params(
+          from:          Addresses::Address,
+          stake_account: Addresses::Address,
+          authorized:    Addresses::Address,
+          lamports:      Integer
+        ).returns(T::Array[Instructions::Instruction])
+      end
+      def create_account_instructions(from:, stake_account:, authorized:, lamports:)
+        stake_program_bytes = Encoding::Base58.decode(PROGRAM_ID.value)
+        authorized_bytes    = Encoding::Base58.decode(authorized.value)
+        zero_pubkey         = ("\x00" * 32).b
+
+        # Instruction 0: System Program createAccount (discriminant = 0)
+        create_data = [0, lamports, STAKE_ACCOUNT_SPACE, stake_program_bytes].pack('VQ<Q<a32').b
+
+        create_account_ix = Instructions::Instruction.new(
+          program_address: SystemProgram::PROGRAM_ID,
+          accounts: [
+            Instructions.writable_signer_account(from),          # 0 from
+            Instructions.writable_signer_account(stake_account), # 1 stake_account
+          ],
+          data: create_data
+        )
+
+        # Instruction 1: Stake Program Initialize
+        initialize_data = [
+          DISCRIMINATOR_INITIALIZE,
+          authorized_bytes,  # staker
+          authorized_bytes,  # withdrawer
+          0,                 # lockup.unix_timestamp (i64)
+          0,                 # lockup.epoch (u64)
+          zero_pubkey        # lockup.custodian
+        ].pack('Va32a32q<Q<a32').b
+
+        initialize_ix = Instructions::Instruction.new(
+          program_address: PROGRAM_ID,
+          accounts: [
+            Instructions.writable_account(stake_account),                                       # 0 stake_account
+            Instructions.readonly_account(Addresses::Address.new(Sysvars::SYSVAR_RENT_ADDRESS)), # 1 sysvar rent
+          ],
+          data: initialize_data
+        )
+
+        [create_account_ix, initialize_ix]
+      end
+
+      # Builds a DelegateStake instruction that delegates an initialised stake
+      # account to a validator vote account.
+      #
+      # Data layout (4 bytes):
+      #   [0..3] u32 LE = 2   (DelegateStake discriminant)
+      # Pack string: 'V'
+      #
+      # Accounts:
+      #   0. stake_account        — writable, not signer
+      #   1. vote_account         — readonly, not signer
+      #   2. SYSVAR_CLOCK         — readonly, not signer
+      #   3. SYSVAR_STAKE_HISTORY — readonly, not signer
+      #   4. STAKE_CONFIG_ID      — readonly, not signer
+      #   5. authorized           — readonly, signer
+      #
+      # @param stake_account [Addresses::Address]  stake account to delegate
+      # @param vote_account  [Addresses::Address]  validator's vote account
+      # @param authorized    [Addresses::Address]  authorised staker (must sign)
+      # @return [Instructions::Instruction]
+      sig do
+        params(
+          stake_account: Addresses::Address,
+          vote_account:  Addresses::Address,
+          authorized:    Addresses::Address
+        ).returns(Instructions::Instruction)
+      end
+      def delegate_instruction(stake_account:, vote_account:, authorized:)
+        data = [DISCRIMINATOR_DELEGATE].pack('V').b
+
+        Instructions::Instruction.new(
+          program_address: PROGRAM_ID,
+          accounts: [
+            Instructions.writable_account(stake_account),                                             # 0 stake_account
+            Instructions.readonly_account(vote_account),                                               # 1 vote_account
+            Instructions.readonly_account(Addresses::Address.new(Sysvars::SYSVAR_CLOCK_ADDRESS)),      # 2 clock
+            Instructions.readonly_account(Addresses::Address.new(Sysvars::SYSVAR_STAKE_HISTORY_ADDRESS)), # 3 stake history
+            Instructions.readonly_account(STAKE_CONFIG_ID),                                            # 4 stake config
+            Instructions.readonly_signer_account(authorized),                                          # 5 authorized staker
+          ],
+          data: data
+        )
+      end
+    end
+  end
+end

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

@@ -5,6 +5,7 @@
 # returned in Solana transaction failures.
 require_relative 'programs/associated_token_account'
 require_relative 'programs/system_program'
+require_relative 'programs/stake_program'
 #
 # A program error in a transaction result looks like:
 #   { "InstructionError" => [0, { "Custom" => 1234 }] }

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

@@ -4,7 +4,7 @@
 module Solana
   module Ruby
     module Kit
-      VERSION = '0.1.5'
+      VERSION = '0.1.6'
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby-kit
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Paul Zupan, Idhra Inc.
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: openssl
@@ -231,6 +231,7 @@ files:
 - lib/solana/ruby/kit/plugin_core.rb
 - lib/solana/ruby/kit/programs.rb
 - lib/solana/ruby/kit/programs/associated_token_account.rb
+- lib/solana/ruby/kit/programs/stake_program.rb
 - lib/solana/ruby/kit/programs/system_program.rb
 - lib/solana/ruby/kit/promises.rb
 - lib/solana/ruby/kit/railtie.rb
@@ -313,7 +314,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Ruby port of the Anza TypeScript SDK (@anza-xyz/kit)
 test_files: []