//! Bitcoin script for Zebra use std::{fmt, io}; use hex::ToHex; use crate::serialization::{ zcash_serialize_bytes, SerializationError, ZcashDeserialize, ZcashSerialize, }; /// An encoding of a Bitcoin script. #[derive(Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize)] #[cfg_attr( any(test, feature = "proptest-impl"), derive(proptest_derive::Arbitrary) )] pub struct Script( /// # Correctness /// /// Consensus-critical serialization uses [`ZcashSerialize`]. /// [`serde`]-based hex serialization must only be used for RPCs and testing. #[serde(with = "hex")] Vec, ); impl Script { /// Create a new Bitcoin script from its raw bytes. /// The raw bytes must not contain the length prefix. pub fn new(raw_bytes: &[u8]) -> Self { Script(raw_bytes.to_vec()) } /// Return the raw bytes of the script without the length prefix. /// /// # Correctness /// /// These raw bytes do not have a length prefix. /// The Zcash serialization format requires a length prefix; use `zcash_serialize` /// and `zcash_deserialize` to create byte data with a length prefix. pub fn as_raw_bytes(&self) -> &[u8] { &self.0 } } impl fmt::Display for Script { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.write_str(&self.encode_hex::()) } } impl fmt::Debug for Script { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.debug_tuple("Script") .field(&hex::encode(&self.0)) .finish() } } impl ToHex for &Script { fn encode_hex>(&self) -> T { self.as_raw_bytes().encode_hex() } fn encode_hex_upper>(&self) -> T { self.as_raw_bytes().encode_hex_upper() } } impl ToHex for Script { fn encode_hex>(&self) -> T { (&self).encode_hex() } fn encode_hex_upper>(&self) -> T { (&self).encode_hex_upper() } } impl ZcashSerialize for Script { fn zcash_serialize(&self, writer: W) -> Result<(), io::Error> { zcash_serialize_bytes(&self.0, writer) } } impl ZcashDeserialize for Script { fn zcash_deserialize(reader: R) -> Result { Vec::zcash_deserialize(reader).map(Script) } } #[cfg(test)] mod proptests { use std::io::Cursor; use proptest::prelude::*; use super::*; use crate::serialization::{ZcashDeserialize, ZcashSerialize}; proptest! { #[test] fn script_roundtrip(script in any::