Skip to main content

XCM Instructions & Register Specification

XCM Documentation

For a more practical approach to utilizing XCM, refer to the XCM Docs. Please keep in mind that XCM is under active development.

This page can also be viewed at the xcm-format repository, where each instruction and register is explained in-depth.

XCVM Registers​

  • Programme
  • Programme Counter
  • Error
  • Error Handler
  • Appendix
  • Origin
  • Holding
  • Surplus Weight
  • Refunded Weight
  • Transact Status
  • Topic
  • Transact Status Register
  • Topic Register

XCVM Instruction Set​

  • WithdrawAsset
  • ReserveAssetDeposited
  • ReceiveTeleportedAsset
  • QueryResponse
  • TransferAsset
  • TransferReserveAsset
  • Transact
  • HrmpNewChannelOpenRequest
  • HrmpChannelAccepted
  • HrmpChannelClosing
  • ClearOrigin
  • DescendOrigin
  • ReportError
  • DepositAsset
  • DepositReserveAsset
  • ExchangeAsset
  • InitiateReserveWithdraw
  • InitiateTeleport
  • QueryHolding
  • BuyExecution
  • RefundSurplus
  • SetErrorHandler
  • SetAppendix
  • ClearError
  • ClaimAsset
  • Trap
  • SubscribeVersion
  • UnsubscribeVersion
  • BurnAsset
  • ExpectAsset
  • ExpectError
  • ExpectOrigin
  • QueryPallet
  • ExpectPallet
  • ReportTransactStatus
  • ClearTransactStatus
  • LockAsset
  • UnlockAsset
  • NoteUnlockable
  • RequestUnlock

Instructions Application Example​

The following presents the practical mapping of instructions to some core functionality in XCM.

These are the primary instructions that enable programmability and branching to be possible. Branching in this context is the ability for errors and logic to be handled as needed when dealing with a message.

  • ExpectAsset(MultiAssets) - Checks if the Holding register has a specific amount of assets, throws an error if it doesn't.

  • ExpectError(Option<(u32, Error)>) - Ensures the Error register contains the given error, and throws an error if it doesn't.

  • ExpectOrigin(MultiLocation) - Ensures the Origin register contains the expected origin, and throws an error if it doesn't.

  • QueryPallet - Queries the existence of a particular pallet type.

  • ExpectPallet - Ensure that a particular pallet with a particular version exists.

  • ReportTransactStatus(QueryResponseInfo) - Send a QueryResponse message containing the value of the Transact Status Register to some destination.

  • ClearTransactStatus - Set the Transact Status Register to its default, cleared, value.