Torge

CLI tool to produce Foundry-style traces for EVM transactions and calls through debug_traceTransaction and debug_traceCall RPC requests.

Installation

From crates.io:

cargo install torge

From source:

cargo install --path .

Usage

torge tx — Trace a transaction

torge tx <TX_HASH> [OPTIONS]

Basic usage:

torge tx 0x1234...abcd --rpc-url http://localhost:8545

With Foundry alias:

torge tx 0x1234...abcd --rpc-url ethereum

With selector resolution:

torge tx 0x1234...abcd --rpc-url http://localhost:8545 --resolve-selectors

With contract name resolution (replaces addresses with verified names via Sourcify):

torge tx 0x1234...abcd --rpc-url http://localhost:8545 --resolve-contracts

With all resolution options, argument decoding, calldata, and events:

torge tx 0x1234...abcd --resolve-selectors --resolve-contracts --include-args --include-calldata --include-logs

torge call — Simulate a call

torge call <TO> <DATA> [OPTIONS]
torge call --create <DATA> [OPTIONS]

Simulate a call against a contract:

torge call 0xdead...beef 0xa9059cbb... --rpc-url http://localhost:8545

With sender, value, and gas limit:

torge call 0xdead...beef 0xa9059cbb... --from 0xcafe...1234 --value 1ether --gas-limit 1000000

At a specific block:

torge call 0xdead...beef 0xa9059cbb... --block 18000000

Simulate a contract creation:

torge call --create 0x6080604052... --rpc-url http://localhost:8545

With contract name resolution for a simulated call:

torge call 0xdead...beef 0xa9059cbb... --rpc-url http://localhost:8545 --resolve-contracts

torge clean — Manage cache

torge clean [OPTIONS]

Clear the entire cache (selectors and contracts):

torge clean

Remove only unresolved entries (retry on next lookup):

torge clean --only-unknown