solana_rpc_ruby 1.1.4 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2b14096111bbe436c1b308176794fd8430c0cf1a4a4ab2619812631e9789c12
-  data.tar.gz: 1334bb335177b3c3f019ad8a4c73b9c1357700b00ea7e2d326991929cccacf34
+  metadata.gz: 445e4852f291cb7e6d417e3a3277905c7c2935ed40ec9cdca3e1d5f2f599f8ab
+  data.tar.gz: 36f27011567ebd56e0f0b86db2fa93c04e66c55351d0307a014b432a3988f8e5
 SHA512:
-  metadata.gz: 0defe25b84f574253aa26519489e6ca7428958e598fc5c53519d301bcfda229cb7be951afa53f472c9df8242d8b78b3a24f43ff10859dea4bab6d3ce66249169
-  data.tar.gz: 824349620d2471754a063fd8da98e03e8adc34bb984084560763114a91953522d17e7a7363c985e20660ed2b4751c9a47ffa3bb7de57746529233b267871cd2c
+  metadata.gz: 9be80c9efcff01f3324cee479e4262cafd9ca8cc43dfc7d19e6bf537f336428a5bacf124b4d920955c364638fd355e9bdbe33bf425bc458a2d37025bbfbb794e
+  data.tar.gz: 86e7db1d6cdf6b2a5b208b7b5b8fdae6766fbeb5e919ff8dfd23c845c9c8d5105827f4609d10ad01581f0049a1dfbd1c9e9ded0937f621ad7912856837397da2

data/CHANGELOG.md

@@ -25,3 +25,11 @@
 
 ## 1.1.4
 * Removes deprecated constant
+
+## 1.2.0
+* Fix handling commitment param in methods
+* Add RPC and websocket methods added by solana core to RPC recently
+* Add new params to methods added by solana core
+* Add warns to deprecated methods
+* Update docs
+* Small fixes

data/lib/solana_rpc_ruby/methods_wrapper.rb

@@ -29,7 +29,7 @@ module SolanaRpcRuby
     # @param cluster [String] cluster where requests will be sent.
     # @param id [Integer] unique client-generated identifying integer.
     def initialize(
-      api_client: ApiClient, 
+      api_client: ApiClient,
       cluster: SolanaRpcRuby.cluster,
       id: rand(1...99_999)
     )
@@ -40,16 +40,18 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getaccountinfo
+    #
     # Returns all information associated with the account of provided Pubkey
     #
     # @param account_pubkey [String]
     # @param encoding [String]
+    # @param commitment [String]
     # @param data_slice [Hash]
     # @option data_slice [Integer] :offset
     # @option data_slice [Integer] :length
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_account_info(account_pubkey, encoding: '', data_slice: {})
+    def get_account_info(account_pubkey, encoding: '', data_slice: {}, commitment: '')
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -58,6 +60,7 @@ module SolanaRpcRuby
 
       params_hash['encoding'] = encoding unless blank?(encoding)
       params_hash['dataSlice'] = data_slice unless data_slice.empty?
+      params_hash['commitment'] = commitment unless blank?(commitment)
 
       params << account_pubkey
       params << params_hash unless params_hash.empty?
@@ -68,6 +71,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getbalance
+    #
     # Returns the balance of the account of provided Pubkey
     #
     # @param account_pubkey [String]
@@ -94,6 +98,7 @@ module SolanaRpcRuby
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblock
     # NEW: This method is only available in solana-core v1.7 or newer. Please use getConfirmedBlock for solana-core v1.6
+    #
     # Returns identity and transaction information about a confirmed block in the ledger
     #
     # @param slot [Integer]
@@ -124,6 +129,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblockheight
+    #
     # Returns the current block height of the node
     #
     # @param commitment [String]
@@ -145,6 +151,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblockproduction
+    #
     # Returns recent block production information from the current or previous epoch.
     #
     # @param identity [String]
@@ -167,6 +174,7 @@ module SolanaRpcRuby
 
       params_hash['identity'] = identity unless blank?(identity)
       params_hash['range'] = range_hash unless range_hash.empty?
