FuzzyVM

command module
v0.0.0-...-ec53fa7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 9, 2024 License: LGPL-2.1 Imports: 12 Imported by: 0

README

FuzzyVM [fuzz​ɛvm]

A framework to fuzz Ethereum Virtual Machine implementations. FuzzyVM creates state tests that can be used to differential fuzz EVM implementations against each other. It only focus on the test generation part, the test execution is handled by goevmlab.

Environment

You need to have golang and go-ethereum installed

Install instructions

# Clone the repo to a place of your liking using
git clone git@github.com:MariusVanDerWijden/FuzzyVM.git
# Enter the repo
cd FuzzyVM
# Build the binary
go build
# Create an initial corpus
./FuzzyVM corpus --count 100  
# Run the fuzzer
./FuzzyVM run

Corpus

It makes sense to create an initial corpus in order to improve the efficiency of the fuzzer. You can generate corpus elements with ./FuzzyVM corpus --count N, which will generate N corpus elements.

You might create corpus that is to big, you can minimize your corpus with ./FuzzyVM minCorpus.

Bench

You can run a benchmark with ./FuzzyVM bench.

Documentation

Overview

Package main creates a fuzzer for Ethereum Virtual Machine (evm) implementations.

Directories

Path Synopsis
Package filler can fill objects based on a provided data source.
Package filler can fill objects based on a provided data source.
Package fuzzer is the entry point for go-fuzz.
Package fuzzer is the entry point for go-fuzz.
Package generator provides means to generate state tests for Ethereum.
Package generator provides means to generate state tests for Ethereum.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL