Skip to main content
Helius предоставляет полноценную поддержку AI-агентов, создающих приложения в Solana. От программного создания учётных записей до потоковой передачи данных в реальном времени — агенты могут использовать все возможности Helius без ручного вмешательства.
  • Helius MCP — 10 маршрутизируемых инструментов для запросов к блокчейну, отправки транзакций, потоковой передачи данных и других задач
  • Плагин Claude Code — первый и пока единственный официальный плагин Claude Code от криптокомпании. Одна установка: серверы MCP + навыки + справочные файлы
  • Навыки — экспертные наборы инструкций для Claude: Build, Phantom, Jupiter, DFlow, OKX, SVM
  • SDK для TypeScript — типобезопасные методы для всех API Helius
  • SDK для Rust — высокопроизводительный SDK для Rust, предназначенный для API Helius
  • Helius CLI — управление учётными записями и создание сценариев оболочки
Машиночитаемая версия этого раздела для использования AI-агентами доступна по адресу agents/llms.txt.

MCP и CLI

Сервер Helius MCP — рекомендуемый способ взаимодействия AI-агентов с Helius. Он предоставляет 10 маршрутизируемых инструментов, которые обеспечивают AI прямой структурированный доступ к Solana без команд оболочки, анализа выходных данных и ручных вызовов API.
Начните с MCP. Если ваш AI-инструмент поддерживает MCP (Claude Code, Cursor, Claude Desktop и т. д.), используйте сервер MCP или плагин Claude Code. CLI удобен для сценариев оболочки и CI/CD, но MCP обеспечивает более цельный процесс для рабочих потоков на основе AI: AI вызывает инструменты напрямую, а не запускает команды оболочки и анализирует их выходные данные.

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

Агенты могут создать учётную запись Helius и получить ключ API с помощью Helius CLI:
Для каждой новой регистрации, включая тариф Agent, требуются адрес электронной почты, имя и фамилия. Кошелёк используется только для оплаты.
При успешном выполнении (--resume или --pay) агент получает ключ API, конечные точки RPC и 1 000 000 кредитов. Подробную информацию см. в полном руководстве по CLI.

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

Для всех запросов к API Helius необходимо передавать ключ API в качестве параметра запроса:
Добавляйте этот параметр к любой конечной точке RPC или API. Например: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Получите ключ API на панели управления Helius или программно через Helius CLI.
Используйте Gatekeeper для снижения задержки — Gatekeeper (бета) исключает Cloudflare из критического пути, сокращая время ответа на десятки или сотни миллисекунд. Тот же ключ API и те же методы — достаточно заменить конечную точку:
Поддерживает все методы RPC, DAS, WebSocket, ZK Compression, Priority Fee и Enhanced Transaction. Подробную информацию см. в руководстве по миграции.

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

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

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

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

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

Ограничения частоты запросов зависят от вашего тарифа. Агенты начинают с уровня Agent, включающего 1 000 000 кредитов. Для уровня Agent требуется единовременный платёж в размере 10 USDC, а для каждой новой регистрации необходимо указать адрес электронной почты, имя и фамилию.
Все цены, указанные в долларах, приведены в долларах США (USD).
Подробные ограничения частоты запросов для каждого API см. в разделе Ограничения частоты запросов.

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

Полную разбивку см. в разделе Кредиты.

Повторные попытки и обработка ошибок

Коды состояния HTTP

Схема повторных попыток

Отслеживание использования кредитов

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

  • 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
  • Статус: helius.statuspage.io