Solana技能

使用Helius基础设施进行全面的Solana区块链交互。

先决条件

1. Helius API密钥— 免费获取地址https://dashboard.helius.dev/signup
2. 将密钥存储于~/.config/solana-skill/config.json：

{
  "heliusApiKey": "your-api-key",
  "network": "mainnet-beta"
}

核心功能

钱包管理

• 创建新钱包（密钥对生成）
• 导入现有钱包（私钥或助记词）
• 列出管理的钱包
• 安全的密钥存储（静态加密）

余额与资产

• 检查SOL余额
• 获取所有代币余额（SPL代币）
• 查看NFT和压缩NFT
• 投资组合估值（通过DAS API）

交易

• 发送SOL
• 发送SPL代币
• 交易历史（增强版，人类可读）
• 优先费用估算

兑换（Jupiter平台）

• 获取兑换报价
• 执行代币兑换
• 滑点保护

监控

• 监控地址活动
• 交易通知

快速参考

检查余额

import { createHelius } from 'helius-sdk';

const helius = createHelius({ apiKey: 'YOUR_KEY' });
const assets = await helius.getAssetsByOwner({
  ownerAddress: 'WALLET_ADDRESS',
  displayOptions: {
    showFungible: true,
    showNativeBalance: true
  }
});

发送SOL

import { Connection, Keypair, SystemProgram, Transaction, sendAndConfirmTransaction, LAMPORTS_PER_SOL } from '@solana/web3.js';

const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=YOUR_KEY');
const tx = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: sender.publicKey,
    toPubkey: recipientPubkey,
    lamports: amount * LAMPORTS_PER_SOL
  })
);
await sendAndConfirmTransaction(connection, tx, [sender]);

Jupiter兑换

// 1. Get quote
const quote = await fetch(`https://api.jup.ag/swap/v1/quote?inputMint=${inputMint}&outputMint=${outputMint}&amount=${amount}`);

// 2. Build swap transaction
const swap = await fetch('https://api.jup.ag/swap/v1/swap', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    quoteResponse: await quote.json(),
    userPublicKey: wallet.publicKey.toString()
  })
});

// 3. Sign and send

API端点

安全

关键规则：

• 切勿记录或显示私钥
• 对密钥使用加密存储
• 交易前验证所有地址
• 设置合理的滑点限制（默认：1%）
• 大额交易始终需用户确认

查看references/security.md以获取详细的安全实践。

详细参考

• references/helius-api.md— Helius API 完整参考
• references/security.md— 钱包安全最佳实践
• references/jupiter.md— Jupiter 交换集成

常用代币地址

错误处理

常见错误及解决方案：

• SOL不足：需要SOL用于租金和交易费用
• 未找到代币账户：发送代币前先创建ATA
• 交易过大：减少指令或使用地址查找表
• 区块哈希已过期：使用新的区块哈希重试