WAIaaS

Wallet-as-a-Service (Кошелек как услуга) для ИИ-агентов

👁 npm downloads
👁 License: MIT
👁 Node.js
👁 Tests
👁 MCP Server

Самохостируемый демон кошелька, который позволяет ИИ-агентам безопасно выполнять ончейн-транзакции, в то время как владелец сохраняет полный контроль над средствами.

Проблема

ИИ-агенты, которым необходимо совершать транзакции в блокчейне, сталкиваются с невозможным выбором: хранить приватные ключи (и рисковать полной потерей в случае компрометации) или зависеть от централизованного кастодиана (единая точка отказа, зависимость от доверия).

WAIaaS устраняет этот разрыв — агенты мгновенно обрабатывают небольшие транзакции, крупные суммы требуют одобрения владельца, и все работает на вашем компьютере без сторонних зависимостей.

Related MCP server: AgentWallet MCP Server

Как это работает

WAIaaS — это локальный демон, который находится между вашим ИИ-агентом и блокчейном:

• 3-уровневая аутентификация — Раздельные роли для оператора демона (masterAuth), владельца средств (ownerAuth) и ИИ-агента (sessionAuth)

• 4-уровневый движок политик — Транзакции автоматически классифицируются по стоимости в USD на уровни: INSTANT (мгновенно) / NOTIFY (уведомить) / DELAY (задержка) / APPROVAL (одобрение)

• 12 типов политик — Кумулятивные лимиты расходов, разрешенные списки токенов, белые списки контрактов, одобренные получатели и многое другое

• Глубокая эшелонированная защита — Аварийный выключатель (Kill Switch), движок AutoStop, аудит-логирование, уведомления по 4 каналам

Подробности см. в Модели безопасности.

Архитектура

graph LR
 subgraph Interfaces
 SDK["TypeScript SDK"]
 MCP["MCP Server"]
 CLI["CLI"]
 Admin["Admin UI"]
 Skills["Skill Files"]
 WalletSDK["Wallet SDK"]
 end

 subgraph Daemon
 API["API Layer<br>(Hono + Middleware)"]
 Services["Service Layer<br>(Policy, Notifications, Kill Switch)"]
 Pipeline["Transaction Pipeline<br>(6-stage + 8-state)"]
 Infra["Infrastructure<br>(SQLite, Keystore, Config)"]
 end

 subgraph Blockchain
 Solana["Solana"]
 EVM["EVM Chains"]
 end

 SDK & MCP & CLI & Admin & Skills & WalletSDK --> API
 API --> Services --> Pipeline --> Infra
 Infra --> Solana & EVM

12 пакетов в монорепозитории:

• @waiaas/core — Общие типы, Zod-схемы, перечисления и интерфейсы

• @waiaas/daemon — Самохостируемый демон кошелька (HTTP-сервер Hono)

• @waiaas/adapter-solana — Адаптер сети Solana (SPL / Token-2022)

• @waiaas/adapter-evm — Адаптер EVM-сетей (ERC-20 через viem)

• @waiaas/actions — Провайдеры DeFi-действий (Jupiter, 0x, LI.FI, Lido, Jito)

• @waiaas/sdk — Клиентская библиотека TypeScript

• @waiaas/mcp — Сервер Model Context Protocol для ИИ-агентов

• @waiaas/cli — Интерфейс командной строки

• @waiaas/admin — Веб-интерфейс администратора на базе Preact

• @waiaas/wallet-sdk — SDK для подписи транзакций для интеграции с кошельками

• @waiaas/push-relay — Сервер ретрансляции push-уведомлений (демон → Pushwoosh/FCM)

• @waiaas/skills — Готовые файлы инструкций .skill.md для ИИ-агентов

Полный технический разбор см. в разделе Архитектура.

Быстрый старт

npm install -g @waiaas/cli
waiaas init # Create data directory + config.toml
waiaas start # Start daemon (sets master password on first run)
waiaas quickset --mode mainnet # Create wallets + MCP sessions in one step

Команда quickset выполняет все необходимое для начала работы:

1. Автоматически создает кошельки Solana Mainnet + EVM Ethereum Mainnet

2. Выпускает MCP-токены сессии для каждого кошелька

3. Выводит фрагмент конфигурации Claude Desktop MCP — просто скопируйте и вставьте

Мы рекомендуем настроить лимиты расходов и зарегистрировать кошелек владельца для подтверждения транзакций с высокой стоимостью. Для тестирования используйте waiaas quickset --mode testnet для создания кошельков Solana Devnet + EVM Sepolia.

Панель администратора

После запуска демона управляйте всем из панели администратора по адресу http://127.0.0.1:3100/admin (требуется masterAuth).

Подключение вашего ИИ-агента

После быстрой настройки выберите один из двух путей интеграции:

