> ## 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-агентам для разработки в Solana с помощью Helius: программная регистрация, доступ к API, SDK, интеграция с MCP и рекомендуемые рабочие процессы.

Helius предоставляет полноценную поддержку AI-агентов, создающих приложения в Solana. От программного создания учётных записей до потоковой передачи данных в реальном времени — агенты могут использовать все возможности Helius без ручного вмешательства.

* [Helius MCP](/docs/ru/agents/mcp) — 10 маршрутизируемых инструментов для запросов к блокчейну, отправки транзакций, потоковой передачи данных и других задач
* [Плагин Claude Code](/docs/ru/agents/claude-code-plugin) — первый и пока единственный официальный плагин Claude Code от криптокомпании. Одна установка: серверы MCP + навыки + справочные файлы
* [Навыки](/docs/ru/agents/skills/overview) — экспертные наборы инструкций для Claude: [Build](/docs/ru/agents/skills/build), [Phantom](/docs/ru/agents/skills/phantom), [Jupiter](/docs/ru/agents/skills/jupiter), [DFlow](/docs/ru/agents/skills/dflow), [OKX](/docs/ru/agents/skills/okx), [SVM](/docs/ru/agents/skills/svm)
* [SDK для TypeScript](/docs/ru/agents/typescript-sdk) — типобезопасные методы для всех API Helius
* [SDK для Rust](/docs/ru/agents/rust-sdk) — высокопроизводительный SDK для Rust, предназначенный для API Helius
* [Helius CLI](/docs/ru/agents/cli) — управление учётными записями и создание сценариев оболочки

<Note>
  Машиночитаемая версия этого раздела для использования AI-агентами доступна по адресу [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt).
</Note>

## MCP и CLI

[Сервер Helius MCP](/docs/ru/agents/mcp) — рекомендуемый способ взаимодействия AI-агентов с Helius. Он предоставляет 10 маршрутизируемых инструментов, которые обеспечивают AI прямой структурированный доступ к Solana без команд оболочки, анализа выходных данных и ручных вызовов API.

| | [MCP](/docs/ru/agents/mcp) | [CLI](/docs/ru/agents/cli) |
| - | - | - |
| **Лучше всего подходит для** | AI-агентов в Claude Code, Cursor, Claude Desktop и любых инструментах с поддержкой MCP | Сценариев оболочки, конвейеров CI/CD и рабочих процессов в терминале |
| **Интерфейс** | Структурированные вызовы инструментов с типизированными входными и выходными данными | Командная строка с выходными данными `--json` |
| **Возможности** | 10 маршрутизируемых инструментов (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) для запросов к блокчейну, транзакций, вебхуков, потоковой передачи данных, анализа кошельков, документации и регистрации | Более 95 команд: те же возможности, а также управление конфигурацией и интерактивные процессы |
| **Настройка учётной записи** | Встроенная: действия `heliusAccount` `generateKeypair` → `signup` (ссылка или автоматическая оплата) — внешние инструменты не требуются | `helius keygen` → `helius signup` |
| **Когда использовать** | Вариант по умолчанию для любого AI-агента | Когда нужна автоматизация на уровне оболочки или вы не используете инструмент с поддержкой MCP |

<Tip>
  **Начните с MCP.** Если ваш AI-инструмент поддерживает MCP (Claude Code, Cursor, Claude Desktop и т. д.), используйте [сервер MCP](/docs/ru/agents/mcp) или [плагин Claude Code](/docs/ru/agents/claude-code-plugin). CLI удобен для сценариев оболочки и CI/CD, но MCP обеспечивает более цельный процесс для рабочих потоков на основе AI: AI вызывает инструменты напрямую, а не запускает команды оболочки и анализирует их выходные данные.
</Tip>

## Быстрый старт: регистрация агента

Агенты могут создать учётную запись Helius и получить ключ API с помощью [Helius CLI](/docs/ru/agents/cli):

<Note>
  Для каждой новой регистрации, включая тариф Agent, требуются адрес электронной почты, имя и фамилия. Кошелёк используется только для оплаты.
</Note>

```bash theme={"system"}
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair

# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json

# After paying via the link, finalize the account
helius signup --resume --json

# Or autopay: fund the keypair with the plan amount in USDC ($10 for Agent) + ~0.001 SOL, then
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json
```

При успешном выполнении (`--resume` или `--pay`) агент получает ключ API, конечные точки RPC и 1 000 000 кредитов. Подробную информацию см. в [полном руководстве по CLI](/docs/ru/agents/cli).

## Аутентификация

