Como Migrar para Gatekeeper

Migrar para o Gatekeeper leva menos de 5 minutos. É uma simples mudança de URL—sua chave API funciona sem quaisquer modificações.

Migração Rápida

Basta substituir seu endpoint existente:

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

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

É isso! Teste sua aplicação, monitore o desempenho e faça o deploy quando estiver pronto.

Exemplos Específicos do 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

Endpoints WebSocket

Se você estiver usando WebSockets, atualize esses endpoints também:

// 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 Verificação de Migração

Atualizar URL do endpoint

Mude mainnet.helius-rpc.com para beta.helius-rpc.com

Testar em desenvolvimento

Verifique se todas as chamadas RPC funcionam e a autenticação é bem-sucedida

Monitorar desempenho

Verifique suas métricas para ver melhorias na latência e nos tempos de resposta

Fazer deploy em produção

Implemente as alterações usando seu processo padrão de implantação

Implementação Gradual (Opcional)

Para uma migração mais segura, você pode usar variáveis de ambiente ou feature flags:

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

Rollback

Se necessário, basta voltar para o endpoint padrão:

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

Resolução de Problemas

Recebendo erros 401 Unauthorized

Verifique se sua chave API está incluída: ?api-key=YOUR_API_KEY

Não vendo melhorias de desempenho

Teste a partir de seu ambiente de produção (não local dev)
Verifique se não está atingindo limites de taxa (verifique erros 429)
Contate o suporte se os problemas persistirem

Falhas nas conexões WebSocket

Use wss:// (não ws://)
Certifique-se de que sua chave API está na URL
Verifique as configurações do firewall

Formatos de resposta parecem diferentes

O Gatekeeper retorna respostas idênticas. Entre em contato com o suporte imediatamente se notar diferenças.

Precisa de Ajuda?

Email: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Documentação: Visão Geral do Gatekeeper

Dúvidas sobre migração?

Junte-se ao nosso Discord para conversar com a equipe e outros desenvolvedores

Primeiros Passos

Transmissão de Dados & Escuta de Eventos

APIs de Dados & RPCs

Negociação

Envio de Transações

Carteira como Serviço

Guias

Recursos

Como Migrar para Gatekeeper

Migração Rápida

Exemplos Específicos do Framework

Endpoints WebSocket

Lista de Verificação de Migração

Implementação Gradual (Opcional)

Rollback

Resolução de Problemas

Precisa de Ajuda?

Dúvidas sobre migração?

​Migração Rápida

​Exemplos Específicos do Framework

​Endpoints WebSocket

​Lista de Verificação de Migração

​Implementação Gradual (Opcional)

​Rollback

​Resolução de Problemas

​Precisa de Ajuda?

Dúvidas sobre migração?

Migração Rápida

Exemplos Específicos do Framework

Endpoints WebSocket

Lista de Verificação de Migração

Implementação Gradual (Opcional)

Rollback

Resolução de Problemas

Precisa de Ajuda?