Wie Sie zu Gatekeeper migrieren

Die Migration zu Gatekeeper dauert weniger als 5 Minuten. Es handelt sich um eine einfache URL-Änderung – Ihr API-Schlüssel funktioniert ohne Änderungen.

Schnelle Migration

Ersetzen Sie einfach Ihren bestehenden Endpunkt:

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

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

Das war’s! Testen Sie Ihre Anwendung, überwachen Sie die Leistung und stellen Sie bereit, wenn Sie bereit sind.

Framework-spezifische Beispiele

Solana Web3.js
Anchor
Solana-py
Rust
Umgebungsvariable

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

WebSocket-Endpunkte

Wenn Sie WebSockets verwenden, aktualisieren Sie auch diese Endpunkte:

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

Migrations-Checkliste

Endpunkt-URL aktualisieren

Ändern Sie mainnet.helius-rpc.com zu beta.helius-rpc.com

Im Entwicklungsmodus testen

Überprüfen Sie, ob alle RPC-Anrufe funktionieren und die Authentifizierung erfolgreich ist

Leistung überwachen

Überprüfen Sie Ihre Metriken auf verbesserte Latenz- und Antwortzeiten

In die Produktion einführen

Implementieren Sie die Änderungen mit Ihrem üblichen Bereitstellungsprozess

Stufenweise Einführung (optional)

Für eine sicherere Migration können Sie Umgebungsvariablen oder Feature-Flags verwenden:

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

Falls erforderlich, wechseln Sie einfach zum Standardendpunkt zurück:

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

Fehlerbehebung

Erhalte 401 Unauthorized-Fehler

Überprüfen Sie, ob Ihr API-Schlüssel enthalten ist: ?api-key=YOUR_API_KEY

Keine Leistungsverbesserungen zu sehen

Testen Sie aus Ihrer Produktionsumgebung (nicht lokales Dev)
Überprüfen Sie, ob Sie an Ratenlimits stoßen (auf 429-Fehler überprüfen)
Kontaktieren Sie den Support, wenn die Probleme weiterhin bestehen

WebSocket-Verbindungen schlagen fehl

Verwenden Sie wss:// (nicht ws://)
Stellen Sie sicher, dass Ihr API-Schlüssel in der URL ist
Überprüfen Sie die Firewall-Einstellungen

Antwortformate sehen anders aus

Gatekeeper liefert identische Antworten. Kontaktieren Sie sofort den Support, wenn Sie Unterschiede feststellen.

Brauchen Sie Hilfe?

E-Mail: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Dokumentation: Gatekeeper Überblick

Fragen zur Migration?

Treten Sie unserem Discord bei, um mit dem Team und anderen Entwicklern zu chatten

Erste Schritte

Daten-Streaming & Ereignisüberwachung

Daten-APIs & RPCs

Handel

Transaktionen senden

Wallet-as-a-Service

Privatsphäre

Ressourcen

Wie Sie zu Gatekeeper migrieren

Schnelle Migration

Framework-spezifische Beispiele

WebSocket-Endpunkte

Migrations-Checkliste

Stufenweise Einführung (optional)

Rollback

Fehlerbehebung

Brauchen Sie Hilfe?

Fragen zur Migration?

​Schnelle Migration

​Framework-spezifische Beispiele

​WebSocket-Endpunkte

​Migrations-Checkliste

​Stufenweise Einführung (optional)

​Rollback

​Fehlerbehebung

​Brauchen Sie Hilfe?

Fragen zur Migration?

Schnelle Migration

Framework-spezifische Beispiele

WebSocket-Endpunkte

Migrations-Checkliste

Stufenweise Einführung (optional)

Rollback

Fehlerbehebung

Brauchen Sie Hilfe?