Awaken Agent Kit：为AI Agent赋能的aelf链DeFi工具包开发指南

1. 项目概述：一个为AI Agent赋能的DeFi工具包

如果你是一名在aelf区块链上构建应用的开发者，或者是一位热衷于探索AI与Web3结合可能性的技术爱好者，那么你很可能遇到过这样的困境：你希望让Claude、Cursor或者GPT这类AI助手帮你完成一些链上操作，比如查询代币价格、执行一笔Swap，或者管理流动性池，却发现现有的工具要么过于底层，需要你手动处理大量RPC调用和ABI编码；要么就是功能单一，无法集成到AI工作流中。

Awaken Agent Kit（@awaken-finance/agent-kit）正是为了解决这个问题而生的。它是一个开源的、功能完备的TypeScript SDK，其核心目标是将Awaken DEX（aelf链上的头部去中心化交易所）的核心功能——包括查询、交易和K线数据获取——封装成一套干净、纯粹的API。这套API不仅可以直接在你的Node.js或Bun项目中作为SDK调用，更关键的是，它原生适配了Model Context Protocol (MCP)和OpenClaw标准。这意味着你可以将这些功能无缝“安装”到Claude Desktop、Cursor IDE，甚至是任何支持MCP协议的AI工具中，让AI助手直接成为你在链上的“交易员”或“数据分析师”。

简单来说，这个工具包扮演了“翻译官”和“执行器”的双重角色。它将复杂的区块链交互逻辑（如合约调用、签名、Gas估算）和DeFi业务逻辑（如路由计算、滑点处理）抽象成简单的函数，再通过MCP或CLI接口暴露给AI。对于用户而言，你不再需要记忆复杂的命令或手动操作钱包，只需用自然语言告诉AI：“用1个ELF换USDT，滑点0.5%”，剩下的就交给Agent去处理。

2. 核心架构与设计哲学

2.1 清晰的分层架构：核心逻辑与适配器分离

这个项目的代码结构体现了一种非常清晰、可维护的架构思想，即“核心逻辑与适配器分离”。这种设计确保了代码的复用性和可测试性，是许多优秀开源库的共同特点。

核心层 (src/core/)这是整个项目的“心脏”，包含了所有纯粹的业务逻辑。这里的“纯粹”指的是函数没有副作用（side-effect），它们不直接进行网络I/O（如HTTP请求、RPC调用），也不处理用户界面（如控制台输出）。core目录下的函数只负责接收参数、执行业务计算、并返回结果或抛出错误。例如，getQuote函数的核心是计算最优交易路径和预估输出，它依赖外部传入的配置和客户端来获取链上数据。这种设计让核心逻辑极易进行单元测试，因为你只需要模拟（mock）输入，而无需搭建真实的网络环境。

适配器层 (CLI & MCP)适配器层是核心逻辑与外部世界沟通的桥梁。它们非常“薄”，主要职责是：

1. 解析输入：CLI适配器（如awaken_query_skill.ts）使用commander库解析命令行参数；MCP适配器（src/mcp/server.ts）则按照MCP协议解析来自AI工具的JSON-RPC请求。
2. 调用核心：将解析后的参数转换为核心函数所需的格式，并调用对应的核心函数。
3. 格式化输出：将核心函数返回的结果（或错误）格式化为目标接口要求的格式。CLI输出标准化的JSON到stdout，错误信息到stderr；MCP则包装成标准的JSON-RPC响应。

SDK入口 (index.ts)这是面向普通开发者的主要入口。它简单地重新导出（re-export）了core目录下的所有函数和类型定义。当你在自己的TypeScript项目中import { executeSwap } from '@awaken-finance/agent-kit'时，你使用的就是这些纯净的核心函数，你可以自由地将其集成到你的后端服务、自动化脚本或任何Node.js环境中。

设计心得：这种“核心-适配器”模式是我在构建复杂工具时最推崇的模式之一。它强制你将业务逻辑与I/O、UI解耦。带来的好处是巨大的：核心代码可以独立演进和测试；适配器可以轻松替换或增加（比如未来增加一个GraphQL适配器）；SDK用户也能获得最干净、无依赖的API。在项目初期就坚持这种分离，能为后期的功能扩展和维护省下大量精力。

2.2 多协议支持：MCP与OpenClaw的深度集成

项目对MCP和OpenClaw的支持不是简单的“兼容”，而是深度集成，这体现了开发者对AI工具生态的深刻理解。

