Enum xcm::v2::Instruction

pub enum Instruction<Call> {
    WithdrawAsset(MultiAssets),
    ReserveAssetDeposited(MultiAssets),
    ReceiveTeleportedAsset(MultiAssets),
    QueryResponse {
        query_id: QueryId,
        response: Response,
        max_weight: u64,
    },
    TransferAsset {
        assets: MultiAssets,
        beneficiary: MultiLocation,
    },
    TransferReserveAsset {
        assets: MultiAssets,
        dest: MultiLocation,
        xcm: Xcm<()>,
    },
    Transact {
        origin_type: OriginKind,
        require_weight_at_most: u64,
        call: DoubleEncoded<Call>,
    },
    HrmpNewChannelOpenRequest {
        sender: u32,
        max_message_size: u32,
        max_capacity: u32,
    },
    HrmpChannelAccepted {
        recipient: u32,
    },
    HrmpChannelClosing {
        initiator: u32,
        sender: u32,
        recipient: u32,
    },
    ClearOrigin,
    DescendOrigin(InteriorMultiLocation),
    ReportError {
        query_id: QueryId,
        dest: MultiLocation,
        max_response_weight: u64,
    },
    DepositAsset {
        assets: MultiAssetFilter,
        max_assets: u32,
        beneficiary: MultiLocation,
    },
    DepositReserveAsset {
        assets: MultiAssetFilter,
        max_assets: u32,
        dest: MultiLocation,
        xcm: Xcm<()>,
    },
    ExchangeAsset {
        give: MultiAssetFilter,
        receive: MultiAssets,
    },
    InitiateReserveWithdraw {
        assets: MultiAssetFilter,
        reserve: MultiLocation,
        xcm: Xcm<()>,
    },
    InitiateTeleport {
        assets: MultiAssetFilter,
        dest: MultiLocation,
        xcm: Xcm<()>,
    },
    QueryHolding {
        query_id: QueryId,
        dest: MultiLocation,
        assets: MultiAssetFilter,
        max_response_weight: u64,
    },
    BuyExecution {
        fees: MultiAsset,
        weight_limit: WeightLimit,
    },
    RefundSurplus,
    SetErrorHandler(Xcm<Call>),
    SetAppendix(Xcm<Call>),
    ClearError,
    ClaimAsset {
        assets: MultiAssets,
        ticket: MultiLocation,
    },
    Trap(u64),
    SubscribeVersion {
        query_id: QueryId,
        max_response_weight: u64,
    },
    UnsubscribeVersion,
}

Cross-Consensus Message: A message from one consensus system to another.

Consensus systems that may send and receive messages include blockchains and smart contracts.

All messages are delivered from a known origin, expressed as a MultiLocation.

This is the inner XCM format and is version-sensitive. Messages are typically passed using the outer XCM format, known as VersionedXcm.

Variants

WithdrawAsset(MultiAssets)

Withdraw asset(s) (assets) from the ownership of origin and place them into the Holding Register.

• assets: The asset(s) to be withdrawn into holding.

Kind: Instruction.

Errors:

Tuple Fields of WithdrawAsset

0: MultiAssets

ReserveAssetDeposited(MultiAssets)

Asset(s) (assets) have been received into the ownership of this system on the origin system and equivalent derivatives should be placed into the Holding Register.

• assets: The asset(s) that are minted into holding.

Safety: origin must be trusted to have received and be storing assets such that they may later be withdrawn should this system send a corresponding message.

Kind: Trusted Indication.

Errors:

Tuple Fields of ReserveAssetDeposited

0: MultiAssets

ReceiveTeleportedAsset(MultiAssets)

Asset(s) (assets) have been destroyed on the origin system and equivalent assets should be created and placed into the Holding Register.

• assets: The asset(s) that are minted into the Holding Register.

Safety: origin must be trusted to have irrevocably destroyed the corresponding assets prior as a consequence of sending this message.

Kind: Trusted Indication.

Errors:

Tuple Fields of ReceiveTeleportedAsset

0: MultiAssets

QueryResponse

