Struct xcm_executor::Assets

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

List of non-wildcard fungible and non-fungible assets.

Fields

fungible: BTreeMap<AssetId, u128>

The fungible assets.

non_fungible: BTreeSet<(AssetId, AssetInstance)>

The non-fungible assets.

Implementations

impl Assets

pub fn new() -> Self

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<'a>(
    &'a self
) -> impl Iterator<Item = MultiAsset> + 'a

A borrowing iterator over the fungible assets.

pub fn non_fungible_assets_iter<'a>(
    &'a self
) -> impl Iterator<Item = MultiAsset> + 'a

A borrowing iterator over the non-fungible assets.

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

A consuming iterator over all assets.

pub fn assets_iter<'a>(&'a self) -> impl Iterator<Item = MultiAsset> + 'a

A borrowing iterator over all assets.

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

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

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

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

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

Wildcard values of asset do nothing.

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

Swaps two mutable Assets, without deinitializing either one.

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

Alter any concretely identified assets by prepending the given MultiLocation.

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: &MultiLocation,
    ancestry: &MultiLocation,
    maybe_failed_bin: Option<&mut Self>
)

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

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

pub fn ensure_contains(&self, assets: &MultiAssets) -> 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: MultiAssetFilter) -> Assets

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 limited_saturating_take(
    &mut self,
    asset: MultiAssetFilter,
    limit: usize
) -> Assets

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: MultiAssetFilter) -> Result<Assets, 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: MultiAsset) -> Result<Assets, Assets>

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

pub fn min(&self, mask: &MultiAssetFilter) -> Assets

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

Result is undefined if mask includes elements which match to the same asset more than once.

Example:

use xcm_executor::Assets;
use xcm::latest::prelude::*;
let assets_i_have: Assets = vec![ (Here, 100).into(), (vec![0], 100).into() ].into();
let assets_they_want: MultiAssetFilter = vec![ (Here, 200).into(), (vec![0], 50).into() ].into();

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

Trait Implementations

impl Clone for Assets

fn clone(&self) -> Assets

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Assets

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Assets

fn default() -> Assets

Returns the “default value” for a type.

impl From<Assets> for MultiAssets

fn from(a: Assets) -> Self

Converts to this type from the input type.

impl From<Assets> for Vec<MultiAsset>

fn from(a: Assets) -> Self

Converts to this type from the input type.

impl From<MultiAsset> for Assets

fn from(asset: MultiAsset) -> Assets

Converts to this type from the input type.

impl From<MultiAssets> for Assets

fn from(assets: MultiAssets) -> Assets

Converts to this type from the input type.

impl From<Vec<MultiAsset, Global>> for Assets

fn from(assets: Vec<MultiAsset>) -> Assets

Converts to this type from the input type.

impl PartialEq<Assets> for Assets

fn eq(&self, other: &Assets) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Assets

impl StructuralEq for Assets

impl StructuralPartialEq for Assets