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

# Comment migrer vers Gatekeeper

> Guide étape par étape pour migrer votre application vers Gatekeeper

La migration vers Gatekeeper prend **moins de 5 minutes**. C'est un simple changement d'URL—votre clé API fonctionne sans aucune modification.

## Migration rapide

Remplacez simplement votre point de terminaison existant :

<CodeGroup>
  ```javascript Before theme={"system"}
  const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
  ```

  ```javascript After theme={"system"}
  const url = "https://beta.helius-rpc.com/?api-key=YOUR_API_KEY";
  ```
</CodeGroup>

**C'est tout !**

Testez votre application, surveillez les performances et déployez lorsque vous êtes prêt.

## Exemples spécifiques au framework

<Tabs>
  <Tab title="Solana Web3.js">
    ```javascript theme={"system"}
    import { Connection } from '@solana/web3.js';

    const connection = new Connection(
      `https://beta.helius-rpc.com/?api-key=${YOUR_API_KEY}`,
      'confirmed'
    );
    ```
  </Tab>

  <Tab title="Anchor">
    ```javascript theme={"system"}
    import { AnchorProvider } from '@coral-xyz/anchor';
    import { Connection } from '@solana/web3.js';

    const connection = new Connection(
      `https://beta.helius-rpc.com/?api-key=${YOUR_API_KEY}`,
      'confirmed'
    );

    const provider = new AnchorProvider(connection, wallet, {
      commitment: 'confirmed'
    });
    ```
  </Tab>

  <Tab title="Solana-py">
    ```python theme={"system"}
    from solana.rpc.api import Client

    rpc_url = f"https://beta.helius-rpc.com/?api-key={YOUR_API_KEY}"
    client = Client(rpc_url)
    ```
  </Tab>

  <Tab title="Rust">
    ```rust theme={"system"}
    use solana_client::rpc_client::RpcClient;

    let rpc_url = format!("https://beta.helius-rpc.com/?api-key={}", YOUR_API_KEY);
    let client = RpcClient::new(rpc_url);
    ```
  </Tab>

  <Tab title="Environment Variable">
    ```bash theme={"system"}
    # .env file
    HELIUS_RPC_URL=https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
    ```
  </Tab>
</Tabs>

## Points de terminaison WebSocket

Si vous utilisez des WebSockets, mettez également à jour ces points de terminaison :

```javascript theme={"system"}
// Before
const ws = new WebSocket("wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY");

// After
const ws = new WebSocket("wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY");
```

## Liste de vérification de la migration

<Steps>
  <Step title="Mettre à jour l'URL du point de terminaison">
    Changez `mainnet.helius-rpc.com` vers `beta.helius-rpc.com`
  </Step>

  <Step title="Tester en développement">
    Vérifiez que tous les appels RPC fonctionnent et que l'authentification réussit
  </Step>

  <Step title="Surveiller les performances">
    Vérifiez vos métriques pour une latence et des temps de réponse améliorés
  </Step>

  <Step title="Déployer en production">
    Déployez les changements en utilisant votre processus de déploiement standard
  </Step>
</Steps>

## Déploiement progressif (optionnel)

Pour une migration plus sûre, vous pouvez utiliser des variables d'environnement ou des flags de fonctionnalité :

```javascript theme={"system"}
// Environment-based
const endpoint = process.env.USE_GATEKEEPER
  ? "https://beta.helius-rpc.com"
  : "https://mainnet.helius-rpc.com";

const connection = new Connection(
  `${endpoint}?api-key=${YOUR_API_KEY}`,
  'confirmed'
);
```

```javascript theme={"system"}
// Percentage rollout (10% of traffic)
const useGatekeeper = Math.random() < 0.1;
const endpoint = useGatekeeper
  ? "https://beta.helius-rpc.com"
  : "https://mainnet.helius-rpc.com";
```

## Régression

Si nécessaire, revenez simplement au point de terminaison standard :

```javascript theme={"system"}
const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
```

## Dépannage

<AccordionGroup>
  <Accordion title="Erreurs 401 Non autorisé">
    Vérifiez que votre clé API est incluse : `?api-key=YOUR_API_KEY`
  </Accordion>

  <Accordion title="Pas d'améliorations des performances">
    * Testez depuis votre environnement de production (pas en dev local)
    * Vérifiez que vous ne dépassez pas les limites de taux (vérifiez les erreurs 429)
    * Contactez le support si les problèmes persistent
  </Accordion>

  <Accordion title="Échecs de connexion WebSocket">
    * Utilisez `wss://` (pas `ws://`)
    * Assurez-vous que votre clé API est dans l'URL
    * Vérifiez les paramètres du pare-feu
  </Accordion>

  <Accordion title="Les formats de réponse semblent différents">
    Gatekeeper retourne des réponses identiques. Contactez immédiatement le support si vous voyez des différences.
  </Accordion>
</AccordionGroup>

## Besoin d'aide ?

* **Email**: [support@helius.dev](mailto:support@helius.dev)
* **Discord**: [https://discord.com/invite/6GXdee3gBj](https://discord.com/invite/6GXdee3gBj)
* **Documentation**: [Aperçu de Gatekeeper](/docs/fr/gatekeeper/overview)

<Card title="Questions sur la migration ?" icon="comments" href="https://discord.com/invite/6GXdee3gBj">
  Rejoignez notre Discord pour discuter avec l'équipe et d'autres développeurs
</Card>