# use-developer-controlled-wallets

Скилл для работы с developer-controlled кошельками Circle: создание наборов кошельков, переводы токенов, подпись сообщений и вызовы контрактов через SDK.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 969 установок · ★ 158
- Автор: circlefin
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/circlefin/skills/tree/HEAD/plugins/circle/skills/use-developer-controlled-wallets/SKILL.md
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/skills/use-developer-controlled-wallets

## Что делает

Скилл описывает, как приложение создаёт кошельки от имени пользователей и держит приватные ключи у себя. Ключи защищены entity secret — 32-байтовым hex-значением, которое шифруется открытым ключом Circle и регистрируется один раз. Сам секрет и файл восстановления генерирует и хранит разработчик; скилл прямо запрещает регистрировать секрет за него.

Внутри — установка пакета `@circle-fin/developer-controlled-wallets`, инициализация клиента через `initiateDeveloperControlledWalletsClient`, разбор типов аккаунтов EOA и SCA и жизненного цикла транзакции от `INITIATED` до `COMPLETE`. Для каждой задачи есть отдельный файл-справка: создание кошелька, приём и перевод токенов, проверка баланса, подпись по EIP-191 и EIP-712, исполнение контрактов, апгрейд и вывод кошельков на новые сети. Все изменяющие запросы требуют UUID v4 в `idempotencyKey` — без него транзакция не пройдёт.

Понадобятся `CIRCLE_API_KEY` в формате `PREFIX:ID:SECRET` и `ENTITY_SECRET` в переменных окружения. SCA-кошельки работают только в EVM-сетях, поэтому на Solana, Aptos и NEAR их не создать. На Ethereum mainnet из-за стоимости газа скилл советует брать L2.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add circlefin/skills --skill use-developer-controlled-wallets -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add circlefin/skills --skill use-developer-controlled-wallets -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add circlefin/skills --skill use-developer-controlled-wallets -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install circlefin/skills use-developer-controlled-wallets
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add circlefin/skills --skill use-developer-controlled-wallets -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/circlefin/skills --path plugins/circle/skills/use-developer-controlled-wallets
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add circlefin/skills --skill use-developer-controlled-wallets -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/circlefin/skills/tree/HEAD/plugins/circle/skills/use-developer-controlled-wallets/SKILL.md

## Когда брать
- создать набор кошельков под один entity secret
- перевести токены и оценить комиссию перед отправкой
- подписать типизированные данные по EIP-712
- вызвать функцию контракта по ABI или сырому calldata
- вывести кошелёк на новую сеть и обновить версию SCA

## Примеры запросов агенту
- Создай кошелёк в новом наборе и покажи его адрес
- Проверь баланс кошелька и переведи 10 USDC получателю
- Подпиши типизированные данные этим кошельком

## Похожие
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [lark-im](https://affpapa.org/nevibecode/skills/lark-im.md) — скилл · 472900 установок
- [lark-event](https://affpapa.org/nevibecode/skills/lark-event.md) — скилл · 466800 установок
- [caveman-discover](https://affpapa.org/nevibecode/skills/caveman-discover.md) — скилл · 104400 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок

Из того же набора: [circlefin/skills](https://affpapa.org/nevibecode/by/circlefin/skills.md) — 17 карточек

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

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