tevm-debugging

Trace EVM transactions with execution steps and gas profiling.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/cyotee/crane --skill tevm-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tevm-debugging
Source: https://github.com/cyotee/crane/tree/main/.claude/skills/tevm-debugging
Command: npx skills add https://github.com/cyotee/crane --skill tevm-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug transactions with EVM tracing, gas profiling, and error handling. Use when investigating contract behavior or test failures.

Core Features & Use Cases

  • Basic Tracing
  • Gas Profiling
  • Error Handling
  • Time Manipulation
  • State Snapshots
  • Access VM Directly

Quick Start

Use tevm-debugging to attach a debugger and start tracing a transaction by initializing a tevm client and enabling onStep/onAfterMessage hooks.

Frequently Asked Questions about tevm-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace EVM transactions to investigate smart contract behavior?

You can trace EVM transactions by initializing a client and enabling onStep and onAfterMessage hooks to inspect execution steps. This allows you to debug contract behavior and investigate test failures by observing the execution flow.

Can I profile gas usage for smart contracts during execution?

Yes, gas profiling is supported directly to monitor gas usage during smart contract execution. This helps identify performance diagnostics and optimize contract behavior by analyzing gas consumption across execution steps.

How do I inspect and manipulate EVM state during test failure investigation?

You can inspect and manipulate the EVM state by accessing the VM directly and utilizing state snapshots. This enables detailed error handling and state manipulation to resolve issues found during test failure investigation.

Does this debugging approach work across development and test networks?

Yes, this debugging approach applies to contract behavior analysis and performance diagnostics across both development and test networks. It supports tracing execution steps and profiling gas usage in these environments.

What is the best way to handle errors when debugging Ethereum smart contracts?

The best way to handle errors is by using execution tracing alongside state snapshots to inspect the exact failure point. This allows you to manipulate the EVM state and diagnose the root cause of errors during contract execution.

Can I manipulate time when debugging EVM transactions?

Yes, time manipulation is supported as a core feature for debugging EVM transactions. This allows you to test contract behavior under different time conditions alongside tracing execution and profiling gas usage.