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  use alphavm_utilities::DeserializeExt;
 22  
 23  impl<N: Network> Serialize for TransitionLeaf<N> {
 24      /// Serializes the leaf into string or bytes.
 25      fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
 26          match serializer.is_human_readable() {
 27              true => {
 28                  let mut leaf = serializer.serialize_struct("TransitionLeaf", 4)?;
 29                  leaf.serialize_field("version", &self.version)?;
 30                  leaf.serialize_field("index", &self.index)?;
 31                  leaf.serialize_field("variant", &self.variant)?;
 32                  leaf.serialize_field("id", &self.id)?;
 33                  leaf.end()
 34              }
 35              false => ToBytesSerializer::serialize_with_size_encoding(self, serializer),
 36          }
 37      }
 38  }
 39  
 40  impl<'de, N: Network> Deserialize<'de> for TransitionLeaf<N> {
 41      /// Deserializes the leaf from a string or bytes.
 42      fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
 43          match deserializer.is_human_readable() {
 44              true => {
 45                  // Parse the leaf from a string into a value.
 46                  let mut leaf = serde_json::Value::deserialize(deserializer)?;
 47                  // Recover the leaf.
 48                  Ok(Self::from(
 49                      // Retrieve the version.
 50                      DeserializeExt::take_from_value::<D>(&mut leaf, "version")?,
 51                      // Retrieve the index.
 52                      DeserializeExt::take_from_value::<D>(&mut leaf, "index")?,
 53                      // Retrieve the variant.
 54                      DeserializeExt::take_from_value::<D>(&mut leaf, "variant")?,
 55                      // Retrieve the id.
 56                      DeserializeExt::take_from_value::<D>(&mut leaf, "id")?,
 57                  ))
 58              }
 59              false => FromBytesDeserializer::<Self>::deserialize_with_size_encoding(deserializer, "transition leaf"),
 60          }
 61      }
 62  }
 63  
 64  #[cfg(test)]
 65  mod tests {
 66      use super::*;
 67  
 68      #[test]
 69      fn test_serde_json() -> Result<()> {
 70          let mut rng = TestRng::default();
 71  
 72          // Sample the leaf.
 73          let expected = test_helpers::sample_leaf(&mut rng);
 74  
 75          // Serialize
 76          let expected_string = &expected.to_string();
 77          let candidate_string = serde_json::to_string(&expected)?;
 78          assert_eq!(expected, serde_json::from_str(&candidate_string)?);
 79  
 80          // Deserialize
 81          assert_eq!(expected, TransitionLeaf::from_str(expected_string)?);
 82          assert_eq!(expected, serde_json::from_str(&candidate_string)?);
 83  
 84          Ok(())
 85      }
 86  
 87      #[test]
 88      fn test_bincode() -> Result<()> {
 89          let mut rng = TestRng::default();
 90  
 91          // Sample the leaf.
 92          let expected = test_helpers::sample_leaf(&mut rng);
 93  
 94          // Serialize
 95          let expected_bytes = expected.to_bytes_le()?;
 96          let expected_bytes_with_size_encoding = bincode::serialize(&expected)?;
 97          assert_eq!(&expected_bytes[..], &expected_bytes_with_size_encoding[8..]);
 98  
 99          // Deserialize
100          assert_eq!(expected, TransitionLeaf::read_le(&expected_bytes[..])?);
101          assert_eq!(expected, bincode::deserialize(&expected_bytes_with_size_encoding[..])?);
102  
103          Ok(())
104      }
105  }