eth 0.5.14 → 0.5.16

data/lib/eth/tx/legacy.rb

@@ -68,7 +68,7 @@ module Eth
       # @option params [Integer] :gas_price the gas price.
       # @option params [Integer] :gas_limit the gas limit.
       # @option params [Eth::Address] :from the sender address.
-      # @option params [Eth::Address] :to the reciever address.
+      # @option params [Eth::Address] :to the receiver address.
       # @option params [Integer] :value the transaction value.
       # @option params [String] :data the transaction data payload.
       # @param chain_id [Integer] the EIP-155 Chain ID.
@@ -128,18 +128,18 @@ module Eth
         raise ParameterError, "Transaction missing fields!" if tx.size < 9
 
         # populate the 9 fields
-        nonce = Util.deserialize_big_endian_to_int tx[0]
-        gas_price = Util.deserialize_big_endian_to_int tx[1]
-        gas_limit = Util.deserialize_big_endian_to_int tx[2]
+        nonce = Util.deserialize_rlp_int tx[0]
+        gas_price = Util.deserialize_rlp_int tx[1]
+        gas_limit = Util.deserialize_rlp_int tx[2]
         to = Util.bin_to_hex tx[3]
-        value = Util.deserialize_big_endian_to_int tx[4]
+        value = Util.deserialize_rlp_int tx[4]
         data = tx[5]
         v = Util.bin_to_hex tx[6]
         r = Util.bin_to_hex tx[7]
         s = Util.bin_to_hex tx[8]
 
         # try to recover the chain id from v
-        chain_id = Chain.to_chain_id Util.deserialize_big_endian_to_int tx[6]
+        chain_id = Chain.to_chain_id Util.deserialize_rlp_int tx[6]
 
         # populate class attributes
         @signer_nonce = nonce.to_i
@@ -223,6 +223,30 @@ module Eth
         return hash
       end
 
+      # Signs the transaction with a provided signature blob.
+      #
+      # @param signature [String] the concatenated `r`, `s`, and `v` values.
+      # @return [String] a transaction hash.
+      # @raise [Signature::SignatureError] if transaction is already signed.
+      # @raise [Signature::SignatureError] if sender address does not match signer.
+      def sign_with(signature)
+        if Tx.signed? self
+          raise Signature::SignatureError, "Transaction is already signed!"
+        end
+
+        # ensure the sender address matches the signature
+        unless @sender.nil? or sender.empty?
+          public_key = Signature.recover(unsigned_hash, signature, @chain_id)
+          signer_address = Tx.sanitize_address Util.public_key_to_address(public_key).to_s
+          from_address = Tx.sanitize_address @sender
+          raise Signature::SignatureError, "Signer does not match sender" unless signer_address == from_address
+        end
+
+        r, s, v = Signature.dissect signature
+        send :_set_signature, v, r, s
+        return hash
+      end
+
       # Encodes a raw transaction object.
       #
       # @return [String] a raw, RLP-encoded legacy transaction.

data/lib/eth/tx.rb

@@ -17,6 +17,7 @@ require "konstructor"
 require "eth/chain"
 require "eth/tx/eip1559"
 require "eth/tx/eip2930"
+require "eth/tx/eip4844"
 require "eth/tx/eip7702"
 require "eth/tx/legacy"
 require "eth/unit"
@@ -87,6 +88,8 @@ module Eth
 
     # Creates a new transaction of any type for given parameters and chain ID.
     # Required parameters are (optional in brackets):
+    # - EIP-4844: chain_id, nonce, priority_fee, max_gas_fee, gas_limit, max_fee_per_blob_gas, blob_versioned_hashes(, from, to,
+    #   value, data, access_list)
     # - EIP-1559: chain_id, nonce, priority_fee, max_gas_fee, gas_limit(, from, to,
     #   value, data, access_list)
     # - EIP-2930: chain_id, nonce, gas_price, gas_limit, access_list(, from, to,
@@ -99,9 +102,10 @@ module Eth
     # @param chain_id [Integer] the EIP-155 Chain ID (legacy transactions only).
     def new(params, chain_id = Chain::ETHEREUM)
 
