[!TIP] 请查看由 SendAI 提供的 Suzi 🌸

一个用于将 AI 代理连接到 Solana 协议的开源工具包。现在，任何使用任意模型的代理都可以自主执行 60 多种 Solana 操作：

• 交易代币
• 发行新代币
• 借贷资产
• 发送压缩空投
• 执行 Blinks
• 在 AMM 上发行代币
• 跨链桥接代币
• 以及更多……

无论是位于 SF 的 AI 研究人员，还是原生加密开发者，都可以将自己的 AI 代理与任意模型结合，并无缝集成到 Solana 中。

Replit 模板由 Arpit Singh 创建

🔧 核心区块链功能

• 代币操作

  • 通过 Metaplex 部署 SPL 代币
  • 资产转账
  • 余额检查
  • 质押 SOL
  • 通过 Light Protocol 和 Helius 进行 Zk 压缩空投
  • 使用 Wormhole 跨链桥接代币

• 3.Land 上的 NFT

  • 创建自己的收藏集
  • NFT 创建及在 3.land 上自动上架
  • 以任意 SPL 代币将 NFT 列为待售

• 通过 Metaplex 管理 NFT

  • 收藏集部署
  • NFT 铸造
  • 元数据管理
  • 版税配置

• DeFi 集成

  • Jupiter Exchange 交换
  • 通过 PumpPortal 上线 Pump
  • Raydium 池创建（CPMM、CLMM、AMMv4）
  • Orca Whirlpool 集成
  • Manifest 市场创建及限价单
  • Meteora 动态 AMM、DLMM 池和 Alpha Vault
  • Openbook 市场创建
  • 注册并解析 SNS
  • Jito Bundles
  • Pyth 价格喂价用于获取资产价格
  • 注册/解析 Alldomains
  • 使用 Adrena 协议进行永续合约交易
  • Drift Vaults、Perps、借贷业务
  • 通过 deBridge DLN 进行跨链桥接
  • 通过 Wormhole 进行跨链桥接

• Solana Blinks

  • Lulo 借贷（USDC 最高 APR）
  • 发送 Arcade 游戏
  • JupSOL 质押
  • Solayer SOL (sSOL) 质押

• 非金融类操作

  • Gib Work 用于注册赏金任务

• 市场数据集成

  • CoinGecko Pro API 集成
  • 实时代币价格数据
  • 热门代币和流动性池
  • 涨幅最大代币分析
  • 代币信息查询
  • 最新流动性池追踪

🤖 AI 集成功能

• LangChain 集成

  • 开箱即用的 LangChain 工具，用于区块链操作
  • 支持基于 React 框架的自主代理
  • 内存管理，实现持久化交互
  • 流式响应，提供实时反馈

• Vercel AI SDK 集成

  • Vercel AI SDK 用于 AI 代理集成
  • 框架无关支持
  • 快速简便的工具包设置

• 自主模式

  • 交互式聊天模式，用于引导操作
  • 自主模式，让代理独立执行任务
  • 可配置的操作间隔
  • 内置错误处理与恢复机制

• AI 工具

  • DALL-E 集成，用于生成 NFT 艺术作品
  • 自然语言处理，用于区块链指令
  • 价格喂价集成，用于市场分析
  • 自动决策能力

📃 文档

您可以在 docs.sendai.fun 查看完整的工具包文档。

我们为何构建 V2 以及为何升级？

Solana 代理工具包 V2 是对 V1 的重大升级，如需了解原因，请参阅我们的 迁移指南。

📦 核心安装

npm install solana-agent-kit

📦 插件安装

您可以选择安装以下任一插件，也可以选择全部安装，以体验 Solana 代理工具包的全部功能。

1. 代币插件 (@solana-agent-kit/plugin-token)：针对 SPL 代币的代币操作，例如资产转账、兑换、桥接和地毯拉扯检测。
2. NFT 插件 (@solana-agent-kit/plugin-nft)：针对 Metaplex NFT 的 NFT 操作，例如铸造、上架和元数据管理。
3. DeFi 插件 (@solana-agent-kit/plugin-defi)：针对 Solana 协议的 DeFi 操作，例如质押、借贷、现货和永续合约交易。
4. 杂项插件 (@solana-agent-kit/plugin-misc)：各种杂项操作，例如空投、价格喂价、CoinGecko 代币信息和域名注册。
5. Blinks 插件 (@solana-agent-kit/plugin-blinks)：针对 Solana 协议的 Blinks 操作，例如 Arcade 游戏等，未来还将推出更多功能。

