# Elytro

> Self-custodial Ethereum wallet for you & your AI agents

## What is Elytro?

Elytro is an EIP-4337 smart contract wallet designed for AI agents. It's Ethereum-only, CLI-first, agent-native, and fully self-custodial. One smart account, operated by humans, agents, or both.

## Key Features

- **EIP-4337 Account Abstraction**: Smart contract wallets with programmable policies
- **On-chain 2FA**: SecurityHook with signature/userop/both modes
- **Spending Limits**: USD/day limits enforced on-chain
- **Gasless Transactions**: Paymaster sponsors gas fees by default
- **Social Recovery**: Guardian-based recovery, no seed phrases
- **Multi-channel Access**: Use via CLI, Telegram, iMessage, WhatsApp
- **Batch Transactions**: Multiple calls in one UserOperation
- **macOS Keychain Vault**: Zero-config local security

## Supported Chains

- Ethereum mainnet (1)
- Optimism (10)
- Arbitrum (42161)
- Sepolia testnet (11155111)
- Optimism Sepolia (11155420)

## Installation

```bash
# Via npm (requires Node >=24)
npm install -g @elytro/cli

# Via ClawHub/OpenClaw
run clawhub install elytro
```

## Quick Start

```bash
elytro init                                      # Initialize wallet
elytro account create --chain 1 --alias myWallet # Create account
elytro account activate myWallet                 # Deploy on-chain
elytro query balance myWallet                    # Check balance
elytro tx send --tx "to:0x...,value:0.1"        # Send ETH
```

## CLI Commands

### Account Management
- `elytro init` - Initialize wallet (first-time setup)
- `elytro account create --chain <id> --alias <name>` - Create smart account
- `elytro account list` - List all accounts
- `elytro account info <account>` - Get account details
- `elytro account switch <account>` - Switch active account
- `elytro account activate <account>` - Deploy contract on-chain

### Queries
- `elytro query balance <account>` - ETH balance
- `elytro query balance <account> --token <addr>` - ERC-20 balance
- `elytro query tokens <account>` - All token holdings
- `elytro query tx <hash>` - Transaction status

### Transactions
- `elytro tx send --tx "to:addr,value:eth,data:hex"` - Send transaction
- `elytro tx simulate --tx "..."` - Dry-run (recommended before send)
- `elytro tx build --tx "..."` - Build unsigned UserOp

### Security
- `elytro security status` - View security settings
- `elytro security 2fa install --capability <1|2|3>` - Enable on-chain 2FA
- `elytro security spending-limit <amount>` - Set daily limit (USD)
- `elytro security email bind <email>` - Bind email for OTP

## Agent Integration

Elytro is designed for AI agent workflows:

- **Telegram Bot**: Full Inline Button UI with menu navigation
- **OpenClaw/ClawHub**: Install as agent skill
- **Uniswap**: Token swaps via swap-planner skill
- **Deterministic Output**: JSON responses for programmatic parsing

## Important Rules for Agents

1. Always query balances - never guess (`elytro query balance`)
2. Sponsor covers gas only, NOT transaction value
3. Must activate account before sending transactions
4. Parse JSON output: `{ "success": true, "result": {...} }`
5. Fund CREATE2 address before activation

## Supported Agent Actions

- `get_balance` - Query ETH or ERC-20 balances (`elytro query balance`)
- `get_tokens` - List ERC-20 token holdings (`elytro query tokens`)
- `get_tx_status` - Fetch transaction details by hash (`elytro query tx`)
- `simulate_transaction` - Dry-run transaction before submit (`elytro tx simulate`)
- `send_transaction` - Submit signed transaction/UserOperation (`elytro tx send`)
- `build_userop` - Build unsigned UserOperation payload (`elytro tx build`)
- `query_security_status` - Read current 2FA/limit settings (`elytro security status`)
- `enable_2fa` - Install SecurityHook 2FA (`elytro security 2fa install`)
- `set_spending_limit` - Configure on-chain USD/day limit (`elytro security spending-limit`)

## Typical Agent Tasks

- Initialize wallet and create account aliases for operators
- Check balances before transfers and contract calls
- Simulate then send ETH transfers or contract interactions
- Monitor transaction status and report deterministic JSON results
- Configure account security controls (2FA, email binding, spending limits)

## System Classification

- Type: smart-contract wallet
- Standard: EIP-4337 account abstraction
- Security model: self-custodial smart account with on-chain policy controls

## Links

- Website: https://elytro.com
- GitHub: https://github.com/Elytro-eth
- Chrome Extension: https://chromewebstore.google.com/detail/elytro/alkpdbodocedcmhgmhkebanomfeenoik
- ClawHub Skills:
  - https://clawhub.ai/walkjoi/elytro-wallet-cli-skill
  - https://clawhub.ai/CodeExplorer29/elytro-cli
  - https://clawhub.ai/jayden-sudo/elytro

## Contact

- Twitter: @elytro_eth
- Website: https://elytro.com