MCP (Model Context Protocol)MCP是由Anthropic提出的一种协议，旨在让AI模型能够安全、可控地访问外部工具和数据。Awaken Agent Kit实现了一个完整的MCP服务器（src/mcp/server.ts）。当你在Claude Desktop或Cursor中配置好这个服务器后，AI助手就能“看到”并调用这11个工具。关键在于，MCP服务器是以子进程（stdio）方式运行的，私钥等敏感信息通过环境变量传递，不会在AI服务商的后端泄露，这提供了基本的安全保障。

OpenClawOpenClaw是另一个流行的AI工具集成标准。项目提供了openclaw.json配置文件，其中预定义了每个工具的名称、描述、参数schema。这些描述经过了精心优化，以便AI能更好地理解工具的用途和用法。你可以直接导入这个文件到支持OpenClaw的客户端（如某些Claw客户端），快速获得所有功能。

跨技能签名上下文 (Cross-Skill Signer Context)这是一个非常实用的高级特性。在传统的DeFi交互中，每次交易都需要你提供私钥。但在这个工具包中，它引入了一个“活跃钱包上下文”的概念。工具会按照以下优先级寻找签名者：

1. 调用时显式传入的signer参数。
2. 从~/.portkey/skill-wallet/context.v1.json文件中读取的活跃钱包信息（这通常由Portkey等钱包管理工具维护）。
3. 最后才回退到环境变量中的AELF_PRIVATE_KEY。

这意味着，如果你在一个支持Portkey的AI工作流中，你可能只需要在开始时“登录”一次钱包，后续的所有交易操作都可以自动使用这个上下文，无需反复输入私钥，体验非常流畅。

3. 功能模块深度解析与实操要点

3.1 查询类功能：你的链上数据雷达

查询功能是DeFi交互的基础，也是AI Agent最常用到的能力。Awaken Agent Kit提供了五大查询工具，覆盖了从资产查询到市场分析的核心需求。

getQuote/awaken-query-quote：获取最优交易报价这是最常用的功能之一。你输入想要卖出的代币符号（如ELF）、买入的代币符号（如USDT）和卖出数量，它会返回一个详细的报价对象。这个对象不仅包含预估能收到的amountOut，更重要的是包含了具体的交易路径route。在复杂的多池交易中，路径可能涉及多个中间代币和池子。AI可以利用这个信息向你解释：“这笔交易将通过ELF->AUSD->USDT路径进行，预计你会收到X个USDT，其中包含了Y%的手续费。”

getPair/awaken-query-pair：深入理解交易对每个流动性池（交易对）都有其关键参数。这个工具可以查询指定两个代币和费率等级（如0.3%）所对应的池子信息。返回数据包括池子合约地址、当前储备量（reserve0,reserve1）、总流动性等。对于分析市场深度或计算无常损失非常有用。

getTokenBalance/awaken-query-balance&getTokenAllowance/awaken-query-allowance：资产与授权检查查询余额很简单，但查询授权（Allowance）是执行交易前的关键一步。在ERC-20标准中，你要花费某个代币（比如ELF），必须先授权（Approve）给Swap合约一定的额度。这个工具可以快速检查当前授权是否充足。AI在建议你执行Swap前，可以先用它检查，如果授权不足，它会先提示你调用approveTokenSpending。

getLiquidityPositions/awaken-query-liquidity：流动性头寸管理对于流动性提供者（LP）来说，管理在不同池子中的头寸是日常工作。这个工具可以查询指定地址在所有Awaken池子中的流动性头寸，并以美元计价显示总价值。返回的数据结构包含了池子信息、你拥有的LP代币数量、以及对应两种代币的份额。AI可以据此为你生成一份简洁的流动性资产报告。

实操要点与避坑指南：

1. 符号（Symbol）与地址（Address）：工具大部分情况下接受代币符号（如ELF）作为输入，这非常人性化。但在底层，它依赖一个内置的代币列表进行映射。如果你要查询一个非常新的、未被列表收录的代币，可能需要直接使用合约地址。在调用SDK时，你可以通过config对象传入自定义的代币映射。
2. 网络延迟与RPC节点：所有查询最终都依赖于aelf的RPC节点和Awaken的后端API。在网络拥堵时，响应可能会变慢。工具包内置了重试和超时机制，但在编写自动化脚本时，建议你自己也封装一层错误重试逻辑。
3. 金额精度处理：区块链上处理的是代币的最小单位（如ELF是8位小数）。工具包内部使用了aelf-sdk的toDecimal和toInteger方法进行转换。但你在传入amountIn等参数时，务必使用字符串（String）格式，例如"10.5"，而不是数字10.5，以避免JavaScript浮点数精度丢失问题。这是Web3开发中一个非常经典的坑。