+      params_hash['commitment'] = commitment unless blank?(commitment)
 
       params << params_hash unless params_hash.empty?
 
@@ -176,6 +184,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblockcommitment
+    #
     # Returns commitment for particular block
     #
     # @param block [Integer]
@@ -196,20 +205,25 @@ module SolanaRpcRuby
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblocks
     # NEW: This method is only available in solana-core v1.7 or newer. Please use getConfirmedBlocks for solana-core v1.6
+    #
     # Returns a list of confirmed blocks between two slots
     #
     # @param start_slot [Integer]
     # @param end_slot [Integer]
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_blocks(start_slot, end_slot: nil)
+    def get_blocks(start_slot, end_slot: nil, commitment: nil)
       http_method = :post
       method =  create_method_name(__method__)
 
       params = []
+      params_hash = {}
 
       params << start_slot
       params << end_slot unless end_slot.nil?
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << params_hash unless params_hash.empty?
 
       body = create_json_body(method, method_params: params)
 
@@ -218,6 +232,7 @@ module SolanaRpcRuby
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblockswithlimit
     # NEW: This method is only available in solana-core v1.7 or newer. Please use getConfirmedBlocks for solana-core v1.6
+    #
     # Returns a list of confirmed blocks starting at the given slot
     #
     # @param start_slot [Integer]
@@ -244,6 +259,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getblocktime
+    #
     # Returns the estimated production time of a block.
     #
     # @param block [Integer]
@@ -263,6 +279,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getclusternodes
+    #
     # Returns information about all the nodes participating in the cluster
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
@@ -276,28 +293,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getepochinfo
-    # DEPRECATED: Please use getBlocks instead This method is expected to be removed in solana-core v1.8
-    # Returns a list of confirmed blocks between two slots
     #
-    # @param start_slot [Integer]
-    # @param end_slot [Integer]
-    #
-    # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_confirmed_blocks(start_slot, end_slot: nil)
-      http_method = :post
-      method =  create_method_name(__method__)
-
-      params = []
-
-      params << start_slot
-      params << end_slot unless end_slot.nil? # optional
-
-      body = create_json_body(method, method_params: params)
-
-      send_request(body, http_method)
-    end
-
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getepochinfo
     # Returns information about the current epoch
     #
     # @param commitment [String]
@@ -320,6 +316,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getepochschedule
+    #
     # Returns epoch schedule information from this cluster's genesis config
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
@@ -332,35 +329,37 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfeecalculatorforblockhash
-    # Returns the fee calculator associated with the query blockhash, or null if the blockhash has expired
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfeeformessage
+    # NEW: This method is only available in solana-core v1.9 or newer. Please use getFees for solana-core v1.8
     #
-    # @param query_blockhash [String]
+    # Get the fee the network will charge for a particular Message
+    #
+    # @param message [String]
     # @param commitment [String]
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_fee_calculator_for_blockhash(query_blockhash, commitment: nil)
+    def get_fee_for_message(message, commitment: nil)
       http_method = :post
       method =  create_method_name(__method__)
 
       params = []
       params_hash = {}
 
+      params << message
       params_hash['commitment'] = commitment unless blank?(commitment)
 
-      params << query_blockhash
       params << params_hash unless params_hash.empty?
-
       body = create_json_body(method, method_params: params)
 
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfeerategovernor
-    # Returns the fee rate governor information from the root bank
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfirstavailableblock
+    #
+    # Returns the slot of the lowest confirmed block that has not been purged from the ledger
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_fee_rate_governor
+    def get_first_available_block
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -369,33 +368,12 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfees
-    # Returns a recent block hash from the ledger, a fee schedule that can be used to compute
-    # the cost of submitting a transaction using it, and the last slot in which the blockhash will be valid.
-    #
-    # @param commitment [String]
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getgenesishash
     #
