azeth_create_account
Give an AI agent or service an on-chain smart account with guardian spending limits and ERC-8004 trust registry registration, all in one atomic transaction.
Instructions
Deploy a new Azeth smart account with guardian guardrails and register it on the ERC-8004 trust registry.
Use this when: An AI agent or service needs its own on-chain identity with spending limits and trust registry presence. One EOA can own multiple smart accounts.
Single atomic transaction: deploys smart account proxy, installs all 4 modules (Guardian, TrustRegistry, PaymentAgreement, Reputation), registers on ERC-8004, and permanently revokes factory access.
Returns: The deployed smart account address, trust registry token ID, and transaction hash.
Gas: when the Azeth server relay is reachable, creation is sponsored (EIP-712 gasless relay — no ETH required, and testnet USDC is auto-dripped). When the relay is unreachable, creation FALLS BACK to a direct transaction paid by your EOA (requires ETH for gas). The response's "creationPath" field reports which path was used ("gasless-relay" or "direct").
Guardian: By default, the guardian is derived from AZETH_GUARDIAN_KEY env var. If not set, falls back to self-guardian (owner address). For production, always use a separate guardian key. Set AZETH_GUARDIAN_KEY in your .env file.
Example: { "name": "PriceFeedBot", "entityType": "service", "description": "Real-time crypto price data", "capabilities": ["price-feed", "market-data"] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Display name for this participant in the trust registry. | |
| chain | No | Target chain. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia", "ethereumSepolia", "ethereum" (and aliases like "base-sepolia", "eth-sepolia", "sepolia", "eth", "mainnet"). | |
| endpoint | No | Optional HTTP endpoint (http:// or https://) where this participant can be reached. | |
| guardian | No | Guardian address for co-signing operations that exceed spending limits. If omitted, derived from AZETH_GUARDIAN_KEY env var. If neither is set, defaults to the owner address (self-guardian, NOT recommended for production). | |
| entityType | Yes | Participant type: "agent" (AI agent), "service" (API/oracle), or "infrastructure" (bridge/relay). | |
| description | Yes | Human-readable description of what this participant does. | |
| capabilities | Yes | List of capabilities this participant offers (e.g., ["swap", "price-feed", "translation"]). | |
| maxTxAmountUSD | No | Max USD per transaction (default: $100 testnet, $50 mainnet). | |
| dailySpendLimitUSD | No | Max USD per day (default: $1000 testnet, $500 mainnet). | |
| emergencyWithdrawTo | No | Address where funds are sent during emergency withdrawal. Defaults to the owner EOA address (derived from AZETH_PRIVATE_KEY). Must be a trusted address you control — this is your recovery destination. |