// Copyright 2017-2019 Parity Technologies (UK) Ltd. // This file is part of Substrate. // Substrate is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Substrate is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Substrate. If not, see . //! Generic implementation of a block header. #[cfg(feature = "std")] use serde_derive::Serialize; use crate::codec::{Decode, Encode, Codec, Input, Output, HasCompact, EncodeAsRef}; use crate::traits::{self, Member, SimpleArithmetic, SimpleBitOps, MaybeDisplay, Hash as HashT, DigestItem as DigestItemT, MaybeSerializeDebug, MaybeSerializeDebugButNotDeserialize}; use crate::generic::Digest; /// Abstraction over a block header for a substrate chain. #[derive(PartialEq, Eq, Clone)] #[cfg_attr(feature = "std", derive(Debug, Serialize))] #[cfg_attr(feature = "std", serde(rename_all = "camelCase"))] #[cfg_attr(feature = "std", serde(deny_unknown_fields))] pub struct Header, Hash: HashT, DigestItem> { /// The parent hash. pub parent_hash: ::Output, /// The block number. #[cfg_attr(feature = "std", serde(serialize_with = "serialize_number"))] pub number: Number, /// The state trie merkle root pub state_root: ::Output, /// The merkle root of the extrinsics. pub extrinsics_root: ::Output, /// A chain-specific digest of data useful for light clients or referencing auxiliary data. pub digest: Digest, } #[cfg(feature = "std")] pub fn serialize_number>(val: &T, s: S) -> Result where S: ::serde::Serializer { use substrate_primitives::uint::U256; let v: u128 = (*val).into(); let lower = U256::from(v as u64); let upper = U256::from(v.rotate_left(64) as u64) << 64; ::serde::Serialize::serialize(&(upper + lower), s) } impl Decode for Header where Number: HasCompact + Copy + Into, Hash: HashT, Hash::Output: Decode, DigestItem: DigestItemT + Decode, { fn decode(input: &mut I) -> Option { Some(Header { parent_hash: Decode::decode(input)?, number: <::Type>::decode(input)?.into(), state_root: Decode::decode(input)?, extrinsics_root: Decode::decode(input)?, digest: Decode::decode(input)?, }) } } impl Encode for Header where Number: HasCompact + Copy + Into, Hash: HashT, Hash::Output: Encode, DigestItem: DigestItemT + Encode, { fn encode_to(&self, dest: &mut T) { dest.push(&self.parent_hash); dest.push(&<<::Type as EncodeAsRef<_>>::RefType>::from(&self.number)); dest.push(&self.state_root); dest.push(&self.extrinsics_root); dest.push(&self.digest); } } impl traits::Header for Header where Number: Member + MaybeSerializeDebug + ::rstd::hash::Hash + MaybeDisplay + SimpleArithmetic + Codec + Copy + Into, Hash: HashT, DigestItem: DigestItemT + Codec, Hash::Output: Default + ::rstd::hash::Hash + Copy + Member + MaybeSerializeDebugButNotDeserialize + MaybeDisplay + SimpleBitOps + Codec, { type Number = Number; type Hash = ::Output; type Hashing = Hash; type Digest = Digest; fn number(&self) -> &Self::Number { &self.number } fn set_number(&mut self, num: Self::Number) { self.number = num } fn extrinsics_root(&self) -> &Self::Hash { &self.extrinsics_root } fn set_extrinsics_root(&mut self, root: Self::Hash) { self.extrinsics_root = root } fn state_root(&self) -> &Self::Hash { &self.state_root } fn set_state_root(&mut self, root: Self::Hash) { self.state_root = root } fn parent_hash(&self) -> &Self::Hash { &self.parent_hash } fn set_parent_hash(&mut self, hash: Self::Hash) { self.parent_hash = hash } fn digest(&self) -> &Self::Digest { &self.digest } fn digest_mut(&mut self) -> &mut Self::Digest { &mut self.digest } fn set_digest(&mut self, digest: Self::Digest) { self.digest = digest } fn new( number: Self::Number, extrinsics_root: Self::Hash, state_root: Self::Hash, parent_hash: Self::Hash, digest: Self::Digest ) -> Self { Header { number, extrinsics_root, state_root, parent_hash, digest } } } impl Header where Number: Member + ::rstd::hash::Hash + Copy + MaybeDisplay + SimpleArithmetic + Codec + Into, Hash: HashT, DigestItem: DigestItemT + Codec, Hash::Output: Default + ::rstd::hash::Hash + Copy + Member + MaybeDisplay + SimpleBitOps + Codec, { /// Convenience helper for computing the hash of the header without having /// to import the trait. pub fn hash(&self) -> Hash::Output { Hash::hash_of(self) } } #[cfg(all(test, feature = "std"))] mod tests { use super::*; #[test] fn should_serialize_numbers() { fn serialize(num: u128) -> String { let mut v = vec![]; { let mut ser = ::serde_json::Serializer::new(::std::io::Cursor::new(&mut v)); serialize_number(&num, &mut ser).unwrap(); } String::from_utf8(v).unwrap() } assert_eq!(serialize(0), "\"0x0\"".to_owned()); assert_eq!(serialize(1), "\"0x1\"".to_owned()); assert_eq!(serialize(u64::max_value() as u128), "\"0xffffffffffffffff\"".to_owned()); assert_eq!(serialize(u64::max_value() as u128 + 1), "\"0x10000000000000000\"".to_owned()); } }