WAIaaS

面向 AI 智能体的钱包即服务 (Wallet-as-a-Service)

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

一个自托管的钱包守护进程，让 AI 智能体能够安全地执行链上交易，同时所有者保留对资金的完全控制权。

问题所在

需要进行链上交易的 AI 智能体面临着两难选择：要么持有私钥（一旦泄露将面临全部损失），要么依赖中心化托管机构（存在单点故障和信任依赖）。

WAIaaS 弥补了这一差距——智能体可以即时处理小额交易，大额交易则需要所有者审批，且一切都在您的机器上运行，无需任何第三方依赖。

Related MCP server: AgentWallet MCP Server

工作原理

WAIaaS 是一个位于您的 AI 智能体与区块链之间的本地守护进程：

• 三层身份验证 —— 为守护进程操作员 (masterAuth)、资金所有者 (ownerAuth) 和 AI 智能体 (sessionAuth) 分离角色

• 四层策略引擎 —— 交易根据美元价值自动分类为：即时 (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 — 自托管钱包守护进程 (Hono HTTP 服务器)

• @waiaas/adapter-solana — Solana 链适配器 (SPL / Token-2022)

• @waiaas/adapter-evm — EVM 链适配器 (通过 viem 的 ERC-20)

• @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 指令文件

有关完整的技术深度解析，请参阅 架构。

快速入门

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 主网 + 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)

适用于支持 模型上下文协议 (Model Context Protocol) 的 AI 智能体：

# 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 协议完成。

路径 B：技能文件 (任何 AI 智能体)

适用于不支持 MCP 的智能体，或者当您更倾向于 REST API 集成时：

npx @waiaas/skills add all

这会将 .skill.md 指令文件添加到您的项目中。将其包含在智能体的上下文中，它就会自动学习 WAIaaS API。可用技能：setup, quickstart, wallet, transactions, policies, admin, actions, x402。

智能体自设置 (自动配置)

AI 智能体可以在无需人工干预的情况下完全自主地设置 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}`);

管理 UI

使用您的主密码访问 http://127.0.0.1:3100/admin 处的管理面板：

• 仪表板 —— 系统概览、钱包余额、近期交易

• 钱包 —— 创建、管理和监控跨链钱包；RPC 端点、余额监控和 WalletConnect 设置

• 会话 —— 颁发和撤销智能体会话令牌；会话生命周期和速率限制设置

• 策略 —— 使用可视化表单编辑器配置 12 种策略类型；默认拒绝和层级设置

• 通知 —— 通道状态和交付日志；Telegram、Discord 和 Slack 设置

• 安全 —— 终止开关紧急控制、AutoStop 保护规则、JWT 轮换

• 系统 —— API 密钥、显示货币、价格预言机、速率限制、日志级别和守护进程关闭

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

默认启用（配置中 admin_ui = true）。

支持的网络

共 13 个网络（Solana 3 + EVM 10）。

功能特性

• 自托管本地守护进程 —— 无中心服务器；私钥永远不会离开您的机器

• 多链支持 —— 通过 IChainAdapter 支持 Solana (SPL / Token-2022) 和 EVM (ERC-20)

• 代币、合约与 DeFi —— 原生转账、代币转账、合约调用、批准、批量交易、操作提供程序插件 (Jupiter Swap 等)

• 美元策略评估 —— 价格预言机 (CoinGecko / Pyth / Chainlink) 以美元评估所有交易

• x402 支付 —— 带有 EIP-3009 签名的自动 HTTP 402 支付处理

• 多种接口 —— REST API、TypeScript SDK、Python SDK、MCP 服务器、CLI、管理 Web UI、Tauri Desktop、Telegram Bot

• 技能文件 —— 预构建的指令文件，教导 AI 智能体如何使用 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