npm install @solana-agent-kit/plugin-token @solana-agent-kit/plugin-nft @solana-agent-kit/plugin-defi @solana-agent-kit/plugin-misc @solana-agent-kit/plugin-blinks

快速入门

初始化钱包接口和带有插件的代理：

import { SolanaAgentKit, createVercelAITools, KeypairWallet } from "solana-agent-kit"; // 或者如果使用 LangChain，则导入 createLangchainTools；若使用 OpenAI 代理，则导入 createOpenAITools
import TokenPlugin from "@solana-agent-kit/plugin-token";
import NFTPlugin from "@solana-agent-kit/plugin-nft";
import DefiPlugin from "@solana-agent-kit/plugin-defi";
import MiscPlugin from "@solana-agent-kit/plugin-misc";
import BlinksPlugin from "@solana-agent-kit/plugin-blinks";

const keyPair = Keypair.fromSecretKey(bs58.decode("YOUR_SECRET_KEY"))
const wallet = new KeypairWallet(keyPair)

// 使用私钥和可选的 RPC URL 初始化
const agent = new SolanaAgentKit(
  wallet,
  "YOUR_RPC_URL",
  {
    OPENAI_API_KEY: "YOUR_OPENAI_API_KEY",
  }
) // 添加您想要使用的插件
  .use(TokenPlugin)
  .use(NFTPlugin)
  .use(DefiPlugin)
  .use(MiscPlugin)
  .use(BlinksPlugin);

// 创建 LangChain 工具
const tools = createVercelAITools(agent, agent.actions);

您还可以使用 Solana 钱包适配器提供的钱包界面，用于嵌入式钱包。

使用来自代币、DeFi 等插件的工具示例

发行新代币

const result = await agent.methods.deployToken(
  agent,
  "my ai token", // 名称
  "uri", // URI
  "token", // 符号
  9, // 小数位数
  {
    mintAuthority: null, // 默认为部署者账户
    freezeAuthority: null, // 默认为部署者账户
    updateAuthority: undefined, // 默认为部署者账户
    isMutable: false // 默认为真
  },
  1000000 // 初始供应量
);

console.log("代币铸造地址:", result.mint.toString());

部署新的 Token2022

const result = await agent.methods.deployToken2022(
  "my ai token 2022", // 名称
  "uri", // URI
  "token2022", // 符号
  9, // 小数位数
  {
    mintAuthority: null, // 默认为部署者账户
    freezeAuthority: null, // 默认为部署者账户
    updateAuthority: undefined, // 默认为部署者账户
    isMutable: false // 默认为 true
  },
  1000000 // 初始供应量
);

console.log("Token2022 铸造地址:", result.mint.toString());

在 3Land 上创建 NFT 收藏集

const isDevnet = false; // （可选）若未指定，则交易将在主网上进行
const priorityFeeParam = 1000000; // （可选）若未指定，默认优先费用为 50000

 const collectionOpts: CreateCollectionOptions = {
    collectionName: "",
    collectionSymbol: "",
    collectionDescription: "",
    mainImageUrl: ""
  };

const result = await agent.methods.create3LandCollection(
      collectionOpts,
      isDevnet, // （可选）若未指定，则交易将在主网上进行
      priorityFeeParam, //(可选)
    );

在 3Land 上创建 NFT

使用 3Land 工具创建 NFT 时，它会自动在 3.land 网站上挂售。

