WDK logoWDK documentation

Get Started

Install the bridge package, wire WalletAccountEvm, and review supported chains.

This guide shows how to install the package, create an EVM account, instantiate the bridge protocol, and review supported chains.

Install the package

Prerequisites

  • Node.js: version 18 or higher.
  • npm: usually bundled with Node.js.

You can add the published package to your project from npm: @tetherto/wdk-protocol-bridge-usdt0-evm.

Install @tetherto/wdk-protocol-bridge-usdt0-evm
npm install @tetherto/wdk-protocol-bridge-usdt0-evm

Create an EVM account

You can construct a signing account using new WalletAccountEvm(seed, path, config?) from @tetherto/wdk-wallet-evm with an RPC provider:

Create WalletAccountEvm
import { WalletAccountEvm } from '@tetherto/wdk-wallet-evm'

const seedPhrase = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'

const account = new WalletAccountEvm(seedPhrase, "0'/0/0", {
  provider: 'https://eth.drpc.org'
})

Seed phrase: Store the mnemonic securely. Anyone with the phrase controls the funds on derived accounts.

Instantiate the bridge protocol

You can create a Usdt0ProtocolEvm instance with the new Usdt0ProtocolEvm(account, config?) constructor. Optional bridgeMaxFee caps the total bridge cost in wei (see BridgeProtocolConfig):

Construct Usdt0ProtocolEvm
import Usdt0ProtocolEvm from '@tetherto/wdk-protocol-bridge-usdt0-evm'

const bridgeProtocol = new Usdt0ProtocolEvm(account, {
  bridgeMaxFee: 1000000000000000n
})

The account must not be read-only. Read-only accounts cannot call bridge().

Supported chains

Bridge operations use EVM source chains listed in the API reference. Destination routes include the same EVM set where USD₮0 contracts are deployed, plus Solana (EID 30168), TON (EID 30343), and TRON (EID 30420).

Source chains (EVM, targetChain keys)

ChainKeyChain ID
Ethereumethereum1
Arbitrumarbitrum42161
Optimismoptimism10
Polygonpolygon137
Berachainberachain80094
Inkink57073
Plasmaplasma9745
Conflux eSpaceconflux1030
Corncorn21000000
Avalancheavalanche43114
Celocelo42220
Flareflare14
HyperEVMhyperevm999
Mantlemantle5000
MegaETHmegaeth4326
Monadmonad143
Morphmorph2818
Rootstockrootstock30
Seisei1329
Stablestable988
Unichainunichain130
XLayerxlayer196

Arbitrum supports ERC-4337 workflows (see Bridge with ERC-4337).

Non-EVM destinations

NetworktargetChainEndpoint ID
Solanasolana30168
TONton30343
TRONtron30420

Next Steps

Run a standard EVM-to-EVM transfer with Bridge tokens, or use Bridge with ERC-4337 for gasless flows on supported networks.

On this page