3.2 交易类功能：安全执行链上操作

交易功能是工具包的核心价值所在，它让AI具备了直接操作链上资产的能力。所有交易功能都需要签名者（私钥）授权。

executeSwap/awaken-trade-swap：执行代币兑换这是最复杂的交易操作。它内部完成了以下步骤：

1. 调用getQuote获取最优路径和预估输出。
2. 根据用户设置的滑点容差（slippage，默认0.5%），计算可接受的最小输出量（amountOutMin）。这是防止交易被夹子（sandwich attack）或市场剧烈波动导致损失过大的关键参数。
3. 检查用户当前代币余额和Swap合约的授权额度。如果授权不足，交易会失败（SDK会抛出错误，CLI/MCP会返回错误信息）。在MCP场景下，AI应该先检查授权，再建议用户执行approve。
4. 构造交易参数，调用aelf-sdk进行签名并发送交易。
5. 返回交易哈希（transactionId）。

addLiquidity/awaken-trade-add-liquidity&removeLiquidity/awaken-trade-remove-liquidity：流动性管理添加流动性需要你提供两种代币的金额，工具会帮你计算最优的比例并铸造LP代币。移除流动性则是销毁你的LP代币，换回两种基础资产。这里有一个关键细节：添加流动性时，你提供的两种代币金额比例必须与池子当前的比例大致相同，否则多余的代币会被浪费。工具内部会进行计算并采用最优比例，但你仍然需要理解这个概念。

approveTokenSpending/awaken-trade-approve：授权代币支出这是一个基础但至关重要的操作。它调用代币合约的Approve方法，授权Swap合约可以从你的地址中转走指定数量（或无限额度）的代币。为了提高用户体验和节省Gas，许多DeFi前端会建议用户一次性授权一个非常大的额度（如2^256 - 1）。工具包也支持这种“无限授权”。但请注意，无限授权存在安全风险，如果Swap合约存在漏洞，你的资产可能面临风险。对于不常用的合约或金额较大的主资产，建议采用按需授权的方式。

安全实操心得：

1. 私钥管理是生命线：绝对不要将私钥硬编码在代码中或提交到版本控制系统。CLI和MCP模式都强烈推荐使用环境变量（.env文件或MCP配置的env块）。setup.ts脚本在配置MCP时，会在配置文件中留下<YOUR_PRIVATE_KEY>占位符，就是为了提醒你手动替换，避免误提交。
2. 理解滑点（Slippage）：滑点是你愿意接受的交易价格与执行时实际价格的最大偏差。在市场波动大时，过低的滑点会导致交易失败（revert），过高的滑点则可能让你蒙受较大损失。对于像ELF/USDT这样的主流交易对，0.5%的默认值通常比较安全。但对于小市值或低流动性的代币，你可能需要设置更高的滑点（如2%-5%），但务必清楚其中的风险。
3. 测试网先行：在执行任何主网交易前，强烈建议在测试网（AWAKEN_NETWORK=testnet）上完整走一遍流程。你可以从测试网水龙头获取测试代币。这能帮你熟悉流程、确认Gas费用，并确保你的脚本或AI指令没有错误。

3.3 K线数据功能：为AI提供市场分析能力

fetchKline/awaken-kline-fetch工具为AI Agent打开了时序数据分析的大门。它通过Awaken的SignalR服务获取指定交易对、指定时间间隔的K线（蜡烛图）数据。

数据内容：每条K线数据包含开盘价（open）、收盘价（close）、最高价（high）、最低价（low）、成交量（volume）以及时间戳（timestamp）。这些是技术分析的基础。

使用场景：AI可以获取历史K线数据后，进行简单的趋势分析（例如：“过去24小时内，ELF/USDT的价格在X和Y之间震荡，成交量在Z时放大”），或者结合其他信息做出更复杂的判断。虽然工具包本身不提供复杂的指标计算（如MACD、RSI），但获取到原始数据后，你可以很容易地在后端或让AI进行后续处理。

间隔（Interval）：工具支持多种时间间隔，从1m（1分钟）到1W（1周）不等。你可以通过getKlineIntervals/awaken-kline-intervals工具查询所有支持的间隔。选择间隔取决于你的分析粒度：短期交易关注小间隔，长期趋势分析则使用大间隔。