-      # if we deal with blobs, attempt EIP-4844 (not implemented)
+      # if we deal with blobs, attempt EIP-4844
       unless params[:max_fee_per_blob_gas].nil?
-        raise NotimplementedError, "EIP-4844 blob transactions are not implemented"
+        params[:chain_id] = chain_id if params[:chain_id].nil?
+        return Tx::Eip4844.new params
       end
 
       # if we deal with authorizations, attempt EIP-7702
@@ -148,7 +152,7 @@ module Eth
       when TYPE_4844
 
         # EIP-4844 transaction (type 3)
-        raise NotimplementedError, "EIP-4844 blob transactions are not implemented"
+        return Tx::Eip4844.decode hex
       when TYPE_7702
 
         # EIP-7702 transaction (type 4)
@@ -182,7 +186,7 @@ module Eth
       when TYPE_4844
 
         # EIP-4844 transaction (type 3)
-        raise NotimplementedError, "EIP-4844 blob transactions are not implemented"
+        return Tx::Eip4844.unsigned_copy tx
       when TYPE_7702
 
         # EIP-7702 transaction (type 4)
@@ -278,6 +282,27 @@ module Eth
       return fields
     end
 
+    # Validates that the type-3 transaction blob fields are present
+    #
+    # @param fields [Hash] the transaction fields.
+    # @return [Hash] the validated transaction fields.
+    # @raise [ParameterError] if max blob fee or blob hashes are invalid or exceed limits.
+    def validate_eip4844_params(fields)
+      if fields[:max_fee_per_blob_gas].nil? or fields[:max_fee_per_blob_gas] < 0
+        raise ParameterError, "Invalid max blob fee #{fields[:max_fee_per_blob_gas]}!"
+      end
+      if fields[:blob_versioned_hashes].nil? or !fields[:blob_versioned_hashes].is_a? Array or fields[:blob_versioned_hashes].empty?
+        raise ParameterError, "Invalid blob versioned hashes #{fields[:blob_versioned_hashes]}!"
+      end
+      if fields[:blob_versioned_hashes].length > Eip4844::MAX_BLOBS_PER_BLOCK
+        raise ParameterError, "Too many blob versioned hashes #{fields[:blob_versioned_hashes].length}!"
+      end
+      if fields[:to].nil? or fields[:to].empty?
+        raise ParameterError, "Invalid destination address #{fields[:to]}!"
+      end
+      return fields
+    end
+
     # Validates that the type-4 transaction field authorization list is present
     #
     # @param fields [Hash] the transaction fields.
@@ -372,6 +397,22 @@ module Eth
       return list
     end
 
+    # Populates the blob versioned hashes field with a serializable empty
+    # array in case it is undefined; also ensures the hashes are binary
+    # not hex.
+    #
+    # @param list [Array] the blob versioned hashes.
+    # @return [Array] the sanitized blob versioned hashes.
+    def sanitize_hashes(list)
+      list = [] if list.nil?
+      list.each_with_index do |value, index|
+        if Util.hex? value
+          list[index] = Util.hex_to_bin value
+        end
+      end
+      return list
+    end
+
     # Allows to check wether a transaction is signed already.
     #
     # @return [Bool] true if transaction is already signed.

data/lib/eth/util.rb

@@ -72,8 +72,7 @@ module Eth
     # @param hex [String] a hex-string to be prefixed.
     # @return [String] a prefixed hex-string.
     def prefix_hex(hex)
-      return hex if prefixed? hex
-      return "0x#{hex}"
+      "0x#{remove_hex_prefix hex}"
     end
 
     # Removes the `0x` prefix of a hexa-decimal string.
@@ -93,12 +92,12 @@ module Eth
       prefix_hex bin_to_hex bin
     end
 
-    # Checks if a string is hex-adecimal.
+    # Checks if a string is hexadecimal.
     #
     # @param str [String] a string to be checked.
-    # @return [String] a match if true; `nil` if not.
+    # @return [MatchData, nil] a match if true; `nil` if not.
     def hex?(str)