-    # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_fees(commitment: nil)
-      http_method = :post
-      method =  create_method_name(__method__)
-
-      params = []
-      params_hash = {}
-
-      params_hash['commitment'] = commitment unless blank?(commitment)
-      params << params_hash unless params_hash.empty?
-
-      body = create_json_body(method, method_params: params)
-
-      send_request(body, http_method)
-    end
-
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfirstavailableblock
-    # Returns the slot of the lowest confirmed block that has not been purged from the ledger
+    # Returns the genesis hash.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_first_available_block
+    def get_genesis_hash
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -404,11 +382,12 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getgenesishash
-    # Returns the genesis hash.
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#gethealth
+    #
+    # Returns the current health of the node.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_genesis_hash
+    def get_health
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -417,11 +396,15 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#gethealth
-    # Returns the current health of the node.
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#gethighestsnapshotslot
+    #
+    # NEW: This method is only available in solana-core v1.9 or newer. Please use getSnapshotSlot for solana-core v1.8
+    #
+    # Returns the highest slot information that the node has snapshots for.
+    # This will find the highest full snapshot slot, and the highest incremental snapshot slot based on the full snapshot slot, if there is one.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_health
+    def get_highest_snapshot_slot
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -431,6 +414,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getidentity
+    #
     # Returns the identity pubkey for the current node.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
@@ -444,6 +428,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getinflationgovernor
+    #
     # Returns the current inflation governor.
     #
     # @param commitment [String]
@@ -466,6 +451,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getinflationrate
+    #
     # Returns the specific inflation values for the current epoch.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
@@ -479,6 +465,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getinflationreward
+    #
     # Returns the inflation reward for a list of addresses for an epoch.
     #
     # @param addresses [Array]
@@ -506,6 +493,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getlargestaccounts
+    #
     # Returns the 20 largest accounts, by lamport balance (results may be cached up to two hours)
     #
     # @param commitment [String]
@@ -529,7 +517,32 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getlatestblockhash
+    # NEW: This method is only available in solana-core v1.9 or newer. Please use getRecentBlockhash for solana-core v1.8
+    #
+    # Returns the latest blockhash.
+    #
+    # @param commitment [String]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_latest_blockhash(commitment: nil)
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getleaderschedule
+    #
     # Returns the leader schedule for an epoch.
     #
     # @param epoch [Integer]
@@ -556,6 +569,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getmaxretransmitslot
+    #
     # Get the max slot seen from retransmit stage.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
@@ -582,6 +596,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getminimumbalanceforrentexemption
+    #
     # Returns minimum balance required to make account rent exempt.
     #
     # @param account_data_length [String]
@@ -609,12 +624,15 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getmultipleaccounts
+    #
     # Returns the account information for a list of Pubkeys.
-        # @param account_data_length [String]
-    # @param commitment [String]
     #
-    # @return [Response, ApiError] Response when success, ApiError on failure.    # @param account_data_length [String]
+    # @param pubkeys [Array]
     # @param commitment [String]
