cross-chain-asset-transfer
Transfer tokens between blockchain networks using Hyperlane's cross-chain infrastructure. Move assets like USDC from Ethereum to Polygon or execute multi-chain transfers in a single operation.
Instructions
Transfers tokens/assets between multiple blockchain networks using Hyperlane's cross-chain infrastructure.
FUNCTIONALITY: • Moves tokens from one blockchain to another (e.g., USDC from Ethereum to Polygon) • Supports sequential transfers across multiple chains in a single operation • Handles various token types including native tokens, ERC20 tokens, and synthetic tokens
PREREQUISITES:
• A warp route must exist for the specified token symbol and chain combination
• If no warp route exists, deploy one first using the deploy-warp-route tool
• Sufficient token balance on the origin chain
• Sufficient gas tokens on all involved chains for transaction fees
PARAMETERS: • symbol: The token identifier (e.g., "USDC", "ETH", "WBTC") • chains: Array of blockchain names in transfer order (e.g., ["ethereum", "polygon", "arbitrum"]) • amount: Token amount in wei or smallest token units (e.g., "1000000" for 1 USDC with 6 decimals) • recipient: Destination wallet address (defaults to sender if not specified)
OUTPUT: • Returns transaction hashes and message IDs for each cross-chain transfer • Each transfer between adjacent chains generates one transaction • Use message IDs to track delivery status across chains
EXAMPLE USE CASES: • Bridge USDC from Ethereum to Polygon • Multi-hop transfer: ETH from Ethereum → Arbitrum → Base • Cross-chain token arbitrage or yield farming
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Token symbol to transfer | |
| chains | Yes | Chains to transfer asset between in order of transfer | |
| amount | Yes | Amount to transfer (in wei or token units) | |
| recipient | No | Recipient address | 0x1Be31A94361a391bBaFB2a4CCd704F57dc04d4bb |