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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4347561fb0649ad1967e7900b9b0d918324d0b54d41c151073e179ffc062efbc
-  data.tar.gz: 777a7663b8c1c8f986748bcd2ef2e4b18a57244d4b14c3734ea5385f35d640b4
+  metadata.gz: 769dd8aff42953255243d337b811ab9bd61e27e19e6957d235e9e015300f925b
+  data.tar.gz: e940aa048c15af34c5f06bf5de1db3716e8f68f1f83c41fe480a6de748082310
 SHA512:
-  metadata.gz: d70fbb66c1467ca8c0d913072c1085ca231515a7b9dc0ee918dd5ab4976f42a7513534566bc70485e3a3103d9faa31573161a171cbd528d859192ff1700974cc
-  data.tar.gz: a82cfa020893598eda4e95faef76b50a10eb3df871020997ac7ac2fb50f36e53625cc9f9550907331d2e086992a38edd2f049535e6aa1916edee1e4fd51cdabc
+  metadata.gz: 7cd8eb6a1ff5a1c749cb1ded759323bd1a7a43dea78e6d19444f1d1e8dc77ca24f757c5fc53412431020f09960db0cef8f2bd519641a0bdc5790c4dc8e60a581
+  data.tar.gz: d6c68d6c97ae798d5b79b4fcaae962ac3e34e7e2d28d61b80124b4725b3926803c49f20bd055bc7c6af9b46229558111a3ea0dae932d15750f726484a0c6b460

data/Gemfile

@@ -4,14 +4,3 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in solana.gemspec
 gemspec
-
-gem "rake", "~> 13.0"
-
-gem "rubocop", "~> 1.21"
-
-group :development, :test do
-  gem 'rspec'
-  gem 'webmock'
-  gem 'simplecov', require: false
-  gem 'ed25519'
-end

data/Gemfile.lock

@@ -1,11 +1,9 @@
 PATH
   remote: .
   specs:
-    solana_ruby (2.0.0)
-      brakeman (~> 6.1.2)
-      pry (~> 0.14.2)
-      rubycritic (~> 4.9.0)
-      simplecov (~> 0.22.0)
+    solana-ruby-web3js (1.0.1.beta1)
+      base58 (~> 0.2.3)
+      base64 (~> 0.2.0)
       websocket-client-simple (~> 0.8.0)
 
 GEM
@@ -18,14 +16,17 @@ GEM
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
+    base58 (0.2.3)
+    base64 (0.2.0)
     bigdecimal (3.1.8)
     brakeman (6.1.2)
       racc
-    childprocess (5.0.0)
+    childprocess (5.1.0)
+      logger (~> 1.5)
     coderay (1.1.3)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.3.3)
+    concurrent-ruby (1.3.4)
     crack (1.0.0)
       bigdecimal
       rexml
@@ -79,19 +80,19 @@ GEM
     launchy (3.0.1)
       addressable (~> 2.8)
       childprocess (~> 5.0)
+    logger (1.6.1)
     method_source (1.1.0)
     parallel (1.25.1)
     parser (3.3.4.0)
       ast (~> 2.4.1)
       racc
-    path_expander (1.1.2)
+    path_expander (1.1.3)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     public_suffix (6.0.1)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
     reek (6.3.0)
       dry-schema (~> 1.13.0)
       parser (~> 3.3.0)
@@ -165,20 +166,24 @@ GEM
     websocket-client-simple (0.8.0)
       event_emitter
       websocket
-    zeitwerk (2.6.17)
+    yard (0.9.37)
+    zeitwerk (2.6.18)
 
 PLATFORMS
   arm64-darwin-23
   ruby
 
 DEPENDENCIES
+  brakeman (~> 6.1.2)
   ed25519
-  rake (~> 13.0)
+  pry (~> 0.14.2)
   rspec
   rubocop (~> 1.21)
-  simplecov
-  solana_ruby!
+  rubycritic (~> 4.9.0)
+  simplecov (~> 0.22.0)
+  solana-ruby-web3js!
   webmock
+  yard
 
 BUNDLED WITH
    2.5.16

data/README.md

@@ -57,35 +57,96 @@ Once the client is initialized, you can make API calls to the Solana network. Fo
 
     puts result
 
+### More Information on Solana Methods
+
+For a more detailed overview of Solana's available RPC methods, visit the official documentation:
+
+- [Solana HTTP RPC Methods](https://solana.com/docs/rpc/http)
+- [Solana WebSocket RPC Methods](https://solana.com/docs/rpc/websocket)
+- [Solana web3.js Connection Methods](https://solana-labs.github.io/solana-web3.js/classes/Connection.html)
+
 ### 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. Options include:
 
-commitment: Specifies the level of commitment desired when querying state.
+    - '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.
 
-Options include:
+- **encoding**: Defines the format of the returned account data. Possible values 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.
+    - 'jsonParsed': Returns data in a JSON-parsed format.
+    - 'base64': Returns raw account data in Base64 encoding.
+    - 'base64+zstd': Returns compressed Base64 data.
 
-encoding: Defines the format of the returned account data. Possible values include:
+- **epoch**: Specify the epoch when querying for certain information like epoch details.
 
-    'jsonParsed': Returns data in a JSON-parsed format.
-    'base64': Returns raw account data in Base64 encoding.
-    'base64+zstd': Returns compressed Base64 data.
+- **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.beta1"
+  VERSION = "1.0.1.beta3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solana-ruby-web3js
 version: !ruby/object:Gem::Version
-  version: 1.0.1.beta1
+  version: 1.0.1.beta3
 platform: ruby
 authors:
 - BuildSquad
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-01 00:00:00.000000000 Z
+date: 2024-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: websocket-client-simple
@@ -52,6 +52,118 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: brakeman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.2
+- !ruby/object:Gem::Dependency
+  name: rubycritic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.9.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.2
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ed25519
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement