Waiaas

WAIaaS

面向 AI Agent 的钱包即服务

一个可自托管的钱包守护进程，让 AI Agent 能够安全地执行链上交易，同时由所有者完全掌控资金。

问题

需要进行链上交易的 AI Agent 面临着一个两难选择：持有私钥（遭到入侵时可能导致全部资金损失），或依赖中心化托管方（存在单点故障和信任依赖）。

WAIaaS 弥合了这一差距——Agent 可即时处理小额交易，大额交易则需要所有者批准，且所有操作都在你的机器上运行，不依赖任何第三方。

工作原理

WAIaaS 是一个位于 AI Agent 和区块链之间的本地守护进程：

• 3 级身份验证——为守护进程操作员（masterAuth）、资金所有者（ownerAuth）和 AI Agent（sessionAuth）设置不同角色
• 4 级策略引擎——根据 USD 金额自动将交易分类为 INSTANT / NOTIFY / DELAY / APPROVAL 等级
• 12 种策略类型——累计支出限额、代币允许列表、合约白名单、已批准的支出方等
• 纵深防御——紧急停止开关、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

Monorepo 中的 12 个包：

• @waiaas/core — 共享类型、Zod 模式、枚举和接口
• @waiaas/daemon — 可自托管的钱包守护进程（Hono HTTP 服务）
• @waiaas/adapter-solana — Solana 链适配器（SPL / Token-2022）
• @waiaas/adapter-evm — EVM 链适配器（通过 viem 支持 ERC-20）
• @waiaas/actions — DeFi Action Provider（Jupiter、0x、LI.FI、Lido、Jito）
• @waiaas/sdk — TypeScript 客户端库
• @waiaas/mcp — 面向 AI Agent 的 Model Context Protocol 服务
• @waiaas/cli — 命令行界面
• @waiaas/admin — 基于 Preact 的管理 Web UI
• @waiaas/wallet-sdk — 用于集成钱包应用的 Wallet Signing SDK
• @waiaas/push-relay — 推送中继服务（守护进程 → Pushwoosh/FCM 原生推送）
• @waiaas/skills — 为 AI Agent 预先编写的 .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）。

连接 AI Agent

完成 quickset 后，可选择以下两种集成方式之一：

方式 A：MCP（Claude Desktop / Claude Code）

适用于支持 Model Context Protocol 的 AI Agent：

# 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 服务运行。你的 Agent 可直接调用钱包工具——发送代币、查询余额、管理策略——所有操作均通过 MCP 协议完成。

路径 B：Skill 文件（任意 AI Agent）

对于不支持 MCP 的 Agent，或者你更倾向于使用 REST API 集成：

npx @waiaas/skills add all

这会将 .skill.md 指令文件添加到你的项目中。将它们纳入 Agent 的上下文，Agent 就会自动学习 WAIaaS API。可用的 Skill：setup、quickstart、wallet、transactions、policies、admin、actions、x402。

Agent 自主设置（自动配置）

AI Agent 无需人工交互即可全程自主设置 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 命令都会自动读取该密码。完整流程请参阅 Agent 自主设置指南。

如需在人工指导下手动输入密码进行设置，请安装 Skill 并按照 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 设置
• 会话 —— 签发和撤销 Agent 会话令牌；会话有效期和速率限制设置
• 策略 —— 使用可视化表单编辑器配置 12 种策略类型；默认拒绝和层级设置
• 通知 —— 渠道状态和投递日志；Telegram、Discord 和 Slack 设置
• 安全 —— Kill Switch 紧急控制、AutoStop 保护规则、JWT 轮换
• 系统 —— API 密钥、显示货币、价格预言机、速率限制、日志级别和守护进程关闭

功能包括设置搜索（Ctrl+K / Cmd+K）和未保存更改保护。

默认启用（在 config.toml 中设置 admin_ui = true）。

支持的网络

链	环境	网络
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 个）。

功能

• 可自托管的本地守护进程 —— 无中心服务器；密钥不会离开你的设备
• 多链 —— 通过 IChainAdapter 支持 Solana（SPL / Token-2022）和 EVM（ERC-20）
• 代币、合约和 DeFi —— 原生转账、代币转账、合约调用、授权、批量交易、Action Provider 插件（如 Jupiter Swap）
• USD 策略评估 —— 价格预言机（CoinGecko / Pyth / Chainlink）以 USD 评估所有交易
• x402 支付 —— 通过 EIP-3009 签名自动处理 HTTP 402 支付
• 多种接口 —— REST API、TypeScript SDK、Python SDK、MCP 服务、CLI、管理 Web UI、Tauri 桌面应用、Telegram Bot
• Skill 文件 —— 预构建的指令文件，帮助 AI Agent 学会使用 API

文档

文档	描述
架构	系统概述、软件包结构、管道、链适配器
安全模型	身份验证、策略引擎、Kill Switch、AutoStop
部署指南	Docker、npm、配置参考
API 参考	REST API 端点和身份验证
Agent 自助设置指南	通过自动配置实现完全自主设置
Agent Skills 集成	适用于 27+ 个 AI Agent 平台的通用指南
Claude Code 集成	Claude Code 的技能文件和 MCP 服务设置
OpenClaw 集成	OpenClaw 机器人快速设置
钱包 SDK 集成	面向钱包开发者的集成指南
为什么选择 WAIaaS？	AI Agent 钱包安全背景介绍
贡献指南	开发环境设置、代码风格、测试和 PR 指南

许可证

MIT -- 版权所有 (c) 2026 WAIaaS 贡献者