#evm #bytecode #human-readable #opcode #string #individual #disassembler

evm-disassembler

Disassemble EVM bytecode into individual Opcodes and format into human readable strings

5 releases (breaking)

0.5.0 Mar 15, 2024
0.4.0 Jan 19, 2024
0.3.0 Oct 24, 2023
0.2.0 Mar 13, 2023
0.1.0 Mar 10, 2023

#16 in #opcode

Download history 2182/week @ 2024-07-07 2126/week @ 2024-07-14 2676/week @ 2024-07-21 1831/week @ 2024-07-28 2767/week @ 2024-08-04 1785/week @ 2024-08-11 1763/week @ 2024-08-18 1971/week @ 2024-08-25 2818/week @ 2024-09-01 1786/week @ 2024-09-08 1686/week @ 2024-09-15 1716/week @ 2024-09-22 1417/week @ 2024-09-29 1594/week @ 2024-10-06 2153/week @ 2024-10-13 1497/week @ 2024-10-20

6,872 downloads per month

MIT/Apache

130KB
543 lines

Disassemble EVM bytecode

Lightweight library with the sole purpose of decoding evm bytecode into individual Opcodes and formatting them in a human readable way

Inspiration

This library was inspired by the pyevmasm. When formatting the decoded operations using the inbuilt function the output should be equivalent to that of pyevasm, which is tested on the bytecode of several large evm contracts.

Installation

cargo add evm-disassembler

Documentation

See the API reference here.

Example

use evm_disassembler::{disassemble_str, disassemble_bytes, format_operations};

fn main() {
   
  let bytecode = "608060405260043610603f57600035";
  // Decode from string directly
  let instructions = disassemble_str(bytecode).unwrap();
  println!("{}", format_operations(instructions));

  let bytes = hex::decode(bytecode).unwrap();
  // Decode from Vec<u8> with identical output as above
  let instructions_from_bytes = disassemble_bytes(bytes).unwrap();
  println!("{}", format_operations(instructions_from_bytes));

}

Tests

You can run the tests as usual with cargo test. The main tests compare the output of this library when decoding contract bytecode against the output from pyevasm. The input and reference files for these tests are saved in testdata. To generate new testdata for these tests you can run the generate_testdata.sh script with an array of ethereum mainnet addresses. (Requires prior installation of foundry and pyevasm).

Dependencies

~200KB