# elizaos-plugin-aether 中文文档

规范地址：https://npmcn.com/package/elizaos-plugin-aether/

版本：0\.2\.18
npm 元数据更新时间：2026-11-03T13:43:12.394Z
中文译文更新时间：2026-11-03T14:04:02.358Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/elizaos-plugin-aether
原文对照：https://npmcn.com/package/elizaos-plugin-aether/?lang=original
项目主页：https://github.com/whoyoujoshin/aether/tree/main/clients/eliza#readme
源码仓库：https://github.com/whoyoujoshin/aether

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：19.6 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- peer 依赖：@elizaos/core ^1\.0\.0
- 首次发布：2026-10-11T01:52:18.998Z
- 最新版本发布：2026-11-03T13:43:11.634Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

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

## 安装

```sh
npm install elizaos-plugin-aether
```

也可以使用：`pnpm add elizaos-plugin-aether`、`yarn add elizaos-plugin-aether`、`bun add elizaos-plugin-aether`

## README

# elizaos-plugin-aether

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

```bash
npm install elizaos-plugin-aether
```

```ts
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`：

```bash
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_PAYMENT` | `1 AETH` | 大多数付款可能是，以其单位。 |
| `AETHER_DAILY_BUDGET` | `5 AETH` | 大部分资金可能会在24小时内花在同一项资产上。 |
| `AETHER_RPC_URL` | `https://rpc.157-245-252-221.sslip.io` | 公共测试网。 |
| `AETHER_CHAIN_ID` | `aether-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`](https://npmcn.com/package/ts),这 还将它们作为任何其他框架的纯JSON工具规范。

## 常见问题

### 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 和提交记录判断。