wacc 2.0.0

Web Assembly Cryptographic Constructs VM implementation
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

// SPDX-License-Identifier: Apache-2.0
use std::{fmt, sync::Arc};

/// The values that can be pushed onto the stack
///
/// Values use `Arc` for binary and string data to enable cheap cloning.
/// This significantly reduces allocations when values are pushed/popped
/// from stacks or retrieved from storage.
#[derive(Clone, PartialEq, Eq)]
pub enum Value {
    /// A binary blob value with debugging hint
    Bin {
        /// Arbitrary description of the data for debugging purposes (empty if unused)
        hint: String,
        /// Binary value data (reference-counted for cheap cloning)
        data: Arc<[u8]>,
    },
    /// A printable string value with debugging hint
    Str {
        /// Arbitrary description of the data for debugging purposes (empty if unused)
        hint: String,
        /// String value data (reference-counted for cheap cloning)
        data: Arc<str>,
    },
    /// Success marker
    Success(usize),
    /// Failure marker
    Failure(String),
}

impl fmt::Debug for Value {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::Bin { hint, data } => write!(f, "Bin(\"{}\": {} bytes)", hint, data.len()),
            Self::Str { hint, data } => write!(f, "Str(\"{}\": {} bytes)", hint, data.len()),
            Self::Success(n) => write!(f, "Success({n})"),
            Self::Failure(e) => write!(f, "Failure(\"{e}\")"),
        }
    }
}

impl From<&[u8]> for Value {
    fn from(b: &[u8]) -> Self {
        Self::Bin {
            hint: String::new(),
            data: Arc::from(b),
        }
    }
}

impl From<Vec<u8>> for Value {
    fn from(b: Vec<u8>) -> Self {
        Self::Bin {
            hint: String::new(),
            data: Arc::from(b.into_boxed_slice()),
        }
    }
}

impl From<&str> for Value {
    fn from(s: &str) -> Self {
        Self::Str {
            hint: String::new(),
            data: Arc::from(s),
        }
    }
}

impl From<String> for Value {
    fn from(s: String) -> Self {
        Self::Str {
            hint: String::new(),
            data: Arc::from(s.into_boxed_str()),
        }
    }
}

impl From<usize> for Value {
    fn from(n: usize) -> Self {
        Self::Success(n)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_string_value() {
        let v: Value = "foo".into();
        assert_eq!(
            Value::Str {
                hint: String::new(),
                data: Arc::from("foo"),
            },
            v
        );
    }

    #[test]
    fn test_number_value() {
        let v: Value = 1.into();
        assert_eq!(Value::Success(1), v);
    }
}