solana-ruby-web3js 1.0.1.beta2 → 1.0.1.beta3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4523cc4b31deed37187c1f16585843ad9cb30fb65fa6e1ffd623f40a77cba0b
-  data.tar.gz: 95b7f14f5202f681d19e8ce09c466660d583fd84a4fb82213b77c1eff633164e
+  metadata.gz: 769dd8aff42953255243d337b811ab9bd61e27e19e6957d235e9e015300f925b
+  data.tar.gz: e940aa048c15af34c5f06bf5de1db3716e8f68f1f83c41fe480a6de748082310
 SHA512:
-  metadata.gz: f5e042632802df702a40a514f7fae3d0c2c5d3d3d6cbe563e94f5a8d5b8be2e9bb8b61b0da2cec398f3c9d9f71247162f281e31770d2559d41a9ed85596142eb
-  data.tar.gz: be74a999f1eebc3eb4cded2b4d594aa9a90dca57589af40ce360636efe3cb150317e948ab8b9f95eba8485846a56dde9405d65465615e34ad5c246da8c84e90e
+  metadata.gz: 7cd8eb6a1ff5a1c749cb1ded759323bd1a7a43dea78e6d19444f1d1e8dc77ca24f757c5fc53412431020f09960db0cef8f2bd519641a0bdc5790c4dc8e60a581
+  data.tar.gz: d6c68d6c97ae798d5b79b4fcaae962ac3e34e7e2d28d61b80124b4725b3926803c49f20bd055bc7c6af9b46229558111a3ea0dae932d15750f726484a0c6b460

data/README.md

@@ -67,33 +67,86 @@ For a more detailed overview of Solana's available RPC methods, visit the offici
 
 ### Options Parameter
 
-The options parameter is a hash that can include the following fields:
+The options parameter is a hash that can include the following fields and more, allowing for customized responses:
 
-commitment: Specifies the level of commitment desired when querying state.
+- **commitment**: Specifies the level of commitment desired when querying state. Options include:
 
-Options include:
+    - 'finalized': Query the most recent block confirmed by supermajority of the cluster.
+    - 'confirmed': Query the most recent block that has been voted on by supermajority of the cluster.
+    - 'processed': Query the most recent block regardless of cluster voting.
 
-    'finalized': Query the most recent block confirmed by supermajority of the cluster.
-    'confirmed': Query the most recent block that has been voted on by supermajority of the cluster.
-    'processed': Query the most recent block regardless of cluster voting.
+- **encoding**: Defines the format of the returned account data. Possible values include:
 
-encoding: Defines the format of the returned account data. Possible values include:
+    - 'jsonParsed': Returns data in a JSON-parsed format.
+    - 'base64': Returns raw account data in Base64 encoding.
+    - 'base64+zstd': Returns compressed Base64 data.
 
-    'jsonParsed': Returns data in a JSON-parsed format.
-    'base64': Returns raw account data in Base64 encoding.
-    'base64+zstd': Returns compressed Base64 data.
+- **epoch**: Specify the epoch when querying for certain information like epoch details.
+
+- **skipPreflight**: If true, skip the preflight transaction verification. Preflight ensures that a transaction is valid before sending it to the network, but skipping this can result in faster submission.
+
+- **maxRetries**: Specify how many times to retry sending a transaction before giving up.
+
+- **recentBlockhash**: Provide a custom recent blockhash for a transaction if not relying on the default.
 
 By providing options, you can control the nature of the returned data and the reliability of the query.
 
 ### Filters Parameter
 
-The filters parameter allows you to specify conditions for querying token accounts. Some common filter types include:
+The filters parameter allows you to specify conditions when querying accounts and other resources. Here are some common filters:
+
+#### Token Accounts by Owner
+
+    # Replace 'owner_pubkey' with the owner's public key
+    owner_pubkey = 'Fg6PaFpoGXkYsidMpWxTWqSKJf6KJkUxX92cnv7WMd2J'
+    
+    # Query for token accounts owned by this public key
+    filters = [{ mint: 'TokenMintPublicKey' }]
+    
+    result = client.get_token_accounts_by_owner(owner_pubkey, filters)
+    
+    puts result
+
+#### Account Filters
+
+You can use the filters parameter to apply conditions for certain queries, such as fetching token accounts by a specific owner or a specific token program. Below are examples of filters that can be used in different queries.
+
+#### Mint Filter
+
+- Filter accounts by a specific token mint.
+
+    ``filters = [{ mint: 'TokenMintPublicKey' }]``
+
+    ``result = client.get_token_accounts_by_owner(owner_pubkey, filters)``
+
+#### Program Filter
+
+- Filter accounts associated with a particular program, such as the token program.
+
+    ``filters = [{ programId: 'TokenProgramPublicKey' }]``
+
+    ``result = client.get_token_accounts_by_owner(owner_pubkey, filters)``
+
+#### Data Size Filter
+
+- Filter accounts by the exact size of the account data.
+
+    ``filters = [{ dataSize: 165 }]``
+
+    ``result = client.get_program_accounts('ProgramPublicKey', filters)``
+
+#### Memcmp Filter
+
+- Filter by matching a specific slice of bytes at a given offset in account data.
 
-    # Mint Filter: Filter by a specific token mint. This retrieves accounts holding tokens of that mint.
-    filters = { mint: 'TokenMintPublicKey' }
+    ``filters = [{
+            memcmp: {
+                offset: 0,
+                bytes: 'Base58EncodedBytes'
+            }
+        }]``
 
-    # Program Filter: Filter by a specific program (e.g., the token program).
-    filters = { programId: 'TokenProgramPublicKey' }
+    ``result = client.get_program_accounts('ProgramPublicKey', filters)``
 
 ## WebSocket Methods
 

data/lib/solana_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolanaRuby
-  VERSION = "1.0.1.beta2"
+  VERSION = "1.0.1.beta3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby-web3js
 version: !ruby/object:Gem::Version
-  version: 1.0.1.beta2
+  version: 1.0.1.beta3
 platform: ruby
 authors:
 - BuildSquad