Trace-X

🧠 Project Name

Trace-X

🔍 Description

Trace-X is a blockchain simulation and debugging platform that enables developers to fork any blockchain, manipulate token balances, and debug smart contract transactions with source code mapping. It solves the critical problem of understanding complex smart contract interactions and debugging transaction failures by providing line-by-line code tracing.

🛠️ How It Works

Backend Infrastructure:Trace-X creates isolated blockchain forks using Anvil, each with unique identifiers and dedicated ports. The platform features advanced ERC20 balance manipulation through automated storage slot discovery, comprehensive transaction tracing at both call and opcode levels, and seamless Hyperevmscan integration for contract source code retrieval. Key backend innovations include thread-safe fork management with in-memory database tracking, automatic cleanup systems, and sophisticated RPC forwarding that maintains full EVM compatibility.

Advanced Source Code Mapping:The core differentiator of Trace-X is its sophisticated source code mapping system that bridges the gap between low-level blockchain execution traces and high-level Solidity source code. By combining debug traces with contract compilation source maps, developers can see exactly which line of code caused a transaction to fail, making debugging exponentially faster and more intuitive.

Visual Debugging Interface:The React TypeScript frontend provides an advanced visual debugging experience with step-by-step transaction execution, syntax-highlighted Solidity source code display, and interactive call stack visualization. Users can trace through each opcode execution while seeing the corresponding source code lines, inspect function arguments, visualize contract interaction depth, and analyze transaction failures with precise line-level error reporting.

Technical Highlights:

• Multi-Chain Fork Management: Concurrent blockchain fork creation and management across different networks with automatic port allocation
• Smart Storage Slot Discovery: Brute-force algorithm to automatically find and modify ERC20 balance storage locations
• Source Code Mapping Engine: Intuitive system that maps debug traces to exact source code lines using compilation artifacts
• Advanced Visual Debugger: Step-by-step execution tracing with source code highlighting and call stack visualization
• Comprehensive Error Analysis: Automatic extraction of revert reasons with precise line-level failure identification
• Real-time State Management: Snapshot/revert functionality for testing multiple scenarios
• Developer-Focused UX: Easy to use interface with copy-to-clipboard functionality, auto-scroll tracking, and responsive design

The platform transforms complex blockchain debugging from a black-box experience into an intuitive, line-by-line code inspection tool, making it as easy to debug smart contracts as traditional software while maintaining the power and flexibility needed for sophisticated smart contract development.

💻 Demo

Youtube: Demo

📂 Project Links

• Code: Github [https://github.com/Scannty/hyperliquid-simulations]
• Backend API: N/A
• Frontend Demo: N/A
• Documentation: N/A

👥 Team

1. scannty [ X/Twitter | Github ]
2. kocha [ X/Twitter | Github ]