Cross-Chain Swap
Overview
Executes a cross-chain token swap — swapping a token on one chain for a different (or same) token on another chain. Delegates the full workflow to the cross-chain-executor agent, which handles quoting, route evaluation, safety checks, bridge monitoring, and destination confirmation.
When to Use
Activate when the user asks:
- "Swap ETH on Arbitrum for USDC on Base"
- "Cross-chain swap"
- "Buy USDC on Optimism using ETH from mainnet"
- "Move my ETH from Ethereum to Arbitrum and convert to USDC"
- "Swap tokens across chains"
- "Exchange X on chain A for Y on chain B"
Parameters
| Parameter |
Required |
Default |
Description |
| tokenIn |
Yes |
— |
Input token symbol or address on source chain |
| tokenOut |
Yes |
— |
Output token symbol or address on destination chain |
| amount |
Yes |
— |
Amount to swap (human-readable, e.g., "1.5" or "1000") |
| sourceChain |
Yes |
— |
Source chain name (e.g., "ethereum", "arbitrum") |
| destChain |
Yes |
— |
Destination chain name (e.g., "base", "optimism") |
| slippage |
No |
auto |
Slippage tolerance (e.g., "0.5" for 0.5%) |
| recipient |
No |
Same wallet |
Recipient address on destination chain |
Workflow
Extract parameters from the user's request. Identify:
- Which token they want to send and on which chain.
- Which token they want to receive and on which chain.
- The amount to swap.
- Resolve ambiguous chain references (e.g., "mainnet" = "ethereum").
Validate inputs:
- Verify both chains are supported via
mcp__uniswap__getSupportedChains.
- Verify tokens exist on their respective chains via
mcp__uniswap__getTokenInfo.
- If source and destination chain are the same: redirect to
execute-swap skill instead.
Delegate to cross-chain-executor: Invoke Task(subagent_type:cross-chain-executor) with:
- tokenIn, tokenOut, amount, sourceChain, destChain, slippage, recipient.
- The agent handles the full 7-step workflow: quote, risk assessment, safety check, execution, bridge monitoring, confirmation, and reporting.
Present results: Format the execution report for the user, highlighting:
- Amounts sent and received.
- Total fees (gas + bridge).
- Settlement time.
- Any warnings from safety or risk checks.
Output Format
Cross-Chain Swap Complete
Source: 1.5 ETH on Ethereum
Destination: 2,850.25 USDC on Base
Fees: $3.50 (gas: $2.50, bridge: $1.00)
Settlement: 2 min 35 sec
Source Tx: 0xabc...123
Bridge ID: 0x789...abc
Dest Tx: 0xdef...456
Risk: LOW | Safety: APPROVED
Important Notes
- Cross-chain swaps involve bridge operations that take time to settle (typically 1-10 minutes).
- The skill will monitor the bridge and report status updates during settlement.
- Bridge fees and slippage apply in addition to normal swap fees.
- If the bridge gets stuck, the executor will escalate with recovery instructions.
Error Handling
| Error |
User-Facing Message |
Suggested Action |
| Unsupported chain |
"Chain [name] is not supported for cross-chain swaps." |
Check supported chains |
| Same chain |
"Source and destination are the same chain. Use a regular swap." |
Use execute-swap skill |
| Safety veto |
"This swap was blocked by safety checks: [reason]." |
Reduce amount or check token |
| Risk veto |
"Risk assessment vetoed: [reason]." |
Choose a different route or amount |
| Bridge stuck |
"Bridge settlement is taking longer than expected." |
Wait or check order ID manually |
| Bridge failed |
"Bridge operation failed. Funds should remain on source chain." |
Check source wallet balance |
| Insufficient balance |
"Not enough [token] on [chain] to execute this swap." |
Check balance and reduce amount |
1---2name: cross-chain-swap3description: Execute a cross-chain token swap via Uniswap's bridge infrastructure. Handles quoting, safety validation, bridge monitoring, and destination confirmation. Use when the user wants to swap tokens across different chains.4---56# Cross-Chain Swap78## Overview910Executes a cross-chain token swap — swapping a token on one chain for a different (or same) token on another chain. Delegates the full workflow to the `cross-chain-executor` agent, which handles quoting, route evaluation, safety checks, bridge monitoring, and destination confirmation.1112## When to Use1314Activate when the user asks:1516- "Swap ETH on Arbitrum for USDC on Base"17- "Cross-chain swap"18- "Buy USDC on Optimism using ETH from mainnet"19- "Move my ETH from Ethereum to Arbitrum and convert to USDC"20- "Swap tokens across chains"21- "Exchange X on chain A for Y on chain B"2223## Parameters2425| Parameter | Required | Default | Description |26| ---------------- | -------- | ---------- | ---------------------------------------------------- |27| tokenIn | Yes | — | Input token symbol or address on source chain |28| tokenOut | Yes | — | Output token symbol or address on destination chain |29| amount | Yes | — | Amount to swap (human-readable, e.g., "1.5" or "1000") |30| sourceChain | Yes | — | Source chain name (e.g., "ethereum", "arbitrum") |31| destChain | Yes | — | Destination chain name (e.g., "base", "optimism") |32| slippage | No | auto | Slippage tolerance (e.g., "0.5" for 0.5%) |33| recipient | No | Same wallet| Recipient address on destination chain |3435## Workflow36371. **Extract parameters** from the user's request. Identify:38 - Which token they want to send and on which chain.39 - Which token they want to receive and on which chain.40 - The amount to swap.41 - Resolve ambiguous chain references (e.g., "mainnet" = "ethereum").42432. **Validate inputs**:44 - Verify both chains are supported via `mcp__uniswap__getSupportedChains`.45 - Verify tokens exist on their respective chains via `mcp__uniswap__getTokenInfo`.46 - If source and destination chain are the same: redirect to `execute-swap` skill instead.47483. **Delegate to cross-chain-executor**: Invoke `Task(subagent_type:cross-chain-executor)` with:49 - tokenIn, tokenOut, amount, sourceChain, destChain, slippage, recipient.50 - The agent handles the full 7-step workflow: quote, risk assessment, safety check, execution, bridge monitoring, confirmation, and reporting.51524. **Present results**: Format the execution report for the user, highlighting:53 - Amounts sent and received.54 - Total fees (gas + bridge).55 - Settlement time.56 - Any warnings from safety or risk checks.5758## Output Format5960```text61Cross-Chain Swap Complete6263 Source: 1.5 ETH on Ethereum64 Destination: 2,850.25 USDC on Base65 Fees: $3.50 (gas: $2.50, bridge: $1.00)66 Settlement: 2 min 35 sec6768 Source Tx: 0xabc...12369 Bridge ID: 0x789...abc70 Dest Tx: 0xdef...4567172 Risk: LOW | Safety: APPROVED73```7475## Important Notes7677- Cross-chain swaps involve bridge operations that take time to settle (typically 1-10 minutes).78- The skill will monitor the bridge and report status updates during settlement.79- Bridge fees and slippage apply in addition to normal swap fees.80- If the bridge gets stuck, the executor will escalate with recovery instructions.8182## Error Handling8384| Error | User-Facing Message | Suggested Action |85| ---------------------------- | ---------------------------------------------------------------- | ------------------------------------ |86| Unsupported chain | "Chain [name] is not supported for cross-chain swaps." | Check supported chains |87| Same chain | "Source and destination are the same chain. Use a regular swap." | Use execute-swap skill |88| Safety veto | "This swap was blocked by safety checks: [reason]." | Reduce amount or check token |89| Risk veto | "Risk assessment vetoed: [reason]." | Choose a different route or amount |90| Bridge stuck | "Bridge settlement is taking longer than expected." | Wait or check order ID manually |91| Bridge failed | "Bridge operation failed. Funds should remain on source chain." | Check source wallet balance |92| Insufficient balance | "Not enough [token] on [chain] to execute this swap." | Check balance and reduce amount |
dvcrn