+    # @param encoding [String]
+    # @param data_slice [Hash]
+    # @option data_slice [Integer] :offset
+    # @option data_slice [Integer] :length
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
     def get_multiple_accounts(
@@ -688,30 +706,8 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getrecentblockhash
-    # Returns a recent block hash from the ledger, and a fee schedule
-    # that can be used to compute the cost of submitting a transaction using it.
-    #
-    # @param commitment [String]
-    #
-    # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_recent_blockhash(commitment: nil)
-      http_method = :post
-      method =  create_method_name(__method__)
-
-      params = []
-      params_hash = {}
-
-      params_hash['commitment'] = commitment unless blank?(commitment)
-
-      params << params_hash unless params_hash.empty?
-
-      body = create_json_body(method, method_params: params)
-
-      send_request(body, http_method)
-    end
-
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getrecentperformancesamples
+    #
     # Returns a list of recent performance samples, in reverse slot order.
     # Performance samples are taken every 60 seconds and include the number of transactions and slots that occur in a given time window.
     #
@@ -731,19 +727,6 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getsnapshotslot
-    # Returns the highest slot that the node has a snapshot for.
-    #
-    # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_snapshot_slot
-      http_method = :post
-      method =  create_method_name(__method__)
-
-      body = create_json_body(method)
-
-      send_request(body, http_method)
-    end
-
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getsignaturesforaddress
     # NEW: This method is only available in solana-core v1.7 or newer.
     # Please use getConfirmedSignaturesForAddress2 for solana-core v1.6
@@ -816,6 +799,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getslot
+    #
     # Returns the current slot the node is processing.
     #
     # @param commitment [String]
@@ -838,6 +822,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getslotleader
+    #
     # Returns the current slot leader
     #
     # @param commitment [String]
@@ -860,6 +845,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getslotleaders
+    #
     # Returns the slot leaders for a given slot range.
     #
     # @param start_slot [Integer]
@@ -878,6 +864,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getstakeactivation
+    #
     # Returns epoch activation information for a stake account.
     #
     # @param pubkey [String]
@@ -904,12 +891,14 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getsupply
+    #
     # Returns information about the current supply.
     #
     # @param commitment [String]
+    # @param exclude_non_circulating_accounts_list [Boolean]
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_supply(commitment: nil)
+    def get_supply(commitment: nil, exclude_non_circulating_accounts_list: nil)
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -917,6 +906,8 @@ module SolanaRpcRuby
       params_hash = {}
 
       params_hash['commitment'] = commitment unless blank?(commitment)
+      params_hash['exclude_non_circulating_accounts_list'] = exclude_non_circulating_accounts_list \
+        unless exclude_non_circulating_accounts_list.nil?
 
       params << params_hash unless params_hash.empty?
 
@@ -1080,6 +1071,35 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#gettokensupply
+    #
+    # Returns the total supply of an SPL Token type.
+    #
+    # @param token_mint_pubkey [String]
+    # @param commitment [String]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_token_supply(
+      token_mint_pubkey,
+      commitment: nil
+    )
+
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << token_mint_pubkey
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#gettransaction
     #
     # Returns transaction details for a confirmed transaction
@@ -1145,13 +1165,21 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#getvoteaccounts
+    #
     # Returns the account info and associated stake for all the voting accounts in the current bank.
     #
     # @param commitment [String]
     # @param vote_pubkey [String]
+    # @param keep_unstaked_delinquents [Boolean]
+    # @param delinquent_slot_distance [Integer] NOTE: For the sake of consistency between ecosystem products, it is not recommended that this argument be specified.
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_vote_accounts(commitment: nil, vote_pubkey: nil)
+    def get_vote_accounts(
+      commitment: nil,
+      vote_pubkey: nil,
+      keep_unstaked_delinquents: nil,
+      delinquent_slot_distance: nil
+    )
       http_method = :post
       method =  create_method_name(__method__)
 
@@ -1160,6 +1188,8 @@ module SolanaRpcRuby
 
       params_hash['votePubkey'] = vote_pubkey unless blank?(vote_pubkey)
       params_hash['commitment'] = commitment unless blank?(commitment)
+      params_hash['keep_unstaked_delinquents'] = keep_unstaked_delinquents unless keep_unstaked_delinquents.nil?
+      params_hash['delinquent_slot_distance'] = delinquent_slot_distance unless blank?(delinquent_slot_distance)
 
       params << params_hash unless params_hash.empty?
 
@@ -1168,16 +1198,28 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
-    # @see https://docs.solana.com/developing/clients/jsonrpc-api#minimumledgerslot
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#isblockhashvalid
+    # NEW: This method is only available in solana-core v1.9 or newer. Please use getFeeCalculatorForBlockhash for solana-core v1.8
     #
-    # Returns the current solana versions running on the node.
+    # Returns whether a blockhash is still valid or not.
+    #
+    # @param blockhash [String]
+    # @param commitment [String]
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
-    def get_version
+    def is_blockhash_valid(blockhash, commitment: nil)
       http_method = :post
       method =  create_method_name(__method__)
 
-      body = create_json_body(method)
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << blockhash
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
 
       send_request(body, http_method)
     end
@@ -1212,6 +1254,7 @@ module SolanaRpcRuby
 
       params = []
       params_hash = {}
+      params_hash['commitment'] = commitment unless blank?(commitment)
 
       params << pubkey
       params << lamports
