swap-integration

SKILL.md

Integrate Uniswap swaps into frontends, backends, and smart contracts.

Three integration methods: Trading API (recommended for most use cases), Universal Router SDK (direct control), and smart contract integration via encoded commands

Supports multiple routing types including CLASSIC AMM swaps, UniswapX Dutch auctions (V2/V3), MEV-protected priority orders, and wrap/unwrap operations across all supported chains

Critical implementation details: spread quote responses into request bodies, handle permitData differently for CLASSIC vs. UniswapX routes, validate swap data before broadcasting, and set up CORS proxies for browser environments

Comprehensive error handling, rate limiting strategies, and chain-specific patterns (WETH unwrapping on L2s, smart account delegation, Permit2 approval flows)

Swap Integration

Integrate Uniswap swaps into frontends, backends, and smart contracts.

Prerequisites

This skill assumes familiarity with viem basics (client setup, account management, contract interactions, transaction signing). Install the uniswap-viem plugin for comprehensive viem/wagmi guidance: claude plugin add @uniswap/uniswap-viem

Quick Decision Guide

Building...
Use This Method

Frontend with React/Next.js
Trading API

Backend script or bot
Trading API

Smart contract integration
Universal Router direct calls

Need full control over routing
Universal Router SDK

Routing Types Quick Reference