aomi-transact

Aomi Transact

概要

Aomi Transact は aomi TypeScript CLI を使用して、自然言語で操作できる暗号資産エージェントと web3 アシスタントを構築します。calldata を組み立て、トランザクションをバッチとしてフォーク環境でシミュレーションし、ユーザーが明示的に署名するためのウォレットリクエストを準備します。全工程を通じて非カストディアルです。現在のチェーンメタデータには Ethereum、Polygon、Arbitrum、Base、Base Sepolia、Optimism、Sepolia、Linea、Linea Sepolia、Monad、Monad Testnet、Robinhood Chain、MegaETH、ローカルの Anvil が含まれます。npm CLI は本番環境およびエンドユーザー向けのインターフェースです。一方、product-mono にある Rust 製の aomi-cli はプロセス内で実行する開発・テスト用 CLI で、コマンドのインターフェースが異なります。この 2 つを混同しないでください。詳細については、commands.md、workflows.md、gotchas.md、account-abstraction.md、apps.md、examples.md、session.md、drain-vectors.md、troubleshooting.md を参照してください。

前提条件

• npm または npx を利用できる Node.js 18 以降
• @aomi-labs/client v0.6.0 以降：npm install -g @aomi-labs/client@latest
• EVM 署名の場合：aomi wallet set、--private-key、または PRIVATE_KEY で指定する、0x で始まる秘密鍵
• Solana の署名のみのフローの場合：aomi wallet set --solana（クラスターも保存されます。--cluster で上書きできます）、--solana-private-key、または SOLANA_PRIVATE_KEY で指定する、base58 形式の鍵ペアまたは JSON 鍵ペア
• オプション：認証済みのアカウントに紐づくリクエストには AOMI_ACCOUNT_BEARER または --account-bearer
• 署名に使う EOA の送信先チェーン上のネイティブガス。ローカルでの署名は EOA のみのため、スポンサーによる代替手段はありません

手順

1. CLI を検出し、バージョンを確認します：aomi --version 2>/dev/null || npx @aomi-labs/client@latest --version。表示されたバージョンが 0.6.0 未満の場合は中止し、npm install -g @aomi-labs/client@latest を実行するようユーザーに伝えてください。または、代わりにすべてのコマンドの先頭に npx @aomi-labs/client@latest を付けてください。このスキルをインストールしても、すでにインストール済みのグローバル aomi はアップグレードされません。また、0.4 より前のインターフェースは異なります。
2. 新しいセッションを開始します：aomi chat "<task>" --new-session
3. キューを確認します：aomi tx list
4. 複数ステップのフローでは、まずシミュレーションします：aomi tx simulate tx-1 tx-2
5. 署名します：aomi tx sign tx-1
6. 確認します：aomi session status または aomi session log

詳細な手順（読み取り専用リクエスト、ウォレットリクエストの構築、署名ポリシー、バッチシミュレーション、シークレットの取り込み）については、workflows.md を参照してください。

例

aomi chat "what is the price of ETH?" --new-session
aomi chat "swap 1 ETH for USDC" --new-session --public-key 0xYourAddress --chain 1
aomi tx list && aomi tx simulate tx-1 tx-2 && aomi tx sign tx-1 tx-2
aomi chat "stake 0.5 ETH on Lido" --app lido --chain 1 --new-session

approve と swap、レンディング、ブリッジング、ステーキングの 4 つのエンドツーエンドの手順については、examples.md を参照してください。アプリごとの最初のターンの例（Khalani、0x、Polymarket、Binance、Neynar）については、apps.md を参照してください。

出力

• aomi chat：エージェントの応答、または ⚡ Wallet request queued: tx-N
• aomi tx list：batch_status を含む、保留中または署名済みの tx ID のテーブル
• aomi tx simulate：ステップごとの成功／失敗、リバート理由、ガス使用量
• aomi tx sign：トランザクションハッシュとオンチェーンでの確認

エラー処理

エラー	原因	解決策
insufficient funds for transfer	署名するEOAにネイティブガスがありません	宛先チェーンでEOAに資金を入れてください。ローカル署名にはスポンサー提供の手段がありません
AA execution now runs in the backend lane	tx sign でAAパスが選択されました	--aa／--aa-provider／--aa-mode を削除してください。フラグを渡していない場合は、AOMI_AA_PROVIDER／AOMI_AA_MODE の設定を解除してください
シミュレーションで stateful: false	バッチの順序が正しくありません	実行時の依存関係に合うようにtx idの順序を入れ替えてください
RPC 401／429	レート制限、またはキーがありません	認証済みエンドポイントを --rpc-url に設定してください
チャット後にtxがキューに追加されない	エージェントが先に見積もりを返しました	aomi tx list を実行し、確認の返信を送信してください
リストに孤立した tx-N がある	前回のシミュレーションに失敗しました	batch_status: passed のtxだけに署名してください
Failed to get apps/models: HTTP 404	パブリックバックエンドでは、そのイントロスペクション用ルートが公開されていません	app list／model list はバックエンドに依存するものとして扱い、チャットや署名のフローを妨げないでください