4. 从零开始：完整配置与集成实战

4.1 环境准备与项目初始化

首先，确保你的开发环境满足要求。项目使用Bun作为运行时和包管理器，因其启动速度快、对TypeScript原生支持好。

# 1. 安装Bun (如果尚未安装) # 访问 https://bun.sh 查看最新安装命令，通常如下： curl -fsSL https://bun.sh/install | bash # 2. 克隆项目仓库 git clone https://github.com/Awaken-Finance/awaken-agent-skills.git cd awaken-agent-skills # 3. 安装依赖 bun install

接下来是关键的配置环节。项目使用.env文件管理敏感信息和网络配置。

# 4. 复制环境变量模板并编辑 cp .env.example .env

用文本编辑器打开新创建的.env文件。你需要重点关注以下配置：

# .env 文件内容示例 # 对于EOA（外部拥有账户）钱包，填写私钥（0x开头） AELF_PRIVATE_KEY=0x你的64位十六进制私钥 # 或者，对于Portkey合约账户（CA），填写以下三项 # PORTKEY_PRIVATE_KEY=0x你的管理器私钥 # PORTKEY_CA_HASH=你的CA哈希 # PORTKEY_CA_ADDRESS=你的CA地址 # 选择网络 (mainnet 或 testnet) AWAKEN_NETWORK=testnet # 初次使用强烈建议先用测试网 # 以下配置通常不需要修改，除非你有自建节点 # AWAKEN_RPC_URL=https://tdvw-test-node.aelf.io # AWAKEN_API_BASE_URL=https://api-test.awaken.finance # AWAKEN_DEFAULT_SLIPPAGE=0.005

重要提示：私钥是访问你资产的唯一凭证。AELF_PRIVATE_KEY必须以0x开头，后面跟64个十六进制字符。确保.env文件已被添加到.gitignore中，并且永远不会被提交到任何公共仓库。一种好的实践是使用密码管理器生成并存储私钥，然后复制粘贴。

4.2 一键配置AI工具（MCP集成）

这是项目最强大的特性之一。通过提供的setup.ts脚本，你可以一键将Awaken Agent Kit配置到主流的AI工具中。

配置Claude DesktopClaude Desktop是Anthropic官方客户端，通过MCP支持扩展工具。

# 运行一键配置脚本 bun run bin/setup.ts claude

这个脚本会：

1. 自动检测你的操作系统（macOS, Linux, Windows）。
2. 定位Claude Desktop的配置文件路径（例如，macOS上通常是~/Library/Application Support/Claude/claude_desktop_config.json）。
3. 在该配置文件的mcpServers部分添加一个名为awaken-agent-kit的服务器配置。
4. 配置中会包含运行MCP服务器所需的Bun命令和当前项目的绝对路径，并预留环境变量占位符。

配置完成后，你需要手动编辑生成的配置文件，将<YOUR_PRIVATE_KEY>替换为你真实的私钥。之后重启Claude Desktop，你就可以在对话中直接使用Awaken的相关功能了。

配置Cursor IDECursor是集成了AI编程助手的IDE，同样支持MCP。

# 项目级配置（仅当前项目可用） bun run bin/setup.ts cursor # 全局配置（所有项目可用） bun run bin/setup.ts cursor --global

项目级配置会在当前目录下创建.cursor/mcp.json文件；全局配置则修改~/.cursor/mcp.json。同样，记得替换私钥占位符。

配置OpenClaw如果你使用支持OpenClaw配置的客户端（如某些Claw客户端），可以生成对应的配置文件。

bun run bin/setup.ts openclaw

这会在当前目录生成或更新openclaw.json，你可以将其导入到你的OpenClaw客户端中。

管理配置脚本还提供了其他实用命令：

# 查看所有已配置的平台 bun run bin/setup.ts list # 从特定平台卸载配置 bun run bin/setup.ts uninstall claude bun run bin/setup.ts uninstall cursor

4.3 在AI工具中的实际使用体验

配置成功后，你在AI对话中的体验会发生质变。

在Claude Desktop中： 你可以直接说：

“查询一下我用地址ELF_xxx...在Awaken上所有的流动性头寸，用美元显示总价值。”

Claude会调用awaken_liquidity工具，并返回一个格式清晰的列表，包含每个池子、你的份额和美元价值。

或者进行交易：

“我想用10个ELF兑换USDT，请检查我的ELF余额和授权，如果没问题就用0.5%的滑点执行兑换。”

