Skip to content

OVERVIEW.md

Latest commit

 

History

History
148 lines (90 loc) · 4.44 KB

OVERVIEW.md

File metadata and controls

148 lines (90 loc) · 4.44 KB
Raw

Uniswap AI

Uniswap-specific AI tools (skills, plugins, agents) for developers and AI agents integrating the trading API.

Overview

This repository provides Claude Code plugins and AI development tools specifically designed for building on the Uniswap protocol.

Installation

Skills CLI (Any Agent)

# Install all Uniswap AI skills via the skills.sh CLI
npx skills add Uniswap/uniswap-ai

Claude Code Marketplace

# Install the uniswap-ai plugin marketplace
/plugin marketplace add uniswap/uniswap-ai

# Install a specific plugin
/plugin install uniswap-hooks

Plugins

uniswap-hooks

AI-powered, security-first assistance for creating Uniswap v4 hooks.

Skills: v4-security-foundations

uniswap-trading

Integrate Uniswap swaps via Trading API, Universal Router SDK, or direct smart contract calls.

Skills: swap-integration

uniswap-cca

Configure and deploy Continuous Clearing Auction (CCA) smart contracts for token distribution.

Skills: configurator, deployer | MCP Servers: cca-supply-schedule

uniswap-driver

Plan Uniswap swaps and liquidity positions with deep link generation for the Uniswap interface.

Skills: swap-planner, liquidity-planner

uniswap-viem

Foundational EVM blockchain integration using viem and wagmi.

Skills: viem-integration

uniswap-trading-tools

Automated trading tools — dollar-cost averaging, weighted index baskets, and copy-trading — that delegate execution to existing Uniswap skills. Asset-agnostic across crypto-native tokens and tokenized real-world assets (RWAs), and portable to any chain where Uniswap is deployed.

Skills: dca-bot, index-bot, copy-trade

uniswap-permissioned-pools

Reference material for engineering teams standing up a Uniswap v4 Permissioned Pool for a transfer-restricted ERC-20: the contract stack, the ordered setup journey, the ordering the contracts enforce, and the trust model. Also includes an interactive configurator that collects and validates setup parameters into a JSON config, and a guided deployer that walks the config through the on-chain setup sequence as ordered command sequences. Contract mechanics only — does not constitute legal, financial, investment, tax, or compliance advice, and is not a compliance review.

Skills: permissioned-pools-issuer, permissioned-pools-configurator, permissioned-pools-deployer

Agent-Agnostic Design

All tools in this repository are designed to work with any LLM coding agent, not just Claude Code:

  • AGENTS.md symlinks to CLAUDE.md for cross-agent compatibility
  • Prompts are written to work across different models
  • Skills are structured as markdown that any agent can interpret

Documentation

Development

Prerequisites

  • Node.js 22.x
  • Bun 1.3.13 or later

Setup

# Install dependencies
bun install

# Build all packages
bunx nx run-many -t build

# Run tests
bunx nx run-many -t test

# Run linting
bunx nx run-many -t lint

Project Structure

uniswap-ai/
├── packages/
│   └── plugins/         # Claude Code plugins (skills live here)
├── evals/               # AI tool evaluations (Promptfoo)
├── docs/                # VitePress documentation
└── scripts/             # Build and validation scripts

Contributing

Contributions are welcome. Please ensure:

  1. All code passes linting and tests
  2. New skills include eval suites
  3. Documentation is updated

Automated Checks

PRs are automatically validated by several workflows:

  • PR Checks - Build, lint, test, documentation prose linting, and plugin validation
  • Claude Code Review - AI-powered code review with inline comments
  • Claude Docs Check - Validates CLAUDE.md and README updates, ensures plugin version bumps

If the docs check flags missing documentation updates, you can apply the suggested changes directly from the PR comments.

See .github/workflows/CLAUDE.md for detailed CI documentation.

License

MIT License - see LICENSE for details.

Links