Struct frame_support::traits::tokens::fungible::ItemOf

pub struct ItemOf<F: Inspect<AccountId>, A: Get<<F as Inspect<AccountId>>::AssetId>, AccountId>(/* private fields */);

Convert a fungibles trait implementation into a fungible trait implementation by identifying a single item.

Trait Implementations

impl<F: BalancedHold<AccountId>, A: Get<<F as Inspect<AccountId>>::AssetId>, AccountId> Balanced<AccountId> for ItemOf<F, A, AccountId>

fn slash( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, ) -> (Credit<AccountId, Self>, Self::Balance)

Reduce the balance of some funds on hold in an account.

fn done_slash(_reason: &Self::Reason, _who: &AccountId, _amount: Self::Balance)

impl<F: Inspect<AccountId> + Unbalanced<AccountId> + Balanced<AccountId>, A: Get<<F as Inspect<AccountId>>::AssetId>, AccountId> Balanced<AccountId> for ItemOf<F, A, AccountId>

type OnDropDebt = ConvertImbalanceDropHandler<AccountId, <ItemOf<F, A, AccountId> as Inspect<AccountId>>::Balance, <F as Inspect<AccountId>>::AssetId, A, <F as Balanced<AccountId>>::OnDropDebt>

The type for managing what happens when an instance of Debt is dropped without being used.

type OnDropCredit = ConvertImbalanceDropHandler<AccountId, <ItemOf<F, A, AccountId> as Inspect<AccountId>>::Balance, <F as Inspect<AccountId>>::AssetId, A, <F as Balanced<AccountId>>::OnDropCredit>

The type for managing what happens when an instance of Credit is dropped without being used.

fn deposit( who: &AccountId, value: Self::Balance, precision: Precision, ) -> Result<Debt<AccountId, Self>, DispatchError>

Mints value into the account of who, creating it as needed.

fn issue(amount: Self::Balance) -> Credit<AccountId, Self>

Increase the total issuance by amount and return the according imbalance. The imbalance will typically be used to increase an account by the same amount with e.g. resolve_into_existing or resolve_creating.

fn pair( amount: Self::Balance, ) -> (Debt<AccountId, Self>, Credit<AccountId, Self>)

Produce a pair of imbalances that cancel each other out exactly.

fn rescind(amount: Self::Balance) -> Debt<AccountId, Self>

Reduce the total issuance by amount and return the according imbalance. The imbalance will typically be used to reduce an account by the same amount with e.g. settle.

fn resolve( who: &AccountId, credit: Credit<AccountId, Self>, ) -> Result<(), Credit<AccountId, Self>>

The balance of who is increased in order to counter credit. If the whole of credit cannot be countered, then nothing is changed and the original credit is returned in an Err.

fn settle( who: &AccountId, debt: Debt<AccountId, Self>, preservation: Preservation, ) -> Result<Credit<AccountId, Self>, Debt<AccountId, Self>>

The balance of who is decreased in order to counter debt. If the whole of debt cannot be countered, then nothing is changed and the original debt is returned in an Err.

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

Removes value balance from who account if possible.

fn done_rescind(_amount: Self::Balance)

fn done_issue(_amount: Self::Balance)

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

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

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

type Reason = <F as Inspect<AccountId>>::Reason

An identifier for a hold. Used for disambiguating different holds so that they can be individually replaced or removed and funds from one hold don’t accidentally become unreserved or slashed for another.

fn reducible_total_balance_on_hold( who: &AccountId, force: Fortitude, ) -> Self::Balance

Get the maximum amount that the total_balance_on_hold of who can be reduced successfully based on whether we are willing to force the reduction and potentially go below user-level restrictions on the minimum amount of the account. Note: This cannot bring the account into an inconsistent state with regards any required existential deposit.

fn hold_available(reason: &Self::Reason, who: &AccountId) -> bool

Returns true if it’s possible to place (additional) funds under a hold of a given reason. This may fail if the account has exhausted a limited number of concurrent holds or if it cannot be made to exist (e.g. there is no provider reference).

fn total_balance_on_hold(who: &AccountId) -> Self::Balance

Amount of funds on hold (for all hold reasons) of who.

fn balance_on_hold(reason: &Self::Reason, who: &AccountId) -> Self::Balance

Amount of funds on hold (for the given reason) of who.

fn can_hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, ) -> bool

Check to see if some amount of funds of who may be placed on hold for the given reason. Reasons why this may not be true:

fn ensure_can_hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Check to see if some amount of funds of who may be placed on hold with the given reason. Reasons why this may not be true:

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

type Balance = <F as Inspect<AccountId>>::Balance

Scalar type for representing balance of an account.

