跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Helius 为在 Solana 上构建的 AI 代理提供一流支持。从程序化帐户创建到实时数据流,代理可以在无需人工干预的情况下访问 Helius 的全部功能。
  • Helius MCP — 包含 10 个路由工具,可用于查询区块链、发送交易、流媒体等
  • Claude Code Plugin — 第一个,也是目前唯一,一个来自加密公司的官方 Claude Code 插件。一次安装:MCP 服务器 + 技能 + 参考文件
  • Skills — Claude 的专家指令集:BuildPhantomJupiterDFlowOKXSVM
  • TypeScript SDK — 为所有 Helius API 提供类型安全的方法
  • Rust SDK — 高性能的 Rust SDK,用于 Helius API
  • Helius CLI — 账户管理和脚本编写
本节的机器可读版本可在 agents/llms.txt 获得,以供 AI 代理使用。

MCP vs CLI

Helius MCP服务器 是AI代理与Helius交互的推荐方式。它提供了10个路由工具,为AI提供直接、结构化的Solana访问——无需shell命令、无需输出解析、无需手动API调用。
MCPCLI
最佳用途Claude Code、Cursor、Claude Desktop中的AI代理以及任何兼容MCP的工具Shell脚本、CI/CD管道、终端工作流
接口具有类型化输入/输出的结构化工具调用命令行与--json输出
功能10个路由工具(heliusWallet, heliusAsset, heliusTransaction, …)涵盖区块链查询、交易、webhooks、流媒体、钱包分析、文档和注册95+命令:相同功能加上配置管理和交互式流程
账户设置内置:heliusAccount动作 generateKeypairsignup(链接或自动支付)— 不需要外部工具helius keygenhelius signup
何时使用默认选择任何AI代理当您需要shell级自动化或不使用兼容MCP的工具时
从MCP开始。 如果您的AI工具支持MCP(Claude Code, Cursor, Claude Desktop等),请使用MCP服务器Claude Code Plugin。CLI对shell脚本和CI/CD非常有用,但对于AI驱动的工作流程,MCP提供了更无缝的体验——AI直接调用工具,而不是生成shell命令并解析输出。

快速入门:代理注册

代理可以使用 Helius CLI 通过四个步骤创建一个 Helius 账户并获取一个 API 密钥:
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# (Autopay only) Fund wallet with 1 USDC + ~0.001 SOL — skip if paying via the hosted link
helius signup --email you@example.com --first-name Jane --last-name Doe --json          # Get API key (JSON output)
成功后,您的代理将收到一个 API 密钥、RPC 端点和 1,000,000 积分。详情请参阅 完整的 CLI 指南

认证

所有 Helius API 请求都需要将 API 密钥作为查询参数传递:
?api-key=YOUR_API_KEY
将此附加到任何 RPC 或 API 端点。例如:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Helius 仪表板 或通过 Helius CLI 编程获取一个 API 密钥。
使用 Gatekeeper 以降低延迟Gatekeeper (Beta) 从关键路径中移除 Cloudflare,将响应时间减少数十到数百毫秒。相同的 API 密钥,相同的方法 — 只需更换端点:
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
支持所有 RPC、DAS、WebSocket、ZK 压缩、优先费用和增强型事务方法。详情请参阅 迁移指南

Helius 特定 API 指南

使用这些 Helius 优化的 API 代替链接标准 Solana RPC 方法:
替代方案…使用这个原因
getSignaturesForAddress + getTransactiongetTransactionsForAddress单次调用获取完整交易历史和代币账户数据
getTokenAccountsByOwnergetAssetsByOwner (DAS API)返回丰富的元数据,而不仅仅是原始账户
getRecentPrioritizationFeesgetPriorityFeeEstimate预先计算最佳费用,无需手动计算
getSignaturesForAddress (用于 cNFTs)getSignaturesForAsset (DAS API)标准 RPC 不适用于压缩 NFT
getProgramAccounts (用于 NFT 搜索)searchAssetsgetAssetsByGroup更快、更便宜、索引化数据
轮询实时数据LaserStream WebSocketLaserStream gRPC更低延迟、更高效
标准 sendTransactionHelius Sender双重路由(验证者 + Jito),更高的着陆率

推荐工作流程

构建…使用 Helius 产品
交易机器人Gatekeeper (最低延迟 RPC)+ Sender (快速交易提交)+ Priority Fee API + LaserStream (实时价格)
钱包应用DAS API (getAssetsByOwner) + getTransactionsForAddress (完整历史)
NFT 市场DAS API (searchAssets, getAssetsByGroup) + Webhooks (跟踪销售/列表)
代币狙击器Gatekeeper (边缘路由 RPC)+ LaserStream gRPC (最低延迟)+ Sender (抵押连接)
投资组合追踪器DAS API (getAssetsByOwnershowFungible) + Enhanced Transactions
钱包监控器LaserStream WebSocketWebhooks 实时通知
分析仪表板Enhanced Transactions API + getTransactionsForAddress
空投工具AirShip (使用 ZK 压缩便宜 95%)

速查限制

速率限制取决于您的计划。代理以Agent级别开始,有1,000,000积分。Agent级别需要支付1美元以防止滥用。
计划价格每月积分RPC速率限制DAS & 增强API
Agent$1 注册1M10 请求/s2 请求/s
Developer$49/月10M50 请求/s10 请求/s
Business$499/月100M200 请求/s50 请求/s
Professional$999/月200M500 请求/s100 请求/s
有关每个API的详细速率限制,请参见速率限制

每次API调用的积分

APICredits备注
Standard RPC calls1大多数 Solana RPC 方法
getProgramAccounts10尽可能使用 DAS API
DAS API10所有 DAS 端点
Enhanced Transactions100解析的交易数据
getTransactionsForAddress10+仅限 Developer+ 计划。完整交易每返回 100 条需 10 积分;仅签名响应固定为 10 积分。
getTransfersByAddress10仅限 Developer+ 计划
Wallet API100所有 Wallet API 端点
Priority Fee API1费用估算
Sender0所有计划免费
Webhook events1每个事件传送
Webhook management100创建、编辑、删除
有关完整的明细,请参阅Credits

重试和错误处理

HTTP 状态码

代码含义操作
200成功处理响应
400错误请求修正请求参数
401未授权检查 API 密钥
429达到速率限制退避并重试
5xx服务器错误使用指数回退重试

重试模式

async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}

监控信用使用情况

helius usage --json

快速参考

  • Mainnet RPC: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Mainnet RPC (Gatekeeper Beta): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet RPC: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Mainnet WSS: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Mainnet WSS (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet WSS: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 发送端点: https://sender.helius-rpc.com/fast
  • MCP 服务器: https://www.helius.dev/docs/mcp
  • 仪表板: dashboard.helius.dev
  • 状态: helius.statuspage.io