| list_chainsA | Retrieve a list of all blockchain networks supported by the Stargate protocol for cross-chain bridging.
This tool fetches the comprehensive list of chains from the Stargate API and formats it as a Markdown table.
Parameters:
- None
Returns:
- str: Markdown table with columns: Name, Chain Type, Chain ID, Chain Key, Native Symbol.
|
| list_bridgeable_tokensA | Retrieve a list of bridgeable destination chains and tokens for a given source chain and token.
This tool directly queries the Stargate /tokens API with srcChainKey and srcToken parameters to get available destination tokens that can be bridged to from the source.
Parameters:
- src_chain_key (str): Source chain key (e.g., 'ethereum').
- src_token (str): Source token contract address (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' for USDC on Ethereum).
Returns:
- str: Markdown table with columns: Chain Key, Symbol, Address for bridgeable destinations (excluding source chain).
|
| get_quotesA | Fetch quotes for a cross-chain token bridge transfer using the Stargate API.
This tool retrieves all available bridge routes, including expected destination amounts, fees, estimated times, and transaction steps for each route. It accepts human-readable amounts (floats) and converts them internally using token decimals. If src_address is not provided, it uses the address derived from the PRIVATE_KEY in .env. If dst_address is not provided, it defaults to src_address.
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 (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48').
- dst_token (str): Destination token contract address.
- src_amount (float): Human-readable amount to bridge (e.g., 1.0 for 1 USDC).
- dst_amount_min (float): Minimum expected destination amount for slippage (human-readable, e.g., 0.99).
- src_address (Optional[str]): Source wallet address (e.g., '0x...'). If omitted, uses address from PRIVATE_KEY.
- dst_address (Optional[str]): Destination wallet address. If omitted, uses src_address.
Returns:
- str: Concise Markdown-formatted string listing all quotes with key details and steps. If no quotes available, returns an error message in Markdown.
|
| bridge_transferA | 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).
|
