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

> Compétence experte pour créer des applications frontend Solana avec le Phantom Connect SDK et Helius — intégration de portefeuille, signature de transaction, limitation de jeton et paiements.

La compétence **Phantom** rend votre assistant IA expert dans la création d'applications frontend Solana. Elle combine [Phantom Connect SDK](https://phantom.com) — intégration de portefeuille React, React Native et JS vanilla — avec l'infrastructure Helius pour la soumission de transactions, l'optimisation des frais, les requêtes d'actifs et les mises à jour en temps réel.

Lorsqu'elle est installée, l'IA lit automatiquement les fichiers de référence appropriés et appelle les bons [outils MCP](/docs/fr/agents/mcp) en fonction de votre demande — pas besoin de sélection manuelle d'outil.

<Info>
  **Claude Code :** `/helius:phantom` (via [plugin](/docs/fr/agents/claude-code-plugin)) ou invoqué automatiquement (autonome). **Codex :** `$helius-phantom` (découvert automatiquement depuis `.agents/skills/`). **API / Cursor / ChatGPT :** Utilisez les [variantes de prompts système](/docs/fr/agents/skills/overview#utilisation-des-compétences-sur-diverses-plateformes) préconstruites.
</Info>

## Ce que cela couvre

La compétence Phantom dirige l'IA à travers à la fois les SDK Phantom et les outils Helius :

| Domaine                                      | Fichiers de référence                            | Outils MCP Utilisés                                         |
| -------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
| **Connexion de Portefeuille — React**        | `react-sdk.md`                                   | —                                                           |
| **Connexion de Portefeuille — Navigateur**   | `browser-sdk.md`                                 | —                                                           |
| **Connexion de Portefeuille — React Native** | `react-native-sdk.md`                            | —                                                           |
| **Transactions**                             | `transactions.md`, `helius-sender.md`            | `getPriorityFeeEstimate`, `getSenderInfo`                   |
| **Limitation de Jeton**                      | `token-gating.md`, `helius-das.md`               | `getAssetsByOwner`, `searchAssets`, `getAsset`              |
| **Minting NFT**                              | `nft-minting.md`, `helius-sender.md`             | `getAsset`, `getPriorityFeeEstimate`                        |
| **Paiements Crypto**                         | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate`               |
| **Sécurité Frontend**                        | `frontend-security.md`                           | —                                                           |
| **Affichage de Portefeuille**                | `helius-das.md`, `helius-wallet-api.md`          | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **Mises à jour en temps réel**               | `helius-websockets.md`                           | `transactionSubscribe`, `accountSubscribe`                  |
| **Historique des Transactions**              | `helius-enhanced-transactions.md`                | `parseTransactions`, `getTransactionHistory`                |
| **Schémas d'Intégration**                    | `integration-patterns.md`                        | Multiple (dépend du schéma)                                 |

## Règles Clés

La compétence Phantom impose des schémas critiques qui préviennent les erreurs courantes frontend :

* **Toujours utiliser `@phantom/react-sdk`** pour React (jamais `window.phantom.solana` ou `@solana/wallet-adapter-react`)
* **Toujours utiliser `@phantom/browser-sdk`** pour JS vanilla et **`@phantom/react-native-sdk`** pour React Native
* **Ne jamais exposer les clés API Helius dans le code client** — seulement `https://sender.helius-rpc.com/fast` est sûr pour le navigateur sans clé API
* **Tout proxy via votre backend** — ne jamais ouvrir des WebSockets Helius directement depuis le navigateur
* **Toujours soumettre les transactions via Helius Sender** avec `skipPreflight: true`, `maxRetries: 0`, et un pourboire Jito
* **Utiliser l'outil MCP `getPriorityFeeEstimate`** — ne jamais coder en dur les frais prioritaires

## Schémas Composites

La compétence fournit cinq schémas de référence de bout en bout pour les applications complexes :

1. **Interface d'Échange** — Agrégateur → signature Phantom → soumission Helius Sender
2. **Visionneuse de Portefeuille** — connexion Phantom → proxy backend → API DAS/Portefeuille
3. **Tableau de Bord en Temps Réel** — connexion Phantom → WebSocket serveur → relais client
4. **Transfert de Jeton** — Construire VersionedTransaction → signature Phantom → soumission Sender
5. **Galerie NFT** — portefeuille Phantom → requête DAS backend → affichage des NFT

## Prérequis

Cette compétence nécessite le [serveur Helius MCP](/docs/fr/agents/mcp). Pour les portefeuilles intégrés (connexion Google/Apple), vous avez également besoin d'un compte [Phantom Portal](https://phantom.com/portal) avec un ID d'App et des URLs de redirection sur liste blanche.

Si vous l'installez via le [plugin Claude Code](/docs/fr/agents/claude-code-plugin), le serveur MCP se lance automatiquement. Pour une installation autonome, ajoutez-le manuellement :

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

## Installation Autonome

Si vous souhaitez la compétence Phantom sans le plugin complet, installez-la directement :

<Steps>
  <Step title="Cloner le dépôt">
    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills/helius-phantom
    ```
  </Step>

  <Step title="Exécuter le script d'installation">
    ```bash theme={"system"}
    ./install.sh
    ```

    Cela installe la compétence et ses fichiers de référence à `~/.claude/skills/helius-phantom/`.

    **Options :**

    * `./install.sh --project` — installer dans le projet actuel (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — installer dans un répertoire personnalisé
  </Step>

  <Step title="Installer le serveur Helius MCP">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="Définir votre clé API">
    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    Ou utilisez l'outil MCP `setHeliusApiKey` dans Claude Code. Si vous avez besoin d'un nouveau compte, voir [Helius CLI](/docs/fr/agents/cli) ou utilisez le flux d'inscription autonome via [outils MCP](/docs/fr/agents/mcp).
  </Step>
</Steps>

## Exemples de Prompts

Une fois installé, demandez en anglais clair :

* "Construire une interface d'échange avec portefeuille Phantom"
* "Construire une visionneuse de portefeuille qui montre les jetons après la connexion Phantom"
* "Comment proxy ma clé API Helius dans Next.js?"
* "Construire un tableau de bord en temps réel avec connexion de portefeuille"
* "Ajouter une limitation de jeton à mon application React en utilisant Phantom"
* "Construire une page de minting NFT avec Phantom et Metaplex Core"

L'IA choisit automatiquement les bons outils et lit les fichiers de référence appropriés.

## Ce qui est Inclus

La compétence installe deux composants :

* **`SKILL.md`** — Logique de routage, règles et contexte expert qui guident le comportement de l'IA
* **`prompts/`** — Variantes de prompts système préconstruites (`openai.developer.md`, `claude.system.md`, `full.md`) — voir [configuration de la plateforme](/docs/fr/agents/skills/overview#utilisation-des-compétences-sur-diverses-plateformes)
* **`references/`** — 16 fichiers de documentation approfondis :
  * `react-sdk.md` — SDK Phantom React (`@phantom/react-sdk`)
  * `browser-sdk.md` — SDK Phantom Browser (`@phantom/browser-sdk`)
  * `react-native-sdk.md` — SDK Phantom React Native (`@phantom/react-native-sdk`)
  * `transactions.md` — Schémas de signature de transaction
  * `token-gating.md` — Contrôle d'accès par limitation de jeton
  * `nft-minting.md` — Minting NFT avec Phantom
  * `payments.md` — Flux de paiements crypto
  * `frontend-security.md` — Proxy de clé API et CORS
  * `integration-patterns.md` — Schémas composites de bout en bout
  * `helius-das.md` — Référence API DAS
  * `helius-sender.md` — Référence du Sender
  * `helius-priority-fees.md` — Référence sur les frais prioritaires
  * `helius-wallet-api.md` — Référence API Portefeuille
  * `helius-websockets.md` — Référence WebSocket
  * `helius-enhanced-transactions.md` — Référence Transactions Améliorées
  * `helius-onboarding.md` — Référence de configuration du compte

## En Savoir Plus

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/fr/agents/mcp">
    Le serveur MCP qui alimente les outils de cette compétence
  </Card>

  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/fr/agents/claude-code-plugin">
    Installation en un clic de MCP + compétences
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/fr/agents/skills/build">
    Développement général Solana avec Helius
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    Code source et suivi des problèmes
  </Card>
</CardGroup>