solana-ruby 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a89b4b3a79a083057806945963669aab8ca3b312223ea7c1e13a41a26c0063b
-  data.tar.gz: 824eaaa7913f9b499bc6514f1d5fec3d48f3692f399a3205d069425ea32b328c
+  metadata.gz: 9ce5e8285735080d504a24b4a1237a9ea2273939b7d77965e0184baf282853ba
+  data.tar.gz: 032a7e179b759db0ddca3f42299837838470bf36649bdf118c93375deba04394
 SHA512:
-  metadata.gz: 8317d94e7781fb218a31c73a2270daf7ccf5d782f4ec565e89c90994abf871827593a25cec9cb0c83e4bab9bc42a7fc30029c9b289785e3499d81f2c7549a8b9
-  data.tar.gz: e50e55dd5237008503167a603959cad90877ee88c1d43a434924d64db59688783de6445b3f8eb42e14575e2006a0dfc2635d324db6319683c7bf3494f1d701f7
+  metadata.gz: b3d9b31be76b89d2de951324a037dd5cc61d8c04e60eeff30d81730d49d65844a464b8f0d93e7deb08e127aed155479c6b370993bb0fdf7aa553b89440b0ab90
+  data.tar.gz: e71dec47fbd4722efee8ed355d70b7b864d952968cbdbcd97fefc454346a68564da8c4816652899306f88c9cb5f8c13060c82cbfaa7e33ad4a93da596f218217

data/lib/solana-ruby/client.rb

@@ -1,249 +1,772 @@
-require 'httparty'
+require 'faraday'
+require 'faye/websocket'
 require 'json'
+require 'thread'
+
+require_relative 'utils'
 
 module SolanaRB
+  ##
+  # Client class for interacting with the Solana JSON RPC API over HTTP and WS.
   class Client
-    include HTTParty
-    base_uri 'https://api.mainnet-beta.solana.com'
-
-    def initialize(api_key = nil)
+    ##
+    # Initializes a new Client.
+    #
+    # @param [String, nil] api_key Optional API key for authentication.
+    def initialize(api_endpoint = SolanaRB::Utils::MAINNET, api_key = nil)
       @api_key = api_key
+      @api_endpoint = api_endpoint
+      # @api_ws = WebSocket::Handshake::Client.new(url: @api_endpoint::WS)
+      @api_http = Faraday.new(url: @api_endpoint::HTTP) do |faraday|
+        faraday.request :json
+        faraday.response :json, content_type: 'application/json'
+        faraday.adapter Faraday.default_adapter
+      end
     end
 
+    ##
+    # Retrieves account information for a given public key.
+    #
+    # @param [String] pubkey The public key of the account.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The account information.
     def get_account_info(pubkey, options = {})
-      request('getAccountInfo', [pubkey, options])
+      request_http('getAccountInfo', [pubkey, options])
     end
 
+    ##
+    # Retrieves the balance for a given public key.
+    #
+    # @param [String] pubkey The public key of the account.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The balance in lamports.
     def get_balance(pubkey, options = {})
-      request('getBalance', [pubkey, options])
+      request_http('getBalance', [pubkey, options])
     end
 
+    ##
+    # Retrieves information about a specific block.
+    #
+    # @param [Integer] slot_number The slot number of the block.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The block information.
     def get_block(slot_number, options = {})
-      request('getBlock', [slot_number, options])
+      request_http('getBlock', [slot_number, options])
     end
 
+    ##
+    # Retrieves block commitment information for a specific block.
+    #
+    # @param [Integer] slot_number The slot number of the block.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The block commitment information.
     def get_block_commitment(slot_number, options = {})
-      request('getBlockCommitment', [slot_number, options])
+      request_http('getBlockCommitment', [slot_number, options])
     end
 
+    ##
+    # Retrieves the current block height.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The current block height.
     def get_block_height(options = {})
-      request('getBlockHeight', [options])
+      request_http('getBlockHeight', [options])
     end
 
+    ##
+    # Retrieves block production information.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The block production information.
     def get_block_production(options = {})
-      request('getBlockProduction', [options])
+      request_http('getBlockProduction', [options])
     end
 
