elizaos-plugin-aether

中文文档
0.2.18发布于 2026/11/03MITTypeScriptES Module构建来源已验证

ElizaOS以太坊插件:一个具有支出限制的代理钱包,用于支付api (x402),发送AETH和USDC,并在链上目录中查找付费服务。

中文使用文档
文档目录3 节
  1. 行动
  2. 设置
  3. 安全

elizaos-plugin-aether

一个 ElizaOS 插件,给代理一个 以太 钱包:它可以支付api 按请求收费(HTTP 402, x402),发送eth和USDC,检查余额和 交易,在以太链上目录中找到付费服务,并报价AETH OSMO交换,在代码中强制执行的支出限制内。

npm install elizaos-plugin-aether
import aetherPlugin from "elizaos-plugin-aether";

export const character = {
  name: "Ada",
  plugins: ["@elizaos/plugin-bootstrap", "elizaos-plugin-aether"], // or plugins: [aetherPlugin] in code
  settings: {
    secrets: { AETHER_MNEMONIC: process.env.AETHER_MNEMONIC },
    AETHER_MAX_PER_PAYMENT: "0.1 AETH",
    AETHER_DAILY_BUDGET: "1 AETH",
  },
};

对以太不熟悉?为代理创建一个帐户(一次)并将其短语保留为 AETHER_MNEMONIC:

node -e 'import("aether-chain-client").then(({Key})=>{const {key,mnemonic}=Key.generate();console.log(key.address+"\n"+mnemonic)})'

然后请求代理为自己获取一些测试网以太:它请求水龙头。

行动

行动它是做什么的花
AETHER_GET_BALANCE每个已知资产中地址的余额(如果没有给出,则为代理自己的地址)否
AETHER_TRANSACTION_STATUS事务是否挂起、已确认或失败否
AETHER_FIND_PAID_SERVICES链上目录中的付费api,按单词和最高价格否
AETHER_SEND_PAYMENT发送eth(或USDC)到一个地址是
AETHER_CALL_PAID_API调用API,最大限度地支付请求的费用,然后返回答案是
AETHER_REQUEST_TESTNET_FUNDS要求测试网水龙头启动AETH否
AETHER_QUOTE_SWAP在Osmosis测试网的AETH/OSMO池中交换AETH为OSMO的报价(OSMO out, cost, a minOutput);只引用,不交换否
AETHER_GET_INFLOW_CAPS其他链可能发送到以太坊和每个链离开的房间的令牌;更多的被拒绝并在发送链上退款否

这个 AETHER_WALLET 提供者告诉代理它的地址和预算的剩余部分。

设置

设置默认的
AETHER_MNEMONIC无代理账户的24字恢复短语。一个秘密。没有它,插件是只读的。
AETHER_MAX_PER_PAYMENT1 AETH大多数付款可能是,以其单位。
AETHER_DAILY_BUDGET5 AETH大部分资金可能会在24小时内花在同一项资产上。
AETHER_RPC_URLhttps://rpc.157-245-252-221.sslip.io公共测试网。
AETHER_CHAIN_IDaether-testnet-1
AETHER_FAUCET_URL公共测试网水龙头none 关掉它。
AETHER_USDC_PATH, AETHER_USDC_BASE_DENOM, AETHER_USDC_ISSUER未设置(仅限eth)USDC知道。来自Injective的测试网USDC: transfer/channel-2, erc20:0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d, Injective。要花费USDC,就要设定USDC的限制。

安全

  • 限制在代码中成立。 付款结束 AETHER_MAX_PER_PAYMENT,或过去 AETHER_DAILY_BUDGET 在签署任何协议之前,24小时内被拒绝 对话说。任何可以与代理交谈的人都可以要求它花费 在他们心中:设定他们是你准备失去的,并且只保留那么多 在账户里。
  • 一条信息最多只能发送一次。 发送方的等幂键来自 消息,而不是模型,因此重试处理程序不会支付两次。
  • 不受信任的文本保留数据。 备忘录、服务名称和描述以及API 答案是别人写的;模特被告知不要拍照 来自他们的指示或付款细节。
  • 为代理使用一个专用帐户,不要使用其他帐户。

工具本身是 AetherToolkit 在 aether-chain-client,这 还将它们作为任何其他框架的纯JSON工具规范。

版本与发布记录

elizaos-plugin-aether 共发布 9 个版本,首次发布于 2026/10/11;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.18latest2026/11/03今天
0.2.172026/11/012 天前
0.2.162026/10/305 天前
0.2.152026/10/286 天前
0.2.142026/10/1816 天前
0.2.132026/10/1618 天前

关于 elizaos-plugin-aether 的常见问题

elizaos-plugin-aether 是什么?

ElizaOS以太坊插件:一个具有支出限制的代理钱包,用于支付api (x402),发送AETH和USDC,并在链上目录中查找付费服务。

如何安装 elizaos-plugin-aether?

在项目目录运行 npm install elizaos-plugin-aether,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@elizaos/core(^1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

elizaos-plugin-aether 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

elizaos-plugin-aether 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

elizaos-plugin-aether 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

elizaos-plugin-aether 可以商用吗?

elizaos-plugin-aether 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

elizaos-plugin-aether 还在维护吗?

最新版本 0.2.18 发布于 2026/11/03(今天);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/10/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。