/ console / program / src / data / record / 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 Record<N, Plaintext<N>> {
 22      /// Serializes the record plaintext into a string or as 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 Record<N, Plaintext<N>> {
 32      /// Deserializes the record plaintext 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, "record plaintext"),
 37          }
 38      }
 39  }
 40  
 41  impl<N: Network> Serialize for Record<N, Ciphertext<N>> {
 42      /// Serializes the record ciphertext into a string or as bytes.
 43      fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
 44          match serializer.is_human_readable() {
 45              true => serializer.collect_str(self),
 46              false => ToBytesSerializer::serialize_with_size_encoding(self, serializer),
 47          }
 48      }
 49  }
 50  
 51  impl<'de, N: Network> Deserialize<'de> for Record<N, Ciphertext<N>> {
 52      /// Deserializes the record ciphertext from a string or bytes.
 53      fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
 54          match deserializer.is_human_readable() {
 55              true => FromStr::from_str(&String::deserialize(deserializer)?).map_err(de::Error::custom),
 56              false => FromBytesDeserializer::<Self>::deserialize_with_size_encoding(deserializer, "record ciphertext"),
 57          }
 58      }
 59  }
 60  
 61  #[cfg(test)]
 62  mod tests {
 63      use super::*;
 64      use alphavm_console_network::MainnetV0;
 65  
 66      type CurrentNetwork = MainnetV0;
 67  
 68      const ITERATIONS: u64 = 1;
 69  
 70      #[test]
 71      fn test_serde_json_without_version() -> Result<()> {
 72          for _ in 0..ITERATIONS {
 73              // Sample a new record.
 74              let expected = Record::<CurrentNetwork, Plaintext<CurrentNetwork>>::from_str(
 75                  "{ owner: ax150w2lvhdzychwvzu54ys5zas7tm5s0ycdyw563pms83g9u0vucgqe5fs5w.private, token_amount: 100u64.private, _nonce: 0group.public }",
 76              )?;
 77              println!("{}", serde_json::to_string_pretty(&expected)?);
 78  
 79              // Serialize
 80              let expected_string = &expected.to_string();
 81              let candidate_string = serde_json::to_string(&expected)?;
 82              assert_eq!(expected_string, serde_json::Value::from_str(&candidate_string)?.as_str().unwrap());
 83  
 84              // Deserialize
 85              assert_eq!(expected, Record::from_str(expected_string)?);
 86              assert_eq!(expected, serde_json::from_str(&candidate_string)?);
 87          }
 88          Ok(())
 89      }
 90  
 91      #[test]
 92      fn test_serde_json_with_version() -> Result<()> {
 93          for _ in 0..ITERATIONS {
 94              // Sample a new record.
 95              let expected = Record::<CurrentNetwork, Plaintext<CurrentNetwork>>::from_str(
 96                  "{ owner: ax150w2lvhdzychwvzu54ys5zas7tm5s0ycdyw563pms83g9u0vucgqe5fs5w.private, token_amount: 100u64.private, _nonce: 0group.public, _version: 1u8.public }",
 97              )?;
 98              println!("{}", serde_json::to_string_pretty(&expected)?);
 99  
100              // Serialize
101              let expected_string = &expected.to_string();
102              let candidate_string = serde_json::to_string(&expected)?;
103              assert_eq!(expected_string, serde_json::Value::from_str(&candidate_string)?.as_str().unwrap());
104  
105              // Deserialize
106              assert_eq!(expected, Record::from_str(expected_string)?);
107              assert_eq!(expected, serde_json::from_str(&candidate_string)?);
108          }
109          Ok(())
110      }
111  
112      #[test]
113      fn test_bincode_without_version() -> Result<()> {
114          for _ in 0..ITERATIONS {
115              // Sample a new record.
116              let expected = Record::<CurrentNetwork, Plaintext<CurrentNetwork>>::from_str(
117                  "{ owner: ax150w2lvhdzychwvzu54ys5zas7tm5s0ycdyw563pms83g9u0vucgqe5fs5w.private, token_amount: 100u64.private, _nonce: 0group.public }",
118              )?;
119  
120              // Serialize
121              let expected_bytes = expected.to_bytes_le()?;
122              let expected_bytes_with_size_encoding = bincode::serialize(&expected)?;
123              assert_eq!(&expected_bytes[..], &expected_bytes_with_size_encoding[8..]);
124  
125              // Deserialize
126              assert_eq!(expected, Record::read_le(&expected_bytes[..])?);
127              assert_eq!(expected, bincode::deserialize(&expected_bytes_with_size_encoding[..])?);
128          }
129          Ok(())
130      }
131  
132      #[test]
133      fn test_bincode_with_version() -> Result<()> {
134          for _ in 0..ITERATIONS {
135              // Sample a new record.
136              let expected = Record::<CurrentNetwork, Plaintext<CurrentNetwork>>::from_str(
137                  "{ owner: ax150w2lvhdzychwvzu54ys5zas7tm5s0ycdyw563pms83g9u0vucgqe5fs5w.private, token_amount: 100u64.private, _nonce: 0group.public, _version: 1u8.public }",
138              )?;
139  
140              // Serialize
141              let expected_bytes = expected.to_bytes_le()?;
142              let expected_bytes_with_size_encoding = bincode::serialize(&expected)?;
143              assert_eq!(&expected_bytes[..], &expected_bytes_with_size_encoding[8..]);
144  
145              // Deserialize
146              assert_eq!(expected, Record::read_le(&expected_bytes[..])?);
147              assert_eq!(expected, bincode::deserialize(&expected_bytes_with_size_encoding[..])?);
148          }
149          Ok(())
150      }
151  }