mcpField
A
aomi-transact

aomi-transact

github.com/aomi-labs其他841 次安装6 天前更新
代码仓库

关于 aomi-transact

Aomi Transact 是用于通过 `aomi` TypeScript 命令行，以自然语言创建加密 Agent 和 Web3 助手的技能。它将钱包交易排队，经模拟后由用户明确签名，采用非托管流程。

主要功能

  1. 01自然语言加密请求
  2. 02查看交易队列
  3. 03批量分叉模拟
  4. 04明确签署钱包交易
  5. 05管理会话与链

适用场景

  1. 01查询加密资产价格、余额或路由
  2. 02签名前模拟多步交易
  3. 03构建并签署钱包请求
  4. 04管理命令行会话与区块链

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aomi-labs/skills --skill aomi-transact

安装后在 Claude Code 中输入/aomi-transact确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
README.md
SECURITY.md
.claude-plugin/
plugin.json
.codex-plugin/
plugin.json
agents/
openai.yaml
references/
account-abstraction.md
apps.md
commands.md
drain-vectors.md
examples.md
gotchas.md
session.md
troubleshooting.md
workflows.md
templates/
aomi-workflow.sh

详细介绍

Aomi Transact

概述

Aomi Transact 驱动 aomi TypeScript 命令行工具，用于构建自然语言加密 Agent 和 web3 助手。它会组合 calldata，将多个交易作为一个批次进行分叉模拟，并暂存钱包请求，供用户明确签名——全程非托管。当前链元数据包括 Ethereum、Polygon、Arbitrum、Base、Base Sepolia、Optimism、Sepolia、Linea、Linea Sepolia、Monad、Monad Testnet、Robinhood Chain、MegaETH 和本地 Anvil。npm 命令行工具是面向生产环境和最终用户的入口；product-mono 中的 Rust aomi-cli 是进程内开发/测试命令行工具，二者的命令接口不同——切勿混用。详细参考请参阅 commands.md、workflows.md、gotchas.md、account-abstraction.md、apps.md、examples.md、session.md、drain-vectors.md、troubleshooting.md。

先决条件

  • Node.js 18+，以及 npm 或 npx
  • @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 在目标链上必须持有原生 gas；本地签名仅支持 EOA，因此没有赞助回退方案

使用说明

  1. 检测命令行工具并检查其版本：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

examples.md 中提供了四个端到端操作示例（授权+兑换、借贷、跨链桥接、质押）。apps.md 中提供了各应用（Khalani、0x、Polymarket、Binance、Neynar）的首轮交互示例。

输出

  • aomi chat：Agent 回复或 ⚡ Wallet request queued: tx-N
  • aomi tx list：显示待处理/已签名交易 ID 及 batch_status 的表格
  • aomi tx simulate：逐步显示成功/失败、回退原因及 gas 用量
  • aomi tx sign：交易哈希和链上确认

错误处理

错误原因解决方案
insufficient funds for transfer签名 EOA 没有原生 Gas在目标链上为 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 设置为经过身份验证的端点
聊天后没有排入队列的 txAgent 先返回了报价运行 aomi tx list；发送确认回复
列表中有孤立的 tx-N上一次模拟失败仅签署 batch_status: passed 的 tx
Failed to get apps/models: HTTP 404公共后端未提供该 introspection 路由将 app list/model list 视为依赖后端的功能；不要因此阻断聊天/签名流程

完整的故障排除指南请参阅 troubleshooting.md。

安全性说明

此技能的 risk_tier: L2，因为它可以签署并广播链上交易。权限清单贯彻最小权限原则：

  • Shell 允许列表将执行范围限定为仅 aomi 和 npx @aomi-labs/client@latest——不允许任意子进程。
  • 网络允许列表将出站流量限制为 chat.aomi.dev（CLI 的默认后端；api.aomi.dev 是旧版主机）。用户提供的 --rpc-url 端点由 CLI 自行解析；操作者必须在允许签名前进行审核。
  • 文件范围仅对 ~/.aomi/ 具有读写权限；根据 OWASP AST03 缓解措施 #3，身份文件（SOUL.md、MEMORY.md、AGENTS.md）被列入禁止写入列表。
  • 不盲目签名。 多步骤流程会先通过分叉链上的 aomi tx simulate，再执行 aomi tx sign。在模拟时，如果排空向量 calldata 字段（recipient、onBehalfOf、mintRecipient、_to）不等于 msg.sender，则会被阻止——请参阅 drain-vectors.md。
  • 凭据保持不透明。 此技能绝不会伪造、推导或回显凭据值；只有当用户明确提出要求并在本轮提供该值时，才会运行设置命令。完整规则请参阅 gotchas.md → Hard Rules。

适用场景

  • 用户希望在终端中与 Aomi Agent 聊天。
  • 用户需要查询余额、价格、路由、报价或交易状态。
  • 用户希望构建、模拟、确认、签署或广播钱包请求。
  • 用户希望查看或切换应用、模型、链或会话。
  • 用户希望查看或更改账户抽象偏好（同步至后端通道）。
  • 用户希望使用 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。

资源

评论

支持 Markdown