Get Started

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.

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:

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'
})

Instantiate the bridge protocol

You can create a Usdt0ProtocolEvm instance with the new Usdt0ProtocolEvm(account, config?) constructor. Optional bridgeMaxFee rejects a bridge when the implementation's combined fee value is at or above the cap:

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

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

For standard EVM accounts, fee and bridgeFee are source-chain native base units. ERC-4337 fee units depend on the account's gas-payment mode while bridgeFee is returned in bridged-token base units. Read Fee units and bridgeMaxFee before setting a cap for an ERC-4337 flow.

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)

ERC-4337 helper workflows are available when the source chain is Ethereum, Arbitrum, Plasma, or Polygon. Other listed source chains support standard EVM accounts only. See Bridge with ERC-4337.

Non-EVM destinations

Next Steps

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