Respond with information that the local system is expecting.

• query_id: The identifier of the query that resulted in this message being sent.
• response: The message content.
• max_weight: The maximum weight that handling this response should take.

Safety: No concerns.

Kind: Information.

Errors:

Fields of QueryResponse

query_id: QueryIdresponse: Responsemax_weight: u64

TransferAsset

Withdraw asset(s) (assets) from the ownership of origin and place equivalent assets under the ownership of beneficiary.

• assets: The asset(s) to be withdrawn.
• beneficiary: The new owner for the assets.

Safety: No concerns.

Kind: Instruction.

Errors:

Fields of TransferAsset

assets: MultiAssetsbeneficiary: MultiLocation

TransferReserveAsset

Withdraw asset(s) (assets) from the ownership of origin and place equivalent assets under the ownership of dest within this consensus system (i.e. its sovereign account).

Send an onward XCM message to dest of ReserveAssetDeposited with the given xcm.

• assets: The asset(s) to be withdrawn.
• dest: The location whose sovereign account will own the assets and thus the effective beneficiary for the assets and the notification target for the reserve asset deposit message.
• xcm: The instructions that should follow the ReserveAssetDeposited instruction, which is sent onwards to dest.

Safety: No concerns.

Kind: Instruction.

Errors:

Fields of TransferReserveAsset

assets: MultiAssetsdest: MultiLocationxcm: Xcm<()>

Transact

Apply the encoded transaction call, whose dispatch-origin should be origin as expressed by the kind of origin origin_type.

• origin_type: The means of expressing the message origin as a dispatch origin.
• max_weight: The weight of call; this should be at least the chain’s calculated weight and will be used in the weight determination arithmetic.
• call: The encoded transaction to be applied.

Safety: No concerns.

Kind: Instruction.

Errors:

Fields of Transact

origin_type: OriginKindrequire_weight_at_most: u64call: DoubleEncoded<Call>

HrmpNewChannelOpenRequest

A message to notify about a new incoming HRMP channel. This message is meant to be sent by the relay-chain to a para.

• sender: The sender in the to-be opened channel. Also, the initiator of the channel opening.
• max_message_size: The maximum size of a message proposed by the sender.
• max_capacity: The maximum number of messages that can be queued in the channel.

Safety: The message should originate directly from the relay-chain.

Kind: System Notification

Fields of HrmpNewChannelOpenRequest

sender: u32max_message_size: u32max_capacity: u32

HrmpChannelAccepted

A message to notify about that a previously sent open channel request has been accepted by the recipient. That means that the channel will be opened during the next relay-chain session change. This message is meant to be sent by the relay-chain to a para.

Safety: The message should originate directly from the relay-chain.

Kind: System Notification

Errors:

Fields of HrmpChannelAccepted

recipient: u32

HrmpChannelClosing

A message to notify that the other party in an open channel decided to close it. In particular, initiator is going to close the channel opened from sender to the recipient. The close will be enacted at the next relay-chain session change. This message is meant to be sent by the relay-chain to a para.

Safety: The message should originate directly from the relay-chain.

Kind: System Notification

Errors:

Fields of HrmpChannelClosing

initiator: u32sender: u32recipient: u32

ClearOrigin

Clear the origin.

This may be used by the XCM author to ensure that later instructions cannot command the authority of the origin (e.g. if they are being relayed from an untrusted source, as often the case with ReserveAssetDeposited).

Safety: No concerns.

Kind: Instruction.

Errors:

DescendOrigin(InteriorMultiLocation)

Mutate the origin to some interior location.

Kind: Instruction

Errors:

Tuple Fields of DescendOrigin

0: InteriorMultiLocation

ReportError

Immediately report the contents of the Error Register to the given destination via XCM.

A QueryResponse message of type ExecutionOutcome is sent to dest with the given query_id and the outcome of the XCM.

Kind: Instruction

Errors:

Fields of ReportError

query_id: QueryIddest: MultiLocationmax_response_weight: u64

DepositAsset

Remove the asset(s) (assets) from the Holding Register and place equivalent assets under the ownership of beneficiary within this consensus system.

