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

> Construa aplicativos frontend Solana com Phantom Connect SDK e infraestrutura Helius. Abrange integração SDK para React, React Native e navegador, assinatura de transações, token gating, mintagem de NFTs, pagamentos e arquitetura frontend segura.

A habilidade **Phantom** torna seu assistente de IA um especialista em construir aplicativos frontend Solana. Ela combina [Phantom Connect SDK](https://phantom.com) — integração de carteira para React, React Native e vanilla JS — com a infraestrutura Helius para submissão de transações, otimização de taxas, consultas de ativos e atualizações em tempo real.

Quando instalada, a IA lê automaticamente os arquivos de referência corretos e chama as [ferramentas MCP](/docs/pt-BR/agents/mcp) certas com base no que você pedir — sem a necessidade de seleção manual de ferramentas.

<Info>
  **Claude Code:** `/helius:phantom` (via [plugin](/docs/pt-BR/agents/claude-code-plugin)) ou invocado automaticamente (autônomo). **Codex:** `$helius-phantom` (descoberto automaticamente a partir de `.agents/skills/`). **API / Cursor / ChatGPT:** Use as [variantes de prompt de sistema](/docs/pt-BR/agents/skills/overview#using-skills-across-platforms) pré-construídas.
</Info>

## O que Cobre

A habilidade Phantom direciona a IA através dos SDKs Phantom e das ferramentas Helius:

| Domínio                                | Arquivos de Referência                           | Ferramentas MCP Usadas                                      |
| -------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
| **Conexão de Carteira — React**        | `react-sdk.md`                                   | —                                                           |
| **Conexão de Carteira — Navegador**    | `browser-sdk.md`                                 | —                                                           |
| **Conexão de Carteira — React Native** | `react-native-sdk.md`                            | —                                                           |
| **Transações**                         | `transactions.md`, `helius-sender.md`            | `getPriorityFeeEstimate`, `getSenderInfo`                   |
| **Token Gating**                       | `token-gating.md`, `helius-das.md`               | `getAssetsByOwner`, `searchAssets`, `getAsset`              |
| **Mintagem de NFT**                    | `nft-minting.md`, `helius-sender.md`             | `getAsset`, `getPriorityFeeEstimate`                        |
| **Pagamentos Cripto**                  | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate`               |
| **Segurança Frontend**                 | `frontend-security.md`                           | —                                                           |
| **Exibição de Portfólio**              | `helius-das.md`, `helius-wallet-api.md`          | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **Atualizações em Tempo Real**         | `helius-websockets.md`                           | `transactionSubscribe`, `accountSubscribe`                  |
| **Histórico de Transações**            | `helius-enhanced-transactions.md`                | `parseTransactions`, `getTransactionHistory`                |
| **Padrões de Integração**              | `integration-patterns.md`                        | Múltiplos (dependente do padrão)                            |

## Regras Principais

A habilidade Phantom aplica padrões críticos que previnem erros comuns no frontend:

* **Sempre use `@phantom/react-sdk`** para React (nunca `window.phantom.solana` ou `@solana/wallet-adapter-react`)
* **Sempre use `@phantom/browser-sdk`** para vanilla JS e **`@phantom/react-native-sdk`** para React Native
* **Nunca exponha chaves de API Helius no código do cliente** — apenas `https://sender.helius-rpc.com/fast` é seguro para o navegador sem uma chave de API
* **Faça proxy de tudo através do seu backend** — nunca abra WebSockets Helius diretamente do navegador
* **Sempre submeta transações via Helius Sender** com `skipPreflight: true`, `maxRetries: 0`, e uma dica Jito
* **Use o MCP tool `getPriorityFeeEstimate`** — nunca codifique fixamente as taxas de prioridade

## Padrões Compostos

A habilidade fornece cinco padrões de referência de ponta a ponta para aplicativos complexos:

1. **UI de Swap** — Agregador → Assinatura Phantom → Submissão Helius Sender
2. **Visualizador de Portfólio** — Conexão Phantom → proxy de backend → DAS/Wallet API
3. **Dashboard em Tempo Real** — Conexão Phantom → WebSocket do servidor → relé do cliente
4. **Transferência de Token** — Construir VersionedTransaction → Assinatura Phantom → Submissão Sender
5. **Galeria de NFT** — Carteira Phantom → consulta DAS de backend → exibir NFTs

## Pré-requisitos

Esta habilidade requer o [servidor Helius MCP](/docs/pt-BR/agents/mcp). Para carteiras embutidas (login Google/Apple), você também precisará de uma conta [Phantom Portal](https://phantom.com/portal) com um App ID e URLs de redirecionamento na lista de permissões.

Se você instalar via [plugin Claude Code](/docs/pt-BR/agents/claude-code-plugin), o servidor MCP inicia automaticamente. Para instalação autônoma, adicione manualmente:

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

## Instalação Autônoma

Se quiser a habilidade Phantom sem o plugin completo, instale diretamente:

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

  <Step title="Execute o script de instalação">
    ```bash theme={"system"}
    ./install.sh
    ```

    Isto instala a habilidade e seus arquivos de referência em `~/.claude/skills/helius-phantom/`.

    **Opções:**

    * `./install.sh --project` — instalar no projeto atual (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — instalar em um diretório personalizado
  </Step>

  <Step title="Instale o servidor Helius MCP">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="Configure sua chave de API">
    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    Ou use a ferramenta MCP `setHeliusApiKey` dentro do Claude Code. Se precisar de uma nova conta, veja [Helius CLI](/docs/pt-BR/agents/cli) ou use o fluxo de inscrição autônomo via [ferramentas MCP](/docs/pt-BR/agents/mcp).
  </Step>
</Steps>

## Exemplos de Prompts

Uma vez instalado, pergunte em inglês claro:

* "Construa uma UI de swap com a carteira Phantom"
* "Desenvolva um visualizador de portfólio que exiba tokens após conectar o Phantom"
* "Como faço para fazer proxy da minha chave de API Helius no Next.js?"
* "Desenvolva um dashboard em tempo real com conexão de carteira"
* "Adicione token gating ao meu aplicativo React usando Phantom"
* "Construa uma página de mintagem de NFT com Phantom e Metaplex Core"

A IA escolhe as ferramentas certas e lê os arquivos de referência corretos automaticamente.

## O que Está Incluído

A habilidade instala dois componentes:

* **`SKILL.md`** — Lógica de roteamento, regras e contexto especializado que guiam o comportamento da IA
* **`prompts/`** — Variantes de prompt de sistema pré-construídas (`openai.developer.md`, `claude.system.md`, `full.md`) — veja [configuração da plataforma](/docs/pt-BR/agents/skills/overview#using-skills-across-platforms)
* **`references/`** — 16 arquivos de documentação profunda:
  * `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` — Padrões de assinatura de transações
  * `token-gating.md` — Controle de acesso com token
  * `nft-minting.md` — Mintagem de NFT com Phantom
  * `payments.md` — Fluxos de pagamento cripto
  * `frontend-security.md` — Proxy de chave de API e CORS
  * `integration-patterns.md` — Padrões compostos de ponta a ponta
  * `helius-das.md` — Referência da API DAS
  * `helius-sender.md` — Referência do sender
  * `helius-priority-fees.md` — Referência de taxa prioritária
  * `helius-wallet-api.md` — Referência da API de carteira
  * `helius-websockets.md` — Referência de WebSocket
  * `helius-enhanced-transactions.md` — Referência de Transações Avançadas
  * `helius-onboarding.md` — Referência de configuração de conta

## Saiba Mais

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/pt-BR/agents/mcp">
    O servidor MCP que alimenta as ferramentas desta habilidade
  </Card>

  <Card title="Plugin Claude Code" icon="puzzle-piece" href="/docs/pt-BR/agents/claude-code-plugin">
    Instalação com um clique do MCP + habilidades
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/pt-BR/agents/skills/build">
    Desenvolvimento geral Solana com Helius
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    Código fonte e rastreamento de problemas
  </Card>
</CardGroup>