bridge_transfer
Move tokens between blockchains with Stargate protocol: automatically fetches quote, processes approvals, and broadcasts transactions to the source chain.
Instructions
Execute a cross-chain token bridge transfer using the Stargate protocol.
This tool fetches a quote internally (using provided chains and default addresses), constructs and signs transactions using the private key from the .env file, broadcasts them sequentially to the source chain, and waits for confirmations. It handles approvals and bridge steps. Source address is derived from PRIVATE_KEY. Destination address defaults to source if not provided.
Parameters:
- src_chain_key (str): Source chain key (e.g., 'ethereum').
- dst_chain_key (str): Destination chain key (e.g., 'polygon').
- src_token (str): Source token contract address.
- dst_token (str): Destination token contract address.
- src_amount (float): Human-readable amount to bridge (e.g., 1.0).
- dst_amount_min (float): Minimum expected destination amount for slippage (e.g., 0.99).
- dst_address (Optional[str]): Destination wallet address. If omitted, uses source address from PRIVATE_KEY.
Returns:
- str: Markdown-formatted string with success message including transaction hashes for each step, or an error message if any step fails (e.g., invalid key, no quote, RPC failure, or transaction revert).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dst_token | Yes | ||
| src_token | Yes | ||
| src_amount | Yes | ||
| dst_address | No | ||
| dst_chain_key | Yes | ||
| src_chain_key | Yes | ||
| dst_amount_min | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |