> ## 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 CLI
> Интерфейс командной строки Helius с более чем 95 командами для управления учетными записями, выполнения запросов к Solana, отправки транзакций, работы с вебхуками и потоковой передачей данных, а также автоматизации стейкинга.
[Helius CLI](https://www.npmjs.com/package/helius-cli) — это полнофункциональный интерфейс командной строки для платформы Helius. Он предоставляет более 95 команд для управления учетными записями, выполнения запросов к данным блокчейна, отправки транзакций, работы с вебхуками, потоковой передачи данных в реальном времени, стейкинга, ZK Compression и других задач. Каждая команда поддерживает вывод в машиночитаемом формате JSON.
**Используете инструмент ИИ, совместимый с MCP?** [Сервер Helius MCP](/docs/ru/agents/mcp) — рекомендуемый способ взаимодействия ИИ-агентов с Helius. Он предоставляет 10 маршрутизируемых инструментов со структурированными входными и выходными данными, включая встроенную регистрацию учетной записи. Используйте CLI для сценариев оболочки, конвейеров CI/CD или когда MCP недоступен.
## Установка
```bash theme={"system"}
npm install -g helius-cli
```
## Быстрый старт — существующие пользователи
Если у вас уже есть ключ API Helius, просто укажите его и приступайте к работе:
```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```
Получите ключ на странице [dashboard.helius.dev](https://dashboard.helius.dev). Готово — пропустите описанные ниже шаги регистрации.
## Быстрый старт — новые пользователи
Для вызовов `helius signup`, создающих учетную запись, необходимо указать `--email`, `--first-name` и `--last-name` — в том числе для плана Agent. Кошелек используется только для оплаты и не заменяет ваши контактные данные. Для `helius signup --resume`, завершающего существующую регистрацию после оплаты по размещенной платежной ссылке, другие флаги не нужны.
```bash theme={"system"}
helius keygen
```
Вывод:
```
✓ Keypair generated
Path: ~/.helius/keypair.json
Address: 7xKp...3nQm
To use this wallet, fund it with:
- ~0.001 SOL for transaction fees
- USDC for your chosen plan:
agent $10 (one-time)
developer $49/mo
business $499/mo
professional $999/mo
Then run: helius signup --email --first-name --last-name
Options: --plan --period monthly|yearly --coupon --pay
```
Приведенная выше подсказка о пополнении применима только при использовании автоматической оплаты. Не пополняйте баланс, если планируете заплатить по размещенной платежной ссылке.
Доступны два способа оплаты: размещенная платежная ссылка (можно заплатить с любого кошелька, пополнять баланс не нужно) или автоматическая оплата (оплата в USDC с локальной пары ключей, на которой должно быть около 0,001 SOL и сумма, соответствующая плану).
```bash theme={"system"}
# Default: print a hosted payment link, pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe
# After paying via link, finalize the account
helius signup --resume
# Or autopay from the local keypair
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
```
```bash theme={"system"}
helius projects
helius apikeys
helius rpc
```
Ключ API — это конфиденциальная информация, предоставляющая доступ к вашей учетной записи Helius. Никогда не раскрывайте его в клиентском коде, общедоступных репозиториях или доступных из браузера областях.
## Планы и цены
Вы можете приобрести любой общий план Helius непосредственно через CLI. Передайте `--plan` при регистрации или используйте `helius upgrade` позже:
Все цены, указанные в долларах, приведены в долларах США (USD).
| План | Цена | Кредиты | Значение `--plan` |
| - | - | - | - |
| Agent | \$10 единоразово | 1 000 000 | `agent` |
| Developer | \$49/мес. | 10 000 000 | `developer` |
| Business | \$499/мес. | 100 000 000 | `business` |
| Professional | \$999/мес. | 200 000 000 | `professional` |
План **Agent** (`agent`) используется по умолчанию. Он стоит \$10 (оплата в USDC), что позволяет предотвратить злоупотребления, и предоставляет 1 000 000 кредитов. Чтобы получить более высокие ограничения частоты запросов и больше кредитов, зарегистрируйтесь с платным планом или перейдите на него позже.
### Регистрация с определенным планом
```bash theme={"system"}
# Default: Agent plan ($10)
helius signup --email you@example.com --first-name Jane --last-name Doe
# Developer plan ($49/mo)
helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe
# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe
```
### Повышение уровня плана существующей учетной записи
```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```
### Оплата продления
Когда наступает срок продления подписки (ежемесячной или ежегодной), Helius создает **платежное намерение** — ожидающий платеж с уникальным идентификатором, суммой и сроком действия. Идентификатор платежного намерения будет отправлен вам по электронной почте или появится на [панели управления](https://dashboard.helius.dev).
```bash theme={"system"}
helius pay
```
Команда получает сведения о платежном намерении, показывает сумму и срок действия, запрашивает подтверждение, а затем отправляет платеж в USDC из кошелька вашей пары ключей.
## Справочник команд
CLI предоставляет более 95 команд в 14 категориях. Каждая команда поддерживает `--json` для машиночитаемого вывода и глобальные переопределения `--api-key ` / `--network `.
Все более 95 команд: управление учетными записями, запросы к блокчейну, DAS API, кошельки, вебхуки, отправка транзакций, WebSocket, стейкинг, ZK Compression и многое другое
## Режим вывода JSON
Добавьте `--json` к любой команде, чтобы получить машиночитаемый вывод:
```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```
Пример:
```json theme={"system"}
{
"projects": [
{
"id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
"name": "My Project",
"plan": "free"
}
]
}
```
## Коды завершения
Для надежной автоматизации агенты должны проверять коды завершения:
| Код | Значение |
| - | - |
| 0 | Успешное выполнение |
| 1 | Общая ошибка |
| 10 | Вход не выполнен |
| 11 | Пара ключей не найдена |
| 20 | Недостаточно SOL |
| 21 | Недостаточно USDC |
| 30 | Проекты не найдены |
| 31 | Проект не найден |
| 40 | Ошибка API |
## Конфигурация
Конфигурация хранится в `~/.helius/`:
```
~/.helius/
├── config.json # JWT token, API key, network, default project
└── keypair.json # Solana keypair (if generated with keygen)
```
Управляйте конфигурацией с помощью:
```bash theme={"system"}
helius config show # View current config
helius config set-api-key # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project # Set default project
helius config clear # Reset everything
```
### Порядок определения ключа API
Ключи API определяются в следующем порядке:
1. Флаг `--api-key ` (переопределение для отдельной команды)
2. Переменная среды `HELIUS_API_KEY`
3. `~/.helius/config.json` (задается через `helius config set-api-key`)
## Глобальные параметры
Все команды принимают следующие флаги:
| Флаг | Описание |
| - | - |
| `--api-key ` | Переопределить настроенный ключ API |
| `--network ` | Переопределить сеть (`mainnet` или `devnet`) |
| `--json` | Вывести данные в формате JSON |
| `-k, --keypair ` | Путь к файлу пары ключей (для команд, требующих подписи) |
## Полный рабочий процесс агента
```bash theme={"system"}
# Step 1: Generate keypair
helius keygen
# Step 2: Create account (default: hosted payment link, pay from any wallet)
helius signup --email you@example.com --first-name Jane --last-name Doe
helius signup --resume # Finalize after paying via link
# Or autopay from the local keypair (requires ~0.001 SOL + plan USDC):
# helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
# Step 3: Get API keys
helius projects
helius apikeys
# Step 4: Get RPC endpoints
helius rpc
# Step 5: Start querying
helius balance
helius asset owner
helius tx history --limit 10
```
## Следующие шаги
Рекомендации по работе с API, рабочие процессы и обработка ошибок для агентов
Подключайте инструменты ИИ напрямую к API Helius
Изучите планы Helius и варианты повышения их уровня
Отслеживайте использование API и управляйте ключами
## Поддержка
Присоединяйтесь к нашему сообществу в Discord, чтобы получать помощь в реальном времени и поддержку сообщества
Свяжитесь напрямую с нашей службой поддержки
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.