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

# Wie Sie zu Gatekeeper migrieren

> Schritt-für-Schritt-Anleitung zur Migration Ihrer Anwendung zu Gatekeeper

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:

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

**Das war's!**

Testen Sie Ihre Anwendung, überwachen Sie die Leistung und stellen Sie bereit, wenn Sie bereit sind.

## Framework-spezifische Beispiele

<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="Umgebungsvariable">
    ```bash theme={"system"}
    # .env file
    HELIUS_RPC_URL=https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
    ```
  </Tab>
</Tabs>

## WebSocket-Endpunkte

Wenn Sie WebSockets verwenden, aktualisieren Sie auch diese Endpunkte:

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

## Migrations-Checkliste

<Steps>
  <Step title="Endpunkt-URL aktualisieren">
    Ändern Sie `mainnet.helius-rpc.com` zu `beta.helius-rpc.com`
  </Step>

  <Step title="Im Entwicklungsmodus testen">
    Überprüfen Sie, ob alle RPC-Anrufe funktionieren und die Authentifizierung erfolgreich ist
  </Step>

  <Step title="Leistung überwachen">
    Überprüfen Sie Ihre Metriken auf verbesserte Latenz- und Antwortzeiten
  </Step>

  <Step title="In die Produktion einführen">
    Implementieren Sie die Änderungen mit Ihrem üblichen Bereitstellungsprozess
  </Step>
</Steps>

## Stufenweise Einführung (optional)

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

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

## Rollback

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

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

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Erhalte 401 Unauthorized-Fehler">
    Überprüfen Sie, ob Ihr API-Schlüssel enthalten ist: `?api-key=YOUR_API_KEY`
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Antwortformate sehen anders aus">
    Gatekeeper liefert identische Antworten. Kontaktieren Sie sofort den Support, wenn Sie Unterschiede feststellen.
  </Accordion>
</AccordionGroup>

## Brauchen Sie Hilfe?

* **E-Mail**: [support@helius.dev](mailto:support@helius.dev)
* **Discord**: [https://discord.com/invite/6GXdee3gBj](https://discord.com/invite/6GXdee3gBj)
* **Dokumentation**: [Gatekeeper Überblick](/docs/de/gatekeeper/overview)

<Card title="Fragen zur Migration?" icon="comments" href="https://discord.com/invite/6GXdee3gBj">
  Treten Sie unserem Discord bei, um mit dem Team und anderen Entwicklern zu chatten
</Card>
