loading…
Search for a command to run...
loading…
Self-hosted wallet-as-a-service for AI agents. 60 tools for multi-chain crypto: transfers, DeFi (swap, lend, stake, bridge, perp, yield), NFTs, smart contracts,
Self-hosted wallet-as-a-service for AI agents. 60 tools for multi-chain crypto: transfers, DeFi (swap, lend, stake, bridge, perp, yield), NFTs, smart contracts, transaction signing, and x402 payments. Solana + EVM with session auth and spending policies.
Wallet-as-a-Service for AI Agents
npm downloads License: MIT Node.js Tests MCP Server
A self-hosted wallet daemon that lets AI agents perform on-chain transactions securely -- while the owner keeps full control of funds.
AI agents that need to transact on-chain face an impossible choice: hold private keys (and risk total loss if compromised) or depend on a centralized custodian (single point of failure, trust dependency).
WAIaaS bridges the gap -- agents handle small transactions instantly, large amounts require owner approval, and everything runs on your machine with no third-party dependency.
WAIaaS is a local daemon that sits between your AI agent and the blockchain:
See Security Model for full details.
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 packages in a monorepo:
.skill.md instruction files for AI agentsSee Architecture for the full technical deep-dive.
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
The quickset command does everything you need to get started:
We recommend configuring spending limits and registering an owner wallet for high-value transaction approval. For testing, use
waiaas quickset --mode testnetto create Solana Devnet + EVM Sepolia wallets instead.
After starting the daemon, manage everything from the admin panel at http://127.0.0.1:3100/admin (masterAuth required).
After quickset, choose one of two integration paths:
For AI agents that support the 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
The daemon runs as an MCP server. Your agent calls wallet tools directly -- send tokens, check balances, manage policies -- all through the MCP protocol.
For agents that don't support MCP, or when you prefer REST API integration:
npx @waiaas/skills add all
This adds .skill.md instruction files to your project. Include them in your agent's context and it learns the WAIaaS API automatically. Available skills: setup, quickstart, wallet, transactions, policies, admin, actions, x402.
AI agents can set up WAIaaS fully autonomously with no human interaction:
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
The --auto-provision flag generates a cryptographically random master password and saves it to ~/.waiaas/recovery.key. All subsequent CLI commands read it automatically. See the Agent Self-Setup Guide for the complete flow.
For manual setup with human-guided password entry, install skills and follow waiaas-setup/SKILL.md:
npx @waiaas/skills add all
git clone https://github.com/minho-yoo/waiaas.git && cd waiaas
docker compose up -d
The daemon listens on http://127.0.0.1:3100.
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}`);
Access the admin panel at http://127.0.0.1:3100/admin with your master password:
Features include settings search (Ctrl+K / Cmd+K) and unsaved changes protection.
Enabled by default (admin_ui = true in config.toml).
| Chain | Environment | Networks |
|---|---|---|
| Solana | mainnet | mainnet |
| Solana | testnet | devnet, testnet |
| EVM | mainnet | ethereum-mainnet, polygon-mainnet, arbitrum-mainnet, optimism-mainnet, base-mainnet |
| EVM | testnet | ethereum-sepolia, polygon-amoy, arbitrum-sepolia, optimism-sepolia, base-sepolia |
13 networks total (Solana 3 + EVM 10).
IChainAdapter| Document | Description |
|---|---|
| Architecture | System overview, package structure, pipeline, chain adapters |
| Security Model | Authentication, policy engine, Kill Switch, AutoStop |
| Deployment Guide | Docker, npm, configuration reference |
| API Reference | REST API endpoints and authentication |
| Agent Self-Setup Guide | Fully autonomous setup with auto-provision |
| Agent Skills Integration | Universal guide for 27+ AI agent platforms |
| Claude Code Integration | Skill files + MCP server setup for Claude Code |
| OpenClaw Integration | Quick setup for OpenClaw bot |
| Wallet SDK Integration | Integration guide for wallet developers |
| Why WAIaaS? | Background on AI agent wallet security |
| Contributing | Development setup, code style, testing, PR guidelines |
MIT -- Copyright (c) 2026 WAIaaS Contributors
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"minhoyoo-iotrust-waiaas": {
"command": "npx",
"args": []
}
}
}