/ console / program / src / data / access / serialize.rs
serialize.rs
 1  // Copyright (c) 2025-2026 ACDC Network
 2  // This file is part of the alphavm library.
 3  //
 4  // Alpha Chain | Delta Chain Protocol
 5  // International Monetary Graphite.
 6  //
 7  // Derived from Aleo (https://aleo.org) and ProvableHQ (https://provable.com).
 8  // They built world-class ZK infrastructure. We installed the EASY button.
 9  // Their cryptography: elegant. Our modifications: bureaucracy-compatible.
10  // Original brilliance: theirs. Robert's Rules: ours. Bugs: definitely ours.
11  //
12  // Original Aleo/ProvableHQ code subject to Apache 2.0 https://www.apache.org/licenses/LICENSE-2.0
13  // All modifications and new work: CC0 1.0 Universal Public Domain Dedication.
14  // No rights reserved. No permission required. No warranty. No refunds.
15  //
16  // https://creativecommons.org/publicdomain/zero/1.0/
17  // SPDX-License-Identifier: CC0-1.0
18  
19  use super::*;
20  
21  impl<N: Network> Serialize for Access<N> {
22      /// Serializes the access into a string or bytes.
23      fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
24          match serializer.is_human_readable() {
25              true => serializer.collect_str(self),
26              false => ToBytesSerializer::serialize_with_size_encoding(self, serializer),
27          }
28      }
29  }
30  
31  impl<'de, N: Network> Deserialize<'de> for Access<N> {
32      /// Deserializes the access from a string or bytes.
33      fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
34          match deserializer.is_human_readable() {
35              true => FromStr::from_str(&String::deserialize(deserializer)?).map_err(de::Error::custom),
36              false => FromBytesDeserializer::<Self>::deserialize_with_size_encoding(deserializer, "access"),
37          }
38      }
39  }
40  
41  #[cfg(test)]
42  mod tests {
43      use super::*;
44      use alphavm_console_network::MainnetV0;
45  
46      type CurrentNetwork = MainnetV0;
47  
48      fn check_serde_json<
49          T: Serialize + for<'a> Deserialize<'a> + Debug + Display + PartialEq + Eq + FromStr + ToBytes + FromBytes,
50      >(
51          expected: T,
52      ) {
53          // Serialize
54          let expected_string = &expected.to_string();
55          let candidate_string = serde_json::to_string(&expected).unwrap();
56          assert_eq!(expected_string, serde_json::Value::from_str(&candidate_string).unwrap().as_str().unwrap());
57  
58          // Deserialize
59          assert_eq!(expected, T::from_str(expected_string).unwrap_or_else(|_| panic!("FromStr: {expected_string}")));
60          assert_eq!(expected, serde_json::from_str(&candidate_string).unwrap());
61      }
62  
63      fn check_bincode<
64          T: Serialize + for<'a> Deserialize<'a> + Debug + Display + PartialEq + Eq + FromStr + ToBytes + FromBytes,
65      >(
66          expected: T,
67      ) {
68          // Serialize
69          let expected_bytes = expected.to_bytes_le().unwrap();
70          let expected_bytes_with_size_encoding = bincode::serialize(&expected).unwrap();
71          assert_eq!(&expected_bytes[..], &expected_bytes_with_size_encoding[8..]);
72  
73          // Deserialize
74          assert_eq!(expected, T::read_le(&expected_bytes[..]).unwrap());
75          assert_eq!(expected, bincode::deserialize(&expected_bytes_with_size_encoding[..]).unwrap());
76      }
77  
78      #[test]
79      fn test_serde_json() {
80          for i in 0..1000 {
81              check_serde_json(Access::<CurrentNetwork>::from_str(&format!(".owner_{i}")).unwrap());
82              check_serde_json(Access::<CurrentNetwork>::from_str(&format!("[{i}u32]")).unwrap());
83          }
84      }
85  
86      #[test]
87      fn test_bincode() {
88          for i in 0..1000 {
89              check_bincode(Access::<CurrentNetwork>::from_str(&format!(".owner_{i}")).unwrap());
90              check_bincode(Access::<CurrentNetwork>::from_str(&format!("[{i}u32]")).unwrap());
91          }
92      }
93  }