Как перейти на Gatekeeper

Переход на Gatekeeper занимает менее 5 минут. Достаточно просто изменить URL — ваш ключ API будет работать без каких-либо изменений.

Быстрая миграция

Просто замените текущую конечную точку:

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

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

Готово! Протестируйте приложение, отслеживайте производительность и разверните его, когда будете готовы.

Примеры для разных фреймворков

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

Конечные точки WebSocket

Если вы используете WebSocket, обновите и эти конечные точки:

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

Контрольный список миграции

Update endpoint URL

Замените mainnet.helius-rpc.com на beta.helius-rpc.com

Test in development

Убедитесь, что все вызовы RPC работают и аутентификация проходит успешно

Monitor performance

Проверьте показатели на предмет снижения задержки и времени ответа

Deploy to production

Разверните изменения с помощью стандартного процесса развертывания

Постепенное развертывание (необязательно)

Для более безопасной миграции можно использовать переменные среды или флаги функций:

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

Откат

При необходимости просто вернитесь к стандартной конечной точке:

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

Устранение неполадок

Getting 401 Unauthorized errors

Убедитесь, что ключ API указан: ?api-key=YOUR_API_KEY

Not seeing performance improvements

Тестируйте в рабочей среде, а не в локальной среде разработки
Убедитесь, что вы не превышаете ограничения частоты запросов (проверьте наличие ошибок 429)
Если проблема сохраняется, обратитесь в службу поддержки

WebSocket connections failing

Используйте wss:// (не ws://)
Убедитесь, что ключ API указан в URL
Проверьте настройки межсетевого экрана

Response formats look different

Gatekeeper возвращает идентичные ответы. Если вы заметили различия, немедленно обратитесь в службу поддержки.

Нужна помощь?

Электронная почта: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Документация: Обзор Gatekeeper

Questions about migration?

Присоединяйтесь к нашему серверу Discord, чтобы пообщаться с командой и другими разработчиками

Начало работы

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

Как перейти на Gatekeeper

Быстрая миграция

Примеры для разных фреймворков

Конечные точки WebSocket

Контрольный список миграции

Постепенное развертывание (необязательно)

Откат

Устранение неполадок

Нужна помощь?

Questions about migration?

​Быстрая миграция

​Примеры для разных фреймворков

​Конечные точки WebSocket

​Контрольный список миграции

​Постепенное развертывание (необязательно)

​Откат

​Устранение неполадок

​Нужна помощь?

Questions about migration?

Быстрая миграция

Примеры для разных фреймворков

Конечные точки WebSocket

Контрольный список миграции

Постепенное развертывание (необязательно)

Откат

Устранение неполадок

Нужна помощь?