Skip to content
Send UST to an EVM chain

Send UST to an EVM chain

Transfer UST tokens from Terra to an EVM chain using the terminal.

Prerequisites

Send UST tokens from Terra to an EVM chain

Link your {EVM_DEST_ADDR} to a new temporary deposit address on Axelar:

axelard tx axelarnet link {EVM_CHAIN} {EVM_DEST_ADDR} uusd --from validator

Output should contain

successfully linked {AXELAR_TEMP_ADDR} and {EVM_DEST_ADDR}

Send UST tokens from Terra to your temporary Axelar address {AXELAR_TEMP_ADDR} via IBC.

ℹ️

Info: There are several ways to do IBC.

IBC from a web wallet

Use a web wallet such as Keplr. See Transfer Terra assets to EVM chains using Satellite | Axelar Network (opens in a new tab).

IBC from the terminal

You need shell access to a Terra node with at least {AMOUNT} balance of UST tokens in an account called terra-validator. Get {TERRA_TO_AXELAR_CHANNEL_ID} from Testnet resources or Mainnet resources.

terrad tx ibc-transfer transfer transfer {TERRA_TO_AXELAR_CHANNEL_ID} {AXELAR_TEMP_ADDR} --packet-timeout-timestamp 0 --packet-timeout-height "0-20000" {AMOUNT}uusd --gas-prices 0.15uusd --from terra-validator -y -b block

Wait a few minutes for the IBC relayer to relay your transaction to Axelar.

📝

Note: Third-party monitoring tools will automatically complete the remaining steps of this process.

Wait a few minutes then check your Metamask for the UST tokens. Don't forget to import the UST token into Metamask so you can see your balance as described in Metamask for EVM chains.

⚠️

Caution: If you attempt the remaining steps while third-party monitoring tools are active then your commands are likely to conflict with third-party commands. In this case you are likely to observe errors. Deeper investigation might be needed to resolve conflicts and complete the transfer.

The remaining steps are needed only if there are no active third-party monitoring tools and you wish to complete the process manually.

Verify the IBC transaction by checking the balances of {AXELAR_TEMP_ADDR} as per Basic node management. Output should contain something like:

balances:
- amount: "15000000"
  denom: {IBC_DENOM}
📝

Note: You will not see UST, uusd or a similar token denomination for {IBC_DENOM}. IBC token denominations look something like ibc/6F4968A73F90CF7DE6394BF937D6DF7C7D162D74D839C13F53B41157D315E05F

Get {IBC_DENOM} from Testnet resources or Mainnet resources.

The remaining steps are similar to Transfer AXL tokens from Axelar to an EVM chain using the terminal.

Confirm the deposit transaction. Look for {TX_HASH} in the output of the previous command.

axelard tx axelarnet confirm-deposit {TX_HASH} {AMOUNT}"{IBC_DENOM}" {AXELAR_TEMP_ADDR} --from my_account

Create and sign pending transfers for {EVM_CHAIN}.

axelard tx evm create-pending-transfers {EVM_CHAIN} --from my_account
axelard tx evm sign-commands {EVM_CHAIN} --from