radix-common 1.3.1

A library of common types and functions shared by all layers of the Radix stack, from the Radix DLT project.
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

use crate::internal_prelude::*;

#[cfg_attr(
    feature = "fuzzing",
    derive(::arbitrary::Arbitrary, ::serde::Serialize, ::serde::Deserialize)
)]
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct ManifestBlobRef(pub [u8; 32]);

//========
// error
//========

/// Represents an error when parsing ManifestBlobRef.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ParseManifestBlobRefError {
    InvalidLength,
}

#[cfg(not(feature = "alloc"))]
impl std::error::Error for ParseManifestBlobRefError {}

#[cfg(not(feature = "alloc"))]
impl fmt::Display for ParseManifestBlobRefError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{:?}", self)
    }
}

//========
// binary
//========

impl TryFrom<&[u8]> for ManifestBlobRef {
    type Error = ParseManifestBlobRefError;

    fn try_from(slice: &[u8]) -> Result<Self, Self::Error> {
        if slice.len() != 32 {
            return Err(Self::Error::InvalidLength);
        }
        Ok(Self(copy_u8_array(slice)))
    }
}

impl ManifestBlobRef {
    pub fn to_vec(&self) -> Vec<u8> {
        self.0.to_vec()
    }
}

manifest_type!(ManifestBlobRef, ManifestCustomValueKind::Blob, 32);

impl sbor::Describe<ScryptoCustomTypeKind> for ManifestBlobRef {
    const TYPE_ID: sbor::RustTypeId = <Vec<u8> as Describe<ScryptoCustomTypeKind>>::TYPE_ID;

    fn type_data() -> sbor::TypeData<ScryptoCustomTypeKind, sbor::RustTypeId> {
        Vec::<u8>::type_data()
    }
}

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

    #[test]
    fn manifest_blob_parse_fail() {
        let buf = Vec::from_iter(0..32u8);

        let blob = ManifestBlobRef(buf.as_slice().try_into().unwrap());
        let mut blob_vec = blob.to_vec();

        assert!(ManifestBlobRef::try_from(blob_vec.as_slice()).is_ok());

        // malform encoded vector
        blob_vec.push(0);
        let blob_out = ManifestBlobRef::try_from(blob_vec.as_slice());
        assert_matches!(blob_out, Err(ParseManifestBlobRefError::InvalidLength));

        #[cfg(not(feature = "alloc"))]
        println!("Manifest Blob error: {}", blob_out.unwrap_err());
    }

    #[test]
    fn manifest_blob_encode_decode_fail() {
        let mut buf = Vec::new();
        let mut encoder = VecEncoder::<ManifestCustomValueKind>::new(&mut buf, 1);
        let malformed_value: u8 = 0;
        encoder.write_slice(&malformed_value.to_le_bytes()).unwrap();

        let mut decoder = VecDecoder::<ManifestCustomValueKind>::new(&buf, 1);
        let blob_output = decoder
            .decode_deeper_body_with_value_kind::<ManifestBlobRef>(ManifestBlobRef::value_kind());

        // expecting 4 bytes, found only 1, so Buffer Underflow error should occur
        assert_matches!(blob_output, Err(DecodeError::BufferUnderflow { .. }));
    }
}