@@ -1230,13 +1273,15 @@ module SolanaRpcRuby
     # @param skip_pre_flight [Boolean]
     # @param pre_flight_commitment [String]
     # @param encoding [String]
+    # @param max_retries [Integer]
     #
     # @return [Response, ApiError] Response when success, ApiError on failure.
     def send_transaction(
           transaction_signature,
           skip_pre_flight: false,
           pre_flight_commitment: nil,
-          encoding: ''
+          encoding: '',
+          max_retries: nil
         )
       http_method = :post
       method =  create_method_name(__method__)
@@ -1247,6 +1292,7 @@ module SolanaRpcRuby
       params_hash['skipPreFlight'] = skip_pre_flight unless skip_pre_flight.nil?
       params_hash['preflightCommitment'] = pre_flight_commitment unless blank?(pre_flight_commitment)
       params_hash['encoding'] = encoding unless blank?(encoding)
+      params_hash['max_retries'] = max_retries unless blank?(max_retries)
 
       params << transaction_signature
       params << params_hash unless params_hash.empty?
@@ -1306,7 +1352,155 @@ module SolanaRpcRuby
       send_request(body, http_method)
     end
 
+
+    ######## DEPRECATED METHODS #########
+
+    # @deprecated Please use getBlocks instead This method is expected to be removed in solana-core v1.8
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getepochinfo
+    #
+    # Returns a list of confirmed blocks between two slots
+    #
+    # @param start_slot [Integer]
+    # @param end_slot [Integer]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_confirmed_blocks(start_slot, end_slot: nil)
+      warn 'DEPRECATED: Please use getBlocks instead. This method is expected to be removed in solana-core v1.8'
+
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+
+      params << start_slot
+      params << end_slot unless end_slot.nil? # optional
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
+    # @deprecated Please use isBlockhashValid or getFeeForMessage instead This method is expected to be removed in solana-core v2.0
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfeecalculatorforblockhash
+    #
+    # Returns the fee calculator associated with the query blockhash, or null if the blockhash has expired
+    #
+    # @param query_blockhash [String]
+    # @param commitment [String]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_fee_calculator_for_blockhash(query_blockhash, commitment: nil)
+      warn "DEPRECATED: Please use isBlockhashValid or getFeeForMessage instead. This method is expected to be removed in solana-core v2.0"
+
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << query_blockhash
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
+    # @deprecated Please check solana docs for substitution.
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfeerategovernor
+    #
+    # Returns the fee rate governor information from the root bank
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_fee_rate_governor
+      warn "DEPRECATED Please check solana docs for substitution."
+
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      body = create_json_body(method)
+
+      send_request(body, http_method)
+    end
+
+    # @deprecated DEPRECATED: Please use getFeeForMessage instead This method is expected to be removed in solana-core v2.0
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getfees
+    #
+    # Returns a recent block hash from the ledger, a fee schedule that can be used to compute
+    # the cost of submitting a transaction using it, and the last slot in which the blockhash will be valid.
+    #
+    # @param commitment [String]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_fees(commitment: nil)
+      warn "DEPRECATED: Please use getFeeForMessage instead This method is expected to be removed in solana-core v2.0"
+
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
+    # @depreated Please use getFeeForMessage instead This method is expected to be removed in solana-core v2.0
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getrecentblockhash
+    #
+    # Returns a recent block hash from the ledger, and a fee schedule
+    # that can be used to compute the cost of submitting a transaction using it.
+    #
+    # @param commitment [String]
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_recent_blockhash(commitment: nil)
+      warn "DEPRECATED: Please use getFeeForMessage instead This method is expected to be removed in solana-core v2.0"
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      params = []
+      params_hash = {}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+
+      params << params_hash unless params_hash.empty?
+
+      body = create_json_body(method, method_params: params)
+
+      send_request(body, http_method)
+    end
+
+    # @deprecated Please use getHighestSnapshotSlot instead This method is expected to be removed in solana-core v2.0
+    #
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#getsnapshotslot
+    #
+    # Returns the highest slot that the node has a snapshot for.
+    #
+    # @return [Response, ApiError] Response when success, ApiError on failure.
+    def get_snapshot_slot
+      warn "DEPRECATED: Please use getHighestSnapshotSlot instead This method is expected to be removed in solana-core v2.0"
+      http_method = :post
+      method =  create_method_name(__method__)
+
+      body = create_json_body(method)
+
+      send_request(body, http_method)
+    end
+
     private
