app-kit-bridge-evm

Bridge USDC between EVM chains

Use @circle-fin/app-kit to bridge USDC from Ethereum Sepolia to Arc Testnet with a browser wallet and the viem adapter.

This Vite + TypeScript page connects an EIP-6963 wallet (for example MetaMask), creates a Circle adapter from the provider, then calls bridge() and retryBridge() when needed.

Prerequisites

• Node.js 22 or later
• An EIP-6963 browser wallet such as MetaMask
• Testnet USDC on Ethereum Sepolia
• Native gas token on Ethereum Sepolia for the wallet transaction

This project does not require environment variables or API keys.

Install and run

npm install
npm run dev

Open the local Vite URL in a browser with your wallet installed.

npm run build

What this example does

1. Discovers an EIP-6963 browser wallet and requests account access.
2. Creates a viem adapter with createViemAdapterFromProvider().
3. Bridges 1 USDC from Ethereum_Sepolia to Arc_Testnet with kit.bridge().
4. Retries with kit.retryBridge() if the result state is "error".
5. Streams App Kit action events into the on-page output panel.

Key file

• src/main.ts — wallet connect, adapter creation, bridge, and retry. Change from / to chain, amount, and optional token in the bridge call for different chains, amounts, or tokens.

Bridge a non-USDC token

This sample defaults to USDC. To bridge a non-USDC token, pass token on the same kit.bridge() call in src/main.ts — for example token: "EURC" (also "wETH", "cirBTC", or a configured asset's tokenId). Fund the source wallet with that token. amount stays a human-readable decimal string (EURC uses 6 decimals, cirBTC 8, wETH 18).

Both chains must support CCTP for non-USDC, and the token must be configured on both. Check supported blockchains and tokens.