Struct staging_xcm_builder::test_utils::AssetsInHolding

pub struct AssetsInHolding {
    pub fungible: BTreeMap<AssetId, u128>,
    pub non_fungible: BTreeSet<(AssetId, AssetInstance)>,
}

Expand description

Map of non-wildcard fungible and non-fungible assets held in the holding register.

Fields§

§fungible: BTreeMap<AssetId, u128>

The fungible assets.

§non_fungible: BTreeSet<(AssetId, AssetInstance)>

The non-fungible assets.

Implementations§

§

impl AssetsInHolding

pub fn new() -> AssetsInHolding

New value, containing no assets.

pub fn len(&self) -> usize

Total number of distinct assets.

pub fn is_empty(&self) -> bool

Returns true if self contains no assets.

pub fn fungible_assets_iter(&self) -> impl Iterator<Item = Asset>

A borrowing iterator over the fungible assets.

pub fn non_fungible_assets_iter(&self) -> impl Iterator<Item = Asset>

A borrowing iterator over the non-fungible assets.

pub fn into_assets_iter(self) -> impl Iterator<Item = Asset>

A consuming iterator over all assets.

pub fn assets_iter(&self) -> impl Iterator<Item = Asset>

A borrowing iterator over all assets.

pub fn subsume_assets(&mut self, assets: AssetsInHolding)

Mutate self to contain all given assets, saturating if necessary.

NOTE: AssetsInHolding are always sorted, allowing us to optimize this function from O(n^2) to O(n).

pub fn subsume(&mut self, asset: Asset)

Mutate self to contain the given asset, saturating if necessary.

Wildcard values of asset do nothing.

pub fn swapped(&mut self, with: AssetsInHolding) -> AssetsInHolding

Swaps two mutable AssetsInHolding, without deinitializing either one.

pub fn prepend_location(&mut self, prepend: &Location)

Alter any concretely identified assets by prepending the given Location.

WARNING: For now we consider this infallible and swallow any errors. It is thus the caller’s responsibility to ensure that any internal asset IDs are able to be prepended without overflow.

pub fn reanchor( &mut self, target: &Location, context: &Junctions, maybe_failed_bin: Option<&mut AssetsInHolding> )

Mutate the assets to be interpreted as the same assets from the perspective of a target chain. The local chain’s context is provided.

Any assets which were unable to be reanchored are introduced into failed_bin.

pub fn contains_asset(&self, asset: &Asset) -> bool

Returns true if asset is contained within self.

pub fn contains_assets(&self, assets: &Assets) -> bool

Returns true if all assets are contained within self.

pub fn contains(&self, assets: &AssetsInHolding) -> bool

Returns true if all assets are contained within self.

pub fn ensure_contains(&self, assets: &Assets) -> Result<(), TakeError>

Returns an error unless all assets are contained in self. In the case of an error, the first asset in assets which is not wholly in self is returned.

pub fn saturating_take(&mut self, asset: AssetFilter) -> AssetsInHolding

Mutates self to its original value less mask and returns true iff it contains at least mask.

Returns Ok with the non-wildcard equivalence of mask taken and mutates self to its value minus mask if self contains asset, and return Err otherwise.

pub fn try_take( &mut self, mask: AssetFilter ) -> Result<AssetsInHolding, TakeError>

Mutates self to its original value less mask and returns true iff it contains at least mask.

Returns Ok with the non-wildcard equivalence of asset taken and mutates self to its value minus asset if self contains asset, and return Err otherwise.

pub fn checked_sub( self, asset: Asset ) -> Result<AssetsInHolding, AssetsInHolding>

Consumes self and returns its original value excluding asset iff it contains at least asset.

pub fn min(&self, mask: &AssetFilter) -> AssetsInHolding

Return the assets in self, but (asset-wise) of no greater value than mask.

The number of unique assets which are returned will respect the count parameter in the counted wildcard variants of mask.

Example:

use staging_xcm_executor::AssetsInHolding;
use xcm::latest::prelude::*;
let assets_i_have: AssetsInHolding = vec![ (Here, 100).into(), (Junctions::from([GeneralIndex(0)]), 100).into() ].into();
let assets_they_want: AssetFilter = vec![ (Here, 200).into(), (Junctions::from([GeneralIndex(0)]), 50).into() ].into();

let assets_we_can_trade: AssetsInHolding = assets_i_have.min(&assets_they_want);
assert_eq!(assets_we_can_trade.into_assets_iter().collect::<Vec<_>>(), vec![
	(Here, 100).into(), (Junctions::from([GeneralIndex(0)]), 50).into(),
]);