+    ##
+    # Retrieves the estimated production time of a specific block.
+    #
+    # @param [Integer] slot_number The slot number of the block.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The estimated production time in seconds.
     def get_block_time(slot_number, options = {})
-      request('getBlockTime', [slot_number, options])
+      request_http('getBlockTime', [slot_number, options])
     end
 
+    ##
+    # Retrieves a list of confirmed blocks between two slot numbers.
+    #
+    # @param [Integer] start_slot The start slot number.
+    # @param [Integer] end_slot The end slot number.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Integer>] The list of confirmed blocks.
     def get_blocks(start_slot, end_slot, options = {})
-      request('getBlocks', [start_slot, end_slot, options])
+      request_http('getBlocks', [start_slot, end_slot, options])
     end
 
+    ##
+    # Retrieves a list of confirmed blocks starting from a given slot number with a limit on the number of blocks.
+    #
+    # @param [Integer] start_slot The start slot number.
+    # @param [Integer] limit The maximum number of blocks to return.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Integer>] The list of confirmed blocks.
     def get_blocks_with_limit(start_slot, limit, options = {})
-      request('getBlocksWithLimit', [start_slot, limit, options])
+      request_http('getBlocksWithLimit', [start_slot, limit, options])
     end
 
+    ##
+    # Retrieves the list of cluster nodes.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The list of cluster nodes.
     def get_cluster_nodes(options = {})
-      request('getClusterNodes', [options])
+      request_http('getClusterNodes', [options])
     end
 
+    ##
+    # Retrieves epoch information.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The epoch information.
     def get_epoch_info(options = {})
-      request('getEpochInfo', [options])
+      request_http('getEpochInfo', [options])
     end
 
+    ##
+    # Retrieves the epoch schedule.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The epoch schedule.
     def get_epoch_schedule(options = {})
-      request('getEpochSchedule', [options])
+      request_http('getEpochSchedule', [options])
     end
 
+    ##
+    # Retrieves the fee for a given message.
+    #
+    # @param [String] message The message for which the fee is to be calculated.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The fee for the message.
     def get_fee_for_message(message, options = {})
-      request('getFeeForMessage', [message, options])
+      request_http('getFeeForMessage', [message, options])
     end
 
+    ##
+    # Retrieves the slot of the first available block.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The slot of the first available block.
     def get_first_available_block(options = {})
-      request('getFirstAvailableBlock', [options])
+      request_http('getFirstAvailableBlock', [options])
     end
 
+    ##
+    # Retrieves the genesis hash.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [String] The genesis hash.
     def get_genesis_hash(options = {})
-      request('getGenesisHash', [options])
+      request_http('getGenesisHash', [options])
     end
 
+    ##
+    # Checks the health of the node.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [String] The health status of the node.
     def get_health(options = {})
-      request('getHealth', [options])
+      request_http('getHealth', [options])
     end
 
+    ##
+    # Retrieves the highest snapshot slot.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The highest snapshot slot.
     def get_highest_snapshot_slot(options = {})
-      request('getHighestSnapshotSlot', [options])
+      request_http('getHighestSnapshotSlot', [options])
     end
 
+    ##
+    # Retrieves the identity of the node.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The identity information of the node.
     def get_identity(options = {})
-      request('getIdentity', [options])
+      request_http('getIdentity', [options])
     end
 
+    ##
+    # Retrieves the current inflation governor settings.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The inflation governor settings.
     def get_inflation_governor(options = {})
-      request('getInflationGovernor', [options])
+      request_http('getInflationGovernor', [options])
     end
 
+    ##
+    # Retrieves the current inflation rate.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The inflation rate.
     def get_inflation_rate(options = {})
-      request('getInflationRate', [options])
+      request_http('getInflationRate', [options])
     end
 
+    ##
+    # Retrieves the inflation reward for a given list of addresses.
+    #
+    # @param [Array<String>] addresses The list of addresses.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The inflation rewards for the addresses.
     def get_inflation_reward(addresses, options = {})
-      request('getInflationReward', [addresses, options])
+      request_http('getInflationReward', [addresses, options])
     end
 
