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

# Habilidad de Phantom

> Habilidad experta para crear aplicaciones frontend de Solana con Phantom Connect SDK y Helius: integración de billeteras, firma de transacciones, control de acceso mediante tokens y pagos.

La habilidad **Phantom** convierte a tu asistente de IA en un experto en la creación de aplicaciones frontend de Solana. Combina [Phantom Connect SDK](https://phantom.com) —integración de billeteras con React, React Native y JS puro— con la infraestructura de Helius para enviar transacciones, optimizar comisiones, consultar activos y recibir actualizaciones en tiempo real.

Una vez instalada, la IA lee automáticamente los archivos de referencia correctos y llama a las [herramientas de MCP](/docs/es/agents/mcp) adecuadas según lo que pidas. No necesitas seleccionar herramientas manualmente.

<Info>
  **Claude Code:** `/helius:phantom` (mediante el [plugin](/docs/es/agents/claude-code-plugin)) o invocación automática (independiente). **Codex:** `$helius-phantom` (descubierta automáticamente desde `.agents/skills/`). **API / Cursor / ChatGPT:** Usa las [variantes prediseñadas del prompt del sistema](/docs/es/agents/skills/overview#uso-de-habilidades-en-distintas-plataformas).
</Info>

## Qué incluye

La habilidad Phantom dirige a la IA entre los SDK de Phantom y las herramientas de Helius:

| Área                                     | Archivos de referencia                           | Herramientas de MCP utilizadas                              |
| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
| **Conexión de billetera — React**        | `react-sdk.md`                                   | —                                                           |
| **Conexión de billetera — Navegador**    | `browser-sdk.md`                                 | —                                                           |
| **Conexión de billetera — React Native** | `react-native-sdk.md`                            | —                                                           |
| **Transacciones**                        | `transactions.md`, `helius-sender.md`            | `getPriorityFeeEstimate`, `getSenderInfo`                   |
| **Control de acceso mediante tokens**    | `token-gating.md`, `helius-das.md`               | `getAssetsByOwner`, `searchAssets`, `getAsset`              |
| **Acuñación de NFT**                     | `nft-minting.md`, `helius-sender.md`             | `getAsset`, `getPriorityFeeEstimate`                        |
| **Pagos con criptomonedas**              | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate`               |
| **Seguridad del frontend**               | `frontend-security.md`                           | —                                                           |
| **Visualización del portafolio**         | `helius-das.md`, `helius-wallet-api.md`          | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **Actualizaciones en tiempo real**       | `helius-websockets.md`                           | `transactionSubscribe`, `accountSubscribe`                  |
| **Historial de transacciones**           | `helius-enhanced-transactions.md`                | `parseTransactions`, `getTransactionHistory`                |
| **Patrones de integración**              | `integration-patterns.md`                        | Varias (según el patrón)                                    |

## Reglas clave

La habilidad Phantom aplica patrones fundamentales que evitan errores comunes en el frontend:

* **Usa siempre `@phantom/react-sdk`** para React (nunca `window.phantom.solana` ni `@solana/wallet-adapter-react`)
* **Usa siempre `@phantom/browser-sdk`** para JS puro y **`@phantom/react-native-sdk`** para React Native
* **Nunca expongas las claves de API de Helius en el código del cliente** — solo `https://sender.helius-rpc.com/fast` es seguro para el navegador sin una clave de API
* **Canaliza todo lo demás mediante tu backend** — nunca abras WebSockets de Helius directamente desde el navegador
* **Envía siempre las transacciones mediante Helius Sender** con `skipPreflight: true`, `maxRetries: 0` y una propina de Jito
* **Usa la herramienta de MCP `getPriorityFeeEstimate`** — nunca codifiques de forma fija las comisiones de prioridad

## Patrones compuestos

La habilidad proporciona cinco patrones de referencia integrales para aplicaciones complejas:

1. **Interfaz de swap** — Agregador → firma de Phantom → envío mediante Helius Sender
2. **Visor de portafolio** — Conexión con Phantom → proxy del backend → API de DAS/Wallet
3. **Panel en tiempo real** — Conexión con Phantom → WebSocket del servidor → retransmisión al cliente
4. **Transferencia de tokens** — Crear VersionedTransaction → firma de Phantom → envío mediante Sender
5. **Galería de NFT** — Billetera Phantom → consulta de DAS mediante el backend → mostrar NFT

## Requisitos previos

Esta habilidad requiere el [servidor MCP de Helius](/docs/es/agents/mcp). Para las billeteras integradas (inicio de sesión con Google/Apple), también necesitas una cuenta de [Phantom Portal](https://phantom.com/portal) con un App ID y URL de redirección incluidas en la lista de permitidas.

Si realizas la instalación mediante el [plugin de Claude Code](/docs/es/agents/claude-code-plugin), el servidor MCP se inicia automáticamente. Para una instalación independiente, agrégalo manualmente:

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

## Instalación independiente

Si quieres usar la habilidad Phantom sin el plugin completo, instálala directamente:

<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
    ```

    Esto instala la habilidad y sus archivos de referencia en `~/.claude/skills/helius-phantom/`.

    **Opciones:**

    * `./install.sh --project` — instalar en el proyecto actual (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — instalar en un directorio personalizado
  </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
    ```

    También puedes usar la herramienta de MCP `setHeliusApiKey` dentro de Claude Code. Si necesitas una cuenta nueva, consulta [Helius CLI](/docs/es/agents/cli) o usa el flujo de registro autónomo mediante las [herramientas de MCP](/docs/es/agents/mcp).
  </Step>
</Steps>

## Ejemplos de prompts

Una vez instalada, pide lo que necesites en lenguaje natural:

* "Crea una interfaz de swap con la billetera Phantom"
* "Crea un visor de portafolio que muestre los tokens después de conectar Phantom"
* "¿Cómo canalizo mi clave de API de Helius mediante un proxy en Next.js?"
* "Crea un panel en tiempo real con conexión de billetera"
* "Agrega control de acceso mediante tokens a mi aplicación React usando Phantom"
* "Crea una página para acuñar NFT con Phantom y Metaplex Core"

La IA elige automáticamente las herramientas adecuadas y lee los archivos de referencia correctos.

## Qué incluye

La habilidad instala dos componentes:

* **`SKILL.md`** — Lógica de enrutamiento, reglas y contexto especializado que guían el comportamiento de la IA
* **`prompts/`** — Variantes prediseñadas del prompt del sistema (`openai.developer.md`, `claude.system.md`, `full.md`) — consulta la [configuración de la plataforma](/docs/es/agents/skills/overview#uso-de-habilidades-en-distintas-plataformas)
* **`references/`** — 16 archivos de documentación detallada:
  * `react-sdk.md` — SDK de Phantom para React (`@phantom/react-sdk`)
  * `browser-sdk.md` — SDK de Phantom para navegador (`@phantom/browser-sdk`)
  * `react-native-sdk.md` — SDK de Phantom para React Native (`@phantom/react-native-sdk`)
  * `transactions.md` — Patrones de firma de transacciones
  * `token-gating.md` — Control de acceso mediante tokens
  * `nft-minting.md` — Acuñación de NFT con Phantom
  * `payments.md` — Flujos de pago con criptomonedas
  * `frontend-security.md` — Uso de proxy para claves de API y CORS
  * `integration-patterns.md` — Patrones compuestos integrales
  * `helius-das.md` — Referencia de la API de DAS
  * `helius-sender.md` — Referencia de Sender
  * `helius-priority-fees.md` — Referencia de comisiones de prioridad
  * `helius-wallet-api.md` — Referencia de la API de Wallet
  * `helius-websockets.md` — Referencia de WebSocket
  * `helius-enhanced-transactions.md` — Referencia de Enhanced Transactions
  * `helius-onboarding.md` — Referencia de configuración de la cuenta

## Más información

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/es/agents/mcp">
    El servidor MCP que proporciona las herramientas de esta habilidad
  </Card>

  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/es/agents/claude-code-plugin">
    Instalación de MCP y habilidades con un solo clic
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/es/agents/skills/build">
    Desarrollo general en Solana con Helius
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    Código fuente y seguimiento de incidencias
  </Card>
</CardGroup>