Для всех запросов к API Helius необходимо передавать ключ API в качестве параметра запроса:

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

Добавляйте этот параметр к любой конечной точке RPC или API. Например: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

Получите ключ API на [панели управления Helius](https://dashboard.helius.dev) или программно через [Helius CLI](/docs/ru/agents/cli).

<Tip>
  **Используйте Gatekeeper для снижения задержки** — [Gatekeeper (бета)](/docs/ru/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 Compression, Priority Fee и Enhanced Transaction. Подробную информацию см. в [руководстве по миграции](/docs/ru/gatekeeper/migration-guide).
</Tip>

## Рекомендации по API Helius

Используйте эти оптимизированные для Helius API вместо последовательного вызова стандартных методов Solana RPC:

| Если вам нужны... | Используйте | Почему |
| - | - | - |
| Отфильтрованная история, загрузка прошлых данных или активность токен-аккаунта | [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress) | Фильтры и пагинация; используйте `transactionDetails: "full"`, только если нужны необработанные объекты транзакций и метаданных (по умолчанию `filters.tokenAccounts` имеет значение `none`) |
| Активность кошелька с изменениями баланса по каждой транзакции | [История Wallet API](/docs/ru/wallet-api/history) (бета) | REST-ответ, ориентированный на кошелёк, — он не эквивалентен отфильтрованной загрузке прошлых данных GTFA или необработанным полным объектам транзакций |
| Записи о переводах SOL или токенов | [`getTransfersByAddress`](/docs/ru/rpc/gettransfersbyaddress) | Нормализованные переводы, а не полные объекты транзакций |
| Новая проанализированная история в удобном для чтения формате | [Проанализированные события](/docs/ru/parsed-events) | Предпочтительнее устаревших [Enhanced Transactions](/docs/ru/enhanced-transactions/overview); GTFA не использует формат ответа Enhanced |
| Подробные метаданные активов кошелька | [`getAssetsByOwner`](/docs/ru/api-reference/das/getassetsbyowner) (DAS API) | Возвращает подробные метаданные, а не только необработанные токен-аккаунты; для взаимозаменяемых активов SPL/Token-2022 требуется параметр `showFungible`, специфичный для этого метода |
| Оценки приоритетной комиссии | [`getPriorityFeeEstimate`](/docs/ru/api-reference/priority-fee/getpriorityfeeestimate) | Предварительно рассчитанные оптимальные комиссии без ручных вычислений |
| История транзакций со сжатыми NFT | [`getSignaturesForAsset`](/docs/ru/api-reference/das/getsignaturesforasset) (DAS API) | Стандартный RPC на основе адресов не включает историю сжатых NFT |
| Поиск NFT | [`searchAssets`](/docs/ru/api-reference/das/searchassets) или [`getAssetsByGroup`](/docs/ru/api-reference/das/getassetsbygroup) | Более быстрые, дешёвые и индексированные данные |
| Данные в реальном времени | [LaserStream WebSocket](/docs/ru/rpc/websocket), [LaserStream gRPC](/docs/ru/laserstream) или [вебхуки](/docs/ru/webhooks) | Постоянные потоки или обратные вызовы HTTP без опроса |
| Высокопроизводительная серверная потоковая передача с повторным воспроизведением | [Подписка LaserStream gRPC](/docs/ru/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`) | WSS для браузера или пользовательского интерфейса использует LaserStream WebSocket; MCP `laserstreamSubscribe` только создаёт конфигурацию и примеры — он не открывает поток в реальном времени |
| Отправка транзакций с низкой задержкой | [Helius Sender](/docs/ru/sending-transactions/sender) | Многоканальная маршрутизация (Helius, Jito, Harmonic, Rakurai и т. д.) и более высокая доля успешно включённых транзакций |

## Рекомендуемые рабочие процессы

| Что вы создаёте... | Какие продукты Helius использовать |
| - | - |
| Торговый бот | [Gatekeeper](/docs/ru/gatekeeper/overview) (RPC с минимальной задержкой) + [Sender](/docs/ru/sending-transactions/sender) (быстрая отправка транзакций) + [Priority Fee API](/docs/ru/priority-fee-api) + [LaserStream](/docs/ru/laserstream) (цены в реальном времени) |
| Приложение-кошелёк | [DAS API](/docs/ru/das-api) для данных о владении активами и метаданных + [история Wallet API](/docs/ru/wallet-api/history) (бета-версия данных об активности с изменениями баланса) или [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress) для отфильтрованной истории, загрузки прошлых данных, активности токен-аккаунта или необработанных полных объектов транзакций |
| Маркетплейс NFT | [DAS API](/docs/ru/das-api) (`searchAssets`, `getAssetsByGroup`) + [вебхуки](/docs/ru/webhooks) (отслеживание продаж и объявлений) |
| Снайпер токенов | [Gatekeeper](/docs/ru/gatekeeper/overview) (RPC с пограничной маршрутизацией) + [LaserStream gRPC](/docs/ru/laserstream) (минимальная задержка) + [Sender](/docs/ru/sending-transactions/sender) (стейкинговые подключения) |
| Трекер портфеля | [Балансы Wallet API](/docs/ru/wallet-api/balances) (сводки портфеля, бета) + [DAS API](/docs/ru/das-api) (`getAssetsByOwner` с параметром `showFungible`, специфичным для метода) для инвентаризации NFT и метаданных |
| Мониторинг кошелька | [LaserStream WebSocket](/docs/ru/rpc/websocket) или [вебхуки](/docs/ru/webhooks) для уведомлений в реальном времени |
| Аналитическая панель | [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress) для отфильтрованной загрузки прошлых данных; [проанализированные события](/docs/ru/parsed-events) для новых интеграций с проанализированными данными; [Enhanced Transactions](/docs/ru/enhanced-transactions/overview) только для существующих интеграций с проанализированными данными |
| Инструмент для аирдропов | [AirShip](https://airship.helius.dev) (на 95% дешевле благодаря ZK-сжатию) |

<Note>
  При использовании [балансов Wallet API](/docs/ru/wallet-api/balances) для сводок портфеля учитывайте следующее: API находится в бета-версии; количество токенов ограничено 100 на страницу; NFT исключены, если не указан `showNfts=true` (не более 100 NFT и только на первой странице); `pricePerToken` и `usdValue` могут иметь значение null; цены представляют собой почасовые оценки, а не рыночные цены в реальном времени; `totalUsdValue` относится к текущей странице, а не ко всему портфелю с пагинацией; каждый запрос стоит 100 кредитов. Для получения полного списка NFT и их метаданных используйте DAS с пагинацией — не рассматривайте Balances как полный список NFT.
</Note>

## Краткий справочник по ограничениям частоты запросов

Ограничения частоты запросов зависят от вашего [тарифа](/docs/ru/billing/plans). Агенты начинают с уровня Agent, включающего 1 000 000 кредитов. Для уровня Agent требуется единовременный платёж в размере 10 USDC, а для каждой новой регистрации необходимо указать адрес электронной почты, имя и фамилию.

<Note>Все цены, указанные в долларах, приведены в долларах США (USD).</Note>

| Тариф | Цена | Кредитов в месяц | Ограничение частоты запросов RPC | DAS и Enhanced API |
| - | - | - | - | - |
| Agent | \$10 единовременно | 1 млн | 10 запросов/с | 2 запроса/с |
| Developer | \$49/мес. | 10 млн | 50 запросов/с | 10 запросов/с |
| Business | \$499/мес. | 100 млн | 200 запросов/с | 50 запросов/с |
| Professional | \$999/мес. | 200 млн | 500 запросов/с | 100 запросов/с |

Подробные ограничения частоты запросов для каждого API см. в разделе [Ограничения частоты запросов](/docs/ru/billing/rate-limits).

## Количество кредитов за вызов API

| API | Кредиты | Примечания |
| - | - | - |
| Стандартные вызовы RPC | 1 | Большинство методов Solana RPC |
| `getProgramAccounts` | 10 | По возможности используйте вместо него DAS API |
| DAS API | 10 | Все конечные точки DAS |
| Enhanced Transactions | 100 | Проанализированные данные транзакций |
| `getTransactionsForAddress` | 10+ | Полные транзакции стоят 10 кредитов за каждые 100 возвращённых записей; ответы только с подписями стоят фиксированные 10 кредитов. |
| `getTransfersByAddress` | 10 | Только для тарифов Developer и выше |
| Wallet API | 100 | Все конечные точки Wallet API |
| Priority Fee API | 1 | Оценка комиссии |
| Sender | 0 | Бесплатно на всех тарифах |
| События вебхуков | 1 | За каждое доставленное событие |
| Управление вебхуками | 100 | Создание, изменение, удаление |

Полную разбивку см. в разделе [Кредиты](/docs/ru/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
```

## Краткий справочник

* **RPC основной сети**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC основной сети (Gatekeeper, бета)**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC тестовой сети**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS основной сети**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS основной сети (Gatekeeper, бета)**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS тестовой сети**: `wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Конечная точка Sender**: `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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.