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.
迁移到Gatekeeper不到5分钟即可完成。这只是一个简单的URL更改——您的API密钥无需任何修改即可使用。
快速迁移
只需替换现有的端点：
const url = "https://mainnet.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";
故障排除
确保您的 API 密钥已包含：?api-key=YOUR_API_KEY
- 从生产环境（而非本地开发）进行测试
- 确认您没有触及速率限制（检查 429 错误）
- 如果问题仍然存在，请联系支持
- 使用
wss://（而不是 ws://）
- 确保您的 API 密钥在 URL 中
- 检查防火墙设置
Gatekeeper 返回相同的响应。如果您发现差异，请立即联系支持。
需要帮助？
有关迁移的问题？
加入我们的 Discord，与团队和其他开发者交流
