arch_sdk 0.6.4

A Rust SDK for building applications on the Arch Network blockchain platform. Provides tools and interfaces for developing, testing, and deploying programs with native Bitcoin integration.
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

use bitcode::{Decode, Encode};
use borsh::{BorshDeserialize, BorshSerialize};
#[cfg(feature = "fuzzing")]
use libfuzzer_sys::arbitrary;
use serde::{Deserialize, Serialize};

#[derive(Clone, Debug, Eq, PartialEq, BorshSerialize, BorshDeserialize, Hash, Encode, Decode)]
#[cfg_attr(feature = "fuzzing", derive(arbitrary::Arbitrary))]
pub struct Signature(pub [u8; 64]);

impl Signature {
    pub fn to_array(&self) -> [u8; 64] {
        self.0
    }
}

impl From<[u8; 64]> for Signature {
    fn from(data: [u8; 64]) -> Self {
        Self(data)
    }
}

impl From<Signature> for [u8; 64] {
    fn from(signature: Signature) -> Self {
        signature.0
    }
}

impl Serialize for Signature {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        serializer.serialize_bytes(&self.0)
    }
}

impl<'de> Deserialize<'de> for Signature {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        use serde::de::{self, Visitor};

        struct SignatureVisitor;

        impl<'de> Visitor<'de> for SignatureVisitor {
            type Value = Signature;

            fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
                formatter.write_str("a 64-byte array")
            }

            fn visit_bytes<E>(self, v: &[u8]) -> Result<Self::Value, E>
            where
                E: de::Error,
            {
                if v.len() != 64 {
                    return Err(E::custom(format!("expected 64 bytes, got {}", v.len())));
                }
                let mut bytes = [0u8; 64];
                bytes.copy_from_slice(v);
                Ok(Signature(bytes))
            }

            fn visit_seq<A>(self, mut seq: A) -> Result<Self::Value, A::Error>
            where
                A: de::SeqAccess<'de>,
            {
                let mut bytes = [0u8; 64];
                for (i, byte) in bytes.iter_mut().enumerate() {
                    *byte = seq
                        .next_element()?
                        .ok_or_else(|| de::Error::invalid_length(i, &self))?;
                }
                Ok(Signature(bytes))
            }
        }

        deserializer.deserialize_bytes(SignatureVisitor)
    }
}

use proptest::prelude::*;

proptest! {
    #[test]
    fn fuzz_serialize_deserialize_signature(bytes in prop::collection::vec(any::<u8>(), 64..=64)) {
        let mut signature_bytes = [0u8; 64];
        signature_bytes.copy_from_slice(&bytes);
        let signature = Signature::from(signature_bytes);

        // Test internal serialize method
        let serialized = signature.to_array();
        let deserialized = Signature::from(serialized);
        assert_eq!(signature, deserialized);

        // Test serde JSON serialization/deserialization
        let json = serde_json::to_string(&signature).unwrap();
        let from_json: Signature = serde_json::from_str(&json).unwrap();
        assert_eq!(signature, from_json);
    }
}

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

    #[test]
    fn test_serde_serialize_deserialize() {
        // Test with a known signature
        let bytes = [42u8; 64];
        let signature = Signature::from(bytes);

        // Test JSON serialization/deserialization
        let json = serde_json::to_string(&signature).unwrap();
        let from_json: Signature = serde_json::from_str(&json).unwrap();
        assert_eq!(signature, from_json);

        // Test that the JSON is an array (serialize_bytes outputs as array in JSON)
        let json_value: serde_json::Value = serde_json::from_str(&json).unwrap();
        assert!(json_value.is_array());

        // Test with all zeros
        let zeros = Signature::from([0u8; 64]);
        let json_zeros = serde_json::to_string(&zeros).unwrap();
        let from_json_zeros: Signature = serde_json::from_str(&json_zeros).unwrap();
        assert_eq!(zeros, from_json_zeros);

        // Test with all 255s
        let max = Signature::from([255u8; 64]);
        let json_max = serde_json::to_string(&max).unwrap();
        let from_json_max: Signature = serde_json::from_str(&json_max).unwrap();
        assert_eq!(max, from_json_max);
    }
}