AI agents can browse the web, write code, and analyze data, but most can't execute financial transactions on blockchains. WAIaaS solves this by providing 7 transaction types that let your AI agents handle everything from simple transfers to complex contract deployments through a secure, policy-controlled wallet API.
Why Transaction Types Matter for AI Agents
Building AI agents that can interact with decentralized finance requires more than just calling smart contracts. Your agent needs to handle token transfers, approve spending, batch multiple operations, and deploy new contracts—all while respecting security policies and owner oversight.
Traditional blockchain interactions require complex transaction construction, gas estimation, and signing workflows. WAIaaS abstracts this complexity into 7 standardized transaction types that work across both EVM chains and Solana, giving your AI agent a unified interface for all blockchain operations.
The 7 Transaction Types
WAIaaS supports 7 discriminated transaction types that cover every blockchain interaction your AI agent might need. Each type is validated through a 7-stage transaction pipeline with built-in policy enforcement and security controls.
1. Transfer - Native Token Transfers
The most basic transaction type sends native tokens (ETH, SOL) from your agent's wallet to any recipient.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "TRANSFER",
"to": "recipient-address",
"amount": "0.1"
}'
Your AI agent can use transfers for:
- Paying other agents or services
- Distributing rewards
- Moving funds between wallets
- Funding new accounts
2. TokenTransfer - ERC-20/SPL Token Transfers
TokenTransfer handles transfers of any token standard, automatically detecting whether you're on EVM (ERC-20) or Solana (SPL).
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "TOKEN_TRANSFER",
"to": "recipient-address",
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "100"
}'
Use cases include:
- Sending stablecoins for payments
- Distributing governance tokens
- Trading token pairs
- Liquidity provision rewards
3. ContractCall - Smart Contract Interactions
ContractCall lets your agent interact with any smart contract by specifying the method and parameters. WAIaaS handles encoding, gas estimation, and execution.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "CONTRACT_CALL",
"to": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"data": "0xa9059cbb000000000...",
"value": "0"
}'
Perfect for:
- DeFi protocol interactions
- NFT marketplace operations
- Governance voting
- Custom business logic
4. Approve - Token Spending Permissions
Approve transactions grant spending permissions to smart contracts, enabling your agent to interact with DeFi protocols that need to move tokens on its behalf.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "APPROVE",
"tokenAddress": "0xA0b86a33E6441d69BdC585C6ced5aFa36B8C1c4c",
"spender": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
"amount": "1000000000000000000"
}'
Essential for:
- DEX trading setup
- Lending protocol deposits
- Staking operations
- Cross-chain bridging
5. Batch - Multiple Operations in One Transaction
Batch transactions let your agent combine multiple operations into a single atomic transaction, either succeeding or failing together.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "BATCH",
"transactions": [
{
"type": "APPROVE",
"tokenAddress": "0x...",
"spender": "0x...",
"amount": "1000"
},
{
"type": "CONTRACT_CALL",
"to": "0x...",
"data": "0x..."
}
]
}'
Use batch for:
- Approve + swap in one transaction
- Multi-step DeFi strategies
- Portfolio rebalancing
- Complex arbitrage operations
6. NftTransfer - NFT Transfers
NftTransfer handles both ERC-721/ERC-1155 (Ethereum) and Metaplex (Solana) NFT transfers with automatic metadata caching.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "NFT_TRANSFER",
"to": "recipient-address",
"contractAddress": "0x...",
"tokenId": "1234"
}'
Perfect for:
- NFT marketplace operations
- Gaming asset transfers
- Collectible trading
- Reward distribution
7. ContractDeploy - Smart Contract Deployment
ContractDeploy lets your agent deploy new smart contracts, enabling dynamic contract creation based on real-time conditions.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "CONTRACT_DEPLOY",
"bytecode": "0x608060405234801561001057600080fd5b50...",
"constructorArgs": ["param1", "param2"]
}'
Enable your agent to:
- Deploy custom trading strategies
- Create new token contracts
- Launch prediction markets
- Build dynamic governance systems
Security Through Policy Engine
Every transaction type flows through WAIaaS's policy engine with 21 policy types and 4 security tiers. Your agent operates under INSTANT, NOTIFY, DELAY, or APPROVAL security levels based on transaction amount and type.
curl -X POST http://127.0.0.1:3100/v1/policies \
-H "Content-Type: application/json" \
-H "X-Master-Password: my-secret-password" \
-d '{
"walletId": "<wallet-uuid>",
"type": "SPENDING_LIMIT",
"rules": {
"instant_max_usd": 100,
"notify_max_usd": 500,
"delay_max_usd": 2000,
"delay_seconds": 900,
"daily_limit_usd": 5000
}
}'
The policy engine supports CONTRACT_WHITELIST and ALLOWED_TOKENS policies that follow default-deny enforcement—transactions are blocked unless explicitly permitted.
Dry-Run Simulation
Before executing any transaction type, your agent can simulate the operation to check for errors, estimate gas costs, and verify policy compliance.
curl -X POST http://127.0.0.1:3100/v1/transactions/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer wai_sess_<token>" \
-d '{
"type": "TRANSFER",
"to": "recipient-address",
"amount": "0.1",
"dryRun": true
}'
This prevents failed transactions and helps your agent make informed decisions about gas fees and timing.
Integration with AI Frameworks
WAIaaS provides 45 MCP tools that expose these transaction types to Claude Desktop, making blockchain operations available through natural language.
{
"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>"
}
}
}
}
Your Claude agent can now execute commands like "Swap 0.1 ETH for USDC" or "Deploy a new ERC-20 token with 1M supply," and WAIaaS automatically selects the appropriate transaction type.
Quick Start: Enable All 7 Transaction Types
- Install and initialize WAIaaS
npm install -g @waiaas/cli
waiaas init
waiaas start
- Create a wallet and session
waiaas quickset --mode mainnet
- Set up MCP integration
waiaas mcp setup --all
- Test transaction types via SDK
import { WAIaaSClient } from '@waiaas/sdk';
const client = new WAIaaSClient({
baseUrl: 'http://127.0.0.1:3100',
sessionToken: process.env.WAIAAS_SESSION_TOKEN,
});
// Your agent now has access to all 7 transaction types
const balance = await client.getBalance();
const tx = await client.sendToken({ to: '...', amount: '0.1' });
- Configure policies for your use case
# Example: Allow instant transactions up to $100
curl -X POST http://127.0.0.1:3100/v1/policies \
-H "Content-Type: application/json" \
-H "X-Master-Password: <password>" \
-d '{"walletId": "<uuid>", "type": "SPENDING_LIMIT", "rules": {"instant_max_usd": 100}}'
What's Next
These 7 transaction types give your AI agent complete blockchain functionality while maintaining security through policy enforcement and owner oversight. Start with simple transfers and token operations, then expand to complex batch transactions and contract deployments as your agent's capabilities grow.
Ready to give your AI agent a wallet? Check out the WAIaaS GitHub repository or visit waiaas.ai to get started with the complete self-hosted Wallet-as-a-Service platform.
