Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/crypto/aomi/skills/transact

aomi-transact

Verified

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 aware with EIP-7702/4337 in the backend lane; local CLI signing is EOA. MUST NOT fabricate or echo credentials; values reach the CLI only when the user explicitly supplied them.

FileKindSize
SECURITY.mdmarkdown14.9 KB
SKILL.mdskill md10.1 KB
agents/openai.yamlconfig372 B
references/account-abstraction.mdmarkdown4.9 KB
references/apps.mdmarkdown15.9 KB
references/commands.mdmarkdown11.2 KB
references/drain-vectors.mdmarkdown4.7 KB
references/examples.mdmarkdown25.8 KB
references/gotchas.mdmarkdown6.7 KB
references/session.mdmarkdown6.4 KB
references/troubleshooting.mdmarkdown6.0 KB
references/workflows.mdmarkdown7.1 KB
templates/aomi-workflow.shexecutablescript8.1 KB

references/commands.md

View on GitHub
# Command Reference

Full command surface for the TypeScript `aomi` CLI (or `npx @aomi-labs/client@latest` equivalent), verified against `@aomi-labs/client` v0.4.2. The skill invokes read forms freely; `set`/mutating forms only when the user explicitly asks.

Top-level commands in v0.4.2: `chat`, `tx`, `session`, `model`, `app`, `chain`, `wallet`, `account`, `logout`, `config`, `secret`.

## Chat

```bash
aomi chat "<message>"                                  # one-shot send and exit
aomi --prompt "<message>"                              # root-level compatibility form
aomi                                                   # interactive REPL
aomi chat "<message>" --new-session
aomi chat "<message>" --verbose                        # stream tool calls and agent output
aomi chat "<message>" --model <rig>
aomi chat "<message>" --public-key 0xUserAddress --chain 1
aomi chat "<message>" --app khalani --chain 137
aomi chat "<message>" --account-bearer "$AOMI_ACCOUNT_BEARER"
```

- Quote the message.
- On the first command in a new assistant session, prefer `--new-session`.
- Pass `--public-key` on the first wallet-aware message.
- Use `--app`, `--model`, `--chain` to change the active context for the next request.

Running bare `aomi` starts the REPL, which has its own commands: `/heap` (help), `/app <name>`, `/model <rig>|list|show`, `/key <provider:key>|show|clear`, and `:exit`. The skill drives one-shot forms, not the REPL.

## Transactions

```bash
aomi tx list                                           # pending/signed requests
aomi tx simulate <id> [<id> ...] [--cluster devnet]     # dry-run a batch on a fork / cluster
aomi tx sign <id> [<id> ...] [--cluster devnet]         # sign and submit
```

Duplicate ids in one `aomi tx sign` call are rejected. When an id is ambiguous across chains, use the chain-qualified selector shown by `aomi tx list` — `evm:tx-1` or `svm:tx-1`.

`aomi tx sign` is **EOA-only** in v0.4.2 — see [account-abstraction.md](account-abstraction.md).

## Sessions

```bash
aomi session list                                      # local sessions with topic + pending count
aomi session new
aomi session resume <id>                               # set active pointer
aomi session delete <id>                               # remove (check no pending txs first)
aomi session status                                    # current session summary
aomi session log                                       # replay conversation + tool output
aomi session events                                    # raw backend system events
aomi session close                                     # clear active pointer; next chat starts fresh
```

Selectors accept the backend session id, `session-N`, or `N`.

## Secrets

```bash
aomi secret list                                       # handle names only, no values
aomi secret clear                                      # drop all configured secrets
aomi secret add NAME=<value> [NAME=...]                # user-directed only (see workflows.md)
```

## Apps and Models

```bash
aomi app list
aomi app current
aomi model list
aomi model current
aomi model set <rig>                                   # persist model for current session
```

