如何迁移到Gatekeeper

逐步指导将您的应用程序迁移到Gatekeeper

迁移到Gatekeeper不到5分钟即可完成。这只是一个简单的URL更改——您的API密钥无需任何修改即可使用。

​

快速迁移

只需替换现有的端点：

Before

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

就是这样！

测试您的应用程序，监控性能，并在准备好时进行部署。

​

特定框架示例

Solana Web3.js

import { Connection } from '@solana/web3.js';

const connection = new Connection(
  `https://beta.helius-rpc.com/?api-key=${YOUR_API_KEY}`,
  'confirmed'
);

Anchor

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'
});

Solana-py

from solana.rpc.api import Client

rpc_url = f"https://beta.helius-rpc.com/?api-key={YOUR_API_KEY}"
client = Client(rpc_url)

Rust

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

如果您使用 WebSockets，也要更新这些端点：

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

​

迁移清单

1. 更新端点 URL

   将 mainnet.helius-rpc.com 更改为 beta.helius-rpc.com

2. 在开发中测试

   验证所有 RPC 调用工作正常并且身份验证成功

3. 监控性能

   检查您的指标以提高延迟和响应时间

4. 部署到生产环境

   使用标准部署流程进行更改

​

渐进式推出（可选）

为实现更安全的迁移，您可以使用环境变量或功能标志：

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

​

故障排除

获取 401 未经授权的错误

确保您的 API 密钥已包含：?api-key=YOUR_API_KEY

未见性能提升

• 从生产环境（而非本地开发）进行测试
• 确认您没有触及速率限制（检查 429 错误）
• 如果问题仍然存在，请联系支持

WebSocket 连接失败

• 使用 wss://（而不是 ws://）
• 确保您的 API 密钥在 URL 中
• 检查防火墙设置

响应格式看起来不同

Gatekeeper 返回相同的响应。如果您发现差异，请立即联系支持。

​

需要帮助？

• 电子邮件: [e-mail]
• Discord: https://discord.com/invite/6GXdee3gBj
• 文档: Gatekeeper 概述

有关迁移的问题？

加入我们的 Discord，与团队和其他开发者交流