Cách di chuyển sang Gatekeeper

Việc di chuyển sang Gatekeeper mất chưa đến 5 phút. Bạn chỉ cần thay đổi URL—khóa API vẫn hoạt động mà không cần sửa đổi gì.

Di chuyển nhanh

Chỉ cần thay thế điểm cuối hiện tại:

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

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

Vậy là xong! Kiểm thử ứng dụng, theo dõi hiệu suất và triển khai khi đã sẵn sàng.

Ví dụ dành riêng cho từng 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

Điểm cuối WebSocket

Nếu đang sử dụng WebSocket, hãy cập nhật cả các điểm cuối đó:

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

Danh sách kiểm tra khi di chuyển

Update endpoint URL

Thay đổi mainnet.helius-rpc.com thành beta.helius-rpc.com

Test in development

Xác minh tất cả lệnh gọi RPC đều hoạt động và xác thực thành công

Monitor performance

Kiểm tra các chỉ số để xác nhận độ trễ và thời gian phản hồi đã được cải thiện

Deploy to production

Phát hành các thay đổi bằng quy trình triển khai tiêu chuẩn của bạn

Phát hành dần (Không bắt buộc)

Để di chuyển an toàn hơn, bạn có thể sử dụng biến môi trường hoặc cờ tính năng:

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

Khôi phục

Nếu cần, chỉ cần chuyển về điểm cuối tiêu chuẩn:

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

Khắc phục sự cố

Getting 401 Unauthorized errors

Xác minh khóa API đã được thêm vào: ?api-key=YOUR_API_KEY

Not seeing performance improvements

Kiểm thử từ môi trường production của bạn (không phải môi trường phát triển cục bộ)
Xác minh bạn không vượt quá giới hạn tốc độ (kiểm tra lỗi 429)
Liên hệ bộ phận hỗ trợ nếu sự cố vẫn tiếp diễn

WebSocket connections failing

Sử dụng wss:// (không phải ws://)
Đảm bảo khóa API có trong URL
Kiểm tra cài đặt tường lửa

Response formats look different

Gatekeeper trả về các phản hồi giống hệt nhau. Hãy liên hệ ngay với bộ phận hỗ trợ nếu bạn thấy có sự khác biệt.

Bạn cần trợ giúp?

Email: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
Tài liệu: Tổng quan về Gatekeeper

Questions about migration?

Tham gia Discord của chúng tôi để trò chuyện với đội ngũ và các nhà phát triển khác

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Ví dưới dạng dịch vụ

Quyền riêng tư

Tài nguyên

Cách di chuyển sang Gatekeeper

Di chuyển nhanh

Ví dụ dành riêng cho từng framework

Điểm cuối WebSocket

Danh sách kiểm tra khi di chuyển

Phát hành dần (Không bắt buộc)

Khôi phục

Khắc phục sự cố

Bạn cần trợ giúp?

Questions about migration?

​Di chuyển nhanh

​Ví dụ dành riêng cho từng framework

​Điểm cuối WebSocket

​Danh sách kiểm tra khi di chuyển

​Phát hành dần (Không bắt buộc)

​Khôi phục

​Khắc phục sự cố

​Bạn cần trợ giúp?

Questions about migration?

Di chuyển nhanh

Ví dụ dành riêng cho từng framework

Điểm cuối WebSocket

Danh sách kiểm tra khi di chuyển

Phát hành dần (Không bắt buộc)

Khôi phục

Khắc phục sự cố

Bạn cần trợ giúp?