`aomi chat --model <rig> "<message>"` applies a model for one turn without persisting it. Pick an app per turn with `--app <name>` or `AOMI_APP=<name>`. The installed set is dynamic — confirm with `aomi app list`. Full catalog and per-app credential requirements in [apps.md](apps.md).

## Chain

```bash
aomi chain list
aomi chain current
aomi chain set <id>                                    # only when user asked to change default
```

## Wallet

```bash
aomi wallet set <evm-hex-key>                          # user-directed EVM 0x key (default)
aomi wallet set --evm <evm-hex-key>                    # explicit EVM form
aomi wallet set --solana <base58-key>                  # user-directed Solana keypair
aomi wallet current                                    # configured wallet address
aomi wallet whoami                                     # authenticated backend account
```

`aomi wallet set` persists local signing material under `AOMI_STATE_DIR` (default `~/.aomi`). After running, confirm with the derived address or Solana public key — never repeat the key value back.

## Account

```bash
aomi account login                                     # browser auth, mint account bearer
aomi account login --provider privy                    # provider browser auth ("privy" or "para")
aomi account login --wallet                            # native CLI SIWE with configured EVM wallet
aomi account login --solana                            # native CLI SIWS with configured Solana wallet
aomi account login --no-browser                        # skip provider auth, use native SIWE
aomi account whoami                                    # inspect authenticated account
aomi account links                                     # login methods and linked wallets
aomi account link [--provider <p>] [--wallet] [--solana] [--label <text>]
aomi account unlink <id> [--yes]                       # id, identity:<id>, or wallet:<id>
aomi account rename <id> --label <text>
aomi account update [--display-name <name>] [--avatar-url <url>]
aomi account delete --yes
aomi account sessions                                  # local CLI sessions for account switching
aomi account switch <id>
aomi logout                                            # also available as `aomi account logout`
```

## Config

```bash
aomi config current                                    # backend URL
aomi config set-backend <url>                          # repoint CLI at a different backend
```

## Flags and Env Vars

Flags override environment variables.

| Flag            | Default                 | Purpose                                                   |
| --------------- | ----------------------- | --------------------------------------------------------- |
| `--backend-url` | `https://chat.aomi.dev` | Backend URL (`AOMI_BACKEND_URL`)                          |
| `--api-key`     | `AOMI_API_KEY`          | API key for non-default apps (user-supplied)              |
| `--account-bearer` | `AOMI_ACCOUNT_BEARER` | Account-bound auth bearer                                 |
| `--embedded-provider` | deprecated        | Legacy provider exchange; prefer `--account-bearer`       |
| `--embedded-provider-token` | deprecated  | Legacy provider token; prefer `--account-bearer`          |
| `--app`         | `default`               | Backend app (`AOMI_APP`)                                  |
| `--application-id` | `AOMI_APPLICATION_ID` | Concrete backend application id for dynamic apps         |
| `--model`       | backend default         | Session model (`AOMI_MODEL`)                              |
| `--new-session` | off                     | Create a fresh active session for this command            |
| `--public-key`  | `AOMI_PUBLIC_KEY`       | Wallet address for chat/session context                   |
| `--private-key` | `PRIVATE_KEY`           | EVM signing key for this invocation                       |
| `--solana-private-key` | `SOLANA_PRIVATE_KEY` | Solana signing key for this invocation                |
| `--rpc-url`     | chain RPC default       | RPC override for signing (`CHAIN_RPC_URL`)                |
| `--chain`       | `AOMI_CHAIN_ID`         | Active wallet chain (inherits session chain if unset)     |
| `--cluster`     | `AOMI_SOLANA_CLUSTER`   | Solana cluster (`mainnet-beta`, `devnet`, `testnet`, or CAIP-2) |
| `--payment-method` | `AOMI_PAYMENT_METHOD` | Paid chat rail, e.g. `coinbase`/`x402`                   |
| `--json`        | off                     | Machine-readable JSON where supported                     |
| `--verbose`     | off                     | Extra diagnostics; on `chat`, streams tool calls live     |
| `--eoa`         | the default             | Plain EOA execution (`tx sign`) — local signing is always EOA |
| `--aa`          | off                     | Errors: AA now runs in the backend lane (`tx sign`)       |
| `--aa-provider` | `AOMI_AA_PROVIDER`      | `alchemy` \| `pimlico` preference synced to `user_state`  |
| `--aa-mode`     | `AOMI_AA_MODE`          | `4337` \| `7702` preference synced to `user_state`        |

