> ## 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 给代理商

> AI 代理的所有需求在使用 Helius 建立 Solana：程序化注册、API 访问、SDK、MCP 集成和推荐工作流程。

Helius 为在 Solana 上构建的 AI 代理提供一流支持。从程序化帐户创建到实时数据流，代理可以在无需人工干预的情况下访问 Helius 的全部功能。

* [Helius MCP](/zh/agents/mcp) — 包含 10 个路由工具，可用于查询区块链、发送交易、流媒体等
* [Claude Code Plugin](/zh/agents/claude-code-plugin) — 第一个，也是目前唯一，一个来自加密公司的官方 Claude Code 插件。一次安装：MCP 服务器 + 技能 + 参考文件
* [Skills](/zh/agents/skills/overview) — Claude 的专家指令集：[Build](/zh/agents/skills/build)、[Phantom](/zh/agents/skills/phantom)、[Jupiter](/zh/agents/skills/jupiter)、[DFlow](/zh/agents/skills/dflow)、[OKX](/zh/agents/skills/okx)、[SVM](/zh/agents/skills/svm)
* [TypeScript SDK](/zh/agents/typescript-sdk) — 为所有 Helius API 提供类型安全的方法
* [Rust SDK](/zh/agents/rust-sdk) — 高性能的 Rust SDK，用于 Helius API
* [Helius CLI](/zh/agents/cli) — 账户管理和脚本编写

<Note>
  本节的机器可读版本可在 [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) 获得，以供 AI 代理使用。
</Note>

## MCP vs CLI

[Helius MCP服务器](/zh/agents/mcp) 是AI代理与Helius交互的推荐方式。它提供了10个路由工具，为AI提供直接、结构化的Solana访问——无需shell命令、无需输出解析、无需手动API调用。

