near 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 147f21ee313f56cb2e1327e8817df79796dd56fe90eff771e9057e6d7248c4f5
-  data.tar.gz: bf81f3240cb7e18c519d85696bf472b1bf2c8e56c3049aa942fe2aaae37e38f6
+  metadata.gz: 1d113e40c4ca1414cd8bff319acdaeba7d7cd1a07ebc866ce875afd2080e44b1
+  data.tar.gz: ae7151a4a1022ecf3b9d652ae11bcabfffc427ccaad0cc07858fd662fb91cbd8
 SHA512:
-  metadata.gz: 4cfef8be7777c9dd2f2f839284581a44a0f2479f256f09e759628c21509a6d3bc9b95ad07c7e0e13a2e8c22aa5238bd826a224cdac9c6e649388bd060971569d
-  data.tar.gz: 4c5e69608fe79e7a1e0f7a9046477ea9c590d61d1ee6bf12b530054775fc26464d68ddd29c6c9655f05459faf2752a4c7119e5a29afb17a2500ba115618d0b3d
+  metadata.gz: 779325138cf044d38991e1911d8bf115f8559d86a530bda11e0b97a75367406386b63e81a7e9a3d9db69b70ab826ce146e0b326efdb9e69dcf3545083227c1bb
+  data.tar.gz: f5b55100bc19a9c8d3e6c165e66d7780b94a60ed1fea90bce0523cf77657b384b13c1439c8aabbc4db2b6d2ae5534ef186ad9d7ed82dd2bb3e85ee915f5e1fb0

data/CHANGES.md

@@ -5,6 +5,8 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.3.1 - 2025-02-05
+
 ## 0.3.0 - 2025-02-02
 
 ### Added

data/README.md