+    ##
+    # Retrieves the largest accounts.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The largest accounts.
     def get_largest_accounts(options = {})
-      request('getLargestAccounts', [options])
+      request_http('getLargestAccounts', [options])
     end
 
+    ##
+    # Retrieves the latest blockhash.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The latest blockhash.
     def get_latest_blockhash(options = {})
-      request('getLatestBlockhash', [options])
+      request_http('getLatestBlockhash', [options])
     end
 
+    ##
+    # Retrieves the leader schedule.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The leader schedule.
     def get_leader_schedule(options = {})
-      request('getLeaderSchedule', [options])
+      request_http('getLeaderSchedule', [options])
     end
 
+    ##
+    # Retrieves the maximum retransmit slot.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The maximum retransmit slot.
     def get_max_retransmit_slot(options = {})
-      request('getMaxRetransmitSlot', [options])
+      request_http('getMaxRetransmitSlot', [options])
     end
 
+    ##
+    # Retrieves the maximum shred insert slot.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The maximum shred insert slot.
     def get_max_shred_insert_slot(options = {})
-      request('getMaxShredInsertSlot', [options])
+      request_http('getMaxShredInsertSlot', [options])
     end
 
+    ##
+    # Retrieves the minimum balance required for rent exemption for a given data length.
+    #
+    # @param [Integer] data_length The length of the data in bytes.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The minimum balance for rent exemption.
     def get_minimum_balance_for_rent_exemption(data_length, options = {})
-      request('getMinimumBalanceForRentExemption', [data_length, options])
+      request_http('getMinimumBalanceForRentExemption', [data_length, options])
     end
 
+    ##
+    # Retrieves information for multiple accounts.
+    #
+    # @param [Array<String>] pubkeys The list of public keys.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The information for the accounts.
     def get_multiple_accounts(pubkeys, options = {})
-      request('getMultipleAccounts', [pubkeys, options])
+      request_http('getMultipleAccounts', [pubkeys, options])
     end
 
+    ##
+    # Retrieves information for accounts owned by a specific program.
+    #
+    # @param [String] pubkey The public key of the program.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The information for the program accounts.
     def get_program_accounts(pubkey, options = {})
-      request('getProgramAccounts', [pubkey, options])
+      request_http('getProgramAccounts', [pubkey, options])
     end
 
+    ##
+    # Retrieves recent performance samples.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The recent performance samples.
     def get_recent_performance_samples(options = {})
-      request('getRecentPerformanceSamples', [options])
+      request_http('getRecentPerformanceSamples', [options])
     end
 
+    ##
+    # Retrieves recent prioritization fees.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The recent prioritization fees.
     def get_recent_prioritization_fees(options = {})
-      request('getRecentPrioritizationFees', [options])
+      request_http('getRecentPrioritizationFees', [options])
     end
 
+    ##
+    # Retrieves the status of given transaction signatures.
+    #
+    # @param [Array<String>] signatures The list of transaction signatures.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The status of the transaction signatures.
     def get_signature_statuses(signatures, options = {})
-      request('getSignatureStatuses', [signatures, options])
+      request_http('getSignatureStatuses', [signatures, options])
     end
 
+    ##
+    # Retrieves the signatures for a given address.
+    #
+    # @param [String] address The address for which to retrieve signatures.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The signatures for the address.
     def get_signatures_for_address(address, options = {})
-      request('getSignaturesForAddress', [address, options])
+      request_http('getSignaturesForAddress', [address, options])
     end
 
+    ##
+    # Retrieves the current slot.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The current slot.
     def get_slot(options = {})
-      request('getSlot', [options])
+      request_http('getSlot', [options])
     end
 
+    ##
+    # Retrieves the current slot leader.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [String] The current slot leader.
     def get_slot_leader(options = {})
-      request('getSlotLeader', [options])
+      request_http('getSlotLeader', [options])
     end
 
+    ##
+    # Retrieves the slot leaders starting from a given slot with a limit on the number of leaders.
+    #
+    # @param [Integer] start_slot The start slot number.
+    # @param [Integer] limit The maximum number of leaders to return.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<String>] The slot leaders.
     def get_slot_leaders(start_slot, limit, options = {})