Claude会依次调用awaken_balance、awaken_allowance，如果授权不足，它会建议你先执行awaken_approve，最后再调用awaken_swap完成交易。整个过程你只需要确认，无需手动操作钱包插件或复制粘贴地址。

在Cursor中： 你可以在编写一个DeFi策略脚本时，直接让Cursor帮你查询实时价格：

（在代码注释中）“Cursor，获取当前ELF/USDT交易对的最新价格。”

Cursor可以调用工具获取信息，并直接将结果插入到你的代码或注释中，极大地提升了开发效率。

4.4 作为SDK在自有项目中使用

除了给AI用，这个工具包本身就是一个功能强大的SDK，非常适合集成到你自己的Node.js/Bun后端服务、自动化脚本或数据分析平台中。

基本查询示例：

import { getQuote, getNetworkConfig } from '@awaken-finance/agent-kit'; async function checkBestPrice() { // 获取主网配置 const config = getNetworkConfig('mainnet'); try { const quote = await getQuote(config, { symbolIn: 'ELF', symbolOut: 'USDT', amountIn: '100', // 注意：使用字符串 }); console.log(`用100 ELF预计可兑换: ${quote.amountOut} USDT`); console.log(`推荐路径: ${quote.route.map(r => r.poolId).join(' -> ')}`); console.log(`价格影响: ${(quote.priceImpact * 100).toFixed(2)}%`); } catch (error) { console.error('获取报价失败:', error.message); } } checkBestPrice();

执行交易示例（需私钥）：

import { executeSwap, getNetworkConfig } from '@awaken-finance/agent-kit'; import { Wallet } from '@aelf-react/wallet'; async function performSwap() { const config = getNetworkConfig('mainnet'); // 从环境变量或安全存储中加载私钥 const privateKey = process.env.AELF_PRIVATE_KEY!; const wallet = Wallet.getWalletByPrivateKey(privateKey); const swapParams = { symbolIn: 'ELF', symbolOut: 'USDT', amountIn: '1.5', slippage: '0.01', // 1% 滑点容差 }; try { console.log('正在执行交易...'); const result = await executeSwap(config, wallet, swapParams); console.log(`交易成功！交易哈希: ${result.transactionId}`); console.log(`可在浏览器查看: ${config.explorerUrl}/tx/${result.transactionId}`); // 你可以在这里添加交易状态轮询逻辑 // const receipt = await waitForTransaction(result.transactionId, config.rpcUrl); } catch (error) { console.error('交易执行失败:', error); // 错误处理：可能是余额不足、授权不够、滑点过低等 } } // 确保私钥已设置 if (process.env.AELF_PRIVATE_KEY) { performSwap(); } else { console.error('请设置 AELF_PRIVATE_KEY 环境变量'); }

5. 高级主题、问题排查与性能优化

5.1 网络配置与自定义RPC节点

默认情况下，工具包使用aelf官方提供的公共RPC节点。对于高频查询或交易，你可能需要考虑使用自建节点或付费的节点服务以获得更好的稳定性和速度。

自定义网络配置： 你可以完全覆盖默认的网络配置，而不仅仅是切换mainnet和testnet。

import { NetworkConfig } from '@awaken-finance/agent-kit'; // 创建自定义配置 const customConfig: NetworkConfig = { network: 'custom', chainId: 'tDVW', // 或你的链ID rpcUrl: 'https://your-private-node.com', // 你的RPC端点 apiBaseUrl: 'https://your-api-server.com', // Awaken API端点（如果需要） explorerUrl: 'https://your-explorer.com', // ... 其他合约地址 }; // 然后在调用函数时直接传入这个config对象 const quote = await getQuote(customConfig, { symbolIn: 'ELF', symbolOut: 'USDT', amountIn: '10' });

环境变量覆盖： 更灵活的方式是通过环境变量覆盖特定配置。工具包的配置加载优先级从高到低为：函数参数 > CLI参数 > MCP环境变量 > 系统环境变量 >.env文件 > 代码默认值。这意味着你可以在部署时动态调整：

# 临时使用不同的RPC节点 AWAKEN_RPC_URL=https://backup-rpc.aelf.io bun run awaken_query_skill.ts quote --symbol-in ELF --symbol-out USDT --amount-in 10

5.2 错误处理与常见问题排查

在集成和使用过程中，你可能会遇到各种错误。理解这些错误的含义和排查方法至关重要。

1. “Invalid private key” 或 “Failed to get wallet from private key”

• 原因：环境变量AELF_PRIVATE_KEY格式错误、未设置，或包含多余字符（如换行符）。
• 排查：
  • 检查.env文件或MCP配置中的私钥，确保它以0x开头，且长度为66字符（0x + 64位十六进制）。
  • 在终端执行echo $AELF_PRIVATE_KEY或在Node.js中console.log(process.env.AELF_PRIVATE_KEY)查看实际值。
  • 尝试使用aelf-sdk的Wallet.getWalletByPrivateKey方法单独验证私钥是否能正确生成地址。

2. “Insufficient allowance” 或 “ERC20: transfer amount exceeds allowance”

• 原因：试图转移的代币数量超过了你对Swap合约的授权额度。
• 解决：
  • 先调用awaken-query-allowance检查当前授权。
  • 调用awaken-trade-approve进行授权。如果是第一次与某个合约交互，通常需要授权。
  • 注意：授权交易本身需要支付Gas费。

3. “Insufficient balance for transaction”

• 原因：钱包地址的ELF余额不足以支付交易Gas费。在aelf链上，所有交易都需要用ELF支付Gas。
• 解决：确保你的钱包里有足够的ELF作为Gas。可以通过awaken-query-balance查询ELF余额。

4. “Price impact too high” 或交易失败

• 原因：通常发生在交易小市值或低流动性代币时。由于池子深度不够，你的交易会对价格产生较大影响，如果超过滑点设置，交易会被拒绝。
• 解决：
  • 增加slippage参数（例如从0.005增加到0.02，即2%）。
  • 减少交易金额，分拆成多笔小交易。
  • 理解这是低流动性代币的固有风险。

5. MCP服务器连接失败

• 原因：Claude Desktop/Cursor无法启动或连接到本地的MCP服务器。
• 排查：
  • 首先手动运行服务器测试：bun run src/mcp/server.ts。如果报错，根据错误信息解决（通常是依赖或配置问题）。
  • 检查MCP配置文件中的command和args路径是否正确。特别是bun命令是否在系统PATH中，以及server.ts的绝对路径是否正确。
  • 查看AI工具的日志（如Claude Desktop的开发者工具Console），里面通常有更详细的连接错误信息。

6. 查询返回“Pair not found”

• 原因：指定的两个代币之间可能不存在流动性池，或者你指定的费率等级（如0.3%）不对。
• 解决：
  • 使用awaken-query-pair工具，尝试不同的fee-rate（常见的有0.01%， 0.05%， 0.3%， 1%）。
  • 确认代币符号正确，或尝试使用合约地址查询。
  • 访问Awaken DEX前端页面，确认该交易对确实存在。

5.3 性能优化与最佳实践

1. 缓存策略对于频繁的查询请求（如获取多个代币价格），可以考虑在应用层实现缓存，避免对RPC和API的重复调用。例如，将getQuote的结果缓存5-10秒。但要注意，金融市场数据变化快，缓存时间不宜过长。

2. 批量操作工具包目前主要提供单次操作接口。如果你需要批量查询多个余额或多个交易对信息，建议并行执行多个getTokenBalance或getPair调用，而不是串行。可以利用Promise.all来提高效率。

3. 监控与告警对于自动化交易脚本，务必添加监控。可以监听executeSwap等函数抛出的错误，并通过邮件、Slack或Telegram Bot发送告警。同时，记录每笔交易的哈希、时间、参数和结果，便于后续审计和分析。

4. 使用TypeScript获得最佳体验项目完全使用TypeScript编写，并提供了完整的类型定义。在你的项目中同样使用TypeScript，可以获得完美的代码提示、类型检查和自动补全，极大减少低级错误。

5. 贡献与扩展这是一个开源项目，如果你发现了Bug或有新的功能需求，欢迎在GitHub上提交Issue或Pull Request。常见的扩展方向包括：

• 支持更多的区块链网络（虽然目前专注于aelf，但架构允许扩展）。
• 增加更多的查询指标，如池子的历史APY、交易量图表等。
• 实现更复杂的交易策略，如限价单（需要链下订单簿支持）或自动复投LP奖励。

这个工具包将复杂的DeFi交互封装成了AI和开发者友好的接口，大大降低了在aelf生态中进行自动化交易和数据分析的门槛。无论是用于个人资产管理、量化策略研究，还是构建创新的AI+DeFi应用，它都提供了一个坚实可靠的起点。