/ console / program / src / data / register / 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 Register<N> {
 22      /// Serializes the register into 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 Register<N> {
 32      /// Deserializes the register 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, "register"),
 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(Register::<CurrentNetwork>::from_str(&format!("r{i}")).unwrap());
 82              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.a")).unwrap());
 83              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b")).unwrap());
 84              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c")).unwrap());
 85              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c.e")).unwrap());
 86              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c.e.f")).unwrap());
 87              check_serde_json(Register::<CurrentNetwork>::from_str(&format!("r{i}.hello_world_foo_bar")).unwrap());
 88          }
 89      }
 90  
 91      #[test]
 92      fn test_bincode() {
 93          for i in 0..1000 {
 94              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}")).unwrap());
 95              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.a")).unwrap());
 96              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b")).unwrap());
 97              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c")).unwrap());
 98              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c.e")).unwrap());
 99              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.a.b.c.e.f")).unwrap());
100              check_bincode(Register::<CurrentNetwork>::from_str(&format!("r{i}.hello_world_foo_bar")).unwrap());
101          }
102      }
103  }