Echidna/Medusa Trace Parser

Echidna/Medusa Trace Parser is a Python script designed to parse Echidna and Medusa traces and generate corresponding Solidity test functions. This tool simplifies the process of converting fuzzer output into usable Solidity tests, making it easier to replay call sequences.

Features

• Parse Fuzzer Call Traces: Extracts function calls, parameters, delays, and 'from' addresses from Echidna and Medusa traces.
• Generate Solidity Test Functions: Automatically creates Solidity test functions based on the parsed data.
• User-Friendly Input: Allows users to paste traces directly into the terminal.
• Format Detection: Automatically detects whether the input is an Echidna or Medusa trace.

Prerequisites

• Python 3.x
• Basic familiarity with the command line

Installation

1. Clone the repository:

   git clone https://github.com/Enigma-Dark/fuzz-trace-parser.git
   cd fuzz-trace-parser

2. Download the Script: Alternatively, download the script file directly and save it in a directory of your choice.

3. Ensure Python is Installed: You can check if Python is installed by running:

   python3 --version

   If it's not installed, download and install it from python.org.

Running the Script from Anywhere

To run the Trace Parser from any directory in your terminal, follow these steps:

1. Make the Script Executable

If you're using macOS or Linux, you can make the script executable:

• Open your terminal.
• Navigate to the directory where the script is located:

  cd /path/to/your/directory

• Run the following command to make the script executable:

  chmod +x fuzz_parser.py

2. Add the Script to Your PATH

To run the script from anywhere, you can add its directory to your system's PATH.

On macOS/Linux

• Open your terminal.
• Edit your shell configuration file (like ~/.bashrc, ~/.bash_profile, or ~/.zshrc) and add the following line, replacing /path/to/your/directory with the actual path where your script is located:

  export PATH="$PATH:/path/to/your/directory"

• Save the file and run:

  source ~/.bashrc

  (or the corresponding file for your shell).

On Windows

1. Search for "Environment Variables" in the Start menu.
2. Click on "Edit the system environment variables".
3. In the System Properties window, click on "Environment Variables".
4. In the "System variables" section, find and select the Path variable, then click "Edit".
5. Click "New" and add the full path to the directory where your script is saved.
6. Click OK to save your changes.

Usage

1. Open your terminal.

2. Run the script from anywhere:

   fuzz_parser.py

   or if you haven't made it executable:

   python3 fuzz_parser.py

3. Input your fuzzer call trace:

   • Paste your Echidna or Medusa call trace directly into the terminal.
   • Press Enter twice to finish input.

4. View the Generated Solidity Test Function: The tool will output the generated Solidity test function to the terminal.

Example

Echidna Format Example

Paste your Echidna or Medusa call trace below. Press Enter twice to finish:
Tester.function_name(param1, param2) from: 0x12345 Time delay: 5
*wait* Time delay: 3

Detected Echidna trace format

Generated Foundry Test Function:

function test_replay() public {
    _setUpActor(0x12345);
    _delay(5);
    Tester.function_name(param1, param2);
    _delay(3);
}

Medusa Format Example

Paste your Echidna or Medusa call trace below. Press Enter twice to finish:
1) Tester.deposit(uint256,uint8,uint8)(1239852167739453881995240, 0, 0) (block=2, time=2, gas=1250000000, gasprice=1, value=0, sender=0x10000)
2) Tester.donateUnderlying(uint256,uint8,uint8)(45369402357901978417531215225742791157530708442686125403256020909207651452, 0, 11) (block=2138, time=175249, gas=1250000000, gasprice=1, value=0, sender=0x30000)

Detected Medusa trace format

Generated Foundry Test Function:

function test_replay() public {
    _setUpActor(0x10000);
    _delay(2);
    Tester.deposit(1239852167739453881995240, 0, 0);
    _setUpActor(0x30000);
    _delay(175247);
    Tester.donateUnderlying(45369402357901978417531215225742791157530708442686125403256020909207651452, 0, 11);
}

Contributing

Contributions are welcome! If you would like to contribute to this project, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Push your branch and submit a pull request.

License

This project is not open-source.

Contact

For any inquiries or feedback, feel free to reach out on the organization's Discord server.