viem_rb 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fa59c405af0163f103e886bf29fa2c6d9c76f5e97d8e9fb5288446f44d626f4
-  data.tar.gz: 89cdeaabac33bfc76f46d644d1aee348babf49d61d64e2988325cd1f1d1bb99b
+  metadata.gz: b484347f34f49daa07a62c0de9470faefab1b9ea6eb95573fc92b8785fc2e228
+  data.tar.gz: 431aadd5602eebd269ebea09884d1614355b57c3979e5e301c1dbd0451d60bf3
 SHA512:
-  metadata.gz: e1dc6bb79f74d3eba580dded3d3229b150a7cc408b2eaa5f4e7dea4375a6f671aed14342bb9ccf4912df3504fa7445eef7538b1cd48da91deb004a8f8076857c
-  data.tar.gz: 87fe6920ac0199ef8a1749406e20a6c3cb85bec40d4a2b9e274799f575d513da16918809009c97d9f886249bb537893f22352fd5819e194c8d3bbd29fe5120e4
+  metadata.gz: 1e6e9137eee7e6840dd5fd62702d7689d2f8dde28e74338e0cc4fbcfa5ab160633d64d616e8c992e3111b8a401424d3762753f72d24494b2adc4402af7805514
+  data.tar.gz: 62a543abdc1014f1e750a2ec7158a90ebc9dea761cabe06a99da25d6efacc2ae4cb83fe2f33c0e1d3369ae5532736d7c88c28a4732db7228e7d92ed2d2a3a76f

data/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.1.3] - 2026-03-19
+
+### Added
+- `get_logs` fully completed:
+  - `block_hash:` param — filter logs from a specific block hash (mutually exclusive with `from_block`/`to_block`)
+  - Multi-address support — `address:` now accepts an array of contract addresses
+  - Address validation on `address:` param (raises `InvalidAddressError` for invalid inputs)
+  - Full indexed args encoding — `args:` hash now encodes topic1/2/3 by type (`address`, `bool`, `uint`, `int`, `bytes32`, `bytes`, `string`)
+  - OR filtering — pass an array as an arg value to generate a multi-value OR topic filter
+  - Raw `topics:` override — bypass event/args encoding and pass topics directly
+  - Tuple event support — canonical type resolution for events with `tuple` inputs
+  - Trailing nil wildcard stripping — topics array is trimmed to the last meaningful filter
+- 31 new specs for `get_logs` (192 total, 0 failures)
+
 ## [0.1.2] - 2026-03-19
 
 ### Fixed

data/lib/viem/actions/public/get_logs.rb

@@ -4,29 +4,127 @@ module Viem
   module Actions
     module Public
       module GetLogs
-        def get_logs(address: nil, event: nil, args: {}, from_block: nil, to_block: nil)
+        # Fetch event logs from the chain.
+        #
+        # @param address    [String, Array<String>, nil]  Contract address(es) to filter
+        # @param event      [Hash, nil]                   ABI item for the event (generates topic0)
+        # @param args       [Hash]                        Indexed argument values to filter (topic1+).
+        #                                                 Values can be arrays for OR filtering.
+        # @param from_block [Integer, String, nil]        Start block (number, "latest", "earliest", "pending")
+        # @param to_block   [Integer, String, nil]        End block
+        # @param block_hash [String, nil]                 Filter by specific block hash (exclusive with from/to)
+        # @param topics     [Array, nil]                  Raw topics override (skips event+args encoding)
+        #
+        # @return [Array<Hash>] Formatted log objects
+        def get_logs(
+          address: nil,
+          event: nil,
+          args: {},
+          from_block: nil,
+          to_block: nil,
+          block_hash: nil,
+          topics: nil
+        )
+          raise ArgumentError, "block_hash is mutually exclusive with from_block/to_block" \
+            if block_hash && (from_block || to_block)
+
           params = {}