+
     def send_request(body, http_method)
       api_response = api_client.call_api(
         body: body,

data/lib/solana_rpc_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolanaRpcRuby
-  VERSION = '1.1.4'
+  VERSION = '1.2.0'
 end

data/lib/solana_rpc_ruby/websocket_methods_wrapper.rb

@@ -29,7 +29,7 @@ module SolanaRpcRuby
     # @param cluster [String] cluster where requests will be sent.
     # @param id [Integer] unique client-generated identifying integer.
     def initialize(
-      websocket_client: WebsocketClient, 
+      websocket_client: WebsocketClient,
       cluster: SolanaRpcRuby.ws_cluster,
       id: rand(1...99_999)
     )
@@ -47,7 +47,7 @@ module SolanaRpcRuby
     #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def account_subscribe(account_pubkey, commitment: nil, encoding: '', &block)
-      method = create_method_name(__method__) 
+      method = create_method_name(__method__)
 
       params = []
       params_hash = {}
@@ -56,7 +56,7 @@ module SolanaRpcRuby
 
       params << account_pubkey
       params << params_hash if params_hash.any?
-      
+
       subscribe(method, method_params: params, &block)
     end
 
@@ -71,6 +71,57 @@ module SolanaRpcRuby
       unsubscribe(method, subscription_id: subscription_id)
     end
 
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#blocksubscribe---unstable-disabled-by-default
+    # This subscription is unstable and only available if the validator was started with the --rpc-pubsub-enable-block-subscription flag. The format of this subscription may change in the future
+    #
+    # Subscribe to receive notification anytime a new block is Confirmed or Finalized.
+    #
+    # @param filter [String] # 'all' or public key as base-58 endcoded string
+    # @param commitment [String]
+    # @param encoding [String]
+    # @param transaction_details [String]
+    # @param show_rewards [Boolean]
+    # @param &block [Proc]
+    #
+    # @return [Integer] Subscription id (needed to unsubscribe)
+    def block_subscribe(
+      filter,
+      commitment: nil,
+      encoding: '',
+      transaction_details: '',
+      show_rewards: nil,
+      &block
+    )
+      method = create_method_name(__method__)
+
+      params = []
+      param_filter = nil
+      params_hash = {}
+
+      param_filter = filter == 'all' ? filter : { 'mentionsAccountOrProgram': filter}
+
+      params_hash['commitment'] = commitment unless blank?(commitment)
+      params_hash['encoding'] = encoding unless blank?(encoding)
+      params_hash['transactionDetails'] = transaction_details unless blank?(transaction_details)
+      params_hash['showRewards'] = show_rewards unless blank?(show_rewards)
+
+      params << param_filter
+      params << params_hash if params_hash.any?
+
+      subscribe(method, method_params: params, &block)
+    end
+
+    # @see https://docs.solana.com/developing/clients/jsonrpc-api#blockunsubscribe
+    # Unsubscribe from block notifications
+    #
+    # @param subscription_id [Integer]
+    #
+    # @return [Bool] unsubscribe success message
+    def block_unsubscribe(subscription_id)
+      method = create_method_name(__method__)
+      unsubscribe(method, subscription_id: subscription_id)
+    end
+
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#logssubscribe
     # Subscribe to transaction logging
     #
@@ -81,15 +132,15 @@ module SolanaRpcRuby
     #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def logs_subscribe(filter, commitment: nil, &block)
-      method = create_method_name(__method__) 
+      method = create_method_name(__method__)
 
       params = []
       params_hash = {}
       params_hash['commitment'] = commitment unless blank?(commitment)
-  
+
       params << filter
       params << params_hash
-      
+
       subscribe(method, method_params: params, &block)
     end
 
@@ -107,7 +158,7 @@ module SolanaRpcRuby
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#programsubscribe
     # Subscribe to a program to receive notifications when the lamports or data for a given account owned by the program changes
-    # 
+    #
     # @param account_pubkey [String]
     # @param commitment [String]
     # @param encoding [String]
@@ -116,13 +167,13 @@ module SolanaRpcRuby
     #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def program_subscribe(
-      program_id_pubkey, 
-      commitment: nil, 
-      encoding: '', 
+      program_id_pubkey,
+      commitment: nil,
+      encoding: '',
       filters: [],
       &block
     )
