bm-le 0.11.0

Little endian 256-bit layer for binary merkle trie with ssz compatibility and extensions
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
46
47
48
49
50
51
52
53
54
55
56
57

//! Utilities

use bm::{ReadBackend, WriteBackend, Construct, Error};
use primitive_types::U256;
use crate::{CompatibleConstruct, IntoTree, FromTree};

pub use bm::utils::*;

/// Mix in type.
pub fn mix_in_type<T, DB: WriteBackend>(value: &T, db: &mut DB, ty: usize) -> Result<<DB::Construct as Construct>::Value, Error<DB::Error>> where
    T: IntoTree,
    DB::Construct: CompatibleConstruct,
{
    let left = value.into_tree(db)?;
    let right = U256::from(ty).into_tree(db)?;

    (left, right).into_tree(db)
}

/// Decode type.
pub fn decode_with_type<DB: ReadBackend, F, R>(root: &<DB::Construct as Construct>::Value, db: &mut DB, f: F) -> Result<R, Error<DB::Error>> where
    F: FnOnce(&<DB::Construct as Construct>::Value, &mut DB, usize) -> Result<R, Error<DB::Error>>,
    DB::Construct: CompatibleConstruct,
{
    let (value, ty) = <(<DB::Construct as Construct>::Value, U256)>::from_tree(root, db)?;

    if ty > U256::from(usize::max_value()) {
        Err(Error::CorruptedDatabase)
    } else {
        f(&value, db, ty.as_usize())
    }
}

/// Mix in length.
pub fn mix_in_length<T, DB: WriteBackend>(value: &T, db: &mut DB, len: usize) -> Result<<DB::Construct as Construct>::Value, Error<DB::Error>> where
    T: IntoTree,
    DB::Construct: CompatibleConstruct,
{
    let left = value.into_tree(db)?;
    let right = U256::from(len).into_tree(db)?;

    (left, right).into_tree(db)
}

/// Decode length.
pub fn decode_with_length<T, DB: ReadBackend>(root: &<DB::Construct as Construct>::Value, db: &mut DB) -> Result<(T, usize), Error<DB::Error>> where
    T: FromTree,
    DB::Construct: CompatibleConstruct,
{
    let (value, len) = <(T, U256)>::from_tree(root, db)?;

    if len > U256::from(usize::max_value()) {
        Err(Error::CorruptedDatabase)
    } else {
        Ok((value, len.as_usize()))
    }
}