ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

agentic-awesome-skills 中的 aomi-transact:用自然语言驱动 EVM 链上交易的 DeFi Agent 技能实战指南

2026/9/21 19:04:56 拓冰建站 浏览量
agentic-awesome-skills 中的 aomi-transact:用自然语言驱动 EVM 链上交易的 DeFi Agent 技能实战指南 agentic-awesome-skills 中的 aomi-transact用自然语言驱动 EVM 链上交易的 DeFi Agent 技能实战指南【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills导读本文围绕开源仓库 agentic-awesome-skills 收录的aomi-transact技能SKILL.md展开讲解如何让 AI 代理把“把 1 ETH 换成 USDC”这类自然语言指令转化为经过分叉链模拟、排队等待钱包签名的链上交易。读完你将掌握 Aomi CLI 的四种典型工作流只读查询、单笔交易、多步批量、跨链桥接、强制模拟与显式签名两道安全门禁以及该技能在仓库目录与索引中的定位与使用边界。技能定位自然语言到钱包签名交易的翻译层aomi-transact是一个**高风险risk: critical**技能收录于本仓库的 plugins/agentic-awesome-skills-claude/skills/aomi-transact/SKILL.md同一份 canonical SKILL.md 也存在于 plugins/agentic-awesome-skills/skills/aomi-transact/SKILL.md 与 skills/aomi-transact/SKILL.md三处内容一致。它的职责是驱动 Aomi CLInpm 包aomi-labs/client完成一次典型的提示词 → 交易转换链路用户输入自然语言指令例如swap 1 ETH for USDC on Uniswap代理挑选正确的协议与合约将 approve swap 编排为一个交易批次batch在分叉链forked chain上逐笔模拟该批次返回一个已排队queued的钱包请求tx-N等待用户显式签名钱包只会看到已通过模拟的 calldata不会接触到未经验证的交易内容。从仓库的元数据可以看到该技能的完整画像在 data/catalog.json 中它被归类为category: ai-ml携带defi / wallet / account-abstraction / cli / eip-712 / onchain / agent / intent等标签以及一组触发词defi、wallet、eip-712、aomi、transact等便于代理在匹配用户意图时被自动唤起在 skills_index.json 中它还声明了插件支持矩阵codex: supported、claude: supported且setup 类型为 none无需额外安装配置即可被代理加载使用。Account-Abstraction 优先的 CLI 设计该 CLI 默认走账户抽象路径而非传统 EOA 直签默认通过零配置的 Alchemy 代理完成签名无需提供 provider 凭据以太坊主网使用EIP-7702L2 上使用ERC-4337每次aomi subcommand调用都是启动 → 运行 → 退出不存在常驻后台进程天然适合被代理以单条命令的方式驱动。这一设计同时决定了技能的使用方式代理每次只需执行一条 CLI 命令并在关键节点模拟后、签名前停下来与用户交互。何时启用该技能根据 SKILL.md 的When to Use This Skill清单以下场景应当唤起aomi-transact用户想从终端直接与 Aomi 代理对话用户需要余额、价格、路由、报价或交易状态用户需要构建、模拟、确认、签名或广播钱包请求用户希望在签名前模拟一批待处理交易用户需要查看或切换 app、模型、链或会话用户需要查看或修改账户抽象设置EIP-7702 / ERC-4337用户需要签署 EIP-712 类型化数据链下协议、intent 填充等。与之对应的典型场景是只读的价格/余额查询——这类操作不会排队任何钱包请求属于低风险使用方式适合作为首次体验入口。四条核心工作流实战SKILL.md 给出了四条代表性工作流从只读到跨链覆盖了该技能绝大多数使用形态。只读价格查询aomi --prompt what is the price of ETH? --new-session该命令返回报价不排队任何钱包请求。执行后可用aomi tx list确认没有待处理交易。这是验证代理连接是否正常、CLI 是否就绪的最安全方式。单笔交易Lido 质押aomi chat Stake 0.01 ETH with Lido to get stETH \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list该流程会在 Lido stETH 合约0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84上构造submit(address(0))调用value 0.01 ETH单笔交易、无需 approve。代理应在此处停下展示排队交易详情等待用户显式指令例如sign tx-1后才可进入签名环节。多步批量Uniswap V3 兑换aomi chat swap 1 USDC for WETH on Uniswap V3, send to my wallet \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list # tx-1 approve, tx-2 swap aomi tx simulate tx-1 tx-2 # 多步批量必做这是该技能的核心能力展示兑换被编排为两笔交易tx-1是 USDC 授权approvetx-2是 swap模拟器会在分叉链上按顺序逐笔执行因此 swap 步骤能看到 approve 带来的状态变更不能跳过模拟、不能单独签名第 2 步——若单独签名 swap它会因授权尚未生效而 revert模拟完成后代理必须停下来汇总整个批次等待用户点名两个 tx id的显式签名指令。跨链CCTP 从 Ethereum 桥接到 Baseaomi chat Bridge 50 USDC from Ethereum to Base via CCTP. Recipient is my wallet. \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list aomi tx simulate tx-1 tx-2同样在模拟后停下等待显式批准。SKILL.md 还给出了跨链时间预期签名后源链Ethereum上的销毁burn确认约在1–2 个区块内完成目标链Base上的铸造mint则需要等待 Circle 的链下证明attestation约13–19 分钟。这一时间差对用户预期管理很有价值。签名门禁代理必须遵守的两条红线该技能在文档开头用两段高优先级说明 **Authorized use only.**与 **Signing gate.**定义了不可逾越的安全规则未经用户显式请求不得签名aomi tx sign只有在用户明确要求且存在由aomi tx list排队的对应tx-N时才能运行签名命令不得出现在可复制的多命令块中代理在展示或执行命令时应止步于列出或模拟已排队交易随后汇总 tx id、链、金额、接收方、calldata 用途与模拟结果并向用户索要诸如sign tx-1的显式签名指令收到独立批准后才运行精确的签名命令。这一设计把构建/模拟与签名/广播彻底解耦确保任何自动化流程都无法在未经过户确认的情况下触碰链上资产。已知局限与边界SKILL.md 明确列出了 6 项使用限制理解它们对生产级使用至关重要CLI 版本要求需要aomi-labs/clientv0.1.30 或更新版本。更早的版本缺少--aa、--aa-provider、--aa-mode参数及模拟门禁。安装方式为npm install -g aomi-labs/client或按需执行npx aomi-labs/client0.1.30 ...。后端连接依赖CLI 与api.aomi.dev通信。无网络时仅本地只读命令aomi tx list、aomi session log可用。L2 上的 AA 赞助不保证v0.1.30 的零配置代理路径在 Base/Arbitrum/Optimism 上不能可靠赞助 gas。若 EOA 在目标链上原生 gas 为 0aomi tx sign会返回 viem 的insufficient funds for transfer。对策是向 EOA 转入少量原生 gas或配置真正的 BYOK自备密钥Alchemy/Pimlico 提供商并启用赞助策略。注意不要改用--eoa重试——该路径同样需要 gas。按会话注入凭据需要 provider token 的应用binance、polymarket、dune等必须由用户在自己的 shell 中配置或通过aomi secret add NAMEvalue添加。技能永远不会主动设置凭据。Drain 向量被门禁拦截代理会拒绝recipient/onBehalfOf/mintRecipient≠msg.sender的 calldata。这是安全特性而非缺陷——应把拦截结果如实呈现给用户而不是改写提示词绕开。网络/RPC 故障公共 RPC 可能限流429或鉴权失败401。生产环境签名必须由用户提供与链匹配的可靠 RPC--rpc-url。报价与 deadline 过期带 deadline 的路由Across、Khalani filler 等在用户审核期间报价可能失效代理会通过重建新 deadline 自愈但用户仍应复查aomi tx list以确认最新通过的批次。最佳实践清单SKILL.md 归纳了 7 条最佳实践构成了该技能的安全操作公约新任务首条命令默认加--new-session。任务中途复用该参数会开启全新会话代理将丢失刚给出的报价上下文。签名前永远先aomi tx list绝不假设聊天响应已经排队了交易。多步批量签名前永远先aomi tx simulate tx-1 tx-2 ...单笔交易模拟可选但模拟永远不会是多余操作。签名命令不进入可执行示例aomi tx sign只允许在用户给出点名tx-N的独立显式批准后展示或执行。只签Batch [...] passed的交易跳过早期失败尝试留下的孤儿交易表现为failed at step N: 0x...。--rpc-url要与排队交易的链匹配而不是与会话链--chain匹配——两者是相互独立的控制项。绝不回显凭据值技能只通过 handle 名称或派生地址确认凭据配置完成。授权声明与风险边界SKILL.md 在 Authorization Disclaimer 中强调本技能能够签名并广播具有真实价值的链上交易只能用于自己拥有的账户和信任的网络。技能不托管资金——签名密钥始终由用户通过--public-key与底层钱包完全掌控。运行aomi tx sign之前必须逐一审核每个排队的tx-N。从仓库的索引体系看这一风险定位同样被显式记录在 data/catalog.json 与 skills_index.json 中aomi-transact的风险等级均为critical且其内容哈希与大小被登记在 data/aas-v1/skill-content-index.v1.json 的索引中供目录发现与完整性校验使用。在 AAS 仓库中的定位与延伸阅读aomi-transact是 AASagentic-awesome-skills技能库中链上交易类目的代表条目入口是 SKILL.md元数据分类、风险、标签、触发词、插件支持见 data/catalog.json 与 skills_index.json。该 SKILL.md 明确指出完整的技能包含account-abstraction.md、apps.md、examples.md、session.md、troubleshooting.md、drain-vectors.md等参考文档、aomi-workflow.sh模板以及按主机区分的agents/openai.yaml元数据位于上游aomi-labs/skills仓库本条目只是canonical SKILL.md。若需完整 bundle应克隆上游仓库本仓库收录的该技能同样遵循 MIT 许可。小结aomi-transact展示了一种意图 → 模拟 → 显式签名的安全交易代理模式代理负责协议选择、批量编排与分叉链模拟而签名权始终保留在用户手中。无论你是要接入 DeFi 价格查询、Lido 质押、Uniswap 兑换还是 CCTP 跨链桥接都可以把这份 SKILL.md 作为起点在理解其版本要求、模拟门禁与 gas 边界的前提下将其安全地嵌入 Claude Code、Cursor、Codex 或 Gemini 的代理工作流。【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考