eth 0.5.13 → 0.5.15

data/lib/eth/tx.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2023 The Ruby-Eth Contributors
+# Copyright (c) 2016-2025 The Ruby-Eth Contributors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ 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"
 
@@ -72,6 +74,12 @@ module Eth
     # The EIP-1559 transaction type is 2.
     TYPE_1559 = 0x02.freeze
 
+    # The EIP-4844 transaction type is 3.
+    TYPE_4844 = 0x03.freeze
+
+    # The EIP-7702 transaction type is 4.
+    TYPE_7702 = 0x04.freeze
+
     # The zero byte is 0x00.
     ZERO_BYTE = "\x00".freeze
 
@@ -80,16 +88,32 @@ 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,
     #   value, data)
+    # - EIP-7702: chain_id, nonce, priority_fee, max_gas_fee, gas_limit, authorizations(, from, to,
+    #   value, data, access_list)
     # - Legacy: nonce, gas_price, gas_limit(, from, to, value, data)
     #
     # @param params [Hash] all necessary transaction fields.
     # @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
+      unless params[:max_fee_per_blob_gas].nil?
+        params[:chain_id] = chain_id if params[:chain_id].nil?
+        return Tx::Eip4844.new params
+      end
+
+      # if we deal with authorizations, attempt EIP-7702
+      unless params[:authorization_list].nil?
+        params[:chain_id] = chain_id if params[:chain_id].nil?
+        return Tx::Eip7702.new params
+      end
+
       # if we deal with max gas fee parameter, attempt EIP-1559
       unless params[:max_gas_fee].nil?
         params[:chain_id] = chain_id if params[:chain_id].nil?
@@ -115,6 +139,7 @@ module Eth
     def decode(hex)
       hex = Util.remove_hex_prefix hex
       type = hex[0, 2].to_i(16)
+
       case type
       when TYPE_1559
 
@@ -124,6 +149,14 @@ module Eth
 
         # EIP-2930 transaction (type 1)
         return Tx::Eip2930.decode hex
+      when TYPE_4844
+
+        # EIP-4844 transaction (type 3)
+        return Tx::Eip4844.decode hex
+      when TYPE_7702
+
+        # EIP-7702 transaction (type 4)
+        return Tx::Eip7702.decode hex
       else
 
         # Legacy transaction if first byte is RLP (>= 192)
@@ -150,6 +183,14 @@ module Eth
 
         # EIP-2930 transaction (type 1)
         return Tx::Eip2930.unsigned_copy tx
+      when TYPE_4844
+
+        # EIP-4844 transaction (type 3)
+        return Tx::Eip4844.unsigned_copy tx
+      when TYPE_7702
+
+        # EIP-7702 transaction (type 4)
+        return Tx::Eip7702.unsigned_copy tx
       when TYPE_LEGACY
 
         # Legacy transaction ("type 0")
@@ -241,6 +282,36 @@ 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.
+    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[: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.
+    # @return [Hash] the validated transaction fields.
+    # @raise [ParameterError] if authorization list is missing.
+    def validate_eip7702_params(fields)
+      unless fields[:authorization_list].nil? or fields[:authorization_list].is_a? Array
+        raise ParameterError, "Invalid authorization list #{fields[:authorization_list]}!"
+      end
+      return fields
+    end
+
     # Validates the common legacy transaction fields such as gas price.
     #
     # @param fields [Hash] the transaction fields.
@@ -323,6 +394,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/unit.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2023 The Ruby-Eth Contributors
+# Copyright (c) 2016-2025 The Ruby-Eth Contributors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/eth/util.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2023 The Ruby-Eth Contributors
+# Copyright (c) 2016-2025 The Ruby-Eth Contributors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -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

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2023 The Ruby-Eth Contributors
+# Copyright (c) 2016-2025 The Ruby-Eth Contributors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -22,7 +22,7 @@ module Eth
   MINOR = 5.freeze
 
   # Defines the patch version of the {Eth} module.
-  PATCH = 13.freeze
+  PATCH = 15.freeze
 
   # Defines the version string of the {Eth} module.
   VERSION = [MAJOR, MINOR, PATCH].join(".").freeze

data/lib/eth.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2023 The Ruby-Eth Contributors
+# Copyright (c) 2016-2025 The Ruby-Eth Contributors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

metadata

@@ -1,16 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: eth
 version: !ruby/object:Gem::Version
-  version: 0.5.13
+  version: 0.5.15
 platform: ruby
 authors:
 - Steve Ellis
 - Afri Schoedon
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: forwardable
   requirement: !ruby/object:Gem::Requirement
@@ -71,22 +84,16 @@ 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'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: scrypt
   requirement: !ruby/object:Gem::Requirement
@@ -137,6 +144,8 @@ 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
@@ -146,6 +155,7 @@ files:
 - lib/eth/client/ipc.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
@@ -170,6 +180,8 @@ 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
 - lib/eth/util.rb
@@ -183,7 +195,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
@@ -202,8 +213,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Ruby Ethereum library.
 test_files: []