Cómo migrar a Gatekeeper

Migrar a Gatekeeper toma menos de 5 minutos. Solo necesitas cambiar una URL; tu clave de API funciona sin modificaciones.

Migración rápida

Simplemente reemplaza tu punto de conexión actual:

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

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

¡Eso es todo! Prueba tu aplicación, monitorea el rendimiento e impleméntala cuando esté lista.

Ejemplos específicos para cada 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

Puntos de conexión WebSocket

Si usas WebSockets, actualiza también esos puntos de conexión:

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

Lista de verificación para la migración

Update endpoint URL

Cambia mainnet.helius-rpc.com por beta.helius-rpc.com

Test in development

Verifica que todas las llamadas RPC funcionen y que la autenticación se complete correctamente

Monitor performance

Revisa tus métricas para confirmar mejoras en la latencia y los tiempos de respuesta

Deploy to production

Implementa los cambios mediante tu proceso de implementación habitual

Lanzamiento gradual (opcional)

Para realizar una migración más segura, puedes usar variables de entorno o indicadores de funciones:

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

Reversión

Si es necesario, simplemente vuelve al punto de conexión estándar:

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

Solución de problemas

Getting 401 Unauthorized errors

Verifica que tu clave de API esté incluida: ?api-key=YOUR_API_KEY

Not seeing performance improvements

Realiza las pruebas desde tu entorno de producción (no desde el entorno de desarrollo local)
Verifica que no estés alcanzando los límites de solicitudes (comprueba si hay errores 429)
Contacta al equipo de soporte si los problemas persisten

WebSocket connections failing

Usa wss:// (no ws://)
Asegúrate de que tu clave de API esté en la URL
Revisa la configuración del firewall

Response formats look different

Gatekeeper devuelve respuestas idénticas. Contacta de inmediato al equipo de soporte si observas diferencias.

¿Necesitas ayuda?

Correo electrónico: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Documentación: Descripción general de Gatekeeper

Questions about migration?

Únete a nuestro Discord para conversar con el equipo y otros desarrolladores

Primeros pasos

Streaming de datos y escucha de eventos

API de datos y RPC

Trading

Envío de transacciones

Billetera como servicio

Privacidad

Recursos

Cómo migrar a Gatekeeper

Migración rápida

Ejemplos específicos para cada framework

Puntos de conexión WebSocket

Lista de verificación para la migración

Lanzamiento gradual (opcional)

Reversión

Solución de problemas

¿Necesitas ayuda?

Questions about migration?

​Migración rápida

​Ejemplos específicos para cada framework

​Puntos de conexión WebSocket

​Lista de verificación para la migración

​Lanzamiento gradual (opcional)

​Reversión

​Solución de problemas

​¿Necesitas ayuda?

Questions about migration?

Migración rápida

Ejemplos específicos para cada framework

Puntos de conexión WebSocket

Lista de verificación para la migración

Lanzamiento gradual (opcional)

Reversión

Solución de problemas

¿Necesitas ayuda?