Struct chain_impl_mockchain::accounting::account::Ledger

pub struct Ledger<ID: Hash + Eq, Extra>(Hamt<DefaultHasher, ID, AccountState<Extra>>);

The public ledger of all accounts associated with their current state

Tuple Fields

0: Hamt<DefaultHasher, ID, AccountState<Extra>>

Implementations

impl<ID: Clone + Eq + Hash, Extra: Clone> Ledger<ID, Extra>

pub fn new() -> Self

Create a new empty account ledger

pub fn add_account( &self, identifier: ID, initial_value: Value, extra: Extra ) -> Result<Self, LedgerError>

Add a new account into this ledger.

If the identifier is already present, error out.

pub fn set_delegation( &self, identifier: &ID, delegation: &DelegationType ) -> Result<Self, LedgerError>

Set the delegation of an account in this ledger

pub fn exists(&self, identifier: &ID) -> bool

check if an account already exist

pub fn get_state( &self, account: &ID ) -> Result<&AccountState<Extra>, LedgerError>

Get account state

If the identifier does not match any account, error out

pub fn remove_account(&self, identifier: &ID) -> Result<Self, LedgerError>

Remove an account from this ledger

If the account still have value > 0, then error

pub fn add_value( &self, identifier: &ID, value: Value ) -> Result<Self, LedgerError>

Add value to an existing account.

If the account doesn’t exist, error out.

pub fn add_value_or_account( &self, identifier: &ID, value: Value, extra: Extra ) -> Result<Self, ValueError>

Add value to an existing account.

If the account doesn’t exist, it creates it with the value

pub fn add_rewards_to_account( &self, identifier: &ID, epoch: Epoch, value: Value, extra: Extra ) -> Result<Self, ValueError>

Add rewards to an existing account.

If the account doesn’t exist, it creates it with the value

pub fn spend( &self, identifier: &ID, counter: SpendingCounter, value: Value ) -> Result<Self, LedgerError>

Spend value from an existing account.

If the account doesn’t exist, or if the value is too much to spend, or if the spending counter doesn’t match, it throws a LedgerError.

pub(crate) fn spend_with_no_counter_check( &self, identifier: &ID, counter: SpendingCounter, value: Value ) -> Result<Self, LedgerError>

Spend value from an existing account without spending counter check.

If the account doesn’t exist, or if the value is too much to spend, it throws a LedgerError.

pub fn get_total_value(&self) -> Result<Value, ValueError>

pub fn token_add( &self, identifier: &ID, token: TokenIdentifier, value: Value ) -> Result<Self, LedgerError>

pub fn iter(&self) -> Iter<'_, ID, Extra>

Trait Implementations

impl<ID: Clone + Hash + Eq, Extra: Clone> Clone for Ledger<ID, Extra>

fn clone(&self) -> Ledger<ID, Extra>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<ID: Clone + Eq + Hash + Debug, Extra: Clone + Debug> Debug for Ledger<ID, Extra>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<ID: Clone + Eq + Hash, Extra: Clone> Default for Ledger<ID, Extra>

fn default() -> Self

Returns the “default value” for a type.

impl<ID: Clone + Eq + Hash, Extra: Clone> FromIterator<(ID, AccountState<Extra>)> for Ledger<ID, Extra>

fn from_iter<I: IntoIterator<Item = (ID, AccountState<Extra>)>>(iter: I) -> Self

Creates a value from an iterator.

impl<ID: PartialEq + Hash + Eq, Extra: PartialEq> PartialEq<Ledger<ID, Extra>> for Ledger<ID, Extra>

fn eq(&self, other: &Ledger<ID, Extra>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<ID: Eq + Hash + Eq, Extra: Eq> Eq for Ledger<ID, Extra>

impl<ID: Hash + Eq, Extra> StructuralEq for Ledger<ID, Extra>

impl<ID: Hash + Eq, Extra> StructuralPartialEq for Ledger<ID, Extra>