const isDevnet = true; // （可选）若未指定，则交易将在主网上进行
const withPool = true; // （可选）仅当 NFT 将与特定 SPL 代币的流动性池一起创建时才需要
const priorityFeeParam = 1000000; // （可选）若未指定，默认优先费用为 50000
const collectionAccount = ""; // 收藏集的账户哈希值
const createItemOptions: CreateSingleOptions = {
  itemName: "",
  sellerFee: 500, //5%
  itemAmount: 100, // 总共要创建的物品数量
  itemSymbol: "",
  itemDescription: "",
  traits: [
    { trait_type: "", value: "" },
  ],
  price: 0, //100000000 == 0.1 sol，可以设置为 0 进行免费铸造
  splHash: "", // 若是在特定 SPL 代币上挂售则需要，否则将以 $SOL 挂售；如果“withPool”为真，则必须提供
  poolName: "", // 仅当“withPool”为真时才需要
  mainImageUrl: "",
};
const result = await agent.methods.create3LandSingle(
  {},
  collectionAccount,
  createItemOptions,
  isDevnet, // （可选）若未指定，则交易将在主网上进行
  withPool
  priorityFeeParam, //(可选)
);

创建 NFT 收藏集

const collection = await agent.methods.deployCollection(agent, {
  name: "My NFT Collection",
  uri: "https://arweave.net/metadata.json",
  royaltyBasisPoints: 500, // 5%
  creators: [
    {
      address: "creator-wallet-address",
      percentage: 100,
    },
  ],
});

交换代币

import { PublicKey } from "@solana/web3.js";

const signature = await agent.methods.trade(
  agent,
  new PublicKey("target-token-mint"),
  100, // 数量
  new PublicKey("source-token-mint"),
  300 // 3% 滑点
);

借出代币

import { PublicKey } from "@solana/web3.js";

const signature = await agent.methods.lendAssets(
  agent,
  100 // 借出的 USDC 数量
);

质押 SOL

const signature = await agent.methods.stakeWithJup(
  agent,
  1 // 质押的 SOL 数量
);

在 Solayer 上质押 SOL

const signature = await agent.methods.stakeWithSolayer(
  agent,
  1 // 质押的 SOL 数量
);

通过 ZK 压缩发送 SPL 代币空投

import { PublicKey } from "@solana/web3.js";

(async () => {
  console.log(
    "~空投成本估算:",
    getAirdropCostEstimate(
      1000, // 受赠者人数
      30_000 // lamports 单位的优先费用
    )
  );

  const signature = await agent.methods.sendCompressedAirdrop(
    agent,
    new PublicKey("JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"), // 代币 mint
    42, // 每个受赠者的数量
    9,
    [
      new PublicKey("1nc1nerator11111111111111111111111111111111"),
      // ... 添加更多受赠者
    ],
    30_000 // lamports 单位的优先费用
  );
})();

从 Pyth 获取价格数据

const priceFeedID = await agent.methods.fetchPythPriceFeedID("SOL");

const price = await agent.methods.fetchPythPrice(priceFeedID);

console.log("SOL/USD 价格:", price);

开仓 PERP 交易

import { PublicKey } from "@solana/web3.js";

const signature = await agent.methods.openPerpTradeLong({
  agent: agent,
  price: 300, // $300 SOL 最高价
  collateralAmount: 10, // 存入 10 jitoSOL
  collateralMint: new PublicKey("J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn"), // jitoSOL
  leverage: 50000, // x5
  tradeMint: new PublicKey("J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn"), // jitoSOL
  slippage: 0.3, // 0.3%
});

平仓 PERP 交易

import { PublicKey } from "@solana/web3.js";

const signature = await agent.methods.closePerpTradeLong({
  agent: agent,
  price: 200, // $200 SOL 价格
  tradeMint: new PublicKey("J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn"), // jitoSOL
});

清理空的代币账户

const { signature } = await agent.methods.closeEmptyTokenAccounts(agent);

创建 Drift 账户

创建一个带有初始代币存款的 Drift 账户。

const result = await agent.methods.createDriftUserAccount(
  agent,
  // 存入的代币数量
  100,
  // 存入的代币符号
  "USDC"
)

创建 Drift 金库

创建一个 Drift 金库。

const signature = await agent.methods.createDriftVault(agent, {
  name: "my-drift-vault",
  marketName: "USDC-SPOT",
  redeemPeriod: 1, // 天数
  maxTokens: 100000, // 以代币单位计，例如 100000 USDC
  minDepositAmount: 5, // 以代币单位计，例如 5 USDC
  managementFee: 1, // 1%
  profitShare: 10, // 10%
  hurdleRate: 5, // 5%
  permissioned: false, // 公开金库还是白名单制
})

