// SPDX-License-Identifier: CC0-1.0 //! Internal macros. //! //! Macros meant to be used inside the Rust Bitcoin library. //! macro_rules! impl_consensus_encoding { ($thing:ident, $($field:ident),+) => ( impl $crate::consensus::Encodable for $thing { #[inline] fn consensus_encode( &self, r: &mut R, ) -> Result { let mut len = 0; $(len += self.$field.consensus_encode(r)?;)+ Ok(len) } } impl $crate::consensus::Decodable for $thing { #[inline] fn consensus_decode_from_finite_reader( r: &mut R, ) -> Result<$thing, $crate::consensus::encode::Error> { Ok($thing { $($field: $crate::consensus::Decodable::consensus_decode_from_finite_reader(r)?),+ }) } #[inline] fn consensus_decode( r: &mut R, ) -> Result<$thing, $crate::consensus::encode::Error> { use crate::io::Read as _; let mut r = r.take($crate::consensus::encode::MAX_VEC_SIZE as u64); Ok($thing { $($field: $crate::consensus::Decodable::consensus_decode(r.by_ref())?),+ }) } } ); } pub(crate) use impl_consensus_encoding; // We use test_macros module to keep things organised, re-export everything for ease of use. #[cfg(test)] pub(crate) use test_macros::*; #[cfg(test)] mod test_macros { macro_rules! hex (($hex:expr) => ( as $crate::hex::FromHex>::from_hex($hex).unwrap())); pub(crate) use hex; } /// Implements several traits for byte-based newtypes. /// Implements: /// - core::fmt::LowerHex /// - core::fmt::UpperHex /// - core::fmt::Display /// - core::str::FromStr /// - hex::FromHex macro_rules! impl_bytes_newtype { ($t:ident, $len:literal) => { impl $t { /// Returns a reference the underlying bytes. #[inline] pub fn as_bytes(&self) -> &[u8; $len] { &self.0 } /// Returns the underlying bytes. #[inline] pub fn to_bytes(self) -> [u8; $len] { // We rely on `Copy` being implemented for $t so conversion // methods use the correct Rust naming conventions. fn check_copy() {} check_copy::<$t>(); self.0 } } impl core::fmt::LowerHex for $t { fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { use $crate::hex::{display, Case}; display::fmt_hex_exact!(f, $len, &self.0, Case::Lower) } } impl core::fmt::UpperHex for $t { fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { use $crate::hex::{display, Case}; display::fmt_hex_exact!(f, $len, &self.0, Case::Upper) } } impl core::fmt::Display for $t { fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { core::fmt::LowerHex::fmt(self, f) } } impl core::fmt::Debug for $t { fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { core::fmt::LowerHex::fmt(self, f) } } impl $crate::hex::FromHex for $t { type Err = $crate::hex::HexToArrayError; fn from_byte_iter(iter: I) -> Result where I: core::iter::Iterator> + core::iter::ExactSizeIterator + core::iter::DoubleEndedIterator, { Ok($t($crate::hex::FromHex::from_byte_iter(iter)?)) } } impl core::str::FromStr for $t { type Err = $crate::hex::HexToArrayError; fn from_str(s: &str) -> Result { $crate::hex::FromHex::from_hex(s) } } #[cfg(feature = "serde")] impl $crate::serde::Serialize for $t { fn serialize(&self, s: S) -> Result { if s.is_human_readable() { s.collect_str(self) } else { s.serialize_bytes(&self[..]) } } } #[cfg(feature = "serde")] impl<'de> $crate::serde::Deserialize<'de> for $t { fn deserialize>(d: D) -> Result<$t, D::Error> { if d.is_human_readable() { struct HexVisitor; impl<'de> $crate::serde::de::Visitor<'de> for HexVisitor { type Value = $t; fn expecting(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { f.write_str("an ASCII hex string") } fn visit_bytes(self, v: &[u8]) -> Result where E: $crate::serde::de::Error, { use $crate::serde::de::Unexpected; if let Ok(hex) = core::str::from_utf8(v) { $crate::hex::FromHex::from_hex(hex).map_err(E::custom) } else { return Err(E::invalid_value(Unexpected::Bytes(v), &self)); } } fn visit_str(self, v: &str) -> Result where E: $crate::serde::de::Error, { $crate::hex::FromHex::from_hex(v).map_err(E::custom) } } d.deserialize_str(HexVisitor) } else { struct BytesVisitor; impl<'de> $crate::serde::de::Visitor<'de> for BytesVisitor { type Value = $t; fn expecting(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { f.write_str("a bytestring") } fn visit_bytes(self, v: &[u8]) -> Result where E: $crate::serde::de::Error, { if v.len() != $len { Err(E::invalid_length(v.len(), &stringify!($len))) } else { let mut ret = [0; $len]; ret.copy_from_slice(v); Ok($t(ret)) } } } d.deserialize_bytes(BytesVisitor) } } } }; } pub(crate) use impl_bytes_newtype;