evmole

cdump/evmole is an open-source project by cdump: EVMole is an open-source library that analyzes deployed EVM bytecode to infer function selectors, argument types, state mutability, persistent and transient storage layout, control flow, and compiler metadata, including for unverified contracts. Indexed here so it can be found — not resold.

It is free. Get it from the upstream repository: https://github.com/cdump/evmole

From the project's own README (excerpt, reproduced for discovery under its MIT license):

EVMole is a powerful library that extracts information from Ethereum Virtual Machine (EVM) bytecode, including function selectors, arguments, state mutability, persistent and transient storage layouts, and CBOR metadata, even for unverified contracts.

Key Features • Multi-language support: Available as JavaScript, Rust, Python, and Go libraries. • High accuracy and performance: Outperforms existing tools. • Broad compatibility: Tested with both Solidity and Vyper compiled contracts. • Lightweight: Clean codebase with minimal external dependencies. • Unverified contract analysis: Extracts information even from unverified bytecode. • Selector dispatch classification: Distinguishes normal ABI dispatch from selectors handled by fallback logic. • CBOR metadata: Extracts string-keyed values from a terminal, length-suffixed CBOR map without assuming a particular compiler.

Usage JavaScript API documentation and usage examples (Node.js, Vite, webpack, Parcel, esbuild)

Rust Documentation is available on docs.rs

Python API documentation

Go API documentation

Foundry Foundry's cast uses the Rust implementation of EVMole

AI agents

For application code, use one of the language bindings above. For agent-driven bytecode analysis, choose one integration.

JSON CLI

Use for one-off analysis and scripts:

Portable skill

Install routing and interpretation guidance for supported agents:

Local MCP server

Expose EVMole as a typed local tool:

All integrations expect deployed/runtime bytecode and run locally without sending bytecode to an EVMole-operated service. See the agent integration guide for setup, schemas, limitations, and privacy details.

Benchmark

function selectors FP/FN - False Positive/False Negative errors; smaller is better

Dataset…