@@ -6,12 +6,13 @@
 [![Documentation](https://img.shields.io/badge/rubydoc-latest-blue)](https://rubydoc.info/gems/near)
 
 **NEAR.rb** is a [Ruby] client library for the [NEAR Protocol].
-It provides a [neardata.xyz] API client as well as wraps the
-[NEAR command-line interface] (CLI) in a usable Ruby interface.
+It provides a [neardata.xyz] API client for block data as well as wraps the
+[NEAR Command-Line Interface] (CLI) in a high-productivity Ruby interface.
 
 ## ✨ Features
 
 - Fetches block data from the [neardata.xyz] API.
+- Supports parsing of block, chunk, transaction, and action data.
 - Wraps the complete CLI features in an idiomatic Ruby interface.
 - Provides comprehensive account management operations.
 - Supports token operations for NEAR and other assets.
@@ -25,7 +26,7 @@ It provides a [neardata.xyz] API client as well as wraps the
 
 ## 🛠️ Prerequisites
 
-- [NEAR CLI] 0.19+
+- [NEAR CLI] 0.18+
 - [Ruby] 3.0+
 
 ## ⬇️ Installation
@@ -84,8 +85,6 @@ end
 
 ### Tracking chain transactions
 
-See [`examples/monitor_all_transactions.rb`](examples/monitor_all_transactions.rb).
-
 ```ruby
 NEAR.testnet.fetch_blocks do |block|
   puts block.inspect
@@ -96,9 +95,12 @@ NEAR.testnet.fetch_blocks do |block|
 end
 ```
 
-### Tracking chain actions
+For a more elaborated example, see
+[`examples/monitor_all_transactions.rb`](examples/monitor_all_transactions.rb):
 
-See [`examples/monitor_all_actions.rb`](examples/monitor_all_actions.rb).
+[![monitor_all_transactions.rb](examples/monitor_all_transactions.gif)](examples/monitor_all_transactions.gif)
+
+### Tracking chain actions
 
 ```ruby
 NEAR.testnet.fetch_blocks do |block|
@@ -110,9 +112,12 @@ NEAR.testnet.fetch_blocks do |block|
 end
 ```
 
-### Tracking contract interactions
+For a more elaborated example, see
+[`examples/monitor_all_actions.rb`](examples/monitor_all_actions.rb):
 
-See [`examples/index_evm_transactions.rb`](examples/index_evm_transactions.rb).
+[![monitor_all_actions.rb](examples/monitor_all_actions.gif)](examples/monitor_all_actions.gif)
+
+### Tracking contract interactions
 
 ```ruby
 NEAR.testnet.fetch_blocks do |block|
@@ -124,6 +129,11 @@ NEAR.testnet.fetch_blocks do |block|
 end
 ```
 
+For a more elaborated example, see
+[`examples/index_evm_transactions.rb`](examples/index_evm_transactions.rb):
+
+[![index_evm_transactions.rb](examples/index_evm_transactions.gif)](examples/index_evm_transactions.gif)
+
 ### Instantiating the CLI wrapper
 
 ```ruby
@@ -177,7 +187,7 @@ result = testnet.import_account_with_private_key(
 # Create an account funded from a faucet (testnet only):
 result = testnet.create_account_with_faucet(
   'mynewaccount.testnet',
-  'ed25519:HVPgAsZkZ7cwLZDqK313XJsDyqAvgBxrATcD7VacA8KE'
+  public_key: 'ed25519:HVPgAsZkZ7cwLZDqK313XJsDyqAvgBxrATcD7VacA8KE'
 )
 
 # Create an account funded by another account:
@@ -197,8 +207,8 @@ result = testnet.create_implicit_account('/path/to/credentials/folder')
 ```ruby
 # Delete an existing account:
 result = testnet.delete_account(
-  'todelete.testnet',     # account to delete
-  'beneficiary.testnet'   # account receiving remaining balance
+  'my-obsolete-account.testnet',                # account to delete
+  beneficiary: 'v2.faucet.nonofficial.testnet'  # account receiving remaining balance
 )
 ```
 

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.3.1

data/lib/near/account.rb

@@ -5,10 +5,20 @@
 #
 # @see https://nomicon.io/DataStructures/Account
 class NEAR::Account
+  ##
+  # @param [String, #to_s] id
+  # @return [NEAR::Account]
   def self.parse(id)
     self.new(id.to_s)
   end
 
+  ##
+  # @return [NEAR::Account]
+  def self.temp
+    timestamp = (Time.now.to_f * 1_000).to_i
+    self.new("temp-#{timestamp}.testnet")
+  end
+
   ##
   # @param [String, #to_s] id
   def initialize(id)

data/lib/near/cli/account.rb

@@ -70,15 +70,20 @@ module NEAR::CLI::Account
   ##
   # Creates a new account sponsored by the faucet service.
   #
-  # @param [String] new_account_id
-  # @param [String] public_key
+  # @param [NEAR::Account, #to_s] new_account
+  # @param [String, nil] public_key
   # @return [String]
-  def create_account_with_faucet(new_account_id, public_key)
+  def create_account_with_faucet(new_account, public_key: nil)
     stdout, stderr = execute(
       'account',
       'create-account',
-      'sponsor-by-faucet-service', new_account_id,
-      'use-manually-provided-public-key', public_key,
+      'sponsor-by-faucet-service', new_account.to_s,
+      *case public_key
+        when nil then ['autogenerate-new-keypair', 'save-to-keychain']
+        when String then ['use-manually-provided-public-key', public_key]
+        when Array then public_key
+        else raise ArgumentError
+      end,
       'network-config', @network,
       'create'
     )
@@ -88,16 +93,22 @@ module NEAR::CLI::Account
   ##
   # Creates a new account funded by another account.
   #
-  # @param [NEAR::Account] new_account
-  # @param [NEAR::Account] signer Account that signs & funds the transaction
-  # @param [NEAR::Balance] deposit Amount of NEAR to attach
+  # @param [NEAR::Account, #to_s] new_account
+  # @param [NEAR::Account, #to_s] signer Account that signs & funds the transaction
+  # @param [String, nil] public_key
+  # @param [NEAR::Balance, #to_s] deposit Amount of NEAR to attach
   # @return [String]
-  def create_account_with_funding(new_account, signer:, deposit: nil)
+  def create_account_with_funding(new_account, signer:, public_key: nil, deposit: nil)
     stdout, stderr = execute(
       'account',
       'create-account',
       'fund-myself', new_account.to_s, (deposit ? deposit.to_s : '0') + ' NEAR',
-      'autogenerate-new-keypair', 'save-to-keychain',
+      *case public_key
+        when nil then ['autogenerate-new-keypair', 'save-to-keychain']
+        when String then ['use-manually-provided-public-key', public_key]
+        when Array then public_key
+        else raise ArgumentError
+      end,
       'sign-as', signer.to_s,
       'network-config', @network,
       'sign-with-keychain',

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: near
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Arto Bendiken
 bindir: bin
 cert_chain: []
-date: 2025-02-02 00:00:00.000000000 Z
+date: 2025-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -159,7 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.3
 specification_version: 4
 summary: 'NEAR.rb: NEAR for Ruby'
 test_files: []