Root-only flags: `-p`/`--prompt` (send one prompt and exit), `--show-tool` (show tool output in root prompt/REPL mode), `--provider-key PROVIDER:KEY` (save a BYOK provider key before running).

| Env Var           | Default   | Purpose                                |
| ----------------- | --------- | -------------------------------------- |
| `AOMI_STATE_DIR`  | `~/.aomi` | Root directory for local session state |
| `AOMI_BACKEND_URL` | `https://chat.aomi.dev` | Backend URL |
| `AOMI_ACCOUNT_BEARER` | none | Account auth bearer minted by login or supplied by user |
| `AOMI_API_KEY` | none | API key for non-default apps |
| `AOMI_APP` / `AOMI_APPLICATION_ID` | `default` / none | Active app selection |
| `AOMI_MODEL` | backend default | Active model |
| `AOMI_PUBLIC_KEY` | none | Wallet address for chat context |
| `AOMI_CHAIN_ID` | none | Default active chain |
| `CHAIN_RPC_URL` | none | Signing RPC override |
| `PRIVATE_KEY` | none | EVM signing key |
| `SOLANA_PRIVATE_KEY` | none | Solana signing key |
| `AOMI_SOLANA_CLUSTER` | none | Default Solana cluster |
| `AOMI_PAYMENT_METHOD` | none | Paid chat rail |
| `AOMI_AA_PROVIDER` / `AOMI_AA_MODE` | none | AA preferences — **setting either makes `aomi tx sign` fail** (see below) |

## Config Rules

- EVM signing keys must be 0x-prefixed hex. Solana signing keys are base58 or JSON keypairs. Configuring either is a user action, not a skill action.
- `--aa-provider` and `--aa-mode` cannot be used with `--eoa`, and `--aa` cannot be combined with `--eoa`.
- Passing `--aa`, `--aa-provider`, or `--aa-mode` — or exporting `AOMI_AA_PROVIDER` / `AOMI_AA_MODE` — selects AA execution, which `aomi tx sign` rejects with `AA execution now runs in the backend lane (rolling out); use --eoa for local execution.` Unset those env vars before signing locally.
- `--public-key` must match the address derived from `--private-key` when both are given.
- The default signing RPC is one URL. For chain switching, pass `--rpc-url` on `aomi tx sign` with a chain-matching public RPC.
- Solana signing currently materializes legacy pending `solana_sign` requests with unsigned transactions; canonical instruction-only `svm_ixs` requests may not appear as CLI-signable pending txs yet.

For account-abstraction details (modes, providers, sponsorship, chain defaults), see [account-abstraction.md](account-abstraction.md).

## Not in v0.4.2

Removed or never shipped on this CLI — do not emit these:

- `aomi thread ...` → the group is `aomi session ...` (and was in v0.1.42 too); only the backend HTTP API uses `/api/thread/*`
- `aomi wallet ls` / `dev-key` / `set-mode` → `aomi wallet set` / `current` / `whoami`; there is no CLI signing-policy mutation command
- `aomi login` → `aomi account login` (bare `aomi logout` does still exist; on v0.1.x this lived at `aomi wallet login`)
- `aomi cron ls|show|cancel` → no cron surface on this CLI
- `aomi deploy` → advertised in `aomi --help` but not registered as a subcommand in v0.4.2; `aomi deploy` exits with `Unknown command deploy` (fix pending in aomi-labs/aomi#467)
- `AOMI_CONFIG_DIR` → not read; local state is rooted at `AOMI_STATE_DIR`
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall