> ## 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.

# Навык Phantom

> Экспертный навык для создания фронтенд-приложений Solana с помощью Phantom Connect SDK и Helius — интеграция кошелька, подписание транзакций, доступ по токенам и платежи.

Навык **Phantom** позволяет вашему ИИ-помощнику профессионально создавать фронтенд-приложения Solana. Он объединяет [Phantom Connect SDK](https://phantom.com) — интеграцию кошелька для React, React Native и чистого JS — с инфраструктурой Helius для отправки транзакций, оптимизации комиссий, запросов данных об активах и обновлений в реальном времени.

После установки ИИ автоматически читает нужные справочные файлы и вызывает соответствующие [инструменты MCP](/docs/ru/agents/mcp) в зависимости от вашего запроса — выбирать инструменты вручную не нужно.

<Info>
  **Claude Code:** `/helius:phantom` (через [плагин](/docs/ru/agents/claude-code-plugin)) или автоматический вызов (при автономной установке). **Codex:** `$helius-phantom` (автоматически обнаруживается в `.agents/skills/`). **API / Cursor / ChatGPT:** используйте готовые [варианты системных промптов](/docs/ru/agents/skills/overview#использование-навыков-на-разных-платформах).
</Info>

## Что охватывает навык

Навык Phantom направляет ИИ к соответствующим SDK Phantom и инструментам Helius:

| Область | Справочные файлы | Используемые инструменты MCP |
| - | - | - |
| **Подключение кошелька — React** | `react-sdk.md` | — |
| **Подключение кошелька — браузер** | `browser-sdk.md` | — |
| **Подключение кошелька — React Native** | `react-native-sdk.md` | — |
| **Транзакции** | `transactions.md`, `helius-sender.md` | `getPriorityFeeEstimate`, `getSenderInfo` |
| **Доступ по токенам** | `token-gating.md`, `helius-das.md` | `getAssetsByOwner`, `searchAssets`, `getAsset` |
| **Выпуск NFT** | `nft-minting.md`, `helius-sender.md` | `getAsset`, `getPriorityFeeEstimate` |
| **Криптовалютные платежи** | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate` |
| **Безопасность фронтенда** | `frontend-security.md` | — |
| **Отображение портфеля** | `helius-das.md`, `helius-wallet-api.md` | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **Обновления в реальном времени** | `helius-websockets.md` | `transactionSubscribe`, `accountSubscribe` |
| **История транзакций** | `helius-enhanced-transactions.md` | `parseTransactions`, `getTransactionHistory` |
| **Шаблоны интеграции** | `integration-patterns.md` | Несколько (в зависимости от шаблона) |

## Основные правила

Навык Phantom обеспечивает соблюдение критически важных шаблонов, которые предотвращают распространенные ошибки во фронтенде:

* **Всегда используйте `@phantom/react-sdk`** для React (никогда не используйте `window.phantom.solana` или `@solana/wallet-adapter-react`)
* **Всегда используйте `@phantom/browser-sdk`** для чистого JS и **`@phantom/react-native-sdk`** для React Native
* **Никогда не раскрывайте ключи API Helius в клиентском коде** — только `https://sender.helius-rpc.com/fast` можно безопасно использовать в браузере без ключа API
* **Проксируйте все остальное через свой бэкенд** — никогда не открывайте соединения Helius WebSocket непосредственно из браузера
* **Всегда отправляйте транзакции через Helius Sender** с `skipPreflight: true`, `maxRetries: 0` и чаевыми Jito
* **Используйте инструмент MCP `getPriorityFeeEstimate`** — никогда не задавайте приоритетные комиссии непосредственно в коде

## Составные шаблоны

Навык предоставляет пять сквозных справочных шаблонов для сложных приложений:

1. **Интерфейс обмена** — агрегатор → подписание через Phantom → отправка через Helius Sender
2. **Средство просмотра портфеля** — подключение Phantom → бэкенд-прокси → DAS/Wallet API
3. **Панель мониторинга в реальном времени** — подключение Phantom → серверный WebSocket → ретрансляция клиенту
4. **Перевод токенов** — создание VersionedTransaction → подписание через Phantom → отправка через Sender
5. **Галерея NFT** — кошелек Phantom → запрос DAS через бэкенд → отображение NFT

## Предварительные требования

Для этого навыка требуется [сервер Helius MCP](/docs/ru/agents/mcp). Для встроенных кошельков (вход через Google/Apple) также требуется учетная запись [Phantom Portal](https://phantom.com/portal) с идентификатором приложения и URL перенаправления, добавленными в список разрешенных.

Если вы устанавливаете навык через [плагин Claude Code](/docs/ru/agents/claude-code-plugin), сервер MCP запускается автоматически. При автономной установке добавьте его вручную:

```bash theme={"system"}
claude mcp add helius npx helius-mcp@latest
```

## Автономная установка

Если вам нужен навык Phantom без полного плагина, установите его напрямую:

<Steps>
  <Step title="Clone the repository">
    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills/helius-phantom
    ```
  </Step>

  <Step title="Run the install script">
    ```bash theme={"system"}
    ./install.sh
    ```

    Эта команда устанавливает навык и его справочные файлы в `~/.claude/skills/helius-phantom/`.

    **Параметры:**

    * `./install.sh --project` — установить в текущий проект (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — установить в указанный каталог
  </Step>

  <Step title="Install the Helius MCP server">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="Set your API key">
    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    Или используйте инструмент MCP `setHeliusApiKey` в Claude Code. Если вам нужна новая учетная запись, ознакомьтесь с [Helius CLI](/docs/ru/agents/cli) или воспользуйтесь автономным процессом регистрации через [инструменты MCP](/docs/ru/agents/mcp).
  </Step>
</Steps>

## Примеры запросов

После установки сформулируйте запрос на естественном языке:

* "Создай интерфейс обмена с кошельком Phantom"
* "Создай средство просмотра портфеля, которое показывает токены после подключения Phantom"
* "Как проксировать ключ API Helius в Next.js?"
* "Создай панель мониторинга в реальном времени с подключением кошелька"
* "Добавь в мое приложение React доступ по токенам с помощью Phantom"
* "Создай страницу выпуска NFT с помощью Phantom и Metaplex Core"

ИИ автоматически выбирает нужные инструменты и читает соответствующие справочные файлы.

## Что входит в комплект

Навык устанавливает два компонента:

* **`SKILL.md`** — логика маршрутизации, правила и экспертный контекст, определяющие поведение ИИ
* **`prompts/`** — готовые варианты системных промптов (`openai.developer.md`, `claude.system.md`, `full.md`) — см. [настройку платформы](/docs/ru/agents/skills/overview#использование-навыков-на-разных-платформах)
* **`references/`** — 16 файлов с подробной документацией:
  * `react-sdk.md` — Phantom React SDK (`@phantom/react-sdk`)
  * `browser-sdk.md` — Phantom Browser SDK (`@phantom/browser-sdk`)
  * `react-native-sdk.md` — Phantom React Native SDK (`@phantom/react-native-sdk`)
  * `transactions.md` — шаблоны подписания транзакций
  * `token-gating.md` — управление доступом по токенам
  * `nft-minting.md` — выпуск NFT с помощью Phantom
  * `payments.md` — процессы криптовалютных платежей
  * `frontend-security.md` — проксирование ключей API и CORS
  * `integration-patterns.md` — сквозные составные шаблоны
  * `helius-das.md` — справочник по DAS API
  * `helius-sender.md` — справочник по Sender
  * `helius-priority-fees.md` — справочник по приоритетным комиссиям
  * `helius-wallet-api.md` — справочник по Wallet API
  * `helius-websockets.md` — справочник по WebSocket
  * `helius-enhanced-transactions.md` — справочник по Enhanced Transactions
  * `helius-onboarding.md` — справочник по настройке учетной записи

## Подробнее

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/ru/agents/mcp">
    Сервер MCP, обеспечивающий работу инструментов этого навыка
  </Card>

  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/ru/agents/claude-code-plugin">
    Установка MCP и навыков одним щелчком
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/ru/agents/skills/build">
    Общая разработка для Solana с помощью Helius
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    Исходный код и отслеживание проблем
  </Card>
</CardGroup>


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