WAIaaS

Wallet-as-a-Service für KI-Agenten

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

Ein selbstgehosteter Wallet-Daemon, der es KI-Agenten ermöglicht, On-Chain-Transaktionen sicher durchzuführen – während der Eigentümer die volle Kontrolle über die Gelder behält.

Das Problem

KI-Agenten, die On-Chain-Transaktionen durchführen müssen, stehen vor einer unmöglichen Wahl: Private Keys selbst halten (und bei einer Kompromittierung den Totalverlust riskieren) oder sich auf einen zentralen Verwahrer verlassen (Single Point of Failure, Abhängigkeit vom Vertrauen).

WAIaaS schließt diese Lücke – Agenten wickeln kleine Transaktionen sofort ab, für große Beträge ist die Genehmigung des Eigentümers erforderlich, und alles läuft auf Ihrer eigenen Maschine ohne Abhängigkeit von Dritten.

Related MCP server: AgentWallet MCP Server

Funktionsweise

WAIaaS ist ein lokaler Daemon, der zwischen Ihrem KI-Agenten und der Blockchain agiert:

• 3-stufige Authentifizierung – Getrennte Rollen für den Daemon-Betreiber (masterAuth), den Fondseigentümer (ownerAuth) und den KI-Agenten (sessionAuth)

• 4-stufige Policy-Engine – Transaktionen werden automatisch nach USD-Wert in die Stufen INSTANT / NOTIFY / DELAY / APPROVAL klassifiziert

• 12 Policy-Typen – Kumulative Ausgabenlimits, Token-Allowlists, Contract-Whitelists, zugelassene Empfänger und mehr

• Defense in Depth – Kill Switch, AutoStop-Engine, Audit-Logging, 4-Kanal-Benachrichtigungen

Siehe Security Model für vollständige Details.

Architektur

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 Pakete in einem Monorepo:

• @waiaas/core — Gemeinsame Typen, Zod-Schemas, Enums und Interfaces

• @waiaas/daemon — Selbstgehosteter Wallet-Daemon (Hono HTTP-Server)

• @waiaas/adapter-solana — Solana-Chain-Adapter (SPL / Token-2022)

• @waiaas/adapter-evm — EVM-Chain-Adapter (ERC-20 via viem)

• @waiaas/actions — DeFi Action Provider (Jupiter, 0x, LI.FI, Lido, Jito)

• @waiaas/sdk — TypeScript-Client-Bibliothek

• @waiaas/mcp — Model Context Protocol Server für KI-Agenten

• @waiaas/cli — Befehlszeilenschnittstelle

• @waiaas/admin — Preact-basiertes Admin-Web-UI

• @waiaas/wallet-sdk — Wallet-Signing-SDK für die Integration in Wallet-Apps

• @waiaas/push-relay — Push-Relay-Server (Daemon → Pushwoosh/FCM native Push)

• @waiaas/skills — Vorgefertigte .skill.md-Anweisungsdateien für KI-Agenten

Siehe Architecture für den vollständigen technischen Deep-Dive.

Quick Start

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

Der Befehl quickset erledigt alles, was Sie für den Start benötigen:

1. Erstellt automatisch Solana Mainnet + EVM Ethereum Mainnet Wallets

2. Stellt MCP-Session-Token für jedes Wallet aus

3. Gibt einen Claude Desktop MCP-Konfigurationsschnipsel aus – einfach kopieren und einfügen

Wir empfehlen, Ausgabenlimits zu konfigurieren und ein Eigentümer-Wallet für die Genehmigung von Transaktionen mit hohem Wert zu registrieren. Verwenden Sie zum Testen waiaas quickset --mode testnet, um stattdessen Solana Devnet + EVM Sepolia Wallets zu erstellen.

Admin-UI

Nach dem Start des Daemons können Sie alles über das Admin-Panel unter http://127.0.0.1:3100/admin verwalten (masterAuth erforderlich).

Verbinden Sie Ihren KI-Agenten

Wählen Sie nach dem Quickset einen von zwei Integrationswegen:

Weg A: MCP (Claude Desktop / Claude Code)

