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_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,这
还将它们作为任何其他框架的纯JSON工具规范。