Cryptoclaw token-swap

Execute token swaps on Uniswap/PancakeSwap across multiple EVM chains.

install
source · Clone the upstream repo
git clone https://github.com/TermiX-official/cryptoclaw
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/TermiX-official/cryptoclaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/token-swap" ~/.claude/skills/termix-official-cryptoclaw-token-swap && rm -rf "$T"
manifest: skills/token-swap/SKILL.md
source content

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"