20 CLI Commands for Complete Self-Hosted AI Wallet Management
Self-hosted AI wallet management requires a command-line interface that balances security with simplicity, and WAIaaS delivers exactly that with 20 CLI commands designed for complete wallet infrastructure control. When you're managing crypto wallets for AI agents on your own infrastructure, you need tools that respect your sovereignty while providing enterprise-grade functionality. The alternative—trusting third parties with your agents' private keys—compromises the very principles that make crypto valuable in the first place.
Why Self-Hosted Wallet Management Matters
Running your own wallet infrastructure isn't just about privacy—it's about control. Third-party wallet services can rate-limit your API calls, freeze accounts based on algorithmic decisions, or simply disappear overnight. When your AI agents need to execute hundreds of transactions per day across multiple DeFi protocols, these limitations become operational risks.
Self-hosted solutions also eliminate the custody problem entirely. Your private keys never leave your server, your transaction policies are enforced locally, and you decide which networks and protocols your agents can access. It's the difference between renting someone else's infrastructure and owning your own.
The WAIaaS CLI: 20 Commands for Complete Control
WAIaaS provides a comprehensive CLI that handles everything from initial setup to production wallet management. Let's walk through the key commands organized by use case.
Installation and Setup Commands
The foundation starts with getting WAIaaS running on your infrastructure:
npm install -g @waiaas/cli
waiaas init # Create data directory + config.toml
waiaas start # Start daemon (sets master password on first run)
waiaas status # Check daemon health
waiaas stop # Graceful shutdown
The init command creates your local data directory and configuration file, establishing the foundation for your self-hosted setup. The start command launches the daemon process that handles all wallet operations, while status and stop give you operational control.
For completely automated deployment, you can use auto-provisioning:
waiaas init --auto-provision # Generates random master password → recovery.key
waiaas start # No password prompt needed
Wallet Management Commands
Creating and managing wallets is where the CLI really shines:
waiaas wallet create --name "trading-bot" --chain solana --environment mainnet
waiaas wallet info <wallet-id> # Display wallet details and address
The wallet create command supports both EVM and Solana chains across 18 different networks. Each wallet gets a unique identifier and can be configured with specific policies and permissions.
Session and Authentication Commands
WAIaaS uses a three-tier authentication system, and the CLI manages all aspects:
waiaas session prompt <wallet-id> # Create session for AI agent
waiaas owner connect # Connect wallet owner for approvals
waiaas owner status # Check owner connection status
waiaas owner disconnect # Disconnect owner
waiaas set-master # Update master password
The session system is crucial for AI agent operations. Sessions provide scoped access tokens that agents can use without exposing master credentials. The owner commands handle the human-in-the-loop approval system for high-value transactions.
Backup and Recovery Commands
Self-hosted infrastructure requires robust backup strategies:
waiaas backup create --output backup-$(date +%Y%m%d).tar.gz
waiaas backup list # Show available backups
waiaas backup inspect backup.tar.gz # Verify backup contents
waiaas restore backup.tar.gz # Restore from backup
These commands handle complete system state including wallets, policies, transaction history, and configuration. The backup format is portable across different WAIaaS installations.
Quick Setup Commands
For rapid deployment, WAIaaS provides convenience commands:
waiaas quickstart # Interactive setup wizard
waiaas quickset --mode mainnet # Create wallets + MCP sessions in one step
The quickset command is particularly powerful—it creates both EVM and Solana wallets, generates session tokens, and outputs the complete MCP configuration for Claude Desktop integration.
Integration Commands
Modern AI workflows require seamless integration with AI frameworks:
waiaas mcp setup --all # Auto-register all wallets with Claude Desktop
waiaas notification setup # Configure push notifications
waiaas update # Update to latest version
The MCP setup command automatically configures Claude Desktop to use your self-hosted WAIaaS instance, eliminating manual JSON configuration.
Advanced CLI Features
Beyond the basic commands, the CLI provides sophisticated functionality for production deployments.
Docker Integration
While the CLI handles local development perfectly, production deployments often use Docker:
# The CLI works seamlessly with Docker deployments
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
# CLI can manage the containerized instance
waiaas status # Works with Docker deployment
waiaas backup create # Backs up containerized data
Policy Management via CLI
While policies can be managed through the REST API or admin UI, the CLI provides direct access for automation:
# Create spending limits via API using CLI-managed sessions
curl -X POST http://localhost:3100/v1/policies \
-H 'Content-Type: application/json' \
-H 'X-Master-Password: <from-cli-setup>' \
-d '{
"walletId": "<from-wallet-create>",
"type": "SPENDING_LIMIT",
"rules": {
"instant_max_usd": 10,
"notify_max_usd": 100,
"delay_max_usd": 1000,
"delay_seconds": 300
}
}'
Session Token Management
The CLI makes it easy to generate and manage session tokens for multiple AI agents:
# Create dedicated sessions for different agents
waiaas session prompt $(waiaas wallet info --json | jq -r '.id') --name "trading-agent"
waiaas session prompt $(waiaas wallet info --json | jq -r '.id') --name "defi-manager"
Each session can have different policies and permissions, allowing fine-grained access control.
Quick Start: Self-Hosted AI Wallet in 5 Steps
Here's how to get a complete self-hosted AI wallet infrastructure running:
Install and Initialize
npm install -g @waiaas/cli waiaas init --auto-provision waiaas startCreate Wallets and Sessions
waiaas quickset --mode mainnetSet Up AI Integration
waiaas mcp setup --allTest the Setup Open Claude Desktop and ask: "Check my wallet balance"
Configure Backups
waiaas backup create --output initial-backup.tar.gz
Your AI agents now have access to a fully self-hosted wallet infrastructure with 39 REST API endpoints, 45 MCP tools, and integration with 15 DeFi protocols.
Production Considerations
Self-hosting in production requires additional considerations:
Security Hardening
waiaas set-master # Replace auto-generated password
rm recovery.key # Remove auto-provision key after securing
waiaas backup create # Regular automated backups
Monitoring and Maintenance
waiaas status # Health checks
waiaas backup list # Verify backup schedule
waiaas update # Keep current with security updates
Network Configuration
The default binding is 127.0.0.1:3100 for security. Production deployments should use reverse proxies and proper TLS termination.
What's Next
The CLI provides the foundation, but WAIaaS offers much more for self-hosters: Docker deployment with automatic updates, comprehensive backup systems, and integration with 15 DeFi protocols. Your self-hosted infrastructure can scale from simple token transfers to complex multi-protocol trading strategies.
Ready to take control of your AI agent's financial infrastructure? Clone the repository at https://github.com/minhoyoo-iotrust/WAIaaS and start with waiaas init. For complete documentation and deployment guides, visit https://waiaas.ai.