Struct frame_support::traits::tokens::fungible::UnionOf

pub struct UnionOf<Left, Right, Criterion, AssetKind, AccountId>(/* private fields */);

Type to combine some fungible::* and fungibles::* implementations into one union fungibles::* implementation.

Parameters:

• Left is fungible::* implementation that is incorporated into the resulting union.
• Right is fungibles::* implementation that is incorporated into the resulting union.
• Criterion determines whether the AssetKind belongs to the Left or Right set.
• AssetKind is a superset type encompassing asset kinds from Left and Right sets.
• AccountId is an account identifier type.

Trait Implementations

impl<Left: Inspect<AccountId> + AccountTouch<(), AccountId, Balance = <Left as Inspect<AccountId>>::Balance>, Right: Inspect<AccountId> + AccountTouch<Right::AssetId, AccountId, Balance = <Left as Inspect<AccountId>>::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> AccountTouch<AssetKind, AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

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

The type for currency units of the deposit.

fn deposit_required(asset: AssetKind) -> Self::Balance

The deposit amount of a native currency required for touching an account of the asset.

fn should_touch(asset: AssetKind, who: &AccountId) -> bool

Check if an account for a given asset should be touched to meet the existence requirements.

fn touch( asset: AssetKind, who: &AccountId, depositor: &AccountId, ) -> DispatchResult

Create an account for who of the asset with a deposit taken from the depositor.

impl<Left: Balanced<AccountId>, Right: Balanced<AccountId, Balance = Left::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Balanced<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

type OnDropDebt = ConvertImbalanceDropHandler<<Left as Balanced<AccountId>>::OnDropDebt, <Right as Balanced<AccountId>>::OnDropDebt, Criterion, AssetKind, <Left as Inspect<AccountId>>::Balance, <Right as Inspect<AccountId>>::AssetId, AccountId>

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

type OnDropCredit = ConvertImbalanceDropHandler<<Left as Balanced<AccountId>>::OnDropCredit, <Right as Balanced<AccountId>>::OnDropCredit, Criterion, AssetKind, <Left as Inspect<AccountId>>::Balance, <Right as Inspect<AccountId>>::AssetId, AccountId>

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