Für KI-Agenten, die das Model Context Protocol unterstützen:

# 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

Der Daemon läuft als MCP-Server. Ihr Agent ruft Wallet-Tools direkt auf – Token senden, Guthaben prüfen, Policies verwalten – alles über das MCP-Protokoll.

Weg B: Skill-Dateien (Jeder KI-Agent)

Für Agenten, die kein MCP unterstützen, oder wenn Sie eine REST-API-Integration bevorzugen:

npx @waiaas/skills add all

Dies fügt Ihrem Projekt .skill.md-Anweisungsdateien hinzu. Binden Sie diese in den Kontext Ihres Agenten ein, und er lernt die WAIaaS-API automatisch. Verfügbare Skills: setup, quickstart, wallet, transactions, policies, admin, actions, x402.

Agent Self-Setup (Auto-Provision)

KI-Agenten können WAIaaS vollständig autonom ohne menschliches Eingreifen einrichten:

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

Das Flag --auto-provision generiert ein kryptografisch sicheres Zufallspasswort und speichert es unter ~/.waiaas/recovery.key. Alle nachfolgenden CLI-Befehle lesen es automatisch. Siehe den Agent Self-Setup Guide für den vollständigen Ablauf.

Für die manuelle Einrichtung mit menschlich geführter Passworteingabe installieren Sie die Skills und folgen Sie waiaas-setup/SKILL.md:

npx @waiaas/skills add all

Alternative: Docker

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

Der Daemon lauscht auf http://127.0.0.1:3100.

Verwendung des 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}`);

Admin-UI

Greifen Sie mit Ihrem Master-Passwort auf das Admin-Panel unter http://127.0.0.1:3100/admin zu:

• Dashboard – Systemübersicht, Wallet-Guthaben, letzte Transaktionen

• Wallets – Erstellen, Verwalten und Überwachen von Wallets über Chains hinweg; RPC-Endpunkte, Guthabenüberwachung und WalletConnect-Einstellungen

• Sessions – Ausstellen und Widerrufen von Agent-Session-Token; Einstellungen für Session-Lebensdauer und Rate-Limits

• Policies – Konfiguration von 12 Policy-Typen mit visuellen Formular-Editoren; Standard-Ablehnungs- und Stufeneinstellungen

• Benachrichtigungen – Kanalstatus und Zustellungsprotokolle; Telegram-, Discord- und Slack-Einstellungen

• Sicherheit – Kill-Switch-Notfallsteuerungen, AutoStop-Schutzregeln, JWT-Rotation

• System – API-Schlüssel, Anzeige-Währung, Preis-Orakel, Rate-Limits, Log-Level und Daemon-Herunterfahren

Zu den Funktionen gehören die Einstellungssuche (Strg+K / Cmd+K) und Schutz vor nicht gespeicherten Änderungen.

Standardmäßig aktiviert (admin_ui = true in config.toml).

Unterstützte Netzwerke

Insgesamt 13 Netzwerke (Solana 3 + EVM 10).

Funktionen

• Selbstgehosteter lokaler Daemon – Kein zentraler Server; Keys verlassen niemals Ihre Maschine

• Multi-Chain – Solana (SPL / Token-2022) und EVM (ERC-20) via IChainAdapter

• Token, Contract und DeFi – Native Überweisungen, Token-Überweisungen, Contract-Aufrufe, Genehmigungen, Batch-Transaktionen, Action-Provider-Plugins (Jupiter Swap, etc.)

• USD-Policy-Evaluierung – Preis-Orakel (CoinGecko / Pyth / Chainlink) bewerten alle Transaktionen in USD

• x402-Zahlungen – Automatische HTTP-402-Zahlungsabwicklung mit EIP-3009-Signaturen

• Mehrere Schnittstellen – REST-API, TypeScript-SDK, Python-SDK, MCP-Server, CLI, Admin-Web-UI, Tauri-Desktop, Telegram-Bot

• Skill-Dateien – Vorgefertigte Anweisungsdateien, die KI-Agenten beibringen, wie die API verwendet wird

Dokumentation

Lizenz

MIT – Copyright (c) 2026 WAIaaS Contributors

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