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 엔드포인트

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 Unauthorized 오류 발생

API 키가 포함되어 있는지 확인: ?api-key=YOUR_API_KEY

성능 개선이 보이지 않음

로컬 개발 환경이 아닌 프로덕션 환경에서 테스트
속도 제한에 걸리지 않았는지 확인 (429 오류 확인)
문제가 지속되면 지원팀에 연락

WebSocket 연결 실패

wss:// (ws:// 아님) 사용
API 키가 URL에 포함되어 있는지 확인
방화벽 설정 확인

응답 형식이 다르게 보임

Gatekeeper는 동일한 응답을 반환합니다. 차이가 보이는 경우 즉시 지원팀에 연락하세요.

도움이 필요하십니까?

이메일: support@helius.dev
디스코드: https://discord.com/invite/6GXdee3gBj
문서: Gatekeeper 개요

마이그레이션에 대한 질문이 있으신가요?

디스코드에 참여하여 팀 및 다른 개발자와 대화하세요

시작하기

데이터 스트리밍 및 이벤트 수신

데이터 API 및 RPC

거래

거래 보내기

서비스로서의 지갑

안내서

리소스

Gatekeeper로 마이그레이션하는 방법

빠른 마이그레이션

프레임워크별 예시

WebSocket 엔드포인트

마이그레이션 체크리스트

점진적 배포 (선택 사항)

롤백

문제 해결

도움이 필요하십니까?

마이그레이션에 대한 질문이 있으신가요?

​빠른 마이그레이션

​프레임워크별 예시

​WebSocket 엔드포인트

​마이그레이션 체크리스트

​점진적 배포 (선택 사항)

​롤백

​문제 해결

​도움이 필요하십니까?

마이그레이션에 대한 질문이 있으신가요?

빠른 마이그레이션

프레임워크별 예시

WebSocket 엔드포인트

마이그레이션 체크리스트

점진적 배포 (선택 사항)

롤백

문제 해결

도움이 필요하십니까?