Moonbeam XCM SDK Reference¶

Introduction¶

The Moonbeam XCM SDK enables developers to easily deposit and withdraw assets to Moonbeam/Moonriver from the relay chain and other parachains in the Polkadot/Kusama ecosystem. With the SDK, you don't need to worry about determining the multilocation of the origin or destination assets or which extrinsics are used on which networks to send XCM transfers.

The SDK provides an API which includes a series of interfaces to get asset information for each of the supported assets, chain information for the initialized network, utility methods, and methods to enable deposits, withdrawals, and subscription to balance information.

This page includes a list of the interfaces and methods available in the XCM SDK. For information on how to use the XCM SDK interfaces and methods, please refer to the Using the XCM SDK guide.

Core Interfaces¶

The SDK provides the following core interfaces, which can be accessed after initialization:

Interface	Description
`symbols`	A list containing the asset's origin chain symbol for each of the supported assets for the initialized Moonbeam network
`assets`	A list of the supported assets for the initialized Moonbeam network along with their asset ID, precompiled address on Moonbeam, and the asset symbol
`moonAsset`	Contains the asset ID, precompile contract address, and native asset symbol for the initialized Moonbeam network
`moonChain`	Contains the chain key, name, WSS endpoint, parachain ID, decimals of the native asset, chain ID, and units per second for the initialized Moonbeam network

Core Methods¶

The SDK provides the following core methods:

Method	Description
`init()`	Initializes the XCM SDK. Must be called first before any other SDK methods
`deposit()`	Initiates a deposit to transfer assets from another chain to Moonbeam
`withdraw()`	Initiates a withdraw to transfer assets from Moonbeam to another chain
`subscribeToAssetsBalanceInfo()`	Listens for balance changes for a given account for each of the supported assets
`isXcmSdkDeposit()`	Returns a boolean indicating whether the given transfer data is for a deposit or not
`isXcmSdkWithdraw()`	Returns a boolean indicating whether the given transfer data is for a withdraw or not
`toDecimal()`	Returns a given balance in decimal format
`toBigInt()`	Returns a given decimal in BigInt format

Deposit Methods¶

When building the transfer data needed for a deposit, you'll use multiple methods to build the underlying XCM message and send it:

Method	Description
`deposit()`	Initiates a deposit to transfer assets from another chain to Moonbeam
`from()`	Sets the source chain where the deposit will originate from. This function is returned from the `deposit()` function. Must call `deposit()` first
`get()`	Sets the account on Moonbeam to deposit the funds to and the source account where the deposit will be sent from. This function is returned from the `from()` function. Must call `from()` first
`send()`	Sends the deposit transfer data given an amount to send. This function is returned from the `get()` function. Must call `get()` first
`getFee()`	Returns an estimate of the fee for transferring a given amount, which will be paid in the asset specified in the `deposit()` function. This function is returned from the `get()` function. Must call `get()` first

Withdraw Methods¶

When building the transfer data needed for a withdraw, you'll use multiple methods to build the underlying XCM message and send it:

Method	Description
`withdraw()`	Initiates a withdraw to transfer assets from Moonbeam to another chain
`to()`	Sets the destination chain where the assets will be withdrawn to. This function is returned from the `withdraw()` function. Must call `withdraw()` first
`get()`	Sets the account on the destination chain to send the withdrawn funds to. This function is returned from the `to()` function. Must call `to()` first
`send()`	Sends the withdraw transfer data given an amount to send. This function is returned from the `get()` function. Must call `get()` first
`getFee()`	Returns an estimate of the fee for transferring a given amount, which will be paid in the asset specified in the `withdraw()` function. This function is returned from the `get()` function. Must call `get()` first

Last update: December 28, 2022
| Created: December 28, 2022