eth 0.5.13 → 0.5.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc5ddb568fad899fb1b19cce7995c8152b799475fbca603932d840d561fa4b4c
-  data.tar.gz: fc69a4e2c2866a719336cc94a0adb9244383a6c80116ab7da8a1165262743ac9
+  metadata.gz: 58842e5f3990be268758249080b56b70c1f26f8299ef27e7549db6cc2f675e51
+  data.tar.gz: 388a599dde8f50f34d46287e028e4dfe0c855815baa10de4a8c258b549429286
 SHA512:
-  metadata.gz: 35062c2f2b04723b2889195a5a16c662e2f2913fed4ecc3d5903a6167ed125d23a3b066125756023b2b71451f5899a58f5a36e61049f0e744b6a24583a6eff9e
-  data.tar.gz: 51732510c1e64a48d3095fb6a6502038e493ace3390da31cde1006f67f4b7a4e130f78de2ab667ae235ce4285c2bb986a3720be8b6648e91d845de5bdb6f1a8f
+  metadata.gz: 3d4e42a99aebc7a47673b0706ce8476e08beca249ecae812f10c76e4f8767088b6a185c232abf9cc977a6680b08ac7b38de9d211cfc741f3bb2aa5fce9a4730c
+  data.tar.gz: cb29ed0c90b56eeae5ce519a436fada62e47690c1ca447e230d0fa2f3915fe97cd3346506c6b67e9c93a88d333197f0735529dd3c66c764d1895e76b1aa82b57

data/.github/workflows/codeql.yml

@@ -35,7 +35,7 @@ jobs:
         uses: github/codeql-action/analyze@v3
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.3'
+          ruby-version: '3.4'
           bundler-cache: true
       - name: "Run rufo code formatting checks"
         run: |

data/.github/workflows/docs.yml

@@ -13,14 +13,14 @@ jobs:
     - uses: actions/checkout@v4
     - uses: ruby/setup-ruby@v1
       with:
-        ruby-version: '3.3'
+        ruby-version: '3.4'
         bundler-cache: true
     - name: Run Yard Doc
       run: |
         gem install yard
         yard doc
     - name: Deploy GH Pages
-      uses: JamesIves/github-pages-deploy-action@v4.7.1
+      uses: JamesIves/github-pages-deploy-action@v4.7.3
       with:
           branch: gh-pages
           folder: doc/

data/.github/workflows/spec.yml

@@ -19,7 +19,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest]
-        ruby: ['3.2', '3.3']
+        ruby: ['3.3', '3.4']
     steps:
     - uses: actions/checkout@v4
     - uses: ruby/setup-ruby@v1
@@ -48,8 +48,6 @@ jobs:
     - name: Run Tests
       run: |
         bundle exec rspec
-      env:
-        INFURA_TOKEN: ${{ secrets.INFURA_TOKEN }}
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v5
       with:

data/CHANGELOG.md