fn total_issuance() -> Self::Balance

The total amount of issuance in the system.

fn active_issuance() -> Self::Balance

The total amount of issuance in the system excluding those which are controlled by the system.

fn minimum_balance() -> Self::Balance

The minimum balance any single account may have.

fn balance(who: &AccountId) -> Self::Balance

Get the balance of who which does not include funds which are exclusively allocated to subsystems of the chain (“on hold” or “reserved”).

fn total_balance(who: &AccountId) -> Self::Balance

Get the total amount of funds whose ultimate beneficial ownership can be determined as who.

fn reducible_balance( who: &AccountId, preservation: Preservation, force: Fortitude, ) -> Self::Balance

Get the maximum amount that who can withdraw/transfer successfully based on whether the account should be kept alive (preservation) or whether we are willing to force the reduction and potentially go below user-level restrictions on the minimum amount of the account.

fn can_deposit( who: &AccountId, amount: Self::Balance, provenance: Provenance, ) -> DepositConsequence

Returns true if the balance of who may be increased by amount.

fn can_withdraw( who: &AccountId, amount: Self::Balance, ) -> WithdrawConsequence<Self::Balance>

Returns Success if the balance of who may be decreased by amount, otherwise the consequence.

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

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.

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

Decrease the balance of who by at least amount, possibly slightly more in the case of minimum-balance requirements, burning the tokens. If that isn’t possible then an Err is returned and nothing is changed. If successful, the amount of tokens reduced is returned.

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

Attempt to decrease the asset balance of who by amount.

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

Attempt to increase the asset balance of who by amount.

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

Transfer funds from one account into another.

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.

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)

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

fn hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Hold some funds in an account. If a hold for reason is already in place, then this will increase it.

fn release( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, ) -> Result<Self::Balance, DispatchError>

Release up to amount held funds in an account.

fn burn_held( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, force: Fortitude, ) -> Result<Self::Balance, DispatchError>

Attempt to decrease the balance of who which is held for the given reason by amount.

fn transfer_on_hold( reason: &Self::Reason, source: &AccountId, dest: &AccountId, amount: Self::Balance, precision: Precision, mode: Restriction, force: Fortitude, ) -> Result<Self::Balance, DispatchError>

Transfer held funds into a destination account.

fn transfer_and_hold( reason: &Self::Reason, source: &AccountId, dest: &AccountId, amount: Self::Balance, precision: Precision, preservation: Preservation, force: Fortitude, ) -> Result<Self::Balance, DispatchError>

Transfer some amount of free balance from source to become owned by dest but on hold for reason.

fn done_hold(_reason: &Self::Reason, _who: &AccountId, _amount: Self::Balance)

fn done_release( _reason: &Self::Reason, _who: &AccountId, _amount: Self::Balance, )

fn done_burn_held( _reason: &Self::Reason, _who: &AccountId, _amount: Self::Balance, )

fn done_transfer_on_hold( _reason: &Self::Reason, _source: &AccountId, _dest: &AccountId, _amount: Self::Balance, )

fn done_transfer_and_hold( _reason: &Self::Reason, _source: &AccountId, _dest: &AccountId, _transferred: Self::Balance, )

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

fn handle_dust(dust: Dust<AccountId, Self>)

where Self: Sized,

Do something with the dust which has been destroyed from the system. Dust can be converted into a Credit with the Balanced trait impl.

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

Forcefully set the balance of who to amount.

fn set_total_issuance(amount: Self::Balance)

Set the total issuance to amount.

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

Reduce the balance of who by amount.

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

Increase the balance of who by amount.

fn handle_raw_dust(amount: Self::Balance)

Create some dust and handle it with Self::handle_dust. This is an unbalanced operation and it must only be used when an account is modified in a raw fashion, outside of the entire fungibles API. The amount is capped at Self::minimum_balance() - 1.

fn deactivate(_: Self::Balance)

Reduce the active issuance by some amount.

fn reactivate(_: Self::Balance)

Increase the active issuance by some amount, up to the outstanding amount reduced.

impl<F: UnbalancedHold<AccountId>, A: Get<<F as Inspect<AccountId>>::AssetId>, AccountId> Unbalanced<AccountId> for ItemOf<F, A, AccountId>

fn set_balance_on_hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, ) -> DispatchResult

Forcefully set the balance on hold of who to amount. This is independent of any other balances on hold or the main (“free”) balance.

fn decrease_balance_on_hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, ) -> Result<Self::Balance, DispatchError>

Reduce the balance on hold of who by amount.

fn increase_balance_on_hold( reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, ) -> Result<Self::Balance, DispatchError>

Increase the balance on hold of who by amount.