tools-only Swap Integration
Integrate Uniswap swaps into frontends, backends, and smart contracts using the Trading API, Universal Router SDK, or direct contract calls.
Invocation
/swap-integration
Or describe your requirements naturally:
Help me add Uniswap swap functionality to my Next.js app
What It Does
This skill helps you:
- Choose the right integration method: Trading API, Universal Router SDK, or direct smart contract calls
- Build swap flows: Frontend React hooks, backend Node.js scripts, and Solidity integrations
- Handle Permit2: Signature-based approvals, legacy approvals, and the rules for including permit data
- Avoid common pitfalls: Null field handling, swap request body format, pre-broadcast validation, and L2 WETH handling
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 |
Integration Methods
Trading API (Recommended)
REST API with a 3-step flow: check_approval -> quote -> swap. Handles routing optimization automatically across all Uniswap protocol versions.
Universal Router SDK
Direct SDK usage with @uniswap/universal-router-sdk for full control over transaction construction, including manual command building with RoutePlanner.
Smart Contract Integration
On-chain Solidity contracts calling the Universal Router's execute() function with encoded commands for DeFi composability.
Routing Types
| Type | Description | Chains |
|---|---|---|
| CLASSIC | Standard AMM swap through Uniswap pools | All supported chains |
| DUTCH_V2 | UniswapX Dutch auction V2 | Ethereum, Arbitrum, Base, Unichain |
| PRIORITY | MEV-protected priority order | Base, Unichain |
| WRAP | ETH to WETH conversion | All |
| UNWRAP | WETH to ETH conversion | All |
Additional types include DUTCH_V3, DUTCH_LIMIT, LIMIT_ORDER, BRIDGE, and QUICKROUTE.
Key Topics Covered
- Trading API reference with request/response examples
- Universal Router command encoding and SDK patterns
- Permit2 integration (SignatureTransfer and AllowanceTransfer modes)
- UniswapX auction types by chain (Exclusive Dutch, Open Dutch, Priority Gas)
- ERC-4337 smart account integration
- Rate limiting and retry strategies
- Contract addresses for all supported chains
Related Resources
- Uniswap Trading Plugin - Parent plugin
- viem Integration - Prerequisite EVM blockchain setup
- Universal Router GitHub - Source code
- Uniswap Docs - Official documentation
- Uniswap API Docs - Official API documentation