Skip to main content

Token listing

Exchanges should integrate the IBC token (ICS-20) of the RollApp on Dymension. This approach is identical to an IBC token (ICS-20) on Cosmos Hub or Arbitrum tokens (ERC-20) on Ethereum L1.

info

Make sure you have successfully integrated the Dymension blockchain according to best practices here.

RollApp token address

Interacting with tokens on Dymension can be done with 2 “parallel” standards: IBC (ICS-20) and ERC-20, BOTH SHARE THE SAME STATE, regardless of the method chosen.

IBC standard

Example: USDC on Dymension ibc/B3504E092456BA618CC28AC671A71FB08C6CA0FD0BE7C8A5B5A3E2DD933CC9E4

portal-overview

Singing and Broadcasting using cosmJS:

import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
import { GasPrice, SigningStargateClient } from "@cosmjs/stargate";
import { Decimal } from "@cosmjs/math";

const signer = await DirectSecp256k1HdWallet.fromMnemonic("<mnemonic>", {
prefix: "dym",
});
const gasPrice = new GasPrice(Decimal.fromUserInput("20000000000", 18), "adym");
const client = await SigningStargateClient.connectWithSigner("<rpc>", signer, {
gasPrice,
});
const fromAddress = (await signer.getAccounts())[0].address;
const coins = [{ denom: "<denom-ibc-hash>", amount: "<amount>" }];
const response = await client.sendTokens(
fromAddress,
"<to-address>",
coins,
"auto"
);

ERC-20 contract standard

ERC-20 Standard on Dymension is only a virtual adapter of the Cosmos bank modules.

Singing and Broadcasting using ethers:

import { ethers } from "ethers";

const signer = ethers.Wallet.fromMnemonic("<mnemonic>");
// or another option:
// const signer = (new ethers.providers.JsonRpcProvider('<json-rpc>')).getSigner('<signer-address>');

const transferABI = [
{
inputs: [
{
internalType: "address",
name: "recipient",
type: "address",
},
{
internalType: "uint256",
name: "amount",
type: "uint256",
},
],
name: "transfer",
outputs: [
{
internalType: "bool",
name: "",
type: "bool",
},
],
stateMutability: "nonpayable",
type: "function",
},
];
const contract = new ethers.Contract(
"<erc20-contract-address>",
transferABI,
signer
);
const result = await contract.transfer("<to-address>", "<amount>");