詳細なトラブルシューティングについては、troubleshooting.mdをご覧ください。

安全性の根拠

このスキルはオンチェーントランザクションに署名してブロードキャストできるため、risk_tier: L2 です。権限マニフェストでは、最小権限が適用されます。

• シェルの許可リストでは、実行対象を aomi と npx @aomi-labs/client@latest のみに限定し、任意のサブプロセスを禁止します。
• ネットワークの許可リストでは、送信先を chat.aomi.dev（CLIのデフォルトのバックエンド。api.aomi.dev は旧ホスト）に限定します。ユーザー指定の --rpc-url エンドポイントはCLI自体が解決します。署名を許可する前に、運用者が確認する必要があります。
• ファイルの範囲は ~/.aomi/ のみ読み書き可能です。OWASP AST03 対策 #3 に従い、IDファイル（SOUL.md、MEMORY.md、AGENTS.md）への書き込みは禁止されています。
• 内容を確認せずに署名することはありません。 複数ステップのフローでは、aomi tx sign の前にフォークしたチェーン上で aomi tx simulate を実行します。Drain-vectorのcalldataフィールド（recipient、onBehalfOf、mintRecipient、_to）が msg.sender と一致しない場合、シミュレーション時にブロックされます。drain-vectors.mdをご覧ください。
• 認証情報はそのまま扱います。 このスキルが認証情報の値を捏造、導出、または復唱することはありません。セットアップコマンドは、ユーザーが明示的に要求し、このターンで値を提供した場合にのみ実行します。詳細なルールについては、gotchas.md → Hard Rulesをご覧ください。

使用する場面

• ユーザーがターミナルからAomiエージェントとチャットしたい場合。
• ユーザーが残高、価格、ルート、見積もり、またはトランザクションのステータスを確認したい場合。
• ユーザーがウォレットリクエストを作成、シミュレート、確認、署名、またはブロードキャストしたい場合。
• ユーザーがアプリ、モデル、チェーン、またはセッションを調べたり切り替えたりしたい場合。
• ユーザーがアカウント抽象化の設定（バックエンドレーンに同期）を調べたり変更したりしたい場合。
• ユーザーが aomi account login でCLIアカウントを認証したい場合、aomi account whoami でアカウントを確認したい場合、または aomi account links でリンク済みウォレットやログイン方法を確認したい場合。
• ユーザーがAPI仕様またはSDKから新しいアプリを作成したい場合は、コンパニオンスキル aomi-build を使用してください。

コマンド一覧

aomi                                Interactive REPL
aomi --prompt "<message>"           Send one prompt and exit
aomi chat <message>                 Send a message
aomi tx list|simulate|sign
aomi session list|new|resume|delete|status|log|events|close
aomi model list|set|current
aomi app list|current
aomi chain list|set|current
aomi wallet set|current|whoami
aomi account login|whoami|logout|links|link|unlink|rename|update|delete|sessions|switch
aomi logout
aomi config set-backend|current
aomi secret list|clear|add

このCLIには aomi thread、aomi cron、aomi login、aomi wallet ls|dev-key|set-mode はありません。これらは別のRust製 aomi-cli に属します。aomi deploy は --help に記載されていますが、v0.4.2では実行できません（aomi-labs/aomi#467で修正対応中）。コマンド、フラグ、環境変数の詳細については、commands.mdをご覧ください。

リソース

• ソースリポジトリ：https://github.com/aomi-labs/skills/tree/main/aomi-transact
• npm パッケージ：https://www.npmjs.com/package/@aomi-labs/client
• 新しいプロトコル統合を追加するための関連スキル：aomi-build
• アカウント抽象化の詳細：references/account-abstraction.md
• ドレインベクターカタログ（セキュリティ）：references/drain-vectors.md
• トランザクションのエンドツーエンドの例：references/examples.md
• トラブルシューティングガイド：references/troubleshooting.md
• OWASP AST03（過剰な権限を持つスキル）の仕様：https://owasp.org/www-project-agentic-skills-top-10/ast03
• Anthropic のスキル仕様：https://docs.claude.com/en/docs/claude-code/skills