向 Drift 金库存入资金

向 Drift 金库存入资金。

const signature = await agent.methods.depositIntoDriftVault(agent, 100, "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU")

向您的 Drift 账户存入资金

向您的 Drift 账户存入资金。

const {txSig} = await agent.methods.depositToDriftUserAccount(agent, 100, "USDC")

派生 Drift 金库地址

派生一个 Drift 金库地址。

const vaultPublicKey = await agent.methods.deriveDriftVaultAddress(agent, "my-drift-vault")

检查是否有 Drift 账户

检查代理是否拥有 Drift 账户。

const {hasAccount, account} = await agent.methods.doesUserHaveDriftAccount(agent)

获取 Drift 账户信息

获取 Drift 账户信息。

const accountInfo = await agent.methods.driftUserAccountInfo(agent)

申请从 Drift 金库提款

申请从 Drift 金库提款。

const signature = await agent.methods.requestWithdrawalFromDriftVault(agent, 100, "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU")

使用 Drift 金库进行永续交易

使用已委托给您的 Drift 金库开立一笔永续交易。

const signature = await agent.methods.tradeUsingDelegatedDriftVault(agent, {
  vault: "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU",
  amount: 500,
  symbol: "SOL",
  action: "long",
  type: "limit",
  price: 180 // 请以 $180/SOL 的限价单做多
})

使用您的 Drift 账户进行永续交易

使用您的 Drift 账户开立一笔永续交易。

const signature = await agent.methods.driftPerpTrade(agent, {
  amount: 500,
  symbol: "SOL",
  action: "long",
  type: "limit",
  price: 180 // 请以 $180/SOL 的限价单做多
})

更新 Drift 金库参数

更新 Drift 金库的参数。

const signature = await agent.methods.updateDriftVault(agent, {
  name: "my-drift-vault",
  marketName: "USDC-SPOT",
  redeemPeriod: 1, // 单位：天
  maxTokens: 100000, // 以代币单位计，例如 100000 USDC
  minDepositAmount: 5, // 以代币单位计，例如 5 USDC
  managementFee: 1, // 1%
  profitShare: 10, // 10%
  hurdleRate: 5, // 5%
  permissioned: false, // 公开金库或白名单制
})

从 Drift 账户提取资产

从您的 Drift 账户中提取代币。

const {txSig} = await agent.methods.withdrawFromDriftUserAccount(agent, 100, "USDC")

从 Drift 借款

从 Drift 借用代币。

const {txSig} = await agent.methods.withdrawFromDriftUserAccount(agent, 1, "SOL", true)

偿还 Drift 贷款

偿还来自 Drift 的贷款。

const {txSig} = await agent.methods.depositToDriftUserAccount(agent, 1, "SOL", true)

从 Drift 金库提取资产

在赎回期结束后，从 Drift 金库中提取代币。

const signature = await agent.methods.withdrawFromDriftVault(agent,  "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU")

更新 Drift 金库的委托地址

更新 Drift 金库的委托地址。

const signature = await agent.methods.updateDriftVaultDelegate(agent, "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU", "new-address")

获取 Voltr 金库的头寸价值

获取 Voltr 金库当前的头寸价值及总资产价值。

const values = await agent.methods.voltrGetPositionValues(agent, "7opUkqYtxmQRriZvwZkPcg6LqmGjAh1RSEsVrdsGDx5K")

向 Voltr 策略存入资产

向 Voltr 金库中的特定策略存入资产。

const signature = await agent.methods.voltrDepositStrategy(
  agent,
  new BN("1000000000"), // 以基础单位计（例如，1 USDC = 1000000）
  "7opUkqYtxmQRriZvwZkPcg6LqmGjAh1RSEsVrdsGDx5K", // 金库
  "9ZQQYvr4x7AMqd6abVa1f5duGjti5wk1MHsX6hogPsLk"  // 策略
)

从 Voltr 策略提取资产

从 Voltr 金库中的特定策略提取资产。

const signature = await agent.methods.voltrWithdrawStrategy(
  agent,
  new BN("1000000000"), // 以基础单位计（例如，1 USDC = 1000000）
  "7opUkqYtxmQRriZvwZkPcg6LqmGjAh1RSEsVrdsGDx5K", // 金库
  "9ZQQYvr4x7AMqd6abVa1f5duGjti5wk1MHsX6hogPsLk"  // 策略
)

