WAIaaS

Wallet-as-a-Service (Billetera como Servicio) para Agentes de IA

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

Un demonio de billetera autohospedado que permite a los agentes de IA realizar transacciones en cadena de forma segura, mientras el propietario mantiene el control total de los fondos.

El Problema

Los agentes de IA que necesitan realizar transacciones en cadena se enfrentan a una elección imposible: poseer claves privadas (y arriesgarse a una pérdida total si se ven comprometidas) o depender de un custodio centralizado (punto único de fallo, dependencia de confianza).

WAIaaS cierra esta brecha: los agentes manejan transacciones pequeñas al instante, las grandes cantidades requieren la aprobación del propietario, y todo se ejecuta en su máquina sin dependencia de terceros.

Related MCP server: AgentWallet MCP Server

Cómo funciona

WAIaaS es un demonio local que se sitúa entre su agente de IA y la cadena de bloques:

• Autenticación de 3 niveles -- Roles separados para el operador del demonio (masterAuth), el propietario de los fondos (ownerAuth) y el agente de IA (sessionAuth)

• Motor de políticas de 4 niveles -- Las transacciones se clasifican automáticamente por valor en USD en niveles INSTANT / NOTIFY / DELAY / APPROVAL

• 12 tipos de políticas -- Límites de gasto acumulativo, listas de permitidos de tokens, listas blancas de contratos, gastadores aprobados y más

• Defensa en profundidad -- Interruptor de emergencia (Kill Switch), motor de parada automática (AutoStop), registro de auditoría, notificaciones de 4 canales

Consulte el Modelo de Seguridad para obtener todos los detalles.

Arquitectura

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 paquetes en un monorepo:

• @waiaas/core — Tipos compartidos, esquemas Zod, enumeraciones e interfaces

• @waiaas/daemon — Demonio de billetera autohospedado (servidor HTTP Hono)

• @waiaas/adapter-solana — Adaptador de cadena Solana (SPL / Token-2022)

• @waiaas/adapter-evm — Adaptador de cadena EVM (ERC-20 vía viem)

• @waiaas/actions — Proveedores de acciones DeFi (Jupiter, 0x, LI.FI, Lido, Jito)

• @waiaas/sdk — Biblioteca cliente de TypeScript

• @waiaas/mcp — Servidor del Protocolo de Contexto de Modelo (MCP) para agentes de IA

• @waiaas/cli — Interfaz de línea de comandos

• @waiaas/admin — Interfaz de usuario web de administración basada en Preact

• @waiaas/wallet-sdk — SDK de firma de billetera para integración de aplicaciones de billetera

• @waiaas/push-relay — Servidor de retransmisión de notificaciones push (demonio → Pushwoosh/FCM push nativo)

• @waiaas/skills — Archivos de instrucciones .skill.md preconstruidos para agentes de IA

Consulte la Arquitectura para un análisis técnico profundo.

Inicio Rápido

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

El comando quickset hace todo lo necesario para comenzar:

1. Crea billeteras de Solana Mainnet + EVM Ethereum Mainnet automáticamente

2. Emite tokens de sesión MCP para cada billetera

3. Genera un fragmento de configuración MCP para Claude Desktop; solo copie y pegue

Recomendamos configurar límites de gasto y registrar una billetera de propietario para la aprobación de transacciones de alto valor. Para pruebas, use waiaas quickset --mode testnet para crear billeteras de Solana Devnet + EVM Sepolia en su lugar.

Interfaz de Administración (Admin UI)

Después de iniciar el demonio, gestione todo desde el panel de administración en http://127.0.0.1:3100/admin (se requiere masterAuth).

Conecte su Agente de IA

Después de la configuración rápida, elija una de las dos rutas de integración:

Ruta A: MCP (Claude Desktop / Claude Code)

Para agentes de IA que admiten el Protocolo de Contexto de Modelo:

# 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

El demonio se ejecuta como un servidor MCP. Su agente llama a las herramientas de billetera directamente: enviar tokens, verificar saldos, gestionar políticas, todo a través del protocolo MCP.

Ruta B: Archivos de Habilidades (Cualquier Agente de IA)

Para agentes que no admiten MCP, o cuando prefiere la integración mediante API REST:

npx @waiaas/skills add all

Esto añade archivos de instrucciones .skill.md a su proyecto. Inclúyalos en el contexto de su agente y este aprenderá la API de WAIaaS automáticamente. Habilidades disponibles: setup, quickstart, wallet, transactions, policies, admin, actions, x402.

Auto-configuración del Agente (Auto-Provision)

Los agentes de IA pueden configurar WAIaaS de forma totalmente autónoma sin interacción humana:

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

La bandera --auto-provision genera una contraseña maestra criptográficamente aleatoria y la guarda en ~/.waiaas/recovery.key. Todos los comandos CLI posteriores la leen automáticamente. Consulte la Guía de Auto-configuración del Agente para conocer el flujo completo.

Para una configuración manual con entrada de contraseña guiada por humanos, instale las habilidades y siga waiaas-setup/SKILL.md:

npx @waiaas/skills add all

Alternativa: Docker

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

El demonio escucha en http://127.0.0.1:3100.

Uso del 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}`);

Interfaz de Administración

Acceda al panel de administración en http://127.0.0.1:3100/admin con su contraseña maestra:

• Panel de control -- Resumen del sistema, saldos de billetera, transacciones recientes

• Billeteras -- Cree, gestione y monitoree billeteras en todas las cadenas; puntos finales RPC, monitoreo de saldo y configuraciones de WalletConnect

• Sesiones -- Emita y revoque tokens de sesión de agente; configuración de vida útil de la sesión y límites de tasa

• Políticas -- Configure 12 tipos de políticas con editores de formularios visuales; configuración de denegación predeterminada y niveles

• Notificaciones -- Estado del canal y registros de entrega; configuraciones de Telegram, Discord y Slack

• Seguridad -- Controles de emergencia del Interruptor de emergencia (Kill Switch), reglas de protección AutoStop, rotación de JWT

• Sistema -- Claves API, moneda de visualización, oráculo de precios, límites de tasa, nivel de registro y apagado del demonio

Las características incluyen búsqueda de configuraciones (Ctrl+K / Cmd+K) y protección contra cambios no guardados.

Habilitado por defecto (admin_ui = true en config.toml).

Redes Soportadas

13 redes en total (Solana 3 + EVM 10).

Características

• Demonio local autohospedado -- Sin servidor central; las claves nunca salen de su máquina

• Multicadena -- Solana (SPL / Token-2022) y EVM (ERC-20) a través de IChainAdapter

• Token, contrato y DeFi -- Transferencias nativas, transferencias de tokens, llamadas a contratos, aprobación, transacciones por lotes, complementos de Proveedor de Acciones (Jupiter Swap, etc.)

• Evaluación de políticas en USD -- Los oráculos de precios (CoinGecko / Pyth / Chainlink) evalúan todas las transacciones en USD

• Pagos x402 -- Manejo automático de pagos HTTP 402 con firmas EIP-3009

• Múltiples interfaces -- API REST, SDK de TypeScript, SDK de Python, servidor MCP, CLI, Interfaz Web de Administración, Tauri Desktop, Bot de Telegram

• Archivos de habilidades -- Archivos de instrucciones preconstruidos que enseñan a los agentes de IA cómo usar la API

Documentación

Licencia

MIT -- Copyright (c) 2026 Colaboradores de 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