# Onchain Agent Wallets

MCP-сервер выделяет ИИ-агенту лимит расходов в сети Solana без передачи приватного ключа от основного счёта. Помогает безопасно оплачивать вызовы x402 и переводы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: nirholas
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nirholas/onchain-agent-wallets
- Обновлён: 2026-10-10
- HTML: https://affpapa.org/nevibecode/mcp/onchain-agent-wallets

## Что делает

Сервер разворачивает хранилище токенов, которым владеет пользователь, и оформляет для агента делегирование через стандартную программу SPL Token. Агент получает собственную ключевую пару только с небольшим запасом SOL для комиссий, а расходовать токены может строго в пределах заданного потолка. Если ключ агента скомпрометирован, потери ограничены остатком лимита, а отзыв прав выполняется одной транзакцией.

Перед отправкой транзакции инструмент проверяет локальные правила: лимит на одну операцию, суточный лимит, списки разрешённых адресов получателей и хостов для протокола x402. Любые действия по отзыву, созданию кошельков и выводу средств подписываются владельцем хранилища.

Без собственного RPC-узла Solana публичный эндпоинт быстро упирается в лимиты по запросам. Владельцу не обязательно сохранять свой закрытый ключ в переменную `OWNER_SECRET_KEY` — неподписанные транзакции можно подтверждать вручную через Phantom или другой внешний кошелёк.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `OWNER_SECRET_KEY`, `OAW_NETWORK`, `SOLANA_RPC_URL`, `OAW_STATE_DIR`, `REQUIRE_CONFIRM` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env OWNER_SECRET_KEY=<OWNER_SECRET_KEY> --env OAW_NETWORK=<OAW_NETWORK> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env OAW_STATE_DIR=<OAW_STATE_DIR> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> --transport stdio onchain-agent-wallets -- npx -y @three-ws/onchain-agent-wallets
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add onchain-agent-wallets --env OWNER_SECRET_KEY=<OWNER_SECRET_KEY> --env OAW_NETWORK=<OAW_NETWORK> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env OAW_STATE_DIR=<OAW_STATE_DIR> --env REQUIRE_CONFIRM=<REQUIRE_CONFIRM> -- npx -y @three-ws/onchain-agent-wallets
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "onchain-agent-wallets": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/onchain-agent-wallets"
            ],
            "env": {
                "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>",
                "OAW_NETWORK": "<OAW_NETWORK>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "OAW_STATE_DIR": "<OAW_STATE_DIR>",
                "REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "onchain-agent-wallets": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/onchain-agent-wallets"
            ],
            "env": {
                "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>",
                "OAW_NETWORK": "<OAW_NETWORK>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "OAW_STATE_DIR": "<OAW_STATE_DIR>",
                "REQUIRE_CONFIRM": "<REQUIRE_CONFIRM>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e OWNER_SECRET_KEY=<OWNER_SECRET_KEY> -e OAW_NETWORK=<OAW_NETWORK> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e OAW_STATE_DIR=<OAW_STATE_DIR> -e REQUIRE_CONFIRM=<REQUIRE_CONFIRM> onchain-agent-wallets npx -y @three-ws/onchain-agent-wallets
```
Вместо <…> подставьте свои значения

## Когда брать
- ограничить бюджет ИИ-агента в токенах Solana через ончейн-делегирование
- защитить основной кошелёк от утечки ключей при работе автономных скриптов
- оплачивать платные вызовы API по протоколу x402
- установить локальные суточные лимиты и списки разрешённых получателей
- отозвать права агента на расходование средств и вернуть баланс одной командой

## Примеры запросов агенту
- Создай кошелёк агента researcher с лимитом 100 USDC и суточным потолком 20 через инструмент `create_agent_wallet`.
- Проверь текущий остаток лимита и историю трат агента с помощью `agent_wallet_status`.
- Оплати доступ к API через вызов `pay_x402` для хоста `api.example.com`.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47577
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43902

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