token-swap

name	token-swap
description	Execute token swaps on Uniswap/PancakeSwap across multiple EVM chains.
metadata	{"cryptoclaw":{"emoji":"🔄","always":true}}

Token Swap Skill

Execute token swaps on Uniswap (V2/V3) and PancakeSwap (V2/V3) across multiple EVM chains.

Overview

Swap tokens using dedicated DEX tools that automatically compare V2 and V3 quotes to find the best price. Uses the active wallet for signing transactions.

Supported DEXes

• BSC: PancakeSwap V2 + V3
• Ethereum: Uniswap V2 + V3
• Polygon: QuickSwap V2 + Uniswap V3
• Arbitrum: Uniswap V2 + V3
• Optimism: Uniswap V3
• Base: Uniswap V3

Tools Used

• swap_get_quote - Get best swap quote across V2/V3 with estimated output and price impact
• swap_execute - Execute the swap (auto-approves token spending if needed)
• swap_check_allowance - Check if token is already approved for the router
• swap_supported_dexes - List available DEXes and fee tiers for a network
• get_erc20_token_info - Look up token name, symbol, decimals by contract address

Workflow

1. User requests a swap → call swap_get_quote with tokenIn, tokenOut, amountIn
2. Present quote: input amount, estimated output, minimum output, slippage, DEX name, version
3. If price impact is high or slippage > 1%, warn the user
4. Ask user for explicit confirmation before proceeding
5. Call swap_execute with same parameters

Security Rules

• ALWAYS show the swap quote before executing
• ALWAYS warn if estimated output seems low (possible low liquidity)
• NEVER execute swaps without explicit user confirmation
• Default slippage: 0.5% — warn if user sets above 3%
• For large swaps, suggest splitting into multiple smaller trades
• Run security-check on the target token before executing a swap to detect honeypots and high taxes

V3 Fee Tiers

When using V3, the fee tier affects which liquidity pool is used:

• 0.01% (100) — stablecoin pairs
• 0.05% (500) — stable/common pairs
• 0.3% (3000) — most common, default
• 1% (10000) — exotic pairs

The tool auto-selects the best fee tier by default.

Example Interactions

User: "Swap 1 BNB for USDT on BSC" → Call swap_get_quote with tokenIn="native", tokenOut="0x55d398326f99059fF775485246999027B3197955", amountIn="1" → Show: "PancakeSwap V3: 1 BNB → ~590.23 USDT (min: 587.28 USDT, 0.5% slippage)" → After confirmation: call swap_execute

User: "What would I get for swapping 100 USDT to ETH on Ethereum?" → Call swap_get_quote only, display result without executing

User: "What DEXes work on Arbitrum?" → Call swap_supported_dexes with network="arbitrum"