-      request('getSlotLeaders', [start_slot, limit, options])
+      request_http('getSlotLeaders', [start_slot, limit, options])
     end
 
+    ##
+    # Retrieves the stake activation information for a given public key.
+    #
+    # @param [String] pubkey The public key of the stake account.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The stake activation information.
     def get_stake_activation(pubkey, options = {})
-      request('getStakeActivation', [pubkey, options])
+      request_http('getStakeActivation', [pubkey, options])
     end
 
+    ##
+    # Retrieves the minimum delegation for a stake account.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The minimum delegation.
     def get_stake_minimum_delegation(options = {})
-      request('getStakeMinimumDelegation', [options])
+      request_http('getStakeMinimumDelegation', [options])
     end
 
+    ##
+    # Retrieves the supply information.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The supply information.
     def get_supply(options = {})
-      request('getSupply', [options])
+      request_http('getSupply', [options])
     end
 
+    ##
+    # Retrieves the token balance for a given token account.
+    #
+    # @param [String] pubkey The public key of the token account.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The token balance.
     def get_token_account_balance(pubkey, options = {})
-      request('getTokenAccountBalance', [pubkey, options])
+      request_http('getTokenAccountBalance', [pubkey, options])
     end
 
+    ##
+    # Retrieves token accounts by delegate.
+    #
+    # @param [String] delegate The delegate address.
+    # @param [Hash] opts Additional options for the request.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The token accounts by delegate.
     def get_token_accounts_by_delegate(delegate, opts = {}, options = {})
-      request('getTokenAccountsByDelegate', [delegate, opts, options])
+      request_http('getTokenAccountsByDelegate', [delegate, opts, options])
     end
 
+    ##
+    # Retrieves token accounts by owner.
+    #
+    # @param [String] owner The owner address.
+    # @param [Hash] opts Additional options for the request.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The token accounts by owner.
     def get_token_accounts_by_owner(owner, opts = {}, options = {})
-      request('getTokenAccountsByOwner', [owner, opts, options])
+      request_http('getTokenAccountsByOwner', [owner, opts, options])
     end
 
+    ##
+    # Retrieves the largest accounts for a given token.
+    #
+    # @param [String] pubkey The public key of the token.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Array<Hash>] The largest accounts for the token.
     def get_token_largest_accounts(pubkey, options = {})
-      request('getTokenLargestAccounts', [pubkey, options])
+      request_http('getTokenLargestAccounts', [pubkey, options])
     end
 
+    ##
+    # Retrieves the supply of a given token.
+    #
+    # @param [String] pubkey The public key of the token.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The token supply.
     def get_token_supply(pubkey, options = {})
-      request('getTokenSupply', [pubkey, options])
+      request_http('getTokenSupply', [pubkey, options])
     end
 
+    ##
+    # Retrieves transaction details for a given signature.
+    #
+    # @param [String] signature The transaction signature.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The transaction details.
     def get_transaction(signature, options = {})
-      request('getTransaction', [signature, options])
+      request_http('getTransaction', [signature, options])
     end
 
+    ##
+    # Retrieves the total number of transactions processed by the network.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The total number of transactions.
     def get_transaction_count(options = {})
-      request('getTransactionCount', [options])
+      request_http('getTransactionCount', [options])
     end
 
-    def get_version(options = {})
-      request('getVersion', [options])
+    ##
+    # Retrieves the current version of the Solana software.
+    #
+    # @return [Hash] The current version information.
+    def get_version
+      request_http('getVersion')
     end
 
+    ##
+    # Retrieves the list of vote accounts.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The list of vote accounts.
     def get_vote_accounts(options = {})
-      request('getVoteAccounts', [options])
+      request_http('getVoteAccounts', [options])
     end
 
+    ##
+    # Checks if a given blockhash is valid.
+    #
+    # @param [String] blockhash The blockhash to check.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Boolean] Whether the blockhash is valid.
     def is_blockhash_valid(blockhash, options = {})