根据 ID 获取 Solana 资产

const asset = await agent.methods.getAsset(agent, "41Y8C4oxk4zgJT1KXyQr35UhZcfsp5mP86Z2G7UUzojU")

从 Allora 获取价格推断

通过 Allora 的 API 获取指定代币和时间框架的价格。

const sol5mPrice = await agent.methods.getPriceInference("SOL", "5m");
console.log("SOL/USD 5 分钟价格推断:", sol5mPrice);

列出 Allora 的所有主题

const topics = await agent.methods.getAllTopics();
console.log("Allora 主题:", topics);

获取 Allora 特定主题的推断

const inference = await agent.methods.getInferenceByTopicId(42);
console.log("Allora 第 42 号主题的推断:", inference);

模拟 Switchboard 数据源

模拟给定的 Switchboard 数据源。您可以在 这里 查找或创建数据源。

const value = await agent.methods.simulateSwitchboardFeed(
      "9wcBMATS8bGLQ2UcRuYjsRAD7TPqB1CMhqfueBx78Uj2", // TRUMP/USD
      "http://crossbar.switchboard.xyz");;
console.log("模拟结果如下数值:", value);

### 通过 deBridge 进行跨链桥接

Solana Agent Kit 支持使用 deBridge 的 DLN 协议进行跨链代币转账。以下是使用方法：

