Enum xcm::v1::Xcm [−][src]
pub enum Xcm<Call> {
Show 13 variants
WithdrawAsset {
assets: MultiAssets,
effects: Vec<Order<Call>>,
},
ReserveAssetDeposited {
assets: MultiAssets,
effects: Vec<Order<Call>>,
},
ReceiveTeleportedAsset {
assets: MultiAssets,
effects: Vec<Order<Call>>,
},
QueryResponse {
query_id: u64,
response: Response,
},
TransferAsset {
assets: MultiAssets,
beneficiary: MultiLocation,
},
TransferReserveAsset {
assets: MultiAssets,
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: InteriorMultiLocation,
message: Box<Xcm<Call>>,
},
SubscribeVersion {
query_id: u64,
max_response_weight: u64,
},
UnsubscribeVersion,
}
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
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 register.
Kind: Instruction.
Errors:
Fields of WithdrawAsset
assets: MultiAssets
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 register.
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:
Fields of ReserveAssetDeposited
assets: MultiAssets
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 the Holding Register.
assets
: The asset(s) that are minted into the Holding Register.effects
: The order(s) to execute on 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:
Fields of ReceiveTeleportedAsset
assets: MultiAssets
effects: Vec<Order<Call>>
Indication of the contents of the holding register 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:
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: MultiAssets
beneficiary: MultiLocation
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 effects
.
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.effects
: The orders that should be contained in theReserveAssetDeposited
which is sent onwards todest
.
Safety: No concerns.
Kind: Instruction.
Errors:
Fields of TransferReserveAsset
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 ofcall
; 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
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
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
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:
A message to indicate that the embedded XCM is actually arriving on behalf of some consensus location within the origin.
Kind: Instruction
Errors:
Fields of RelayedFrom
who: InteriorMultiLocation
message: Box<Xcm<Call>>
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
Cancel the effect of a previous SubscribeVersion
instruction.
Kind: Instruction
Implementations
Trait Implementations
Auto Trait Implementations
impl<Call> RefUnwindSafe for Xcm<Call> where
Call: RefUnwindSafe,
impl<Call> UnwindSafe for Xcm<Call> where
Call: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more
Causes self
to use its Binary
implementation when Debug
-formatted.
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.
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
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.
fn pipe_as_ref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: AsRef<T>,
T: 'a,
R: 'a,
fn pipe_as_ref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: AsRef<T>,
T: 'a,
R: 'a,
Pipes a trait borrow into a function that cannot normally be called in suffix position. Read more
fn pipe_borrow<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Borrow<T>,
T: 'a,
R: 'a,
fn pipe_borrow<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Borrow<T>,
T: 'a,
R: 'a,
Pipes a trait borrow into a function that cannot normally be called in suffix position. Read more
fn pipe_deref<'a, R>(&'a self, func: impl FnOnce(&'a Self::Target) -> R) -> R where
Self: Deref,
R: 'a,
fn pipe_deref<'a, R>(&'a self, func: impl FnOnce(&'a Self::Target) -> R) -> R where
Self: Deref,
R: 'a,
Pipes a dereference into a function that cannot normally be called in suffix position. Read more
Pipes a reference into a function that cannot ordinarily be called in suffix position. 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
Provides immutable access to the reference for inspection.
Calls tap_ref
in debug builds, and does nothing in release builds.
Provides mutable access to the reference for modification.
Calls tap_ref_mut
in debug builds, and does nothing in release builds.
Provides immutable access to the borrow for inspection. Read more
Calls tap_borrow
in debug builds, and does nothing in release builds.
fn tap_borrow_mut<F, R>(self, func: F) -> Self where
Self: BorrowMut<T>,
F: FnOnce(&mut T) -> R,
fn tap_borrow_mut<F, R>(self, func: F) -> Self where
Self: BorrowMut<T>,
F: FnOnce(&mut T) -> R,
Provides mutable access to the borrow for modification.
Immutably dereferences self
for inspection.
fn tap_deref_dbg<F, R>(self, func: F) -> Self where
Self: Deref,
F: FnOnce(&Self::Target) -> R,
fn tap_deref_dbg<F, R>(self, func: F) -> Self where
Self: Deref,
F: FnOnce(&Self::Target) -> R,
Calls tap_deref
in debug builds, and does nothing in release builds.
fn tap_deref_mut<F, R>(self, func: F) -> Self where
Self: DerefMut,
F: FnOnce(&mut Self::Target) -> R,
fn tap_deref_mut<F, R>(self, func: F) -> Self where
Self: DerefMut,
F: FnOnce(&mut Self::Target) -> R,
Mutably dereferences self
for modification.