-      request('isBlockhashValid', [blockhash, options])
+      request_http('isBlockhashValid', [blockhash, options])
     end
 
+    ##
+    # Retrieves the minimum ledger slot.
+    #
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Integer] The minimum ledger slot.
     def minimum_ledger_slot(options = {})
-      request('minimumLedgerSlot', [options])
+      request_http('minimumLedgerSlot', [options])
     end
 
+    ##
+    # Requests an airdrop to a given public key.
+    #
+    # @param [String] pubkey The public key to receive the airdrop.
+    # @param [Integer] lamports The amount of lamports to airdrop.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The airdrop request response.
     def request_airdrop(pubkey, lamports, options = {})
-      request('requestAirdrop', [pubkey, lamports, options])
+      request_http('requestAirdrop', [pubkey, lamports, options])
     end
 
-    def send_transaction(transaction, options = {})
-      request('sendTransaction', [transaction, options])
+    ##
+    # Sends a transaction.
+    #
+    # @param [Hash] transaction The transaction to send.
+    # @return [Hash] The response from the send transaction request.
+    def send_transaction(transaction)
+      request_http('sendTransaction', [transaction.to_json])
     end
 
+    ##
+    # Simulates a transaction.
+    #
+    # @param [Hash] transaction The transaction to simulate.
+    # @param [Hash] options Optional parameters for the request.
+    # @return [Hash] The simulation response.
     def simulate_transaction(transaction, options = {})
