fuel-core 0.48.0

Fuel client library is aggregation of all fuels service. It contains the all business logic of the fuel protocol.
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use fuel_core_storage::{
    Mappable,
    blueprint::plain::Plain,
    codec::{
        postcard::Postcard,
        raw::Raw,
    },
    structured_storage::TableWithBlueprint,
};
use fuel_core_types::{
    fuel_tx::{
        Address,
        AssetId,
    },
    fuel_vm::double_key,
};
use rand::{
    Rng,
    distributions::Standard,
    prelude::Distribution,
};

pub type ItemAmount = u64;
pub type TotalBalanceAmount = u128;

double_key!(CoinBalancesKey, Address, address, AssetId, asset_id);
impl Distribution<CoinBalancesKey> for Standard {
    fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> CoinBalancesKey {
        let mut bytes = [0u8; CoinBalancesKey::LEN];
        rng.fill_bytes(bytes.as_mut());
        CoinBalancesKey::from_array(bytes)
    }
}

impl core::fmt::Display for CoinBalancesKey {
    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
        write!(f, "address={} asset_id={}", self.address(), self.asset_id())
    }
}

/// This table stores the balances of coins per owner and asset id.
pub struct CoinBalances;

impl Mappable for CoinBalances {
    type Key = CoinBalancesKey;
    type OwnedKey = Self::Key;
    type Value = TotalBalanceAmount;
    type OwnedValue = Self::Value;
}

impl TableWithBlueprint for CoinBalances {
    type Blueprint = Plain<Raw, Postcard>;
    type Column = super::Column;

    fn column() -> Self::Column {
        Self::Column::CoinBalances
    }
}

#[derive(Clone, Debug, Default, serde::Serialize, serde::Deserialize, PartialEq)]
pub struct MessageBalance {
    pub retryable: TotalBalanceAmount,
    pub non_retryable: TotalBalanceAmount,
}

/// This table stores the balances of messages per owner.
pub struct MessageBalances;

impl Mappable for MessageBalances {
    type Key = Address;
    type OwnedKey = Self::Key;
    type Value = MessageBalance;
    type OwnedValue = Self::Value;
}

impl TableWithBlueprint for MessageBalances {
    type Blueprint = Plain<Raw, Postcard>;
    type Column = super::Column;

    fn column() -> Self::Column {
        Self::Column::MessageBalances
    }
}

#[cfg(test)]
mod test {
    use super::*;

    fuel_core_storage::basic_storage_tests!(
        CoinBalances,
        <CoinBalances as Mappable>::Key::default(),
        <CoinBalances as Mappable>::Value::default()
    );

    fuel_core_storage::basic_storage_tests!(
        MessageBalances,
        <MessageBalances as Mappable>::Key::default(),
        <MessageBalances as Mappable>::Value::default()
    );
}