evm-trace: Ethereum Virtual Machine transaction tracing tool
Project description
Quick Start
Ethereum Virtual Machine transaction tracing tool
Dependencies
- python3 version 3.9 to 3.12.
Installation
via pip
You can install the latest release via pip
:
pip install evm-trace
via setuptools
You can clone the repository and use setuptools
for the most up-to-date version:
git clone https://github.com/ApeWorX/evm-trace.git
cd evm-trace
python3 setup.py install
Quick Usage
Geth Style Traces
If you are using a node that supports the debug_traceTransaction
RPC, you can use web3.py
to get trace frames:
from web3 import HTTPProvider, Web3
from evm_trace import TraceFrame
web3 = Web3(HTTPProvider("https://path.to.my.node"))
txn_hash = "0x..."
struct_logs = web3.manager.request_blocking("debug_traceTransaction", [txn_hash]).structLogs
for item in struct_logs:
frame = TraceFrame.model_validate(item)
If you want to get the call-tree node, you can do:
from evm_trace import CallType, get_calltree_from_geth_trace
root_node_kwargs = {
"gas_cost": 10000000,
"gas_limit": 10000000000,
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"calldata": "0x00",
"value": 1000,
"call_type": CallType.CALL,
}
# Where `trace` is a `TraceFrame` (see example above)
calltree = get_calltree_from_geth_trace(trace, **root_node_kwargs)
Parity Style Traces
If you are using a node that supports the trace_transaction
RPC, you can use web3.py
to get trace objects:
from evm_trace import CallType, ParityTraceList
raw_trace_list = web3.manager.request_blocking("trace_transaction", [txn_hash])
trace_list = ParityTraceList.model_validate(raw_trace_list)
And to make call-tree nodes, you can do:
from evm_trace import get_calltree_from_parity_trace
tree = get_calltree_from_parity_trace(trace_list)
Gas Reports
If you are using a node that supports creating traces, you can get a gas report.
from evm_trace.gas import get_gas_report
# see examples above for creating a calltree
calltree = get_calltree_from_geth_trace(trace, **root_node_kwargs)
gas_report = get_gas_report(calltree)
For a more custom report, use the merge_reports
method to combine a list of reports into a single report.
Pass two or more Dict[Any, Dict[Any, List[int]]]
to combine reports where List[int]
is the gas used.
Customize the values of Any
accordingly:
- The first
Any
represents the bytes from the address. - The second
Any
represents the method selector.
For example, you may replace addresses with token names or selector bytes with signature call strings.
Import the method like so:
from evm_trace.gas import merge_reports
Development
This project is in development and should be considered a beta. Things might not be in their final state and breaking changes may occur. Comments, questions, criticisms and pull requests are welcomed.
License
This project is licensed under the Apache 2.0.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for evm_trace-0.2.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 89b685134ab808c0e66a98887111d9f1ebae64d11b40e255064da7ace14ddf8a |
|
MD5 | 9cb85b6d73376a9cc88826582d103ef0 |
|
BLAKE2b-256 | d2dc65a966a04974e5f6df253b0fa7d6948947bf0fe463cc0126a8e5ed24ed96 |