// 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> { let mut r = r.take($crate::consensus::encode::MAX_VEC_SIZE as u64); Ok($thing { $($field: $crate::consensus::Decodable::consensus_decode(&mut r)?),+ }) } } ); } pub(crate) use impl_consensus_encoding; /// 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; #[rustfmt::skip] macro_rules! impl_hashencode { ($hashtype:ident) => { impl $crate::consensus::Encodable for $hashtype { fn consensus_encode(&self, w: &mut W) -> Result { self.0.consensus_encode(w) } } impl $crate::consensus::Decodable for $hashtype { fn consensus_decode(r: &mut R) -> Result { use $crate::hashes::Hash; Ok(Self::from_byte_array(<<$hashtype as $crate::hashes::Hash>::Bytes>::consensus_decode(r)?)) } } }; } pub(crate) use impl_hashencode; #[rustfmt::skip] macro_rules! impl_asref_push_bytes { ($($hashtype:ident),*) => { $( impl AsRef<$crate::blockdata::script::PushBytes> for $hashtype { fn as_ref(&self) -> &$crate::blockdata::script::PushBytes { use $crate::hashes::Hash; self.as_byte_array().into() } } impl From<$hashtype> for $crate::blockdata::script::PushBytesBuf { fn from(hash: $hashtype) -> Self { use $crate::hashes::Hash; hash.as_byte_array().into() } } )* }; } pub(crate) use impl_asref_push_bytes;