mana-ethereum/ethereumex

Ethereumex is an Elixir library that provides a unified interface for interacting with Ethereum nodes via HTTP, IPC, and WebSocket transports. It supports standard JSON-RPC methods and real-time event subscriptions, leveraging Finch for HTTP requests and poolboy for IPC concurrency. The system includes configuration management, telemetry for monitoring RPC metrics, and helper scripts for local development environments.

New shell scripts have been added to the bin directory to streamline the setup and execution of the Parity Ethereum client. The setup\_parity script downloads the Parity binary (version 1.10.7 for x86\_64 Linux) into a local parity directory and prepares the environment, while run\_parity executes the client in development mode using the downloaded binary.

bin · high confidence

The library now includes a WebSocket-based Ethereum JSON-RPC client (\Ethereumex.WebsocketClient\) that allows users to maintain persistent connections for real-time event subscriptions, such as new block headers, pending transactions, and contract logs. This new client is built on a shared \BaseClient\ behavior and macro system, which centralizes the implementation of standard RPC methods (like \eth\_block\_number\, \eth\_call\, etc.) to ensure consistency across HTTP and WebSocket transports. The underlying \WebsocketServer\ manages connection lifecycle, automatic reconnection with exponential backoff, and request-response matching, enabling developers to subscribe to events and receive notifications directly in their processes.

lib/ethereumex/client · high confidence

The configuration system has been updated to use the Elixir 1.6+ \import Config\ syntax, replacing the deprecated \use Mix.Config\. Default application settings for \:ethereumex\ (including HTTP options, headers, JSON module, and error logging) are now centralized in \config/config.exs\, which dynamically loads environment-specific overrides via \import\_config\. New \config/dev.exs\ and \config/test.exs\ files provide specific defaults, such as reading the URL from the \ETHEREUM\_URL\ environment variable in development and using a local Anvil node in tests.

config · high confidence

The module-level documentation for Ethereumex is no longer hardcoded in the source file. Instead, it is dynamically generated by reading the project's README.md file and extracting the section between the \<!-- MDOC --\> markers, ensuring the API docs stay in sync with the main project documentation.

lib · high confidence

The library has been restructured to support multiple client types (HTTP, IPC, WebSocket) via a new \Ethereumex.Config\ module that manages OTP supervision children. HTTP requests now use the Finch library instead of the previous HTTP client, allowing for configurable pools and per-request HTTP options. IPC communication has been updated to use a \poolboy\-managed worker pool for better concurrency. Additionally, the library now exposes RPC call metrics via Telemetry, allowing users to monitor request counts and method usage.

lib/ethereumex · high confidence

Added comprehensive test coverage for Ethereumex configuration, clients, and telemetry; Added tests for Ethereum JSON-RPC client methods; Updated test configuration and removed legacy test file.

This release upgrades the HTTP transport from Finch 0.19.0 to 0.24.0 (including Mint 1.7.1 to 1.11.0 and hpax 1.0.2 to 1.1.0), changing HTTP transport errors to \%Finch.TransportError{}\. It introduces the ability to configure per-request \:http\_options\ in \HttpClient\, which are merged over the configured defaults, allowing users to override settings like timeouts for individual calls. The library now requires Elixir \~\> 1.16 (up from \~\> 1.13) and updates several dependencies including Jason, telemetry, Mimic, Credo, dialyxir, and ex\_doc.

(repo-wide) · high confidence

The library now requires Elixir 1.16 or higher and updates its HTTP client from HTTPoison to Finch (v0.16+), replacing the previous HTTP implementation. Development tooling has been upgraded, including Credo to 1.7, Dialyxir to 1.4, and ExDoc to 0.40, while Jason is now an optional dependency for JSON encoding. The project structure also includes a dedicated Application module and enhanced Dialyzer configuration for better type checking.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 68 → 67 (-0.5)
• Rubric changed (rubric-2026.09.15 → rubric-2026.10.1) — scores are not directly comparable.

• Code Health 100 → 100 (+0.0)
• Architecture 69 → 69 (+0.0)
• Maturity 57 → 56 (-0.8)
• Readiness 77 → 75 (-2.3)
• Security 95 → 97 (+2.2)

• Documentation: no architecture or design documentation (README.md)
• High CVE: [GHSA redacted] (mix.lock)
• Medium CVE: EEF-[CVE redacted] (mix.lock)
• Outdated: credo
• Outdated: dialyxir
• Outdated: ex_doc
• Outdated: finch
• Outdated: jason
• Outdated: telemetry

• Orphaned files with no living knowledge

• 3 commits — 2 feature/other, 1 fixes

• (root) — 2 commits
• test/ethereumex — 1 commit

• fix: fix tests
• change: Honor per-request :http_options in HttpClient (#226)
• change: release 0.15.0 (#227)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

mana-ethereum/ethereumex was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.