-      method = create_method_name(__method__) 
+      method = create_method_name(__method__)
 
       params = []
       params_hash = {}
@@ -132,7 +183,7 @@ module SolanaRpcRuby
 
       params << program_id_pubkey
       params << params_hash if params_hash.any?
-      
+
       subscribe(method, method_params: params, &block)
     end
 
@@ -149,7 +200,7 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#signaturesubscribe
-    # Subscribe to a transaction signature to receive notification when the transaction is confirmed 
+    # Subscribe to a transaction signature to receive notification when the transaction is confirmed
     # On signatureNotification, the subscription is automatically cancelled
     #
     # @param transaction_signature [String]
@@ -158,19 +209,19 @@ module SolanaRpcRuby
     #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def signature_subscribe(
-      transaction_signature, 
+      transaction_signature,
       commitment: nil,
       &block
     )
-      method = create_method_name(__method__) 
+      method = create_method_name(__method__)
 
       params = []
       params_hash = {}
       params_hash['commitment'] = commitment unless blank?(commitment)
-  
+
       params << transaction_signature
       params << params_hash
-      
+
       subscribe(method, method_params: params, &block)
     end
 
@@ -189,11 +240,11 @@ module SolanaRpcRuby
     # Subscribe to receive notification anytime a slot is processed by the validator
     #
     # @param &block [Proc]
-    # 
+    #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def slot_subscribe(&block)
       method = create_method_name(__method__)
-      
+
       subscribe(method, &block)
     end
 
@@ -209,16 +260,16 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#slotsupdatessubscribe---unstable
-    # 
+    #
     # This subscription is unstable; the format of this subscription may change in the future and it may not always be supported
     # Subscribe to receive a notification from the validator on a variety of updates on every slot
     #
     # @param &block [Proc]
-    # 
+    #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def slots_updates_subscribe(&block)
       method = create_method_name(__method__)
-      
+
       subscribe(method, &block)
     end
 
@@ -234,15 +285,15 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#rootsubscribe
-    # 
+    #
     # Subscribe to receive notification anytime a new root is set by the validator.
     #
     # @param &block [Proc]
-    # 
+    #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def root_subscribe(&block)
       method = create_method_name(__method__)
-      
+
       subscribe(method, &block)
     end
 
@@ -258,19 +309,19 @@ module SolanaRpcRuby
     end
 
     # @see https://docs.solana.com/developing/clients/jsonrpc-api#votesubscribe---unstable-disabled-by-default
-    # 
-    # This subscription is unstable and only available if the validator was started with the --rpc-pubsub-enable-vote-subscription flag. 
+    #
+    # This subscription is unstable and only available if the validator was started with the --rpc-pubsub-enable-vote-subscription flag.
     # The format of this subscription may change in the future
-    # 
-    # Subscribe to receive notification anytime a new vote is observed in gossip. 
+    #
+    # Subscribe to receive notification anytime a new vote is observed in gossip.
     # These votes are pre-consensus therefore there is no guarantee these votes will enter the ledger.
     #
     # @param &block [Proc]
-    # 
+    #
     # @return [Integer] Subscription id (needed to unsubscribe)
     def vote_subscribe(&block)
       method = create_method_name(__method__)
-      
+
       subscribe(method, &block)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solana_rpc_ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.2.0
 platform: ruby
 authors:
 - Block Logic Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-15 00:00:00.000000000 Z
+date: 2022-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faye-websocket
@@ -256,7 +256,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
+rubygems_version: 3.2.2
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for solana JSON RPC API.