Self-Hosting Wallet Infrastructure for AI Agents with WAIaaS and Docker

Self-Hosting a Crypto Wallet: Docker Setup Guide

WAIaaS (Wallet-as-a-Service for AI Agents) provides enterprise-grade wallet infrastructure that runs on private hardware to eliminate third-party custody risks. The system exposes 39 REST API endpoints and 45 MCP tools specifically designed for programmatic fund management by autonomous agents.

Why This Matters

Centralized crypto services and hosted APIs introduce single points of failure, such as rate limits that throttle trading algorithms or outages that prevent emergency liquidations during market volatility. By self-hosting wallet infrastructure, developers gain complete sovereignty over RPC endpoints and security policies, ensuring AI agents maintain reliable, low-latency access to DeFi protocols without vendor lock-in or mysterious third-party dependencies.

Key Insights

• WAIaaS supports 15 networks across Solana and EVM chain types, allowing for redundant RPC configuration to bypass public API rate limits.
• The policy engine includes 21 policy types and 4 security tiers, enabling granular control over automated transaction execution and spending limits.
• Security-hardened Docker deployments run as a non-root user (UID 1001) and support Docker Secrets for managing sensitive master passwords.
• Automated provisioning mode generates a cryptographically random recovery key stored at /data/recovery.key for unattended production setup.
• The platform includes 14 DeFi protocol integrations, facilitating programmatic swaps, lending, and prediction market interactions directly via API.

Working Examples

Standard deployment using Docker Compose

git clone https://github.com/minhoyoo-iotrust/WAIaaS.git
cd WAIaaS
docker compose up -d

Production-ready auto-provisioning setup

docker run -d \
--name waiaas \
-p 127.0.0.1:3100:3100 \
-v waiaas-data:/data \
-e WAIAAS_AUTO_PROVISION=true \
ghcr.io/minhoyoo-iotrust/waiaas:latest

MCP configuration for Claude Desktop integration

{
  "mcpServers": {
    "waiaas": {
      "command": "npx",
      "args": ["-y", "@waiaas/mcp"],
      "env": {
        "WAIAAS_BASE_URL": "http://127.0.0.1:3100",
        "WAIAAS_SESSION_TOKEN": "wai_sess_<your-token>",
        "WAIAAS_DATA_DIR": "~/.waiaas"
      }
    }
  }
}

Practical Applications

• Autonomous Trading Bots: Deploying WAIaaS locally allows trading bots to execute high-frequency swaps on Jupiter or Aave without risking API-based key exposure.
• Automated Policy Enforcement: Use the built-in policy engine to set hard caps on transaction volumes, preventing algorithmic errors from draining wallet balances.
• Custom RPC Management: Configure private RPC endpoints for Solana or Ethereum to ensure transaction inclusion during periods of high network congestion.
• AI Agent Tooling: Utilize the 45 MCP tools to give Claude or LangChain agents direct, secure access to blockchain state and transaction signing.

References:

• https://github.com/minhoyoo-iotrust/WAIaaS
• https://waiaas.ai
• https://dev.to/walletguy/self-hosting-a-crypto-wallet-docker-setup-guide-1a4i