Comment migrer 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 :

const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";

const url = "https://beta.helius-rpc.com/?api-key=YOUR_API_KEY";

C’est tout ! Testez votre application, surveillez les performances et déployez lorsque vous êtes prêt.

Exemples spécifiques au framework

Solana Web3.js
Anchor
Solana-py
Rust
Environment Variable

import { Connection } from '@solana/web3.js';

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

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'
});

from solana.rpc.api import Client

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

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);

# .env file
HELIUS_RPC_URL=https://beta.helius-rpc.com/?api-key=YOUR_API_KEY

Points de terminaison WebSocket

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

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

Mettre à jour l'URL du point de terminaison

Changez mainnet.helius-rpc.com vers beta.helius-rpc.com

Tester en développement

Vérifiez que tous les appels RPC fonctionnent et que l’authentification réussit

Surveiller les performances

Vérifiez vos métriques pour une latence et des temps de réponse améliorés

Déployer en production

Déployez les changements en utilisant votre processus de déploiement standard

Déploiement progressif (optionnel)

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

// 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'
);

// 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 :

const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";

Dépannage

Erreurs 401 Non autorisé

Vérifiez que votre clé API est incluse : ?api-key=YOUR_API_KEY

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

É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

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.

Besoin d’aide ?

Email: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Documentation: Aperçu de Gatekeeper

Questions sur la migration ?

Rejoignez notre Discord pour discuter avec l’équipe et d’autres développeurs

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Wallet en tant que service

Confidentialité

Ressources

Comment migrer vers Gatekeeper

Migration rapide

Exemples spécifiques au framework

Points de terminaison WebSocket

Liste de vérification de la migration

Déploiement progressif (optionnel)

Régression

Dépannage

Besoin d’aide ?

Questions sur la migration ?

​Migration rapide

​Exemples spécifiques au framework

​Points de terminaison WebSocket

​Liste de vérification de la migration

​Déploiement progressif (optionnel)

​Régression

​Dépannage

​Besoin d’aide ?

Questions sur la migration ?

Migration rapide

Exemples spécifiques au framework

Points de terminaison WebSocket

Liste de vérification de la migration

Déploiement progressif (optionnel)

Régression

Dépannage

Besoin d’aide ?