Путь А: MCP (Claude Desktop / Claude Code)

Для ИИ-агентов, поддерживающих Model Context Protocol:

# quickset already printed the MCP config JSON -- paste it into
# ~/Library/Application Support/Claude/claude_desktop_config.json
# Or auto-register with all wallets:
waiaas mcp setup --all

Демон работает как MCP-сервер. Ваш агент вызывает инструменты кошелька напрямую — отправка токенов, проверка баланса, управление политиками — все через протокол MCP.

Путь Б: Файлы навыков (любой ИИ-агент)

Для агентов, которые не поддерживают MCP, или если вы предпочитаете интеграцию через REST API:

npx @waiaas/skills add all

Это добавляет файлы инструкций .skill.md в ваш проект. Включите их в контекст вашего агента, и он автоматически изучит API WAIaaS. Доступные навыки: setup, quickstart, wallet, transactions, policies, admin, actions, x402.

Самостоятельная настройка агента (Auto-Provision)

ИИ-агенты могут настроить WAIaaS полностью автономно без участия человека:

npm install -g @waiaas/cli
waiaas init --auto-provision # Generates random master password → recovery.key
waiaas start # No password prompt
waiaas quickset # Creates wallets + sessions automatically
waiaas set-master # (Later) Harden password, then delete recovery.key

Флаг --auto-provision генерирует криптографически случайный мастер-пароль и сохраняет его в ~/.waiaas/recovery.key. Все последующие команды CLI считывают его автоматически. Полный процесс см. в Руководстве по самостоятельной настройке агента.

Для ручной настройки с вводом пароля под руководством человека установите навыки и следуйте waiaas-setup/SKILL.md:

npx @waiaas/skills add all

Альтернатива: Docker

git clone https://github.com/minho-yoo/waiaas.git && cd waiaas
docker compose up -d

Демон прослушивает порт http://127.0.0.1:3100.

Использование SDK

import { WAIaaSClient } from '@waiaas/sdk';

const client = new WAIaaSClient({
 baseUrl: 'http://127.0.0.1:3100',
 sessionToken: process.env.WAIAAS_SESSION_TOKEN,
});

const balance = await client.getBalance();
console.log(`Balance: ${balance.balance} ${balance.symbol}`);

const tx = await client.sendToken({
 to: 'recipient-address...',
 amount: '0.1',
});
console.log(`Transaction: ${tx.id}`);

Панель администратора

Получите доступ к панели администратора по адресу http://127.0.0.1:3100/admin с помощью вашего мастер-пароля:

• Дашборд — Обзор системы, балансы кошельков, последние транзакции

• Кошельки — Создание, управление и мониторинг кошельков в разных сетях; RPC-эндпоинты, мониторинг баланса и настройки WalletConnect

• Сессии — Выпуск и отзыв токенов сессии агента; настройки времени жизни сессии и лимитов запросов

• Политики — Настройка 12 типов политик с помощью визуальных редакторов форм; настройки запрета по умолчанию и уровней

• Уведомления — Статус каналов и логи доставки; настройки Telegram, Discord и Slack

• Безопасность — Аварийные элементы управления Kill Switch, правила защиты AutoStop, ротация JWT

• Система — API-ключи, валюта отображения, ценовой оракул, лимиты запросов, уровень логирования и выключение демона

Функции включают поиск по настройкам (Ctrl+K / Cmd+K) и защиту от несохраненных изменений.

Включено по умолчанию (admin_ui = true в config.toml).

Поддерживаемые сети

Всего 13 сетей (Solana 3 + EVM 10).

Функции

• Самохостируемый локальный демон — Нет центрального сервера; ключи никогда не покидают ваш компьютер

• Мультичейн — Solana (SPL / Token-2022) и EVM (ERC-20) через IChainAdapter

• Токены, контракты и DeFi — Нативные переводы, переводы токенов, вызовы контрактов, одобрения, пакетные транзакции, плагины Action Provider (Jupiter Swap и др.)

• Оценка политики в USD — Ценовые оракулы (CoinGecko / Pyth / Chainlink) оценивают все транзакции в USD

• Платежи x402 — Автоматическая обработка платежей HTTP 402 с подписями EIP-3009

• Множество интерфейсов — REST API, TypeScript SDK, Python SDK, MCP-сервер, CLI, веб-интерфейс администратора, Tauri Desktop, Telegram-бот

• Файлы навыков — Готовые файлы инструкций, которые обучают ИИ-агентов использованию API

Документация

Лицензия

MIT — Авторское право (c) 2026 Участники WAIaaS

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• approve_tokenB
• build_useropA
• call_contractA
• connect_infoA
• encode_calldataA
• erc8004_get_agent_infoA
• erc8004_get_reputationB
• erc8004_get_validation_statusC