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

source ·
pub trait Mutate<AccountId>: Inspect<AccountId> + Unbalanced<AccountId>
where AccountId: Eq,
{ // Provided methods fn mint_into( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError> { ... } fn burn_from( who: &AccountId, amount: Self::Balance, preservation: Preservation, precision: Precision, force: Fortitude, ) -> Result<Self::Balance, DispatchError> { ... } fn shelve( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError> { ... } fn restore( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError> { ... } fn transfer( source: &AccountId, dest: &AccountId, amount: Self::Balance, preservation: Preservation, ) -> Result<Self::Balance, DispatchError> { ... } fn set_balance(who: &AccountId, amount: Self::Balance) -> Self::Balance { ... } fn done_mint_into(_who: &AccountId, _amount: Self::Balance) { ... } fn done_burn_from(_who: &AccountId, _amount: Self::Balance) { ... } fn done_shelve(_who: &AccountId, _amount: Self::Balance) { ... } fn done_restore(_who: &AccountId, _amount: Self::Balance) { ... } fn done_transfer( _source: &AccountId, _dest: &AccountId, _amount: Self::Balance, ) { ... } }
Expand description

Trait for providing a basic fungible asset.

Provided Methods§

source

fn mint_into( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError>

Increase the balance of who by exactly amount, minting new tokens. If that isn’t possible then an Err is returned and nothing is changed.

source

fn burn_from( who: &AccountId, amount: Self::Balance, preservation: Preservation, precision: Precision, force: Fortitude, ) -> Result<Self::Balance, DispatchError>

Attempt to decrease the balance of who, burning the tokens. The actual amount burned is derived from the amount, preservation, precision and force, and might end up being more, less or equal to the amount specified.

If the burn isn’t possible then an Err is returned and nothing is changed. If successful, the amount of tokens reduced is returned.

source

fn shelve( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError>

Attempt to decrease the asset balance of who by amount.

Equivalent to Mutate::burn_from, except with an expectation that within the bounds of some universal issuance, the total assets suspended and resumed will be equivalent. The implementation may be configured such that the total assets suspended may never be less than the total assets resumed (which is the invariant for an issuing system), or the reverse (which the invariant in a non-issuing system).

Because of this expectation, any metadata associated with the asset is expected to survive the suspect-resume cycle.

source

fn restore( who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError>

Attempt to increase the asset balance of who by amount.

Equivalent to Mutate::mint_into, except with an expectation that within the bounds of some universal issuance, the total assets suspended and resumed will be equivalent. The implementation may be configured such that the total assets suspended may never be less than the total assets resumed (which is the invariant for an issuing system), or the reverse (which the invariant in a non-issuing system).

Because of this expectation, any metadata associated with the asset is expected to survive the suspect-resume cycle.

source

fn transfer( source: &AccountId, dest: &AccountId, amount: Self::Balance, preservation: Preservation, ) -> Result<Self::Balance, DispatchError>

Transfer funds from one account into another.

A transfer where the source and destination account are identical is treated as No-OP after checking the preconditions.

source

fn set_balance(who: &AccountId, amount: Self::Balance) -> Self::Balance

Simple infallible function to force an account to have a particular balance, good for use in tests and benchmarks but not recommended for production code owing to the lack of error reporting.

Returns the new balance.

source

fn done_mint_into(_who: &AccountId, _amount: Self::Balance)

source

fn done_burn_from(_who: &AccountId, _amount: Self::Balance)

source

fn done_shelve(_who: &AccountId, _amount: Self::Balance)

source

fn done_restore(_who: &AccountId, _amount: Self::Balance)

source

fn done_transfer(_source: &AccountId, _dest: &AccountId, _amount: Self::Balance)

Object Safety§

This trait is not object safe.

Implementations on Foreign Types§

source§

impl<AccountId: Eq> Mutate<AccountId> for ()

Dummy implementation of Mutate

Implementors§

source§

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