CLAUDE.md - uniswap-trading Plugin
Overview
This plugin provides comprehensive guidance for integrating Uniswap swaps into frontends, backends, and smart contracts. It supports the Trading API, Universal Router SDK, and direct smart contract integration.
Plugin Components
Skills (./skills/)
- swap-integration: Comprehensive guide for integrating Uniswap swaps via Trading API, Universal Router SDK, or direct smart contract calls. Covers frontend hooks, backend scripts, Solidity integrations, Permit2 patterns, ERC-4337 smart account integration, L2 WETH handling, rate limiting, and troubleshooting.
Agents (./agents/)
- swap-integration-expert: Expert agent for complex Uniswap swap integration questions, Trading API debugging, Universal Router encoding, Permit2 patterns, ERC-4337 smart account integration, and L2-specific patterns.
File Structure
uniswap-trading/
├── .claude-plugin/
│ └── plugin.json
├── agents/
│ └── swap-integration-expert.md
├── skills/
│ └── swap-integration/
│ ├── SKILL.md
│ └── references/
│ └── advanced-patterns.md
├── project.json
├── package.json
├── CLAUDE.md
└── README.md
Integration Methods
Trading API (Recommended for most use cases)
- REST API at
https://trade-api.gateway.uniswap.org/v1
- Handles routing optimization automatically
- 3-step flow: check_approval -> quote -> swap
Universal Router SDK
- Direct SDK usage with
@uniswap/universal-router-sdk
- Full control over transaction construction
- Command-based architecture
Direct Smart Contract Integration
- Solidity contracts calling Universal Router
- For on-chain integrations and DeFi composability
Supported Chains
Ethereum (1), Optimism (10), BNB (56), Unichain (130), Polygon (137), X Layer (196), zkSync (324), World Chain (480), Soneium (1868), Base (8453), Arbitrum (42161), Celo (42220), Avalanche (43114), Blast (81457), Zora (7777777), Monad (143)
Related Plugins
- uniswap-viem: Foundational EVM blockchain integration using viem/wagmi (prerequisite knowledge)
- uniswap-hooks: Uniswap v4 hook development with security-first approach
Key References
- Trading API:
https://trade-api.gateway.uniswap.org/v1
- Universal Router:
github.com/Uniswap/universal-router
- SDKs:
@uniswap/universal-router-sdk, @uniswap/v3-sdk, @uniswap/sdk-core
- Permit2: Token approval infrastructure
1---2name: claude-md-uniswap-trading-plugin3description: This plugin provides comprehensive guidance for integrating Uniswap swaps into frontends, backends, and smart contracts. It supports the Trading API, Universal Router SDK, and direct smart contract integration.4---5# CLAUDE.md - uniswap-trading Plugin67## Overview89This plugin provides comprehensive guidance for integrating Uniswap swaps into frontends, backends, and smart contracts. It supports the Trading API, Universal Router SDK, and direct smart contract integration.1011## Plugin Components1213### Skills (./skills/)1415- **swap-integration**: Comprehensive guide for integrating Uniswap swaps via Trading API, Universal Router SDK, or direct smart contract calls. Covers frontend hooks, backend scripts, Solidity integrations, Permit2 patterns, ERC-4337 smart account integration, L2 WETH handling, rate limiting, and troubleshooting.1617### Agents (./agents/)1819- **swap-integration-expert**: Expert agent for complex Uniswap swap integration questions, Trading API debugging, Universal Router encoding, Permit2 patterns, ERC-4337 smart account integration, and L2-specific patterns.2021## File Structure2223```text24uniswap-trading/25├── .claude-plugin/26│ └── plugin.json27├── agents/28│ └── swap-integration-expert.md29├── skills/30│ └── swap-integration/31│ ├── SKILL.md32│ └── references/33│ └── advanced-patterns.md34├── project.json35├── package.json36├── CLAUDE.md37└── README.md38```3940## Integration Methods41421. **Trading API** (Recommended for most use cases)4344 - REST API at `https://trade-api.gateway.uniswap.org/v1`45 - Handles routing optimization automatically46 - 3-step flow: check_approval -> quote -> swap47482. **Universal Router SDK**4950 - Direct SDK usage with `@uniswap/universal-router-sdk`51 - Full control over transaction construction52 - Command-based architecture53543. **Direct Smart Contract Integration**55 - Solidity contracts calling Universal Router56 - For on-chain integrations and DeFi composability5758## Supported Chains5960Ethereum (1), Optimism (10), BNB (56), Unichain (130), Polygon (137), X Layer (196), zkSync (324), World Chain (480), Soneium (1868), Base (8453), Arbitrum (42161), Celo (42220), Avalanche (43114), Blast (81457), Zora (7777777), Monad (143)6162## Related Plugins6364- **uniswap-viem**: Foundational EVM blockchain integration using viem/wagmi (prerequisite knowledge)65- **uniswap-hooks**: Uniswap v4 hook development with security-first approach6667## Key References6869- Trading API: `https://trade-api.gateway.uniswap.org/v1`70- Universal Router: `github.com/Uniswap/universal-router`71- SDKs: `@uniswap/universal-router-sdk`, `@uniswap/v3-sdk`, `@uniswap/sdk-core`72- Permit2: Token approval infrastructure
tools-only