|          | [MCP](/zh/agents/mcp)                                                                            | [CLI](/zh/agents/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的工具时        |

<Tip>
  **从MCP开始。** 如果您的AI工具支持MCP（Claude Code, Cursor, Claude Desktop等），请使用[MCP服务器](/zh/agents/mcp)或[Claude Code Plugin](/zh/agents/claude-code-plugin)。CLI对shell脚本和CI/CD非常有用，但对于AI驱动的工作流程，MCP提供了更无缝的体验——AI直接调用工具，而不是生成shell命令并解析输出。
</Tip>

## 快速入门：代理注册

代理可以使用 [Helius CLI](/zh/agents/cli) 通过四个步骤创建一个 Helius 账户并获取一个 API 密钥：

```bash theme={"system"}
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 指南](/zh/agents/cli)。

## 认证

所有 Helius API 请求都需要将 API 密钥作为查询参数传递：

```
?api-key=YOUR_API_KEY
```

将此附加到任何 RPC 或 API 端点。例如：`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

从 [Helius 仪表板](https://dashboard.helius.dev) 或通过 [Helius CLI](/zh/agents/cli) 编程获取一个 API 密钥。

<Tip>
  **使用 Gatekeeper 以降低延迟** — [Gatekeeper (Beta)](/zh/gatekeeper/overview) 从关键路径中移除 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 压缩、优先费用和增强型事务方法。详情请参阅 [迁移指南](/zh/gatekeeper/migration-guide)。
</Tip>

## Helius 特定 API 指南

使用这些 Helius 优化的 API 代替链接标准 Solana RPC 方法：

| 而不是...                                       | 使用这个                                                                                                                | 原因                                                 |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| `getSignaturesForAddress` + `getTransaction` | [`getTransactionsForAddress`](/zh/rpc/gettransactionsforaddress)                                                    | 单次调用返回完整交易历史及代币账户数据                                |
| `getTokenAccountsByOwner`                    | [`getAssetsByOwner`](/zh/api-reference/das/getassetsbyowner) (DAS API)                                              | 返回丰富的元数据，而不仅仅是原始账户                                 |
| `getRecentPrioritizationFees`                | [`getPriorityFeeEstimate`](/zh/api-reference/priority-fee/getpriorityfeeestimate)                                   | 预计算的最佳费用，无需手动计算                                    |
| `getSignaturesForAddress` (对于 cNFT)          | [`getSignaturesForAsset`](/zh/api-reference/das/getsignaturesforasset) (DAS API)                                    | 标准 RPC 不适用于压缩 NFT                                  |
| `getProgramAccounts` (用于 NFT 搜索)             | [`searchAssets`](/zh/api-reference/das/searchassets) 或 [`getAssetsByGroup`](/zh/api-reference/das/getassetsbygroup) | 更快、更便宜、索引数据                                        |
| 轮询实时数据                                       | [LaserStream WebSocket](/zh/rpc/websocket) 或 [LaserStream gRPC](/zh/laserstream)                                    | 更低的延迟，更高效                                          |
| 标准 `sendTransaction`                         | [Helius Sender](/zh/sending-transactions/sender)                                                                    | 多路径路由 (Helius, Jito, Harmonic, Rakurai, 等等)，更高的着陆率 |

## 推荐工作流程

| 构建...   | 使用的 Helius 产品                                                                                                                                                                            |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 交易机器人   | [Gatekeeper](/zh/gatekeeper/overview) (最低延迟 RPC) + [Sender](/zh/sending-transactions/sender) (快速交易提交) + [Priority Fee API](/zh/priority-fee-api) + [LaserStream](/zh/laserstream) (实时价格) |
| 钱包应用    | [DAS API](/zh/das-api) (`getAssetsByOwner`) + [`getTransactionsForAddress`](/zh/rpc/gettransactionsforaddress) (完整历史)                                                                    |
| NFT 市场  | [DAS API](/zh/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhooks](/zh/webhooks) (跟踪销售/上市)                                                                                         |
| 代币狙击手   | [Gatekeeper](/zh/gatekeeper/overview) (边缘路由的 RPC) + [LaserStream gRPC](/zh/laserstream) (最低延迟) + [Sender](/zh/sending-transactions/sender) (质押连接)                                        |
| 投资组合追踪器 | [DAS API](/zh/das-api) (`getAssetsByOwner` 与 `showFungible`) + [Enhanced Transactions](/zh/enhanced-transactions/overview)                                                               |
| 钱包监控器   | [LaserStream WebSocket](/zh/rpc/websocket) 或 [Webhooks](/zh/webhooks) 用于实时通知                                                                                                             |
| 分析仪表板   | [Enhanced Transactions API](/zh/enhanced-transactions/overview) + [`getTransactionsForAddress`](/zh/rpc/gettransactionsforaddress)                                                       |
| 空投工具    | [AirShip](https://airship.helius.dev) (使用 ZK 压缩便宜 95%)                                                                                                                                   |

## 速查限制

速率限制取决于您的[计划](/zh/billing/plans)。代理以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的详细速率限制，请参见[速率限制](/zh/billing/rate-limits)。

## 每次API调用的积分

| API                         | 积分  | 备注                                      |
| --------------------------- | --- | --------------------------------------- |
| 标准 RPC 调用                   | 1   | 大多数 Solana RPC 方法                       |
| `getProgramAccounts`        | 10  | 尽可能使用 DAS API                           |
| DAS API                     | 10  | 所有 DAS 端点                               |
| 增强交易                        | 100 | 解析的交易数据                                 |
| `getTransactionsForAddress` | 10+ | 完整交易每返回 100 个需花费 10 积分；仅签名响应固定花费 10 积分。 |
| `getTransfersByAddress`     | 10  | 仅限 Developer+ 计划                        |
| 钱包 API                      | 100 | 所有钱包 API 端点                             |
| 优先费 API                     | 1   | 费用估算                                    |
| 发送者                         | 0   | 所有计划免费                                  |
| Webhook 事件                  | 1   | 每个事件的传递                                 |
| Webhook 管理                  | 100 | 创建、编辑、删除                                |

有关完整的明细，请参阅[Credits](/zh/billing/credits)。

## 重试和错误处理

### HTTP 状态码

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

### 重试模式

```typescript theme={"system"}
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');
}
```

### 监控信用使用情况

```bash theme={"system"}
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](https://dashboard.helius.dev)
* **状态**: [helius.statuspage.io](https://helius.statuspage.io)