Trait frame_support::traits::tokens::fungible::freeze::Mutate

source ·
pub trait Mutate<AccountId>: Inspect<AccountId> {
    // Required methods
    fn set_freeze(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
    ) -> DispatchResult;
    fn extend_freeze(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
    ) -> DispatchResult;
    fn thaw(id: &Self::Id, who: &AccountId) -> DispatchResult;

    // Provided methods
    fn set_frozen(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
        fortitude: Fortitude,
    ) -> DispatchResult { ... }
    fn ensure_frozen(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
        fortitude: Fortitude,
    ) -> DispatchResult { ... }
    fn decrease_frozen(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
    ) -> DispatchResult { ... }
    fn increase_frozen(
        id: &Self::Id,
        who: &AccountId,
        amount: Self::Balance,
    ) -> DispatchResult { ... }
}
Expand description

Trait for introducing, altering and removing freezes for an account for its funds never go below a set minimum.

Required Methods§

source

fn set_freeze( id: &Self::Id, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Prevent actions which would reduce the balance of the account of who below the given amount and identify this restriction though the given id. Unlike extend_freeze, any outstanding freeze in place for who under the id are dropped.

If amount is zero, it is equivalent to using thaw.

Note that amount can be greater than the total balance, if desired.

source

fn extend_freeze( id: &Self::Id, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Prevent the balance of the account of who from being reduced below the given amount and identify this restriction though the given id. Unlike set_freeze, this does not counteract any pre-existing freezes in place for who under the id. Also unlike set_freeze, in the case that amount is zero, this is no-op and never fails.

Note that more funds can be frozen than the total balance, if desired.

source

fn thaw(id: &Self::Id, who: &AccountId) -> DispatchResult

Remove an existing freeze.

Provided Methods§

source

fn set_frozen( id: &Self::Id, who: &AccountId, amount: Self::Balance, fortitude: Fortitude, ) -> DispatchResult

Attempt to alter the amount frozen under the given id to amount.

Fail if the account of who has fewer freezable funds than amount, unless fortitude is Fortitude::Force.

source

fn ensure_frozen( id: &Self::Id, who: &AccountId, amount: Self::Balance, fortitude: Fortitude, ) -> DispatchResult

Attempt to set the amount frozen under the given id to amount, iff this would increase the amount frozen under id. Do nothing otherwise.

Fail if the account of who has fewer freezable funds than amount, unless fortitude is Fortitude::Force.

source

fn decrease_frozen( id: &Self::Id, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Decrease the amount which is being frozen for a particular freeze, failing in the case of underflow.

source

fn increase_frozen( id: &Self::Id, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Increase the amount which is being frozen for a particular freeze, failing in the case that too little balance is available for being frozen.

Object Safety§

This trait is not object safe.

Implementors§

source§

impl<F: MutateFreeze<AccountId>, A: Get<<F as Inspect<AccountId>>::AssetId>, AccountId> Mutate<AccountId> for ItemOf<F, A, AccountId>