-          params[:address]   = address if address
-          params[:fromBlock] =
-            from_block.is_a?(Integer) ? Utils::Hex.number_to_hex(from_block) : (from_block || "earliest")
-          params[:toBlock]   = to_block.is_a?(Integer) ? Utils::Hex.number_to_hex(to_block) : (to_block || "latest")
-          params[:topics]    = encode_event_topics(event, args) if event
+
+          params[:address] = encode_address_filter(address) if address
+
+          if block_hash
+            params[:blockHash] = block_hash
+          else
+            params[:fromBlock] = encode_block_param(from_block) if from_block
+            params[:toBlock]   = encode_block_param(to_block)   if to_block
+          end
+
+          encoded_topics = topics || (event ? encode_event_topics(event, args) : nil)
+          params[:topics] = encoded_topics if encoded_topics
+
           results = @transport.request("eth_getLogs", [stringify_keys(params)])
           results.map { |l| format_log(l) }
         end
 
         private
 
-        def encode_event_topics(event_abi, _args)
-          sig    = event_signature(event_abi)
-          topic0 = Utils::Hash.keccak256(sig)
-          [topic0]
+        # Encode address or array of addresses, validating each one.
+        def encode_address_filter(address)
+          if address.is_a?(Array)
+            address.map { |a| Utils::Address.get_address(a) }
+          else
+            Utils::Address.get_address(address)
+          end
+        end
+
+        # Convert block param to hex string or pass through string tags.
+        def encode_block_param(value)
+          return value if value.is_a?(String)
+
+          Utils::Hex.number_to_hex(value)
+        end
+
+        # Build topics array from event ABI + args.
+        # topic0 = keccak256(event signature)
+        # topic1+ = encoded indexed argument values (nil = wildcard)
+        def encode_event_topics(event_abi, args)
+          topic0 = Utils::Hash.keccak256(event_signature(event_abi))
+          topics = [topic0]
+
+          indexed_inputs = (event_abi["inputs"] || []).select { |i| i["indexed"] }
+          indexed_inputs.each do |input|
+            name  = input["name"]
+            value = if args.is_a?(Hash)
+                      args.key?(name) ? args[name] : args[name.to_sym]
+                    end
+
+            topics << if value.nil?
+                        nil # wildcard — match any value for this topic position
+                      elsif value.is_a?(Array)
+                        value.map { |v| encode_topic_value(input["type"], v) }
+                      else
+                        encode_topic_value(input["type"], value)
+                      end
+          end
+
+          # Strip trailing wildcards to keep the request minimal
+          topics.reverse.drop_while(&:nil?).reverse
         end
 
+        # ABI-encode a single indexed value to a 32-byte hex topic.
+        def encode_topic_value(type, value)
+          case type
+          when "address"
+            addr = Utils::Address.get_address(value).delete_prefix("0x").downcase
+            "0x#{"0" * 24}#{addr}"
+          when "bool"
+            value ? "0x#{"0" * 63}1" : "0x#{"0" * 64}"
+          when /\Auint\d*\z/, /\Aint\d*\z/
+            Abi::Encoder.encode_abi_parameters([type], [value])
+          when /\Abytes(\d+)\z/
+            raw = value.delete_prefix("0x")
+            "0x#{raw.ljust(64, "0")}"
+          when "bytes", "string"
+            # Dynamic types are stored as keccak256 of their content
+            Utils::Hash.keccak256(value)
+          else
+            value
+          end
+        end
+
+        # Build canonical event signature string for keccak256 hashing.
         def event_signature(abi_item)
-          inputs = (abi_item["inputs"] || []).map { |i| i["type"] }.join(",")
+          inputs = (abi_item["inputs"] || []).map { |i| canonical_type(i) }.join(",")
           "#{abi_item["name"]}(#{inputs})"
         end
+
+        # Resolve tuple types to their canonical form for signature hashing.
+        def canonical_type(input)
+          return input["type"] unless input["type"] == "tuple"
+
+          inner = (input["components"] || []).map { |c| canonical_type(c) }.join(",")
+          "(#{inner})"
+        end
       end
     end
   end

data/lib/viem/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Viem
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: viem_rb
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Nyrok