cubipods 0.1.1

A minimal EVM implemented in Rust.
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

use std::{error::Error, fmt::Display};

use crate::instruction::InstructionType;

#[derive(Debug, PartialEq)]
pub enum LexerError {
    UnableToCreateLexer,
    HasWhitespace,
    EmptyChar,
    InvalidNibble,
}

impl Display for LexerError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            LexerError::UnableToCreateLexer => {
                write!(f, "An error occured while creating lexer.")
            }
            LexerError::HasWhitespace => {
                write!(f, "A nibble cannot contain whitespace.")
            }
            LexerError::EmptyChar => {
                write!(f, "A nibble cannot be empty character.")
            }
            LexerError::InvalidNibble => {
                write!(f, "A nibble must be hex digit.")
            }
        }
    }
}

impl Error for LexerError {}

#[derive(Debug)]
pub enum InstructionError {
    InvalidInstruction([u8; 2]),
}

impl Display for InstructionError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            InstructionError::InvalidInstruction(opcode) => {
                write!(f, "The opcode {:?} is unknown.", opcode)
            }
        }
    }
}

impl Error for InstructionError {}

#[derive(Debug)]
pub enum StackError {
    StackOverflow,
    StackUnderflow,
    StackSizeExceeded,
    StackIsEmpty,
    WrongIndex,
}

impl Display for StackError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            StackError::StackOverflow => {
                write!(f, "The stack size exceeded.")
            }
            StackError::StackUnderflow => {
                write!(f, "The stack is currently empty.")
            }
            StackError::StackSizeExceeded => {
                write!(f, "The given index is out of stack size.")
            }
            StackError::StackIsEmpty => {
                write!(f, "Stack is empty.")
            }
            StackError::WrongIndex => {
                write!(f, "Given index is wrong.")
            }
        }
    }
}

impl Error for StackError {}

#[derive(Debug)]
pub enum VmError<'a> {
    ShallowStack(&'a InstructionType),
    IncompatibleSize(InstructionType),
}

impl<'a> Display for VmError<'a> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            VmError::ShallowStack(instruction_type) => {
                write!(f, "Cannot call {:?} opcode.", instruction_type)
            }
            VmError::IncompatibleSize(instruction_type) => {
                write!(f, "Size exceeds {:?} opcode limit.", instruction_type)
            }
        }
    }
}

impl<'a> Error for VmError<'a> {}

#[derive(Debug)]
pub enum HistoryError {
    EmptyDescription,
}

impl Display for HistoryError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            HistoryError::EmptyDescription => {
                write!(f, "Provided description is empty.")
            }
        }
    }
}

impl Error for HistoryError {}

#[derive(Debug)]
pub enum Bytes32Error {
    InvalidStr,
    U128ConversionFailed,
}

impl Error for Bytes32Error {}

impl Display for Bytes32Error {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Bytes32Error::InvalidStr => {
                write!(f, "Invalid string is provided.")
            }
            Bytes32Error::U128ConversionFailed => {
                write!(f, "The conversion from Bytes32 to u128 is failed.")
            }
        }
    }
}