1. 检查支持的链：
```typescript
const chains = await agent.methods.getDebridgeSupportedChains();
console.log("可用链:", chains);
// 示例输出：{ chains: [{ chainId: "1", chainName: "Ethereum" }, { chainId: "7565164", chainName: "Solana" }] }

2. 获取可用代币（可选）：

const tokens = await agent.methods.getDebridgeTokensInfo("1", "USDC"); // 在 Ethereum 上搜索 USDC
console.log("可用代币:", tokens);
// 显示指定链上与 'USDC' 匹配的代币

3. 创建桥接订单（SOL -> ETH）：

const orderInput = {
  srcChainId: "7565164", // Solana
  srcChainTokenIn: "11111111111111111111111111111111111111112", // 原生 SOL
  srcChainTokenInAmount: "1000000000", // 1 SOL（9 位小数）
  dstChainId: "1", // Ethereum
  dstChainTokenOut: "0x0000000000000000000000000000000000000000", // ETH
  dstChainTokenOutRecipient: "0x23C279e58ddF1018C3B9D0C224534fA2a83fb1d2" // ETH 接收者
};

const order = await agent.methods.createDebridgeOrder(orderInput);
console.log("订单已创建:", order);
// 包含交易数据和预估金额

4. 执行桥接订单：

const signature = await agent.methods.executeDebridgeOrder(order.tx.data);
console.log("桥接交易已发送:", signature);

5. 检查桥接状态：

const status = await agent.methods.checkDebridgeTransactionStatus(signature);
console.log("桥接状态:", status);
// 显示当前状态：已创建、已完成等。

注意：跨链桥接时：

• 向 Solana 桥接：接收者和代币 mint 地址应使用 base58 格式。
• 从 Solana 桥接：接收者地址应使用 EVM 格式，代币应为 ERC-20 格式。
• 在执行桥接交易前，请务必核对地址和金额。

从 CoinGecko 获取代币价格数据

const priceData = await agent.methods.getTokenPriceData([
  "So11111111111111111111111111111111111111112", // SOL
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"  // USDC
]);
console.log("代币价格:", priceData);

获取热门代币

const trendingTokens = await agent.methods.getTrendingTokens();
console.log("热门代币:", trendingTokens);

获取最新池子

const latestPools = await agent.methods.getLatestPools();
console.log("最新池子:", latestPools);

获取代币信息

const tokenInfo = await agent.methods.getTokenInfo("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
console.log("代币信息:", tokenInfo);

获取涨幅最高的代币

const topGainers = await agent.methods.getTopGainers("24h", "all");
console.log("涨幅最高的代币:", topGainers);

获取热门池

const trendingPools = await agent.methods.getTrendingPools("24h");
console.log("热门池:", trendingPools);

解析指令数据

const parsedData = await agent.methods.parseInstruction(
  "<programId>",
  "<instructionData>" // base64
)

console.log("解析后的数据:", parsedData)

解析账户数据

const parsedData = await agent.methods.parseAccount(
  "<programId>",
  "<accountData>" // base64
)

console.log("解析后的数据:", parsedData)

获取 Sanctum LST 价格

const prices = await agent.methods.getSanctumLSTPrice([
  "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1",
  "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"
  ])

console.log('价格', prices)

获取 Sanctum LST APY

const apys = await agent.methods.getSanctumLSTAPY([
  "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1",
  "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"
  ])

console.log('APY', apys)

获取 Sanctum LST TVL

const tvls = await agent.methods.getSanctumLSTTVL([
  "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1",
  "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"
  ])

console.log('TVL', tvls)

获取 Sanctum 持有的 LST

const lsts = await agent.methods.getSanctumOwnedLST()

console.log('持有的LST', lsts)

向 Sanctum 无限池添加流动性

const txId = await agent.methods.addSanctumLiquidity(
  "So11111111111111111111111111111111111111112",
  "1000000000",
  "1100000000",
  5000
)

console.log('交易ID', txId)

从 Sanctum 无限池移除流动性

const txId = await agent.methods.removeSanctumLiquidity(
  "So11111111111111111111111111111111111111112",
  "1000000000",
  "1100000000",
  5000
)

console.log('交易ID', txId)

交换 Sanctum LST

const txId = await agent.methods.swapSanctumLST(
  "So11111111111111111111111111111111111111112",
  "1000000000",
  "1100000000",
  5000,
  "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"
)

console.log('交易ID', txId)

获取链上数据

注意：要使用 OKX DEX 集成，您需要设置以下环境变量：请从 OKX 开发者门户获取 OKX API 密钥。

• OKX_API_KEY
• OKX_SECRET_KEY
• OKX_API_PASSPHRASE
• OKX_PROJECT_ID
• RPC_URL
• SOLANA_PRIVATE_KEY
• SOLANA_WALLET_ADDRESS

示例

LangGraph 多智能体系统

该仓库包含一个使用 LangGraph 和 Solana Agent Kit 构建多智能体系统的高级示例。位于 examples/agent-kit-langgraph 的这个示例展示了：

• 使用 LangGraph 的 StateGraph 实现的多智能体架构
• 用于不同任务的专业化智能体：
  • 通用智能体用于基本查询
  • 转账/兑换智能体用于交易操作
  • 读取智能体用于区块链数据查询
  • 管理智能体用于路由和编排
• 完全类型化的 TypeScript 实现
• 基于环境的配置

请查看 LangGraph 示例，了解高级 Solana 智能体系统的完整实现。

依赖项

该工具包依赖于多个关键的 Solana 和 Metaplex 库：

• @solana/web3.js
• @solana/spl-token
• @metaplex-foundation/digital-asset-standard-api
• @metaplex-foundation/mpl-token-metadata
• @metaplex-foundation/mpl-core
• @metaplex-foundation/umi
• @lightprotocol/compressed-token
• @lightprotocol/stateless.js
• @coingecko/sdk

贡献

欢迎贡献！请随时提交 Pull Request。 有关如何为本项目做出贡献的详细指南，请参阅 CONTRIBUTING.md。

贡献者

星标历史

许可证

Apache-2 许可证

资金支持

如果您想回馈开源社区任何代币或捐款——公共 Solana Agent Kit 国库地址：

Solana 网络：EKHTbXpsm6YDgJzMkFxNU1LNXeWcUW7Ezf8mjUNQQ4Pa

安全性

该工具包使用提供的钱包生成、签名并发送交易。请务必在安全环境中使用，并且切勿分享您的私钥。

致谢

系统提示逻辑改编自 Coinbase AgentKit（Apache 2.0）

Solana Agent Kit 快速上手指南

Solana Agent Kit 是一个开源工具包，旨在将 AI 代理与 Solana 协议无缝连接。它支持任何模型训练的 AI 代理自主执行 60+ 种 Solana 操作，包括代币交易、发行、借贷、空投、跨链桥接及 DeFi 交互等。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 建议安装 LTS 版本 (v18 或更高)。
• 包管理器: npm, yarn 或 pnpm。
• Solana 钱包密钥对: 您需要一个拥有 SOL 的 Solana 钱包私钥用于签名交易。
• RPC 节点 URL: 一个可用的 Solana RPC 端点（主网或测试网）。
• AI API Key: 如 OpenAI API Key，用于驱动 AI 代理逻辑。

安装步骤

1. 安装核心库

使用 npm 安装核心工具包：

npm install solana-agent-kit

2. 安装插件

Solana Agent Kit V2 采用模块化设计，您可以根据需求选择安装特定功能的插件，或安装全套插件以体验完整功能：

• @solana-agent-kit/plugin-token: 代币操作（转账、交换、桥接等）
• @solana-agent-kit/plugin-nft: NFT 操作（铸造、上架、元数据管理）
• @solana-agent-kit/plugin-defi: DeFi 操作（质押、借贷、永续合约交易）
• @solana-agent-kit/plugin-misc: 杂项操作（空投、价格馈送、域名注册）
• @solana-agent-kit/plugin-blinks: Blinks 操作（游戏、质押等）

安装所有插件：

npm install @solana-agent-kit/plugin-token @solana-agent-kit/plugin-nft @solana-agent-kit/plugin-defi @solana-agent-kit/plugin-misc @solana-agent-kit/plugin-blinks

基本使用

以下是最小化的初始化示例，展示如何配置钱包、连接 RPC 并加载插件，随后执行一个简单的代币部署操作。

1. 初始化 Agent

创建一个 TypeScript 文件（例如 index.ts），引入必要的模块并初始化 SolanaAgentKit。

import { SolanaAgentKit, createVercelAITools, KeypairWallet } from "solana-agent-kit";
import bs58 from "bs58";
import TokenPlugin from "@solana-agent-kit/plugin-token";
import NFTPlugin from "@solana-agent-kit/plugin-nft";
import DefiPlugin from "@solana-agent-kit/plugin-defi";
import MiscPlugin from "@solana-agent-kit/plugin-misc";
import BlinksPlugin from "@solana-agent-kit/plugin-blinks";

// 从私钥初始化钱包 (请妥善保管私钥，不要硬编码在生产环境中)
const keyPair = Keypair.fromSecretKey(bs58.decode("YOUR_SECRET_KEY"));
const wallet = new KeypairWallet(keyPair);

// 初始化 Agent
const agent = new SolanaAgentKit(
  wallet,
  "YOUR_RPC_URL", // 替换为您的 RPC 地址
  {
    OPENAI_API_KEY: "YOUR_OPENAI_API_KEY", // 替换为您的 OpenAI Key
  }
)
  // 注册所需插件
  .use(TokenPlugin)
  .use(NFTPlugin)
  .use(DefiPlugin)
  .use(MiscPlugin)
  .use(BlinksPlugin);

// 创建工具集 (此处以 Vercel AI SDK 为例，也可使用 createLangchainTools)
const tools = createVercelAITools(agent, agent.actions);

2. 执行操作示例

初始化完成后，您可以调用 agent.methods 执行具体的链上操作。以下是部署一个新 SPL 代币的示例：

async function deployExample() {
  try {
    const result = await agent.methods.deployToken(
      agent,
      "my ai token",       // 代币名称
      "uri",               // 元数据 URI
      "token",             // 代币符号
      9,                   // 小数位数
      {
        mintAuthority: null,
        freezeAuthority: null,
        updateAuthority: undefined,
        isMutable: false
      },
      1000000              // 初始供应量
    );

    console.log("Token Mint Address:", result.mint.toString());
  } catch (error) {
    console.error("Deployment failed:", error);
  }
}

deployExample();

其他常用操作简述

• 代币交换: 使用 agent.methods.trade 通过 Jupiter 进行代币互换。
• SOL 质押: 使用 agent.methods.stakeWithJup 或 stakeWithSolayer 进行质押。
• NFT 铸造: 使用 agent.methods.deployCollection 创建集合或使用 3Land 插件创建单品。
• 获取价格: 使用 agent.methods.fetchPythPrice 获取实时资产价格。

更多高级用法和完整 API 列表，请参考官方文档：docs.sendai.fun