如何迁移到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
环境变量

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

如果您使用 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");

迁移清单

更新端点 URL

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

在开发中测试

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

监控性能

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

部署到生产环境

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

渐进式推出（可选）

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

// 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 返回相同的响应。如果您发现差异，请立即联系支持。

需要帮助？

电子邮件: support@helius.dev
Discord: https://discord.com/invite/6GXdee3gBj
文档: Gatekeeper 概述

有关迁移的问题？

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

快速入门

数据流和事件监听

数据 API 和 RPC

交易

发送交易

Wallet-as-a-Service

指南

资源

如何迁移到Gatekeeper

快速迁移

特定框架示例

WebSocket 端点

迁移清单

渐进式推出（可选）

回滚

故障排除

需要帮助？

有关迁移的问题？

​快速迁移

​特定框架示例

​WebSocket 端点

​迁移清单

​渐进式推出（可选）

​回滚

​故障排除

​需要帮助？

有关迁移的问题？

快速迁移

特定框架示例

WebSocket 端点

迁移清单

渐进式推出（可选）

回滚

故障排除

需要帮助？