-      request('simulateTransaction', [transaction, options])
-    end
-
-    private
-
-    def request(method, params = [])
-      options = {
-        headers: { 'Content-Type' => 'application/json' },
-        body: {
-          jsonrpc: '2.0',
-          method: method,
-          params: params,
-          id: 1
-        }.to_json
+      request_http('simulateTransaction', [transaction.to_json, options])
+    end
+
+    ##
+    # Subscribes to account changes.
+    #
+    # @param [String] pubkey The public key of the account.
+    # @param [Hash] options Optional parameters for the subscription.
+    # @yield [Object] The response from the subscription.
+    def account_subscribe(pubkey, options = {}, &block)
+      request_ws('accountSubscribe', [pubkey, options], &block)
+    end
+
+    ##
+    # Unsubscribes from account changes.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def account_unsubscribe(subscription_id, &block)
+      request_ws('accountUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to new blocks.
+    #
+    # @param [Hash] options Optional parameters for the subscription.
+    # @yield [Object] The response from the subscription.
+    def block_subscribe(options = {}, &block)
+      request_ws('blockSubscribe', [options], &block)
+    end
+
+    ##
+    # Unsubscribes from new blocks.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def block_unsubscribe(subscription_id, &block)
+      request_ws('blockUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to log messages.
+    #
+    # @param [String, Hash] filter The filter for log messages (e.g., a public key or a set of options).
+    # @param [Hash] options Optional parameters for the subscription.
+    # @yield [Object] The response from the subscription.
+    def logs_subscribe(filter, options = {}, &block)
+      request_ws('logsSubscribe', [filter, options], &block)
+    end
+
+    ##
+    # Unsubscribes from log messages.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def logs_unsubscribe(subscription_id, &block)
+      request_ws('logsUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to program changes.
+    #
+    # @param [String] pubkey The public key of the program.
+    # @param [Hash] options Optional parameters for the subscription.
+    # @yield [Object] The response from the subscription.
+    def program_subscribe(pubkey, options = {}, &block)
+      request_ws('programSubscribe', [pubkey, options], &block)
+    end
+
+    ##
+    # Unsubscribes from program changes.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def program_unsubscribe(subscription_id, &block)
+      request_ws('programUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to root changes.
+    #
+    # @yield [Object] The response from the subscription.
+    def root_subscribe(&block)
+      request_ws('rootSubscribe', &block)
+    end
+
+    ##
+    # Unsubscribes from root changes.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def root_unsubscribe(subscription_id, &block)
+      request_ws('rootUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to signature status changes.
+    #
+    # @param [String] signature The signature to monitor.
+    # @param [Hash] options Optional parameters for the subscription.
+    # @yield [Object] The response from the subscription.
+    def signature_subscribe(signature, options = {}, &block)
+      request_ws('signatureSubscribe', [signature, options], &block)
+    end
+
+    ##
+    # Unsubscribes from signature status changes.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def signature_unsubscribe(subscription_id, &block)
+      request_ws('signatureUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to slot changes.
+    #
+    # @yield [Object] The response from the subscription.
+    def slot_subscribe(&block)
+      request_ws('slotSubscribe', &block)
+    end
+
+    ##
+    # Unsubscribes from slot changes.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def slot_unsubscribe(subscription_id, &block)
+      request_ws('slotUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to slot updates.
+    #
+    # @yield [Object] The response from the subscription.
+    def slots_updates_subscribe(&block)
+      request_ws('slotsUpdatesSubscribe', &block)
+    end
+
+    ##
+    # Unsubscribes from slot updates.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def slots_updates_unsubscribe(subscription_id, &block)
+      request_ws('slotsUpdatesUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Subscribes to vote updates.
+    #
+    # @yield [Object] The response from the subscription.
+    def vote_subscribe(&block)
+      request_ws('voteSubscribe', &block)
+    end
+
+    ##
+    # Unsubscribes from vote updates.
+    #
+    # @param [Integer] subscription_id The subscription ID.
+    # @yield [Object] The response from the unsubscription.
+    def vote_unsubscribe(subscription_id, &block)
+      request_ws('voteUnsubscribe', [subscription_id], &block)
+    end
+
+    ##
+    # Sends a JSON-RPC request to the Solana API.
+    #
+    # @param [String] method The RPC method to call.
+    # @param [Array] params The parameters for the RPC method.
+    # @return [Object] The parsed response from the API.
+    def request_http(method, params = nil)
+      body = {
+        jsonrpc: '2.0',
+        method: method,
+        id: 1
       }
+      body[:params] = params if params
 
-      response = self.class.post('/', options)
-      handle_response(response)
+      response = @api_http.post do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = body.to_json
+      end
+
+      handle_response_http(response)
     end
 
-    def handle_response(response)
+    ##
+    # Handles the API response, checking for success and parsing the result.
+    #
+    # @param [Faraday::Response] response The HTTP response object.
+    # @raise [RuntimeError] If the request fails (non-success response).
+    # @return [Object] The parsed result from the API response.
+    def handle_response_http(response)
       if response.success?
-        response.parsed_response['result']
+        response.body['result']
       else
-        raise "Request failed: #{response.code} #{response.message}"
+        raise "Request failed: #{response.status} #{response.reason_phrase}"
+      end
+    end
+
+    ##
+    # Sends a JSON-RPC request to the Solana API over WebSocket.
+    #
+    # @param [String] method The RPC method to call.
+    # @param [Array] params The parameters for the RPC method.
+    # @yield [Object] The parsed response from the API.
+
+    def request_ws(method, params = nil, &block)
+      EM.run do
+        ws = Faye::WebSocket::Client.new(@api_endpoint::WS)
+
+        ws.on :open do |event|
+          body = {
+            jsonrpc: '2.0',
+            method: method,
+            id: 1
+          }
+          body[:params] = params if params
+
+          ws.send(body.to_json)
+        end
+
+        ws.on :message do |event|
+          response = JSON.parse(event.data)
+          yield response['result'] if block_given?
+          ws.close
+        end
+
+        ws.on :close do |event|
+          ws = nil
+          EM.stop
+        end
+
+        ws.on :error do |event|
+          puts "WebSocket error: #{event.message}"
+          ws = nil
+          EM.stop
+        end
       end
     end
   end

data/lib/solana-ruby/keypair.rb

@@ -0,0 +1,105 @@
+require 'rbnacl'
+require 'json'
+require_relative 'utils'
+
+module SolanaRB
+  ##
+  # The Keypair class represents a keypair for signing transactions on the Solana blockchain.
+  #
+  class Keypair
+    attr_reader :public_key, :secret_key
+
+    ##
+    # Initializes a new Keypair.
+    #
+    # If a +secret_key+ is provided, it must be 64 bytes long. The first 32 bytes are used as the signing key,
+    # and the public key is derived from it. If no +secret_key+ is provided, a new keypair is generated.
+    #
+    # Raises an error if the +secret_key+ is not 64 bytes long.
+    #
+    # @param [String, nil] secret_key The secret key to use for the keypair, in binary format (optional).
+    def initialize(secret_key = nil)
+      if secret_key
+        raise 'Bad secret key size' unless secret_key.bytesize == 64
+        @signing_key = RbNaCl::Signatures::Ed25519::SigningKey.new(secret_key[0, 32])
+        @public_key = @signing_key.verify_key.to_bytes
+      else
+        @signing_key = RbNaCl::Signatures::Ed25519::SigningKey.generate
+        @public_key = @signing_key.verify_key.to_bytes
+      end
+      @secret_key = @signing_key.to_bytes + @public_key
+    end
+
+    ##
+    # Generates a new Keypair.
+    #
+    # @return [Keypair] A new Keypair instance.
+    def self.generate
+      new
+    end
+
+    ##
+    # Creates a Keypair from a provided secret key.
+    #
+    # @param [String] secret_key The secret key in binary format.
+    # @return [Keypair] A new Keypair instance initialized with the provided secret key.
+    def self.from_secret_key(secret_key)
+      new(secret_key)
+    end
+
+    ##
+    # Saves the keypair to a JSON file.
+    #
+    # The public and secret keys are encoded in Base58 format before being saved.
+    #
+    # @param [String] file_path The path to the file where the keypair will be saved.
+    def save_to_json(file_path)
+      data = {
+        public_key: Utils::base58_encode(@public_key),
+        secret_key: Utils::base58_encode(@secret_key)
+      }
+      File.write(file_path, data.to_json)
+    end
+
+    ##
+    # Loads a keypair from a JSON file.
+    #
+    # The file must contain the public and secret keys in Base58 format. The method verifies the size of the secret key and
+    # checks that the derived public key matches the saved public key.
+    #
+    # Raises an error if the +secret_key+ is not 64 bytes long or if the derived public key does not match the saved public key.
+    #
+    # @param [String] file_path The path to the file from which the keypair will be loaded.
+    # @return [Keypair] The loaded keypair.
+    def self.load_from_json(file_path)
+      data = JSON.parse(File.read(file_path), symbolize_names: true)
+      secret_key = Utils::base58_decode(data[:secret_key])
+      public_key = Utils::base58_decode(data[:public_key])
+
+      raise 'Bad secret key size' unless secret_key.bytesize == 64
+
+      signing_key = RbNaCl::Signatures::Ed25519::SigningKey.new(secret_key[0, 32])
+      loaded_public_key = signing_key.verify_key.to_bytes
+
+      raise 'Provided secretKey is invalid' unless loaded_public_key == public_key
+
+      new(secret_key)
+    end
+
+    ##
+    # Returns the public key for this keypair in Base58 format.
+    #
+    # @return [String] The public key in Base58 format.
+    def public_key_base58
+      Utils::base58_encode(@public_key)
+    end
+
+    ##
+    # Returns the raw secret key for this keypair in Base58 format.
+    #
+    # @return [String] The secret key in Base58 format.
+    def secret_key_base58
+      Utils::base58_encode(@secret_key)
+    end
+  end
+end

data/lib/solana-ruby/utils.rb

@@ -0,0 +1,107 @@
+require 'base58'
+require 'base64'
+
+module SolanaRB
+  ##
+  # The Utils module provides utility methods and constants for interacting with the Solana blockchain.
+  #
+  module Utils
+    ##
+    # The system program ID for Solana.
+    SYSTEM_PROGRAM_ID = '11111111111111111111111111111111'
+
+    ##
+    # The maximum packet data size for Solana transactions.
+    PACKET_DATA_SIZE = 1232
+
+    ##
+    # Endpoints for the mainnet.
+    module MAINNET
+      ##
+      # HTTP endpoint for the mainnet.
+      HTTP = 'https://api.mainnet-beta.solana.com'
+
+      ##
+      # WebSocket endpoint for the mainnet.
+      WS = 'wss://api.mainnet-beta.solana.com'
+    end
+
+    ##
+    # Endpoints for the testnet.
+    module TESTNET
+      ##
+      # HTTP endpoint for the testnet.
+      HTTP = 'https://api.testnet.solana.com'
+
+      ##
+      # WebSocket endpoint for the testnet.
+      WS = 'wss://api.testnet.solana.com'
+    end
+
+    ##
+    # Endpoints for the devnet.
+    module DEVNET
+      ##
+      # HTTP endpoint for the devnet.
+      HTTP = 'https://api.devnet.solana.com'
+
+      ##
+      # WebSocket endpoint for the devnet.
+      WS = 'wss://api.devnet.solana.com'
+    end
+
+    ##
+    # Instruction types for Solana transactions.
+    module InstructionType
+      CREATE_ACCOUNT = 0
+      ASSIGN = 1
+      TRANSFER = 2
+      CREATE_ACCOUNT_WITH_SEED = 3
+      ADVANCE_NONCE_ACCOUNT = 4
+      WITHDRAW_NONCE_ACCOUNT = 5
+      INITIALIZE_NONCE_ACCOUNT = 6
+      AUTHORIZE_NONCE_ACCOUNT = 7
+      ALLOCATE = 8
+      ALLOCATE_WITH_SEED = 9
+      ASSIGN_WITH_SEED = 10
+      TRANSFER_WITH_SEED = 11
+    end
+
+    ##
+    # Encodes a byte array into a Base58 string.
+    #
+    # @param [String] bytes The byte array to encode.
+    # @return [String] The Base58-encoded string.
+    def self.base58_encode(bytes)
+      Base58.binary_to_base58(bytes, :bitcoin)
+    end
+
+    ##
+    # Decodes a Base58 string into a byte array.
+    #
+    # @param [String] base58 The Base58 string to decode.
+    # @return [String] The decoded byte array.
+    def self.base58_decode(base58)
+      Base58.base58_to_binary(base58, :bitcoin)
+    end
+
+    ##
+    # Encodes a byte array into a Base64 string.
+    #
+    # @param [String] bytes The byte array to encode.
+    # @return [String] The Base64-encoded string.
+    def self.base64_encode(bytes)
+      Base64.strict_encode64(bytes)
+    end
+
+    ##
+    # Decodes a Base64 string into a byte array.
+    #
+    # @param [String] base64 The Base64 string to decode.
+    # @return [String] The decoded byte array.
+    def self.base64_decode(base64)
+      Base64.strict_decode64(base64)
+    end
+  end
+  Utils.freeze
+end

data/lib/solana-ruby/version.rb

@@ -1,3 +1,3 @@
 module SolanaRB
-    VERSION = '0.1.0'.freeze
-end
+    VERSION = '0.1.1'.freeze
+end

data/lib/solana-ruby.rb

@@ -1,5 +1,7 @@
-require_relative 'solana-ruby/version'
 require_relative 'solana-ruby/client'
+require_relative 'solana-ruby/keypair'
+require_relative 'solana-ruby/utils'
+require_relative 'solana-ruby/version'
 
 module SolanaRB
 end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Fabrice Renard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-23 00:00:00.000000000 Z
+date: 2024-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: httparty
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 2.9.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 2.9.2
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.10
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.10
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,76 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: ed25519
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: base58
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.7.0
+- !ruby/object:Gem::Dependency
+  name: rqrcode
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -75,11 +159,14 @@ extra_rdoc_files: []
 files:
 - lib/solana-ruby.rb
 - lib/solana-ruby/client.rb
+- lib/solana-ruby/keypair.rb
+- lib/solana-ruby/utils.rb
 - lib/solana-ruby/version.rb
 homepage: https://github.com/fabricerenard12/solana-ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/fabricerenard12/solana-ruby
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -98,5 +185,5 @@ requirements: []
 rubygems_version: 3.5.9
 signing_key: 
 specification_version: 4
-summary: A Ruby wrapper for the Solana blockchain API
+summary: A Ruby SDK for the Solana blockchain API
 test_files: []