Skip to main content

​
MultiversX (EGLD)

MultiversX (formerly Elrond) is a highly scalable, fast, and secure blockchain platform for distributed apps, enterprise use cases, and the new internet economy.

​
Creating the SDK instance

To interact with the MultiversX blockchain, you first need to create an instance of the SDK. Here’s how you can do it: 
import { MULTIVERSX } from "@kynesyslabs/demosdk/xm-websdk"

const rpc_url = "https://testnet-api.multiversx.com"

const instance = await MULTIVERSX.create(rpc_url)
The instance is now connected to the MultiversX testnet and ready to be used.

​
Connecting your wallet

You can connect your wallet using a private key (keyFile) and password as shown below: 
const keyFile = '{"version":4,...}' // Your keyFile JSON string
const password = "your-wallet-password"

await instance.connectWallet(keyFile, {
    password: password,
})
Note: In a web environment, if you don’t provide a keyFile and password, the SDK will attempt to connect using the MultiversX DeFi Wallet browser extension.

​
Getting your address

You can get your address using the getAddress method: 
const address = instance.getAddress()

​
Preparing a transaction

You can prepare a transaction using the preparePay method: 
const recipientAddress = "erd1..."
const amount = "0.00001" // in EGLD

const tx = await instance.preparePay(recipientAddress, amount)
The preparePay method returns a signed transaction ready to be sent to a DEMOS node.

​
Preparing multiple transactions

You can prepare multiple transactions using the preparePays method: 
const transfers = [
    { address: "erd1...", amount: "0.00001" },
    { address: "erd1...", amount: "0.00002" },
]

const txs = await instance.preparePays(transfers)
The preparePays method returns an array of signed transactions. These transactions are signed with increasing nonces derived from the account’s current nonce on the network.

​
Signing messages

const message = "Hello, world!"

// Signing
const signature = await instance.signMessage(message)

// Verifying signature
const verified = await instance.verifyMessage(
    message,
    signature,
    instance.getAddress(),
)

expect(verified).toBe(true)

​
Cleaning up

When you’re done with the SDK instance, you can disconnect your wallet: 
await instance.disconnect()

​
Hacking

The DEMOS MultiversX SDK provides a limited set of methods to interact with the blockchain. For more advanced usage, you can access the underlying objects:
PropertyTypeDescription
instance.providerINetworkProviderProvides access to network data
instance.walletUserSigner or ExtensionProviderManages wallet operations

​
Example

To get all the tokens owned by an address (a feature not directly implemented in the SDK): 
const address = instance.getAddress()
const tokens = await instance.provider.getAllEsdtTokens(new Address(address))

tokens.forEach(token => {
    console.log(`Token: ${token.identifier}, Balance: ${token.balance}`)
})
This example uses the getAllEsdtTokens method from the underlying INetworkProvider, which is not directly exposed in the DEMOS SDK. For more advanced operations, refer to the following documentation:

​
API Reference

https://kynesyslabs.github.io/demosdk-api-ref/classes/xmwebsdk.MULTIVERSX.html