eot 0.2.0

EVM opcodes library with fork-aware gas costs, static metadata, and bytecode analysis
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Integration tests for real-world usage scenarios.

use eot::{Fork, OpCode};

#[test]
fn gas_cost_analysis() {
    let opcodes = [0x01, 0x02]; // ADD, MUL
    let total: u64 = opcodes
        .iter()
        .map(|&b| OpCode::from_byte(b).gas_cost(Fork::London) as u64)
        .sum();
    assert!(
        total < 1000,
        "simple arithmetic should be cheap, got {total}"
    );
    assert!(total > 0);
}

#[test]
fn fork_compatibility_check() {
    // TLOAD/TSTORE only from Cancun
    for &byte in &[0x5c, 0x5d] {
        let op = OpCode::new(byte).unwrap();
        assert!(!op.is_valid_in(Fork::Frontier));
        assert!(!op.is_valid_in(Fork::Shanghai));
        assert!(op.is_valid_in(Fork::Cancun));
        assert!(op.is_valid_in(Fork::Prague));
    }
}

#[test]
fn contract_analysis_workflow() {
    let opcodes = [
        0x60u8, 0x60, 0x52, 0x34, 0x80, 0x15, 0x61, 0x57, 0x60, 0x80, 0xfd,
    ];

    let mut total_gas = 0u64;
    let mut uses_revert = false;
    let mut uses_create = false;
    let mut uses_transient = false;

    for &b in &opcodes {
        if let Some(op) = OpCode::new(b) {
            total_gas += op.gas_cost(Fork::Cancun) as u64;
            match b {
                0xfd => uses_revert = true,
                0xf0 | 0xf5 => uses_create = true,
                0x5c | 0x5d => uses_transient = true,
                _ => {}
            }
        }
    }

    assert!(total_gas > 0);
    assert!(uses_revert);
    assert!(!uses_create);
    assert!(!uses_transient);
}

#[test]
fn minimal_fork_detection() {
    let opcodes = [
        0x01, // ADD (Frontier)
        0xf4, // DELEGATECALL (Homestead)
        0xfd, // REVERT (Byzantium)
        0x5f, // PUSH0 (Shanghai)
    ];

    let min_fork = find_minimal_fork(&opcodes);
    assert_eq!(min_fork, Fork::Shanghai);
}

#[test]
fn upgrade_path_analysis() {
    let london = OpCode::count_at(Fork::London);
    let shanghai = OpCode::count_at(Fork::Shanghai);
    let cancun = OpCode::count_at(Fork::Cancun);

    assert!(shanghai > london, "Shanghai should add PUSH0");
    assert!(
        cancun > shanghai,
        "Cancun should add TLOAD/TSTORE/MCOPY/etc."
    );

    assert!(!OpCode::PUSH0.is_valid_in(Fork::London));
    assert!(OpCode::PUSH0.is_valid_in(Fork::Shanghai));

    assert!(!OpCode::TLOAD.is_valid_in(Fork::Shanghai));
    assert!(OpCode::TLOAD.is_valid_in(Fork::Cancun));
}

#[test]
fn validation_passes() {
    assert!(eot::validation::validate().is_ok());
}

fn find_minimal_fork(opcodes: &[u8]) -> Fork {
    for &fork in Fork::ordered() {
        if opcodes
            .iter()
            .all(|&b| OpCode::from_byte(b).is_valid_in(fork))
        {
            return fork;
        }
    }
    Fork::latest()
}