• assets: The asset(s) to remove from holding.
• max_assets: The maximum number of unique assets/asset instances to remove from holding. Only the first max_assets assets/instances of those matched by assets will be removed, prioritized under standard asset ordering. Any others will remain in holding.
• beneficiary: The new owner for the assets.

Kind: Instruction

Errors:

Fields of DepositAsset

assets: MultiAssetFiltermax_assets: u32beneficiary: MultiLocation

DepositReserveAsset

Remove the asset(s) (assets) from the Holding Register and place equivalent assets under the ownership of dest within this consensus system (i.e. deposit them into its sovereign account).

Send an onward XCM message to dest of ReserveAssetDeposited with the given effects.

• assets: The asset(s) to remove from holding.
• max_assets: The maximum number of unique assets/asset instances to remove from holding. Only the first max_assets assets/instances of those matched by assets will be removed, prioritized under standard asset ordering. Any others will remain in holding.
• dest: The location whose sovereign account will own the assets and thus the effective beneficiary for the assets and the notification target for the reserve asset deposit message.
• xcm: The orders that should follow the ReserveAssetDeposited instruction which is sent onwards to dest.

Kind: Instruction

Errors:

Fields of DepositReserveAsset

assets: MultiAssetFiltermax_assets: u32dest: MultiLocationxcm: Xcm<()>

ExchangeAsset

Remove the asset(s) (give) from the Holding Register and replace them with alternative assets.

The minimum amount of assets to be received into the Holding Register for the order not to fail may be stated.

• give: The asset(s) to remove from holding.
• receive: The minimum amount of assets(s) which give should be exchanged for.

Kind: Instruction

Errors:

Fields of ExchangeAsset

give: MultiAssetFilterreceive: MultiAssets

InitiateReserveWithdraw

Remove the asset(s) (assets) from holding and send a WithdrawAsset XCM message to a reserve location.

• assets: The asset(s) to remove from holding.
• reserve: A valid location that acts as a reserve for all asset(s) in assets. The sovereign account of this consensus system on the reserve location will have appropriate assets withdrawn and effects will be executed on them. There will typically be only one valid location on any given asset/chain combination.
• xcm: The instructions to execute on the assets once withdrawn on the reserve location.

Kind: Instruction

Errors:

Fields of InitiateReserveWithdraw

assets: MultiAssetFilterreserve: MultiLocationxcm: Xcm<()>

InitiateTeleport

Remove the asset(s) (assets) from holding and send a ReceiveTeleportedAsset XCM message to a dest location.

• assets: The asset(s) to remove from holding.
• dest: A valid location that respects teleports coming from this location.
• xcm: The instructions to execute on the assets once arrived on the destination location.

NOTE: The dest location MUST respect this origin as a valid teleportation origin for all assets. If it does not, then the assets may be lost.

Kind: Instruction

Errors:

Fields of InitiateTeleport

assets: MultiAssetFilterdest: MultiLocationxcm: Xcm<()>

QueryHolding

Send a Balances XCM message with the assets value equal to the holding contents, or a portion thereof.

• query_id: An identifier that will be replicated into the returned XCM message.
• dest: A valid destination for the returned XCM message. This may be limited to the current origin.
• assets: A filter for the assets that should be reported back. The assets reported back will be, asset-wise, the lesser of this value and the holding register. No wildcards will be used when reporting assets back.
• max_response_weight: The maximum amount of weight that the QueryResponse item which is sent as a reply may take to execute. NOTE: If this is unexpectedly large then the response may not execute at all.

Kind: Instruction

Errors:

Fields of QueryHolding

query_id: QueryIddest: MultiLocationassets: MultiAssetFiltermax_response_weight: u64

BuyExecution

Pay for the execution of some XCM xcm and orders with up to weight picoseconds of execution time, paying for this with up to fees from the Holding Register.

• fees: The asset(s) to remove from the Holding Register to pay for fees.
• weight_limit: The maximum amount of weight to purchase; this must be at least the expected maximum weight of the total XCM to be executed for the AllowTopLevelPaidExecutionFrom barrier to allow the XCM be executed.

