# swap-integration

Помогает настроить обмен токенов через Uniswap в веб-интерфейсах, бэкенд-скриптах и смарт-контрактах. Пригодится при работе с Trading API или Universal Router.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2200 установок · ★ 235
- Автор: uniswap
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Uniswap/uniswap-ai/tree/HEAD/packages/plugins/uniswap-trading/skills/swap-integration/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/swap-integration

## Что делает

Скилл генерирует код для интеграции свопов Uniswap в проекты на React, Next.js, Node.js или Solidity. Для фронтенда и ботов он предлагает использовать Uniswap Trading API, где маршрутизация рассчитывается автоматически через эндпоинты `/quote` и `/swap`. Если нужен полный контроль над транзакциями, скилл строит вызовы через Universal Router SDK или прямой метод `execute()` смарт-контракта.

Для работы через Trading API понадобится ключ из портала разработчиков Uniswap, передаваемый в заголовке `x-api-key`. При запросах обязательно указывать заголовок атрибуции `x-agent-info` с полями `integration_name`, `decision_origin` и версией, а для токенов из пулов с разрешениями — повышать версию `x-universal-router-version` минимум до `2.2.0`.

Входные данные строго проверяются перед вставкой в код: скилл отсекает адреса вне формата шестнадцатеричной строки из 40 символов и блокирует спецсимволы командной строки. Базовые операции с кошельками строятся вокруг библиотеки viem.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Uniswap/uniswap-ai --skill swap-integration -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/swap-integration/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/swap-integration/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Uniswap/uniswap-ai --skill swap-integration -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/swap-integration/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Uniswap/uniswap-ai --skill swap-integration -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/swap-integration/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Uniswap/uniswap-ai swap-integration
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/swap-integration/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Uniswap/uniswap-ai --skill swap-integration -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Uniswap/uniswap-ai --path packages/plugins/uniswap-trading/skills/swap-integration
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/swap-integration/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Uniswap/uniswap-ai --skill swap-integration -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Uniswap/uniswap-ai/tree/HEAD/packages/plugins/uniswap-trading/skills/swap-integration/SKILL.md

## Когда брать
- подключить обмен токенов через Uniswap Trading API
- собрать параметры вызова Universal Router через @uniswap/universal-router-sdk
- проверить разрешения и аппрувы токена перед отправкой транзакции
- подготовить транзакции обмена в смарт-контракте через вызов execute()

## Примеры запросов агенту
- Напиши скрипт для обмена ETH на USDC через Uniswap Trading API
- Помоги вызвать Universal Router в смарт-контракте на Solidity
- Добавь проверку аппрува и получение котировки через Trading API

## Похожие
- [gmgn-market](https://affpapa.org/nevibecode/skills/gmgn-market.md) — скилл · 17900 установок
- [swapper-deposit](https://affpapa.org/nevibecode/skills/swapper-deposit.md) — скилл · 752 установки
- [gmgn-swap](https://affpapa.org/nevibecode/skills/gmgn-swap.md) — скилл · 17000 установок
- [nodejs-keccak256](https://affpapa.org/nevibecode/skills/nodejs-keccak256.md) — скилл · 4800 установок
- [dune](https://affpapa.org/nevibecode/skills/dune.md) — скилл · 1100 установок
- [alchemy-api](https://affpapa.org/nevibecode/skills/alchemy-api.md) — скилл · 1600 установок

Из того же набора: [uniswap/uniswap-ai](https://affpapa.org/nevibecode/by/uniswap/uniswap-ai.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md