fn deposit( asset: Self::AssetId, 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(asset: Self::AssetId, 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( asset: Self::AssetId, amount: Self::Balance, ) -> Result<(Debt<AccountId, Self>, Credit<AccountId, Self>), DispatchError>

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

fn rescind(asset: Self::AssetId, 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( asset: Self::AssetId, 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(_asset: Self::AssetId, _amount: Self::Balance)

fn done_issue(_asset: Self::AssetId, _amount: Self::Balance)

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

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

impl<Left: BalancedHold<AccountId> + DoneSlash<Self::Reason, AccountId, Self::Balance>, Right: BalancedHold<AccountId, Balance = Left::Balance, Reason = Left::Reason> + DoneSlash<AssetKind, Left::Reason, AccountId, Left::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Balanced<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

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

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

impl<Left: Inspect<AccountId>, Right: Inspect<AccountId, Balance = Left::Balance> + Create<AccountId>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Create<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn create( asset: AssetKind, admin: AccountId, is_sufficient: bool, min_balance: Self::Balance, ) -> DispatchResult

Create a new fungible asset.

impl<Reason, Balance, Left: DoneSlash<Reason, AccountId, Balance>, Right: DoneSlash<Right::AssetId, Reason, AccountId, Balance> + Inspect<AccountId>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> DoneSlash<AssetKind, Reason, AccountId, Balance> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn done_slash( asset: AssetKind, reason: &Reason, who: &AccountId, amount: Balance, )

impl<Left: InspectHold<AccountId>, Right: InspectHold<AccountId, Balance = Left::Balance, Reason = Left::Reason>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Inspect<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

type Reason = <Left 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( asset: Self::AssetId, 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( asset: Self::AssetId, 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(asset: Self::AssetId, who: &AccountId) -> Self::Balance

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

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

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

fn can_hold( asset: Self::AssetId, 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( asset: Self::AssetId, 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<Left: InspectFreeze<AccountId>, Right: InspectFreeze<AccountId, Balance = Left::Balance, Id = Left::Id>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Inspect<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

type Id = <Left as Inspect<AccountId>>::Id

An identifier for a freeze.

fn balance_frozen( asset: Self::AssetId, id: &Self::Id, who: &AccountId, ) -> Self::Balance

Amount of funds held in reserve by who for the given id.

fn balance_freezable(asset: Self::AssetId, who: &AccountId) -> Self::Balance

The amount of the balance which can become frozen. Defaults to total_balance().

fn can_freeze(asset: Self::AssetId, id: &Self::Id, who: &AccountId) -> bool

Returns true if it’s possible to introduce a freeze for the given id onto the account of who. This will be true as long as the implementor supports as many concurrent freeze locks as there are possible values of id.

impl<Left: Inspect<AccountId>, Right: Inspect<AccountId, Balance = Left::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Inspect<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

type AssetId = AssetKind

Means of identifying one asset class from another.

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

Scalar type for representing balance of an account.

fn total_issuance(asset: Self::AssetId) -> Self::Balance

The total amount of issuance in the system.

fn active_issuance(asset: Self::AssetId) -> Self::Balance

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

fn minimum_balance(asset: Self::AssetId) -> Self::Balance

The minimum balance any single account may have.

fn balance(asset: Self::AssetId, 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(asset: Self::AssetId, who: &AccountId) -> Self::Balance

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

fn reducible_balance( asset: Self::AssetId, 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 transfer and potentially go below user-level restrictions on the minimum amount of the account.

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

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

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

Returns Failed if the asset balance of who may not be decreased by amount, otherwise the consequence.

fn asset_exists(asset: Self::AssetId) -> bool

Returns true if an asset exists.

impl<Left: Mutate<AccountId>, Right: Mutate<AccountId, Balance = Left::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId: Eq> Mutate<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn mint_into( asset: Self::AssetId, 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( asset: Self::AssetId, who: &AccountId, amount: Self::Balance, preservation: Preservation, 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( asset: Self::AssetId, who: &AccountId, amount: Self::Balance, ) -> Result<Self::Balance, DispatchError>

Attempt to decrease the asset balance of who by amount.

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

Attempt to increase the asset balance of who by amount.

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

Transfer funds from one account into another.

fn set_balance( asset: Self::AssetId, 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( _asset: Self::AssetId, _who: &AccountId, _amount: Self::Balance, )

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

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

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

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

impl<Left: MutateHold<AccountId>, Right: MutateHold<AccountId, Balance = Left::Balance, Reason = Left::Reason>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Mutate<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn hold( asset: Self::AssetId, 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( asset: Self::AssetId, 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( asset: Self::AssetId, reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, force: Fortitude, ) -> Result<Self::Balance, DispatchError>

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

fn transfer_on_hold( asset: Self::AssetId, 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( asset: Self::AssetId, 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. for reason.

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

Attempt to decrease the asset balance of who which is held for the given reason to zero.

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

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

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

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

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

impl<Left: MutateFreeze<AccountId>, Right: MutateFreeze<AccountId, Balance = Left::Balance, Id = Left::Id>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Mutate<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn set_freeze( asset: Self::AssetId, 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.

fn extend_freeze( asset: Self::AssetId, 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.

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

Remove an existing lock.

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

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

fn ensure_frozen( asset: Self::AssetId, 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.

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

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

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

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

impl<Left: Inspect<AccountId>, Right: Inspect<AccountId> + Refund<AccountId>, Criterion: Convert<AssetKind, Either<(), <Right as Refund<AccountId>>::AssetId>>, AssetKind: AssetId, AccountId> Refund<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

type AssetId = AssetKind

Means of identifying one asset class from another.

type Balance = <Right as Refund<AccountId>>::Balance

Scalar type for representing deposit balance of an account.

fn deposit_held( asset: AssetKind, who: AccountId, ) -> Option<(AccountId, Self::Balance)>

Returns the amount of account deposit and depositor address, if any.

fn refund(asset: AssetKind, who: AccountId) -> DispatchResult

Return the deposit (if any) of a target asset account.

impl<Left: UnbalancedHold<AccountId>, Right: UnbalancedHold<AccountId, Balance = Left::Balance, Reason = Left::Reason>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Unbalanced<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, AccountId>

fn set_balance_on_hold( asset: Self::AssetId, 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( asset: Self::AssetId, 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( asset: Self::AssetId, reason: &Self::Reason, who: &AccountId, amount: Self::Balance, precision: Precision, ) -> Result<Self::Balance, DispatchError>

Increase the balance on hold of who by amount.

impl<Left: Unbalanced<AccountId>, Right: Unbalanced<AccountId, Balance = Left::Balance>, Criterion: Convert<AssetKind, Either<(), Right::AssetId>>, AssetKind: AssetId, AccountId> Unbalanced<AccountId> for UnionOf<Left, Right, Criterion, AssetKind, 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( asset: Self::AssetId, who: &AccountId, amount: Self::Balance, ) -> Result<Option<Self::Balance>, DispatchError>

Forcefully set the balance of who to amount.

fn set_total_issuance(asset: Self::AssetId, amount: Self::Balance)

Set the total issuance to amount.

fn decrease_balance( asset: Self::AssetId, 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( asset: Self::AssetId, who: &AccountId, amount: Self::Balance, precision: Precision, ) -> Result<Self::Balance, DispatchError>

Increase the balance of who by amount.

fn handle_raw_dust(asset: Self::AssetId, 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(_asset: Self::AssetId, _: Self::Balance)

Reduce the active issuance by some amount.

fn reactivate(_asset: Self::AssetId, _: Self::Balance)

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