cross-chain-swap

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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "cross-chain-swap" with this command: npx skills add wpank/cross-chain-swap

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

ParameterRequiredDefaultDescription
tokenInYesInput token symbol or address on source chain
tokenOutYesOutput token symbol or address on destination chain
amountYesAmount to swap (human-readable, e.g., "1.5" or "1000")
sourceChainYesSource chain name (e.g., "ethereum", "arbitrum")
destChainYesDestination chain name (e.g., "base", "optimism")
slippageNoautoSlippage tolerance (e.g., "0.5" for 0.5%)
recipientNoSame walletRecipient address on destination chain

Workflow

  1. 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").
  2. 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.
  3. 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.
  4. 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

ErrorUser-Facing MessageSuggested 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Web3

test

Gnosis Safe / multisig treasury setup, monitoring, and governance for DAOs and crypto treasuries. Treasury health dashboards, spending alerts, signer managem...

Registry SourceRecently Updated
200Profile unavailable
Web3

test

Monitor and analyze DeFi positions across protocols and chains. Track LP (liquidity provider) positions, staking rewards, yield farming returns, impermanent...

Registry SourceRecently Updated
220Profile unavailable
Web3

Crypto Tracker Cn

Track cryptocurrency markets in real-time. 加密货币行情追踪、比特币价格、以太坊ETH、市值排行、DeFi数据、恐惧贪婪指数、趋势币种、空投信息、RSI技术分析、均线分析、金叉死叉、DeFi收益率对比、Gas费查询。Use when checking crypto pri...

Registry SourceRecently Updated
2060Profile unavailable
Web3

Crypto Market Cli

Cryptocurrency market data tool with price checking, portfolio tracking, and market analysis. Use when you need crypto prices, market cap, 24h changes, portf...

Registry SourceRecently Updated
2730Profile unavailable