Kind: Instruction

Errors:

Fields of BuyExecution

fees: MultiAssetweight_limit: WeightLimit

RefundSurplus

Refund any surplus weight previously bought with BuyExecution.

Kind: Instruction

Errors: None.

SetErrorHandler(Xcm<Call>)

Set the Error Handler Register. This is code that should be called in the case of an error happening.

An error occurring within execution of this code will NOT result in the error register being set, nor will an error handler be called due to it. The error handler and appendix may each still be set.

The apparent weight of this instruction is inclusive of the inner Xcm; the executing weight however includes only the difference between the previous handler and the new handler, which can reasonably be negative, which would result in a surplus.

Kind: Instruction

Errors: None.

Tuple Fields of SetErrorHandler

0: Xcm<Call>

SetAppendix(Xcm<Call>)

Set the Appendix Register. This is code that should be called after code execution (including the error handler if any) is finished. This will be called regardless of whether an error occurred.

Any error occurring due to execution of this code will result in the error register being set, and the error handler (if set) firing.

The apparent weight of this instruction is inclusive of the inner Xcm; the executing weight however includes only the difference between the previous appendix and the new appendix, which can reasonably be negative, which would result in a surplus.

Kind: Instruction

Errors: None.

Tuple Fields of SetAppendix

0: Xcm<Call>

ClearError

Clear the Error Register.

Kind: Instruction

Errors: None.

ClaimAsset

Create some assets which are being held on behalf of the origin.

• assets: The assets which are to be claimed. This must match exactly with the assets claimable by the origin of the ticket.
• ticket: The ticket of the asset; this is an abstract identifier to help locate the asset.

Kind: Instruction

Errors:

Fields of ClaimAsset

assets: MultiAssetsticket: MultiLocation

Trap(u64)

Always throws an error of type Trap.

Kind: Instruction

Errors:

• Trap: All circumstances, whose inner value is the same as this item’s inner value.

Tuple Fields of Trap

0: u64

SubscribeVersion

Ask the destination system to respond with the most recent version of XCM that they support in a QueryResponse instruction. Any changes to this should also elicit similar responses when they happen.

Kind: Instruction

Fields of SubscribeVersion

query_id: QueryIdmax_response_weight: u64

UnsubscribeVersion

Cancel the effect of a previous SubscribeVersion instruction.

Kind: Instruction

Implementations

impl<Call> Instruction<Call>

pub fn into<C>(self) -> Instruction<C>

pub fn from<C>(xcm: Instruction<C>) -> Self

Trait Implementations

impl<Call> Clone for Instruction<Call>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Call> Debug for Instruction<Call>

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

Formats the value using the given formatter.

impl<Call> Decode for Instruction<Call>

fn decode<__CodecInputEdqy: Input>(
    __codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn skip<I>(input: &mut I) -> Result<(), Error> where
    I: Input, 

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<Call> Encode for Instruction<Call>

fn encode_to<__CodecOutputEdqy: Output + ?Sized>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

Convert self to a slice and append it to the destination.

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode(&self) -> Vec<u8, Global>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R where
    F: FnOnce(&[u8]) -> R, 

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<Call, W: XcmWeightInfo<Call>> GetWeight<W> for Instruction<Call>

fn weight(&self) -> Weight

impl<Call> PartialEq<Instruction<Call>> for Instruction<Call>

fn eq(&self, other: &Self) -> 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 !=.

impl<Call> TryFrom<Instruction<Call>> for Order<Call>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(old: Instruction<Call>) -> Result<Order<Call>, ()>

Performs the conversion.

impl<Call> TryFrom<Order<Call>> for Instruction<Call>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(old: OldOrder<Call>) -> Result<Instruction<Call>, ()>

Performs the conversion.

impl<Call> TypeInfo for Instruction<Call> where
    Call: 'static, 

type Identity = Self

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<Call> EncodeLike<Instruction<Call>> for Instruction<Call>

impl<Call> Eq for Instruction<Call>