@@ -1,6 +1,39 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## [0.5.15]
+### Added
+* Eth/tx: add support for EIP-4844 transactions [#345](https://github.com/q9f/eth.rb/pull/345)
+* Eth/contract: support solidity custom errors as per ERC-6093 [#344](https://github.com/q9f/eth.rb/pull/344)
+* Eth/abi: decode transaction input [#354](https://github.com/q9f/eth.rb/pull/354)
+
+### Fixed
+* Eth/abi: handle tuple type without components [#335](https://github.com/q9f/eth.rb/issues/335)
+
+## [0.5.14]
+### Added
+* Add ability to decode event parameters using ABI reference. [#328](https://github.com/q9f/eth.rb/pull/328)
+* Add support for EIP-7702 transactions  [#320](https://github.com/q9f/eth.rb/pull/320)
+* Eth/abi: implement packed encoder [#310](https://github.com/q9f/eth.rb/pull/310)
+
+### Changed
+* Chore: run rufo, add docs [#332](https://github.com/q9f/eth.rb/pull/332)
+* Spec/client: fix nonce too low error handling in spec [#331](https://github.com/q9f/eth.rb/pull/331)
+* Move the tests that are failing due to a geth upgrade to pending  [#330](https://github.com/q9f/eth.rb/pull/330)
+* Spec/client: don't require any rpc api token for tests [#326](https://github.com/q9f/eth.rb/pull/326)
+* Build(deps): bump JamesIves/github-pages-deploy-action from 4.7.2 to 4.7.3 [#327](https://github.com/q9f/eth.rb/pull/327)
+* Eth/eip712: prepare tests for packed encoding [#216](https://github.com/q9f/eth.rb/pull/216)
+* Spec/solidity: mute system call output [#319](https://github.com/q9f/eth.rb/pull/319)
+* Updated nesting of describe blocks in the EIP-1559 spec. [#318](https://github.com/q9f/eth.rb/pull/318)
+* Update README.md [#317](https://github.com/q9f/eth.rb/pull/317)
+* Docs: update README.md [#314](https://github.com/q9f/eth.rb/pull/314)
+* Gem: update copyright headers [#312](https://github.com/q9f/eth.rb/pull/312)
+* Build(deps): bump JamesIves/github-pages-deploy-action from 4.7.1 to 4.7.2 [#309](https://github.com/q9f/eth.rb/pull/309)
+* Spec: switch from infura to drpc [#308](https://github.com/q9f/eth.rb/pull/308)
+* Ci: update ruby version [#307](https://github.com/q9f/eth.rb/pull/307)
+* Gem: bump version to 0.5.14 [#305](https://github.com/q9f/eth.rb/pull/305)
+* Docs: update changelog [#304](https://github.com/q9f/eth.rb/pull/304)
+
 ## [0.5.13]
 ### Changed
 * Eth/api: update to latest available go-ethereum apis [#301](https://github.com/q9f/eth.rb/pull/301)

data/CODE_OF_CONDUCT.md

@@ -115,8 +115,6 @@ community.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, available at [v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
+Community Impact Guidelines were inspired by Mozilla's code of conduct enforcement ladder.

data/Gemfile

@@ -3,14 +3,14 @@
 source "https://rubygems.org"
 
 group :test, :development do
-  gem "bundler", "~> 2.4"
+  gem "bundler", "~> 2.5"
   gem "pry", "~> 0.15"
   gem "rake", "~> 13.2"
-  gem "rdoc", "~> 6.9"
+  gem "rdoc", "~> 6.13"
   gem "rspec", "~> 3.13"
   gem "rufo", "~> 0.18"
   gem "simplecov", "~> 0.22"
-  gem "simplecov-cobertura", "~> 2.1"
+  gem "simplecov-cobertura", "~> 3.0"
   gem "yard", "~> 0.9"
 end
 

data/LICENSE.txt

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   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/README.md

@@ -10,9 +10,7 @@
 [![GitHub release (latest by date)](https://img.shields.io/github/v/release/q9f/eth.rb)](https://github.com/q9f/eth.rb/releases)
 [![Gem](https://img.shields.io/gem/v/eth)](https://rubygems.org/gems/eth)
 [![Gem](https://img.shields.io/gem/dt/eth)](https://rubygems.org/gems/eth)
-[![Visitors](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fq9f%2Feth.rb&count_bg=%2379C83D&title_bg=%23555555&icon=rubygems.svg&icon_color=%23FF0000&title=visitors&edge_flat=false)](https://hits.seeyoufarm.com)
 [![codecov](https://codecov.io/gh/q9f/eth.rb/branch/main/graph/badge.svg?token=IK7USBPBZY)](https://codecov.io/gh/q9f/eth.rb)
-[![Maintainability](https://api.codeclimate.com/v1/badges/469e6f66425198ad7614/maintainability)](https://codeclimate.com/github/q9f/eth.rb/maintainability)
 [![Top Language](https://img.shields.io/github/languages/top/q9f/eth.rb?color=red)](https://github.com/q9f/eth.rb/pulse)
 [![Yard Doc API](https://img.shields.io/badge/documentation-API-blue)](https://q9f.github.io/eth.rb)
 [![Usage Wiki](https://img.shields.io/badge/usage-WIKI-blue)](https://github.com/q9f/eth.rb/wiki)
@@ -34,11 +32,15 @@ What you get:
 - [x] EIP-2028 Call-data intrinsic gas cost estimates (plus access lists)
 - [x] EIP-2718 Ethereum Transaction Envelopes (and types)
 - [x] EIP-2930 Ethereum Type-1 Transactions (with access lists)
+- [x] EIP-4844 Ethereum Type-3 Transactions (with shard blobs)
+- [x] EIP-7702 Ethereum Type-4 Transactions (with authorization lists)
 - [x] ABI-Encoder and Decoder (including type parser)
+- [x] Packed ABI-Encoder for Solidity smart contracts
 - [x] RLP-Encoder and Decoder (including sedes)
 - [x] RPC-Client (IPC/HTTP) for Execution-Layer APIs
 - [x] Solidity bindings (compile contracts from Ruby)
 - [x] Full smart-contract support (deploy, transact, and call)
+- [x] ERC-6093 custom Solidity errors
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -80,8 +82,6 @@ The test suite expects working local HTTP and IPC endpoints with a prefunded dev
 geth --dev --http --ipcpath /tmp/geth.ipc &
 ```
 
-It also expects an `$INFURA_TOKEN` in environment to test some ENS queries on mainnet.
-
 To run tests, simply use `rspec`. Note, that the Ethereum test fixtures are also required.
 
 ```shell
@@ -90,12 +90,12 @@ bundle install
 rspec
 ```
 
-The goal is to have 100% specification coverage for all code inside this gem.
+The goal is to have 100% unit-test coverage for all code inside this gem.
 
 ## Contributing
 Pull requests are welcome! To contribute, please consider the following:
 * Code should be fully documented. Run `yard doc` and make sure it does not yield any warnings or undocumented sets.
-* Code should be fully covered by tests. Run `rspec` to make sure all tests pass. The CI has an integration that will assis you to identify uncovered lines of code and get coverage up to 100%.
+* Code should be fully covered by tests. Run `rspec` to make sure all tests pass. The CI has an integration that will assist you to identify uncovered lines of code and get coverage up to 100%.
 * Code should be formatted properly. Try to eliminate the most common issues such as trailing white-spaces or duplicate new-lines. Usage of the `rufo` gem is recommended.
 * Submit pull requests, questions, or issues to Github: <https://github.com/q9f/eth.rb>
 

data/SECURITY.md

@@ -10,8 +10,8 @@ later.
 
 | Gem            | Version | Supported          |
 | -------------- | ------- | ------------------ |
-| `eth`          | 0.5.x   | :white_check_mark: |
-| `eth`          | < 0.5   | :x:                |
+| `eth`          | >= 0.5  | :white_check_mark: |
+| `eth`          | <  0.5  | :x:                |
 | `ethereum`     | _any_   | :x:                |
 | `ethereum-abi` | _any_   | :x:                |
 | `rlp`          | _any_   | :x:                |

data/eth.gemspec

@@ -34,6 +34,9 @@ Gem::Specification.new do |spec|
   spec.platform = Gem::Platform::RUBY
   spec.required_ruby_version = ">= 3.0", "< 4.0"
 
+  # bigdecimal for big decimals ;)
+  spec.add_dependency "bigdecimal", "~> 3.1"
+
   # forwardable for contracts meta programming
   spec.add_dependency "forwardable", "~> 1.3"
 
@@ -47,7 +50,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "rbsecp256k1", "~> 6.0"
 
   # openssl for encrypted key derivation
-  spec.add_dependency "openssl", ">= 2.2", "< 4.0"
+  spec.add_dependency "openssl", "~> 3.3"
 
   # scrypt for encrypted key derivation
   spec.add_dependency "scrypt", "~> 3.0"

data/lib/eth/abi/decoder.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.
@@ -43,11 +43,14 @@ module Eth
             # Case: decoding array of string/bytes
           else
             l = Util.deserialize_big_endian_to_int arg[0, 32]
+            raise DecodingError, "Wrong data size for dynamic array" unless arg.size >= 32 + 32 * l
 
             # Decode each element of the array
             (1..l).map do |i|
               pointer = Util.deserialize_big_endian_to_int arg[i * 32, 32] # Pointer to the size of the array's element
+              raise DecodingError, "Offset out of bounds" if pointer < 32 * l || pointer > arg.size - 64
               data_l = Util.deserialize_big_endian_to_int arg[32 + pointer, 32] # length of the element
+              raise DecodingError, "Offset out of bounds" if pointer + 32 + Util.ceil32(data_l) > arg.size
               type(Type.parse(type.base_type), arg[pointer + 32, Util.ceil32(data_l) + 32])
             end
           end
@@ -73,11 +76,19 @@ module Eth
           l = Util.deserialize_big_endian_to_int arg[0, 32]
           nested_sub = type.nested_sub
 
-          # ref https://github.com/ethereum/tests/issues/691
-          raise NotImplementedError, "Decoding dynamic arrays with nested dynamic sub-types is not implemented for ABI." if nested_sub.dynamic?
-
-          # decoded dynamic-sized arrays
-          (0...l).map { |i| type(nested_sub, arg[32 + nested_sub.size * i, nested_sub.size]) }
+          if nested_sub.dynamic?
+            raise DecodingError, "Wrong data size for dynamic array" unless arg.size >= 32 + 32 * l
+            offsets = (0...l).map do |i|
+              off = Util.deserialize_big_endian_to_int arg[32 + 32 * i, 32]
+              raise DecodingError, "Offset out of bounds" if off < 32 * l || off > arg.size - 64
+              off
+            end
+            offsets.map { |off| type(nested_sub, arg[32 + off..]) }
+          else
+            raise DecodingError, "Wrong data size for dynamic array" unless arg.size >= 32 + nested_sub.size * l
+            # decoded dynamic-sized arrays with static sub-types
+            (0...l).map { |i| type(nested_sub, arg[32 + nested_sub.size * i, nested_sub.size]) }
+          end
         elsif !type.dimensions.empty?
           l = type.dimensions.first
           nested_sub = type.nested_sub
@@ -102,7 +113,7 @@ module Eth
         when "address"
 
           # decoded address with 0x-prefix
-          "0x#{Util.bin_to_hex data[12..-1]}"
+          Address.new(Util.bin_to_hex data[12..-1]).to_s.downcase
         when "string", "bytes"
           if type.sub_type.empty?
             size = Util.deserialize_big_endian_to_int data[0, 32]

data/lib/eth/abi/encoder.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.
@@ -46,33 +46,21 @@ module Eth
         elsif type.dynamic? && arg.is_a?(Array)
 
           # encodes dynamic-sized arrays
-          head, tail = "", ""
-          head += type(Type.size_type, arg.size)
+          head = type(Type.size_type, arg.size)
           nested_sub = type.nested_sub
-          nested_sub_size = type.nested_sub.size
-
-          # calculate offsets
-          if %w(string bytes).include?(type.base_type) && type.sub_type.empty?
-            offset = 0
-            arg.size.times do |i|
-              if i == 0
-                offset = arg.size * 32
-              else
-                number_of_words = ((arg[i - 1].size + 32 - 1) / 32).floor
-                total_bytes_length = number_of_words * 32
-                offset += total_bytes_length + 32
-              end
 
+          if nested_sub.dynamic?
+            tails = arg.map { |a| type(nested_sub, a) }
+            offset = arg.size * 32
+            tails.each do |t|
               head += type(Type.size_type, offset)
+              offset += t.size
             end
-          elsif nested_sub.base_type == "tuple" && nested_sub.dynamic?
-            head += struct_offsets(nested_sub, arg)
-          end
-
-          arg.size.times do |i|
-            head += type nested_sub, arg[i]
+            head + tails.join
+          else
+            arg.each { |a| head += type(nested_sub, a) }
+            head
           end
-          "#{head}#{tail}"
         else
           if type.dimensions.empty?
 
@@ -93,15 +81,15 @@ module Eth
       # @return [String] the encoded primitive type.
       # @raise [EncodingError] if value does not match type.
       # @raise [ValueOutOfBounds] if value is out of bounds for type.
-      # @raise [EncodingError] if encoding fails for type.
+      # @raise [ArgumentError] if encoding fails for type.
       def primitive_type(type, arg)
         case type.base_type
         when "uint"
           uint arg, type
-        when "bool"
-          bool arg
         when "int"
           int arg, type
+        when "bool"
+          bool arg
         when "ureal", "ufixed"
           ufixed arg, type
         when "real", "fixed"

data/lib/eth/abi/event.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.
@@ -44,6 +44,10 @@ module Eth
         "#{name}(#{types.join(",")})"
       end
 
+      # Gets the input type for events.
+      #
+      # @param input [Hash] events input.
+      # @return [String] input type.
       def type(input)
         if input["type"] == "tuple"
           "(#{input["components"].map { |c| type(c) }.join(",")})"

data/lib/eth/abi/function.rb

@@ -0,0 +1,124 @@
+# 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.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# -*- encoding : ascii-8bit -*-
+
+# Provides the {Eth} module.
+module Eth
+
+  # Provides a Ruby implementation of the Ethereum Application Binary Interface (ABI).
+  module Abi
+
+    # Provides a module to decode transaction input data.
+    module Function
+      extend self
+
+      # Build function signature string from ABI interface.
+      #
+      # @param interface [Hash] ABI function interface.
+      # @return [String] interface signature string.
+      def signature(interface)
+        name = interface.fetch("name")
+        inputs = interface.fetch("inputs", [])
+        types = inputs.map { |i| type(i) }
+        "#{name}(#{types.join(",")})"
+      end
+
+      # Compute selector for ABI function interface.
+      #
+      # @param interface [Hash] ABI function interface.
+      # @return [String] a hex-string selector.
+      def selector(interface)
+        sig = signature(interface)
+        Util.prefix_hex(Util.bin_to_hex(Util.keccak256(sig))[0, 8])
+      end
+
+      # Gets the input type for functions.
+      #
+      # @param input [Hash] function input.
+      # @return [String] input type.
+      def type(input)
+        if input["type"] == "tuple"
+          "(#{input["components"].map { |c| type(c) }.join(",")})"
+        elsif input["type"] == "enum"
+          "uint8"
+        else
+          input["type"]
+        end
+      end
+
+      # A decoded function call.
+      class CallDescription
+        # The function ABI interface used to decode the call.
+        attr_accessor :function_interface
+
+        # The positional arguments of the call.
+        attr_accessor :args
+
+        # The named arguments of the call.
+        attr_accessor :kwargs
+
+        # The function selector.
+        attr_accessor :selector
+
+        # Creates a description object for a decoded function call.
+        #
+        # @param function_interface [Hash] function ABI type.
+        # @param selector [String] function selector hex-string.
+        # @param args [Array] decoded positional arguments.
+        # @param kwargs [Hash] decoded keyword arguments.
+        def initialize(function_interface, selector, args, kwargs)
+          @function_interface = function_interface
+          @selector = selector
+          @args = args
+          @kwargs = kwargs
+        end
+
+        # The function name. (e.g. transfer)
+        def name
+          @name ||= function_interface.fetch("name")
+        end
+
+        # The function signature. (e.g. transfer(address,uint256))
+        def signature
+          @signature ||= Function.signature(function_interface)
+        end
+      end
+
+      # Decodes a transaction input with a set of ABI interfaces.
+      #
+      # @param interfaces [Array] function ABI types.
+      # @param data [String] transaction input data.
+      # @return [CallDescription, nil] a CallDescription object or nil if selector unknown.
+      def decode(interfaces, data)
+        data = Util.remove_hex_prefix(data)
+        selector = Util.prefix_hex(data[0, 8])
+        payload = Util.prefix_hex(data[8..] || "")
+
+        selector_to_interfaces = Hash[interfaces.map { |i| [selector(i), i] }]
+        if (interface = selector_to_interfaces[selector])
+          inputs = interface.fetch("inputs", [])
+          types = inputs.map { |i| type(i) }
+          args = Abi.decode(types, payload)
+          kwargs = {}
+          inputs.each_with_index do |input, i|
+            name = input.fetch("name", "")
+            kwargs[name.to_sym] = args[i] unless name.empty?
+          end
+          CallDescription.new(interface, selector, args, kwargs)
+        end
+      end
+    end
+  end
+end