canfuzz 0.5.0

A coverage-guided fuzzing framework for Internet Computer canisters, built on `libafl` and `pocket-ic`
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use pocket_ic::{ErrorCode, RejectResponse};
use std::{fs::File, io::Read};

use crate::{fuzzer::WasmPath, libafl::executors::ExitKind};

pub fn read_canister_bytes(wasm_path: WasmPath) -> Vec<u8> {
    let wasm_path = match wasm_path {
        WasmPath::EnvVar(env_var) => std::path::PathBuf::from(std::env::var(env_var).unwrap()),
        WasmPath::Path(path) => path,
    };
    let mut f = File::open(wasm_path).unwrap();
    let mut buffer = Vec::new();
    f.read_to_end(&mut buffer).unwrap();
    buffer
}

pub fn parse_canister_result_for_trap(result: Result<Vec<u8>, RejectResponse>) -> ExitKind {
    match result {
        Ok(_) => ExitKind::Ok,
        Err(e) => {
            // println!("{e:?}");
            match e.error_code {
                ErrorCode::CanisterTrapped | ErrorCode::CanisterCalledTrap => ExitKind::Crash,
                ErrorCode::CanisterMemoryAccessLimitExceeded
                | ErrorCode::InsufficientMemoryAllocation
                | ErrorCode::CanisterOutOfMemory
                | ErrorCode::CanisterWasmMemoryLimitExceeded => ExitKind::Oom,
                ErrorCode::CanisterInstructionLimitExceeded => ExitKind::Timeout,
                _ => ExitKind::Ok, // How to handle other errors?
            }
        }
    }
}