Moonbeam XCM SDK Reference: v0¶
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 v0. For information on how to use the XCM SDK interfaces and methods, please refer to the Using the XCM SDK for v0 guide.
If you're using v1.x, please refer to the SDK guides specific to v1.
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 |
| Created: June 23, 2023