Enum xcm::v0::Xcm

source ·
pub enum Xcm<Call> {
    WithdrawAsset {
        assets: Vec<MultiAsset>,
        effects: Vec<Order<Call>>,
    },
    ReserveAssetDeposit {
        assets: Vec<MultiAsset>,
        effects: Vec<Order<Call>>,
    },
    TeleportAsset {
        assets: Vec<MultiAsset>,
        effects: Vec<Order<Call>>,
    },
    QueryResponse {
        query_id: u64,
        response: Response,
    },
    TransferAsset {
        assets: Vec<MultiAsset>,
        dest: MultiLocation,
    },
    TransferReserveAsset {
        assets: Vec<MultiAsset>,
        dest: MultiLocation,
        effects: Vec<Order<()>>,
    },
    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,
    },
    RelayedFrom {
        who: MultiLocation,
        message: Box<Xcm<Call>>,
    },
}
Expand description

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

Fields

§assets: Vec<MultiAsset>
§effects: Vec<Order<Call>>

Withdraw asset(s) (assets) from the ownership of origin and place them into holding. Execute the orders (effects).

  • assets: The asset(s) to be withdrawn into holding.
  • effects: The order(s) to execute on the holding account.

Kind: Instruction.

Errors:

§

ReserveAssetDeposit

Fields

§assets: Vec<MultiAsset>
§effects: Vec<Order<Call>>

Asset(s) (assets) have been received into the ownership of this system on the origin system.

Some orders are given (effects) which should be executed once the corresponding derivative assets have been placed into holding.

  • assets: The asset(s) that are minted into holding.
  • effects: The order(s) to execute on the holding account.

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:

§

TeleportAsset

Fields

§assets: Vec<MultiAsset>
§effects: Vec<Order<Call>>

Asset(s) (assets) have been destroyed on the origin system and equivalent assets should be created on this system.

Some orders are given (effects) which should be executed once the corresponding derivative assets have been placed into holding.

  • assets: The asset(s) that are minted into holding.
  • effects: The order(s) to execute on the holding account.

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

Kind: Trusted Indication.

Errors:

§

QueryResponse

Fields

§query_id: u64
§response: Response

Indication of the contents of the holding account corresponding to the QueryHolding order of query_id.

  • query_id: The identifier of the query that resulted in this message being sent.
  • assets: The message content.

Safety: No concerns.

Kind: Information.

Errors:

§

TransferAsset

Fields

§assets: Vec<MultiAsset>

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

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

Safety: No concerns.

Kind: Instruction.

Errors:

§

TransferReserveAsset

Fields

§assets: Vec<MultiAsset>
§effects: Vec<Order<()>>

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

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

  • assets: The asset(s) to be withdrawn.
  • dest: The new owner for the assets.
  • effects: The orders that should be contained in the ReserveAssetDeposit which is sent onwards to dest.

Safety: No concerns.

Kind: Instruction.

Errors:

§

Transact

Fields

§origin_type: OriginKind
§require_weight_at_most: u64
§call: DoubleEncoded<Call>

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:

§

HrmpNewChannelOpenRequest

Fields

§sender: u32
§max_message_size: u32
§max_capacity: u32

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

§

HrmpChannelAccepted

Fields

§recipient: u32

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:

§

HrmpChannelClosing

Fields

§initiator: u32
§sender: u32
§recipient: u32

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:

§

RelayedFrom

Fields

§message: Box<Xcm<Call>>

A message to indicate that the embedded XCM is actually arriving on behalf of some consensus location within the origin.

Safety: who must be an interior location of the context. This basically means that no Parent junctions are allowed in it. This should be verified at the time of XCM execution.

Kind: Instruction

Errors:

Implementations§

Trait Implementations§

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Attempt to deserialise the value from input.
Attempt to skip the encoded value from input. Read more
Returns the fixed encoded size of the type. Read more
Convert self to a slice and append it to the destination.
If possible give a hint of expected size of the encoding. Read more
Convert self to an owned vector.
Convert self to a slice and then invoke the given closure with it.
Calculates the encoded size. Read more
Converts to this type from the input type.
This method tests for self and other values to be equal, and is used by ==. Read more
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type identifying for which type info is provided. Read more
Returns the static type identifier for Self.

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
Convert from a value of T into an equivalent instance of Option<Self>. Read more
Consume self to return Some equivalent value of Option<T>. Read more
Converts self into T using Into<T>. Read more
Decode Self and consume all of the given input data. Read more
Decode Self and consume all of the given input data. Read more
Decode Self with the given maximum recursion depth and advance input by the number of bytes consumed. Read more
Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait. Read more
Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait. Read more
Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s. Read more
Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s. Read more
Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait. Read more
Compare self to key and return true if they are equal.
Causes self to use its Binary implementation when Debug-formatted. Read more
Causes self to use its Display implementation when Debug-formatted. Read more
Causes self to use its LowerExp implementation when Debug-formatted. Read more
Causes self to use its LowerHex implementation when Debug-formatted. Read more
Causes self to use its Octal implementation when Debug-formatted. Read more
Causes self to use its Pointer implementation when Debug-formatted. Read more
Causes self to use its UpperExp implementation when Debug-formatted. Read more
Causes self to use its UpperHex implementation when Debug-formatted. Read more
Formats each item in a sequence. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Get a reference to the inner from the outer.

Get a mutable reference to the inner from the outer.

Return an encoding of Self prepended by given slice.
Pipes by value. This is generally the method you want to use. Read more
Borrows self and passes that borrow into the pipe function. Read more
Mutably borrows self and passes that borrow into the pipe function. Read more
Borrows self, then passes self.borrow() into the pipe function. Read more
Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Borrows self, then passes self.as_ref() into the pipe function.
Mutably borrows self, then passes self.as_mut() into the pipe function. Read more
Borrows self, then passes self.deref() into the pipe function.
Mutably borrows self, then passes self.deref_mut() into the pipe function. Read more
The alignment of pointer.
The type for initializers.
Initializes a with the given initializer. Read more
Dereferences the given pointer. Read more
Mutably dereferences the given pointer. Read more
Drops the object pointed to by the given pointer. Read more
Should always be Self
Convert from a value of T into an equivalent instance of Self. Read more
Consume self to return an equivalent value of T. Read more
Immutable access to a value. Read more
Mutable access to a value. Read more
Immutable access to the Borrow<B> of a value. Read more
Mutable access to the BorrowMut<B> of a value. Read more
Immutable access to the AsRef<R> view of a value. Read more
Mutable access to the AsMut<R> view of a value. Read more
Immutable access to the Deref::Target of a value. Read more
Mutable access to the Deref::Target of a value. Read more
Calls .tap() only in debug builds, and is erased in release builds.
Calls .tap_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref_mut() only in debug builds, and is erased in release builds. Read more
The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
Attempts to convert self into T using TryInto<T>. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The counterpart to unchecked_from.
Consume self to return an equivalent value of T.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more