内容
# WAIaaS
**适用于 AI 代理的钱包即服务**
[](https://www.npmjs.com/package/@waiaas/core)
[](LICENSE)
[](https://nodejs.org/)
[](#)
[](https://glama.ai/mcp/servers/minhoyoo-iotrust/WAIaaS)
一个自我托管的钱包守护进程，允许 AI 代理安全地进行链上交易，同时所有者保留对资金的完全控制权。
## 问题
需要进行链上交易的 AI 代理面临着一个不可能的选择：持有私钥（并在私钥泄露时面临资金损失风险）或依赖中心化托管人（单点故障，信任依赖）。
WAIaaS 弥补了这一空白——代理即时处理小额交易，大额交易需要所有者批准，所有操作都在您的机器上运行，无需第三方依赖。
## 工作原理
WAIaaS 是一个本地守护进程，位于您的 AI 代理和区块链之间：
- **三层身份验证** -- 分别为守护进程操作员（masterAuth）、资金所有者（ownerAuth）和 AI 代理（sessionAuth）设置独立角色
- **四层策略引擎** -- 根据交易价值（美元）自动将交易分为 INSTANT / NOTIFY / DELAY / APPROVAL 四个层级
- **12 种策略类型** -- 累积消费限额、代币允许列表、合约白名单、批准消费等
- **深度防御** -- 终止开关、自动停止引擎、审计日志、四通道通知
详见 [安全模型](docs/security-model.md)。
## 架构
```mermaid
graph LR
subgraph 接口
SDK["TypeScript SDK"]
MCP["MCP 服务器"]
CLI["CLI"]
Admin["管理 UI"]
技能["技能文件"]
钱包 SDK["钱包 SDK"]
end
subgraph 守护进程
API["API 层<br>(Hono + 中间件)"]
服务["服务层<br>(策略、通知、终止开关)"]
管道["交易管道<br>(6 阶段 + 8 状态)"]
基础设施["基础设施<br>(SQLite、密钥库、配置)"]
end
subgraph 区块链
Solana["Solana"]
EVM["EVM 链"]
end
SDK & MCP & CLI & Admin & 技能 & 钱包 SDK --> API
API --> 服务 --> 管道 --> 基础设施
基础设施 --> Solana & EVM
```
**12 个软件包**在一个 monorepo 中：
- **@waiaas/core** — 共享类型、Zod 模式、枚举和接口
- **@waiaas/daemon** — 自托管钱包守护进程（Hono HTTP 服务器）
- **@waiaas/adapter-solana** — Solana 链适配器（SPL / Token-2022）
- **@waiaas/adapter-evm** — EVM 链适配器（ERC-20 via viem）
- **@waiaas/actions** — DeFi 操作提供程序（Jupiter, 0x, LI.FI, Lido, Jito）
- **@waiaas/sdk** — TypeScript 客户端库
- **@waiaas/mcp** — AI 代理的模型上下文协议服务器
- **@waiaas/cli** — 命令行界面
- **@waiaas/admin** — 基于 Preact 的管理 Web UI
- **@waiaas/wallet-sdk** — 钱包应用集成的钱包签名 SDK
- **@waiaas/push-relay** — 推送中继服务器（守护进程 → Pushwoosh/FCM 原生推送）
- **@waiaas/skills** — AI 代理的预构建 `.skill.md` 指令文件
详见 [架构](docs/architecture.md)。
## 快速入门
```bash
npm install -g @waiaas/cli
waiaas init # 创建数据目录 + config.toml
waiaas start # 启动守护进程（首次运行时设置主密码）
waiaas quickset --mode mainnet # 一步创建钱包 + MCP 会话
```
`quickset` 命令为您完成启动所需的一切：
1. 自动创建 **Solana 主网 + EVM 以太坊主网** 钱包
2. 为每个钱包颁发 **MCP 会话令牌**
3. 输出 **Claude Desktop MCP 配置** 代码段 - 只需复制并粘贴
> 我们建议配置消费限额并注册所有者钱包以批准高价值交易。对于测试，请使用 `waiaas quickset --mode testnet` 创建 Solana Devnet + EVM Sepolia 钱包。
### 管理 UI
启动守护进程后，在 `http://127.0.0.1:3100/admin` 管理面板（需要 masterAuth）。
## 连接您的 AI 代理
快速设置完成后，选择以下两种集成路径之一：
### 路径 A：MCP（Claude Desktop / Claude Code）
对于支持 [模型上下文协议](https://modelcontextprotocol.io) 的 AI 代理：
```bash
# quickset 已经打印了 MCP 配置 JSON - 将其粘贴到
# ~/Library/Application Support/Claude/claude_desktop_config.json
# 或自动注册所有钱包：
waiaas mcp setup --all
```
守护进程作为 MCP 服务器运行。您的代理直接调用钱包工具 - 发送代币、检查余额、管理策略 - 所有操作都通过 MCP 协议。
### 路径 B：技能文件（任何 AI 代理）
对于不支持 MCP 的代理，或您更喜欢 REST API 集成：
```bash
npx @waiaas/skills add all
```
这将 `.skill.md` 指令文件添加到您的项目中。将其包含在代理的上下文中，代理将自动学习 WAIaaS API。可用技能：`setup`、`quickstart`、`wallet`、`transactions`、`policies`、`admin`、`actions`、`x402`。
### 代理自我设置（自动配置）
AI 代理可以在无需人工干预的情况下完全自主地设置 WAIaaS：
```bash
npm install -g @waiaas/cli
waiaas init --auto-provision # 生成随机主密码 → recovery.key
waiaas start # 无密码提示
waiaas quickset # 自动创建钱包 + 会话
waiaas set-master # （稍后）加固密码，然后删除 recovery.key
```
`--auto-provision` 标志生成一个加密随机的主密码并保存到 `~/.waiaas/recovery.key`。所有后续 CLI 命令都会自动读取它。详见 [代理自我设置指南](docs/agent-guides/agent-self-setup.md)。
对于手动设置和人工引导密码输入，请安装技能并遵循 `waiaas-setup/SKILL.md`：
```bash
npx @waiaas/skills add all
```
## 替代方案：Docker
```bash
git clone https://github.com/minho-yoo/waiaas.git && cd waiaas
docker compose up -d
```
守护进程监听 `http://127.0.0.1:3100`。
## 使用 SDK
```typescript
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.symbol}`);
const tx = await client.sendToken({
to: 'recipient-address...',
amount: '0.1',
});
console.log(`交易：${tx.id}`);
```
## 管理 UI
使用主密码访问 `http://127.0.0.1:3100/admin` 管理面板：
- **仪表盘** -- 系统概览、钱包余额、近期交易
- **钱包** -- 创建、管理、监控跨链的钱包；RPC 端点、余额监控和 WalletConnect 设置
- **会话** -- 发布和撤销代理会话令牌；会话生命周期和速率限制设置
- **策略** -- 配置 12 种策略类型，带有可视化表单编辑器；默认拒绝和层级设置
- **通知** -- 通道状态和交付日志；Telegram、Discord 和 Slack 设置
- **安全** -- 终止开关紧急控制、自动停止保护规则、JWT 轮换
- **系统** -- API 密钥、显示货币、价格预言机、速率限制、日志级别和守护进程关闭
默认启用（`admin_ui = true` 在 config.toml 中）。
## 支持的网络
| 链 | 环境 | 网络 |
|-------|-------------|----------|
| Solana | 主网 | mainnet |
| Solana | 测试网 | devnet, testnet |
| EVM | 主网 | ethereum-mainnet, polygon-mainnet, arbitrum-mainnet, optimism-mainnet, base-mainnet |
| EVM | 测试网 | ethereum-sepolia, polygon-amoy, arbitrum-sepolia, optimism-sepolia, base-sepolia |
共 13 个网络（Solana 3 + EVM 10）。
## 功能
- **自我托管本地守护进程** -- 无中心服务器；密钥从未离开您的机器
- **多链** -- Solana（SPL / Token-2022）和 EVM（ERC-20）通过 `IChainAdapter`
- **代币、合约和 DeFi** -- 原生转账、代币转账、合约调用、批准、批量交易、操作提供程序插件（Jupiter Swap 等）
- **美元策略评估** -- 价格预言机（CoinGecko / Pyth / Chainlink）评估所有交易（美元）
- **x402 支付** -- 自动 HTTP 402 支付处理，带有 EIP-3009 签名
- **多个接口** -- REST API、TypeScript SDK、Python SDK、MCP 服务器、CLI、管理 Web UI、Tauri 桌面、Telegram 机器人
- **技能文件** -- 预构建的指令文件，教导 AI 代理如何使用 API
## 文档
| 文档 | 描述 |
|----------|-------------|
| [架构](docs/architecture.md) | 系统概述、软件包结构、管道、链适配器 |
| [安全模型](docs/security-model.md) | 身份验证、策略引擎、终止开关、自动停止 |
| [部署指南](docs/deployment.md) | Docker、npm、配置参考 |
| [API 参考](docs/api-reference.md) | REST API 端点和身份验证 |
| [代理自我设置指南](docs/agent-guides/agent-self-setup.md) | 完全自主设置，带有自动配置 |
| [代理技能集成](docs/agent-guides/agent-skills-integration.md) | 适用于 27+ AI 代理平台的通用指南 |
| [Claude Code 集成](docs/agent-guides/claude-code-integration.md) | 适用于 Claude Code 的技能文件 + MCP 服务器设置 |
| [OpenClaw 集成](docs/agent-guides/openclaw-integration.md) | OpenClaw 机器人的快速设置 |
| [钱包 SDK 集成](docs/wallet-sdk-integration.md) | 适用于钱包开发者的集成指南 |
| [为什么选择 WAIaaS？](docs/why-waiaas/) | AI 代理钱包安全的背景 |
| [贡献](CONTRIBUTING.md) | 开发设置、代码样式、测试、PR 指南 |
## 许可证
[MIT](LICENSE) -- 版权所有 (c) 2026 WAIaaS Contributors
