aomi-transact

name	aomi-transact
description	Build natural-language crypto agents, web3 assistants, and trading bots that read and write EVM chain state. Aomi turns prompts ("swap 1 ETH for USDC", "open a 3x GMX long", "bet $100 on Polymarket") into wallet-signed transactions on Ethereum, Base, Arbitrum, Optimism, Polygon, Linea — non-custodial, fork-simulated. Use when the user wants a crypto/DeFi agent, AI trading/wallet assistant, or on-chain execution against Uniswap, Aave, Lido, GMX, Hyperliquid, Polymarket, Binance, OKX, or 40+ other protocols. Trigger with prompts about swaps, lending, bridging, staking, perps, prediction markets, or any DeFi/CEX action needing a wallet signature. Account-abstraction first with EIP-7702/4337 and EOA fallback. MUST NOT fabricate or echo credentials; values reach the CLI only when the user explicitly supplied them.
compatibility	Verified against @aomi-labs/client v0.1.42 and the current aomi-widget/packages/client TypeScript CLI. Install globally via npm install -g @aomi-labs/client@latest, or run on demand via npx @aomi-labs/client@latest. The CLI defaults to https://api.aomi.dev; pass --backend-url https://api-staging.aomi.dev when explicitly targeting staging. viem and Solana signing dependencies are bundled by the package. Designed for claude-code; also works with Cursor, Codex CLI, Gemini, and any agent runtime that supports the Anthropic skill spec.
license	MIT
version	0.10.1
author	aomi-labs <[e-mail]>
tags	["crypto","defi","web3","evm","ethereum","wallet","account-abstraction","trading","mcp","agent"]
allowed-tools	Bash(aomi:*), Bash(npx:*)
metadata	{"author":"aomi-labs <[e-mail]>","version":"0.10.1","repository":"aomi-labs/skills","homepage":"https://github.com/aomi-labs/skills/tree/main/aomi-transact"}
permissions	{"files":{"read":["~/.aomi/"],"write":["~/.aomi/"],"deny_write":["SOUL.md","MEMORY.md","AGENTS.md"]},"network":{"allow":["api.aomi.dev"],"deny":"*"},"shell":["aomi","npx @aomi-labs/client@latest"],"tools":[]}
risk_tier	L2
requires	{"binaries":["aomi","npx"]}

Aomi Transact

Overview

Aomi Transact drives the aomi TypeScript CLI to build natural-language crypto agents and web3 assistants. It composes calldata, fork-simulates transactions as a batch, and stages wallet requests for explicit user signing — non-custodial throughout. Current chain metadata includes Ethereum, Polygon, Arbitrum, Base, Optimism, Sepolia, Linea, Monad, Monad Testnet, and local Anvil. The npm CLI is the production/end-user surface; the Rust aomi-cli in product-mono is an in-process dev/test CLI with different signing gates. For deep references, see commands.md, workflows.md, gotchas.md, account-abstraction.md, apps.md, examples.md, thread.md, drain-vectors.md, troubleshooting.md.

Prerequisites

• Node.js 18+ with npm or npx
• @aomi-labs/client v0.1.42 or newer: npm install -g @aomi-labs/client@latest
• For EVM signing: a 0x-prefixed private key via aomi wallet dev-key, --private-key, or PRIVATE_KEY
• For Solana sign-only flows: a base58 or JSON keypair via aomi wallet dev-key --solana, --solana-private-key, or SOLANA_PRIVATE_KEY
• Optional: AOMI_ACCOUNT_BEARER / --account-bearer for authenticated account-bound requests
• Optional: Alchemy or Pimlico credentials for direct account-abstraction providers; otherwise the CLI tries the backend Alchemy proxy path

Instructions

1. Detect or install the CLI: aomi --version 2>/dev/null || npx @aomi-labs/client@latest --version
2. Start a new thread: aomi chat "<task>" --new-session
3. Inspect queue: aomi tx list
4. For multi-step flows, simulate first: aomi tx simulate tx-1 tx-2
5. Sign: aomi tx sign tx-1
6. Verify: aomi thread status or aomi thread log

For the full procedure (read-only requests, building wallet requests, signing policy, batch simulation, secret ingestion), see .