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 的全部功能。
MCP vs CLI
Helius MCP服务器 是AI代理与Helius交互的推荐方式。它提供了10个路由工具,为AI提供直接、结构化的Solana访问——无需shell命令、无需输出解析、无需手动API调用。
| MCP | CLI |
|---|
| 最佳用途 | Claude Code、Cursor、Claude Desktop中的AI代理以及任何兼容MCP的工具 | Shell脚本、CI/CD管道、终端工作流 |
| 接口 | 具有类型化输入/输出的结构化工具调用 | 命令行与--json输出 |
| 功能 | 10个路由工具(heliusWallet, heliusAsset, heliusTransaction, …)涵盖区块链查询、交易、webhooks、流媒体、钱包分析、文档和注册 | 95+命令:相同功能加上配置管理和交互式流程 |
| 账户设置 | 内置:heliusAccount动作 generateKeypair → signup(链接或自动支付)— 不需要外部工具 | helius keygen → helius 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 密钥作为查询参数传递:
将此附加到任何 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 + getTransaction | getTransactionsForAddress | 单次调用获取完整交易历史和代币账户数据 |
getTokenAccountsByOwner | getAssetsByOwner (DAS API) | 返回丰富的元数据,而不仅仅是原始账户 |
getRecentPrioritizationFees | getPriorityFeeEstimate | 预先计算最佳费用,无需手动计算 |
getSignaturesForAddress (用于 cNFTs) | getSignaturesForAsset (DAS API) | 标准 RPC 不适用于压缩 NFT |
getProgramAccounts (用于 NFT 搜索) | searchAssets 或 getAssetsByGroup | 更快、更便宜、索引化数据 |
| 轮询实时数据 | LaserStream WebSocket 或 LaserStream gRPC | 更低延迟、更高效 |
标准 sendTransaction | Helius 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 (getAssetsByOwner 与 showFungible) + Enhanced Transactions |
| 钱包监控器 | LaserStream WebSocket 或 Webhooks 实时通知 |
| 分析仪表板 | Enhanced Transactions API + getTransactionsForAddress |
| 空投工具 | AirShip (使用 ZK 压缩便宜 95%) |
速查限制
速率限制取决于您的计划。代理以Agent级别开始,有1,000,000积分。Agent级别需要支付1美元以防止滥用。
| 计划 | 价格 | 每月积分 | RPC速率限制 | DAS & 增强API |
|---|
| Agent | $1 注册 | 1M | 10 请求/s | 2 请求/s |
| Developer | $49/月 | 10M | 50 请求/s | 10 请求/s |
| Business | $499/月 | 100M | 200 请求/s | 50 请求/s |
| Professional | $999/月 | 200M | 500 请求/s | 100 请求/s |
有关每个API的详细速率限制,请参见速率限制。
每次API调用的积分
| API | Credits | 备注 |
|---|
| Standard RPC calls | 1 | 大多数 Solana RPC 方法 |
getProgramAccounts | 10 | 尽可能使用 DAS API |
| DAS API | 10 | 所有 DAS 端点 |
| Enhanced Transactions | 100 | 解析的交易数据 |
getTransactionsForAddress | 10+ | 仅限 Developer+ 计划。完整交易每返回 100 条需 10 积分;仅签名响应固定为 10 积分。 |
getTransfersByAddress | 10 | 仅限 Developer+ 计划 |
| Wallet API | 100 | 所有 Wallet API 端点 |
| Priority Fee API | 1 | 费用估算 |
| Sender | 0 | 所有计划免费 |
| Webhook events | 1 | 每个事件传送 |
| Webhook management | 100 | 创建、编辑、删除 |
有关完整的明细,请参阅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');
}
监控信用使用情况
快速参考
- 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