Move Agent Kit

Move Agent Kit 是一款综合工具包，旨在简化 AI Agent 与基于 Move 的区块链之间的交互。它提供统一的界面来执行各种区块链操作，让开发者更轻松地构建可与不同基于 Move 的协议和应用交互的 AI 驱动应用。

该工具包是 AI Agent 与基于 Move 的区块链生态系统之间的桥梁，可将区块链功能无缝集成到 AI 应用中。无论你是在构建带有钱包功能的聊天机器人，还是复杂的多 Agent 系统，Move Agent Kit 都能提供高效处理区块链交互所需的工具和抽象。

主要功能

代币操作

• 标准代币管理

• 在账户之间转移代币

• 铸造新代币

• 销毁现有代币

NFT 操作

• 创建新的 NFT 集合

• 铸造 NFT

• 在账户之间转移 NFT

• 销毁 NFT

区块链交互

• 读取并解析区块链数据

• 监控区块链事件

• 执行智能合约调用

账户管理

• 交易签名

• 消息签名

• 创建和管理账户

支持的应用

Move Agent Kit 原生集成了多个知名的基于 Move 的应用：

协议	支持的功能
Joule	借贷和 DeFi 操作
Amnis	质押操作
Thala	质押和 DEX 操作
Echelon	借贷和 DeFi 操作
LiquidSwap	DEX 操作
Panora	DEX 聚合操作
Aries	借贷和 DeFi 操作
Echo	质押操作

即将推出的功能

• 图像生成能力

• Twitter 集成，支持社交媒体交互

架构概览

Move Agent Kit 采用模块化架构，便于扩展和维护：

Move Agent Kit
├── 核心模块
│   ├── 代币操作
│   ├── 区块链读取器
│   └── 账户操作
├── 集成层
│   ├── 应用连接器
│   └── 协议适配器
└── 扩展模块
    ├── 图像生成
    └── 社交媒体集成（即将推出）

安装

使用 NPM

npm install move-agent-kit

从源码安装

git clone https://github.com/Metamove/move-agent-kit
cd move-agent-kit
npm i

快速开始

基本设置

首先，导入所需模块：

const aptosConfig = new AptosConfig({
	network: Network.MAINNET,
});

const aptos = new Aptos(aptosConfig);

const account = await aptos.deriveAccountFromPrivateKey({
	privateKey: new Ed25519PrivateKey(
		PrivateKey.formatPrivateKey(
			process.env.PRIVATE_KEY,
			PrivateKeyVariants.Ed25519,
		),
	),
});

配置环境

在项目根目录中创建配置文件 .env：

APTOS_PRIVATE_KEY="private key"
ANTHROPIC_API_KEY="API Key"
OPENAI_API_KEY="API Key"

初始化客户端

const signer = new LocalSigner(account, Network.MAINNET);
const agent = new AgentRuntime(signer, aptos, {
	PANORA_API_KEY: process.env.PANORA_API_KEY, // optional
	OPENAI_API_KEY: process.env.OPENAI_API_KEY // optional
});
const tools = createAptosTools(aptosAgent);

基本操作示例

代币转账

const result = agent.transferTokens("to_address", 1.0)

读取区块链数据

// Get Balance
const balance = agent.getBalance("0x123...")

// Get transaction details
const tx_info = agent.transferTokens("0x789...")

LangChain 集成

import { ChatAnthropic } from "@langchain/anthropic";
import { MemorySaver } from "@langchain/langgraph";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { HumanMessage } from "@langchain/core/messages";

const llm = new ChatAnthropic({
    temperature: 0.7,
    model: "claude-3-5-sonnet-20241022",
});

const memory = new MemorySaver();

const agent = createReactAgent({
    llm,
    tools,
    checkpointSaver: memory,
    messageModifier: `
        You are a helpful agent that can interact onchain using the Aptos Agent Kit. You are
        empowered to interact onchain using your tools. If you ever need funds, you can request them from the
        faucet. If not, you can provide your wallet details and request funds from the user. If there is a 5XX
        (internal) HTTP error code, ask the user to try again later. If someone asks you to do something you
        can't do with your currently available tools, you must say so, and encourage them to implement it
        themselves using the Aptos Agent Kit, recommend they go to https://metamove.build/move-agent-kit for more information. Be
        concise and helpful with your responses. Refrain from restating your tools' descriptions unless it is explicitly requested.
    `,
});

const stream = await agent.stream(
    {
        messages: [new HumanMessage("Deposit 10 APT on Joule")],
    },
    config
);

for await (const chunk of stream) {
    if ("agent" in chunk) {
        console.log(chunk.agent.messages[0].content);
    } else if ("tools" in chunk) {
        console.log(chunk.tools.messages[0].content);
    }
    console.log("-------------------");
}

文档

完整文档请参阅 MetaMove GitBook 文档。

示例和用例

交互式钱包聊天机器人

用于与基于 Move 的区块链交互的自然语言界面。用户可以使用日常英语发送指令来执行区块链操作。

功能：

• 发送/接收代币和 NFT
• 查看余额和交易历史记录
• 创建 NFT 集合
• 与 DeFi 协议交互

GitHub：https://github.com/MetaMove/move-agent-kit/tree/main/examples/chat-agent

多 Agent 系统（基于 LangGraph）

由专门的 AI Agent 协同工作，执行复杂的区块链操作并在 Twitter 上发布看涨推文：

• Manager Agent：协调决策和任务
• Read Agent：从 Aptos 区块链读取有关 joule finance 的数据
• Tweet Writer Agent：根据各种链上数据撰写看涨推文
• X Post Agent：在 X/Twitter 上发布推文

GitHub：https://github.com/MetaMove/move-agent-kit/tree/main/examples/langgraph-agent

Wallet Guardian（类似 Freysa 的 AI）

一款基于游戏的 AI，用户需要勒索 AI Agent，让它交出所有 APT

• 使用 Google 登录
• 每位用户最多可发送 10 条消息
• 尝试越狱 AI Agent 并获得奖励

GitHub：https://github.com/MetaMove/wallet-guardian-agent

Telegram Bot 入门套件

使用 Move agent kit 的 Telegram bot 入门套件

• 管理用户的加密私钥
• 支持各种消息格式

GitHub：https://github.com/MetaMove/tg-bot-starter

安全

此工具包会处理私钥和交易。请始终确保在安全环境中使用，切勿分享私钥。