radix-transactions 1.3.1

Various Radix transaction models and the manifest compiler/decompiler, from the Radix DLT project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

use crate::internal_prelude::*;

/// This is created as part of the preparation of a transaction, during decoding.
#[derive(Debug, Clone, Eq, PartialEq)]
pub struct Summary {
    /// This is an approximation of the encoded length of the underlying items contained within the item,
    /// which needs to be **deterministic** from the information in the hash.
    /// Not necessarily the _actual_ length of the payload.
    pub effective_length: usize,
    /// The total number of bytes which were hashed.
    pub total_bytes_hashed: usize,
    /// The hash by which this payload is identified.
    /// This might be a hash of the payload itself, or of a composite hash of some concatenation of other hashes/values.
    pub hash: Hash,
}

pub trait HasSummary {
    fn get_summary(&self) -> &Summary;
    fn summary_mut(&mut self) -> &mut Summary;
}

macro_rules! impl_has_summary {
    (
        $(< $( $lt:tt $( : $clt:tt $(+ $dlt:tt )* )? $( = $deflt:tt)? ),+ >)?
        $prepared:ident
        $(< $($rt:tt),+ >)?
    ) => {
        #[allow(deprecated)]
        impl
            $(< $( $lt $( : $clt $(+ $dlt )* )? $( = $deflt)? ),+ >)?
            HasSummary for $prepared
            $(< $( $rt ),+ >)?
        {
            fn get_summary(&self) -> &Summary {
                &self.summary
            }

            fn summary_mut(&mut self) -> &mut Summary {
                &mut self.summary
            }
        }
    };
}

pub(crate) use impl_has_summary;