-      return false unless str.is_a? String
+      return unless str.is_a? String
       str = remove_hex_prefix str
       str.match /\A[0-9a-fA-F]*\z/
     end
@@ -108,7 +107,7 @@ module Eth
     # @param hex [String] a string to be checked.
     # @return [String] a match if true; `nil` if not.
     def prefixed?(hex)
-      hex.match /\A0x/
+      hex.match /\A0x/i
     end
 
     # Serializes an unsigned integer to big endian.
@@ -129,7 +128,11 @@ module Eth
     # @param num [Integer] integer to be converted.
     # @return [String] packed, big-endian integer string.
     def int_to_big_endian(num)
-      hex = num.to_s(16) unless hex? num
+      hex = if hex? num
+          remove_hex_prefix num
+        else
+          num.to_s(16)
+        end
       hex = "0#{hex}" if hex.size.odd?
       hex_to_bin hex
     end
@@ -142,6 +145,15 @@ module Eth
       Rlp::Sedes.big_endian_int.deserialize str.sub(/\A(\x00)+/, "")
     end
 
+    # Deserializes an RLP integer, enforcing minimal encoding.
+    #
+    # @param str [String] serialized big endian integer string.
+    # @return [Integer] a deserialized unsigned integer.
+    # @raise [Rlp::DeserializationError] if encoding is not minimal.
+    def deserialize_rlp_int(str)
+      Rlp::Sedes.big_endian_int.deserialize str
+    end
+
     # Converts a big endian to an interger.
     #
     # @param str [String] big endian to be converted.

data/lib/eth/version.rb

@@ -22,7 +22,7 @@ module Eth
   MINOR = 5.freeze
 
   # Defines the patch version of the {Eth} module.
-  PATCH = 14.freeze
+  PATCH = 16.freeze
 
   # Defines the version string of the {Eth} module.
   VERSION = [MAJOR, MINOR, PATCH].join(".").freeze

data/lib/eth.rb

@@ -32,5 +32,6 @@ require "eth/solidity"
 require "eth/tx"
 require "eth/unit"
 require "eth/util"
+require "eth/bls"
 require "eth/ens"
 require "eth/version"

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eth
 version: !ruby/object:Gem::Version
-  version: 0.5.14
+  version: 0.5.16
 platform: ruby
 authors:
 - Steve Ellis
 - Afri Schoedon
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -85,22 +84,30 @@ dependencies:
   name: openssl
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: scrypt
   requirement: !ruby/object:Gem::Requirement
@@ -115,6 +122,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: bls12-381
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: httpx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
 description: Library to handle Ethereum accounts, messages, and transactions.
 email:
 - email@steveell.is
@@ -151,16 +186,20 @@ files:
 - lib/eth/abi/decoder.rb
 - lib/eth/abi/encoder.rb
 - lib/eth/abi/event.rb
+- lib/eth/abi/function.rb
 - lib/eth/abi/packed/encoder.rb
 - lib/eth/abi/type.rb
 - lib/eth/address.rb
 - lib/eth/api.rb
+- lib/eth/bls.rb
 - lib/eth/chain.rb
 - lib/eth/client.rb
 - lib/eth/client/http.rb
 - lib/eth/client/ipc.rb
+- lib/eth/client/ws.rb
 - lib/eth/constant.rb
 - lib/eth/contract.rb
+- lib/eth/contract/error.rb
 - lib/eth/contract/event.rb
 - lib/eth/contract/function.rb
 - lib/eth/contract/function_input.rb
@@ -185,6 +224,7 @@ files:
 - lib/eth/tx.rb
 - lib/eth/tx/eip1559.rb
 - lib/eth/tx/eip2930.rb
+- lib/eth/tx/eip4844.rb
 - lib/eth/tx/eip7702.rb
 - lib/eth/tx/legacy.rb
 - lib/eth/unit.rb
@@ -199,7 +239,6 @@ metadata:
   documentation_uri: https://q9f.github.io/eth.rb/
   github_repo: https://github.com/q9f/eth.rb
   source_code_uri: https://github.com/q9f/eth.rb
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -218,8 +257,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby Ethereum library.
 test_files: []