Solana RPC 엔드포인트 FAQ

요금 청구, Free 플랜, 결제, 401 또는 429 오류에 관한 질문은 시작 방법에 정리되어 있습니다.
거리, 속도, 리전에 관한 질문은 지연 시간 및 리전에 정리되어 있습니다.

Q. Solana RPC 엔드포인트란 무엇이며 ERPC에서 어떻게 받을 수 있나요?

Solana RPC 엔드포인트는 애플리케이션, 트레이딩 봇, 지갑, 분석 시스템이 Solana에 JSON-RPC 요청을 보내고 체인 데이터를 받는 데 사용하는 URL입니다. ERPC를 사용하면 같은 글로벌 프록시 네트워크를 통해 HTTP와 WebSocket 접속을 지원하는 관리형 Solana 엔드포인트를 이용할 수 있습니다.
시작하려면 ERPC Web Dashboard에서 ERPC 계정을 만들거나 열고, API key를 복사한 뒤 엔드포인트 URL의 api-key 파라미터에 추가하세요.
endpoint
https://edge.erpc.global?api-key=<YOUR_API_KEY>
WebSocket 구독에도 같은 API key 형식을 사용하세요.
endpoint
wss://edge.erpc.global?api-key=<YOUR_API_KEY>

Q. WebSocket을 사용할 수 있나요?

예. WebSocket을 지원합니다. 동일한 엔드포인트를 통해 실시간 데이터 업데이트를 효율적으로 받을 수 있습니다.

Q. 노드는 어느 리전에 있나요?

현재 다음 리전에서 노드를 운영합니다.
  • Frankfurt (FRA)
  • Amsterdam (AMS)
  • London (LON)
  • New York (NY)
  • Tokyo (TY)
  • Singapore (SGP)
ERPC의 RPC endpoints는 Cloudflare의 전 세계 300개 이상 Edge 서버 네트워크를 활용합니다. 요청은 가까운 Cloudflare Edge 위치를 거쳐 최적의 ERPC 노드로 전달되어, 가능한 짧은 네트워크 경로와 일관된 저지연 연결을 제공합니다.
이 구조는 지리적 거리와 복잡한 라우팅의 영향을 줄이고, Solana 노드에 안정적으로 연결할 수 있도록 설계되어 있습니다.
ERPC Web Dashboard: ERPC Web Dashboard

Q. 오래된 Solana 블록이나 트랜잭션이 보이지 않거나 -32011이 표시되는 이유는 무엇인가요?

getTransactionsForAddress를 제외하면 history=true가 없는 요청에는 각 노드가 보유한 최근 범위에서 응답하므로, 오래된 블록이나 트랜잭션은 메서드에 따라 오류 This request needs history access. Add history=true to the endpoint URL. (코드 -32011), null 또는 빈 결과를 반환할 수 있습니다. 이를 요청하려면 HTTP 요청의 https://edge.erpc.global URL에 history=true를 추가하세요.
API key를 URL에 포함해 보내세요:
endpoint
https://edge.erpc.global?api-key=<YOUR_API_KEY>&history=true
또는 Authorization: Bearer <YOUR_API_KEY> 헤더로 보내고 history=true는 URL에 그대로 두세요:
endpoint
https://edge.erpc.global?history=true
오래된 블록이나 트랜잭션을 조회하는 데에는 일반 요청보다 훨씬 오래 걸릴 수 있으며, 경우에 따라 수 초가 걸리기도 합니다. History Access는 이러한 조회를 일반 요청과 분리하는 별도의 옵션이며, 덕분에 일반 요청은 빠르게 유지됩니다. getTransactionsForAddress의 "full" 모드를 제외하고, History Access가 응답한 호출은 각각 메서드의 일반 요금보다 640토큰 더 듭니다.
Free 요금제를 포함한 무료 할당량에는 History Access에 대한 한도가 있습니다. Free 요금제는 10초당 History Access 요청 한 건으로 제한됩니다.
history=true가 없으면 transactionDetails를 "full"로 설정한 getTransactionsForAddress는 데이터의 신구와 관계없이 동일한 -32011 오류를 반환합니다. 가격은 ERPC 문서에 나와 있습니다.

Q. Shreds / getBlock 출력이 갑자기 깨져 보이거나 -32015가 반환됩니다. 무엇이 바뀌었나요?

Solana Transaction v1(SIMD-0385)이 2026년 9월 15일, 에포크 1035에 Solana 메인넷에서 활성화되었습니다. v1 트랜잭션의 와이어 레이아웃은 버전 프리픽스 바이트 0x81로 시작하고, 서명은 메시지 뒤에 오며, 레거시 길이 프리픽스는 없습니다.
ShredStream 또는 UDP Forwarding의 엔트리를 직접 디코딩하는 경우, 4.2 미만 버전의 bincode 또는 solana-entry 디코더는 이 0x81 바이트를 서명 개수로 잘못 읽으며, 이는 EOF 오류, compact-length 오버플로 또는 "invalid message version" 오류로 나타납니다. 4.2 이전 크레이트로 raw 트랜잭션을 역직렬화하는 Geyser gRPC 사용자도 같은 문제를 겪습니다. maxSupportedTransactionVersion: 0으로 호출한 getBlock과 getTransaction RPC는 -32015 Transaction version (1) is not supported by the requesting client를 반환하며, getTransactionsForAddress는 full 모드에서 영향을 받는 각 행마다 같은 오류를 보고합니다. 이미 버전 1을 지정해 ERPC의 파싱된 JSON 응답을 읽고 있다면 영향을 받지 않습니다.
옵션 객체에서 maxSupportedTransactionVersion을 1로 설정하세요. getBlock과 getTransaction의 두 번째 매개변수, 그리고 getTransactionsForAddress의 옵션에도 동일하게 적용합니다:
json
{
  "maxSupportedTransactionVersion": 1
}
Solana Stream SDK를 2.0.0으로 업그레이드하세요. crates.io의 Rust solana-stream-sdk, 또는 npm의 @validators-dao/solana-stream-sdk와 @validators-dao/solana-shreds-client입니다. @validators-dao/solana-entry-decoder는 별도로 2.5.0으로 업그레이드하세요. 1.4.0과 entry-decoder 2.4.0은 v1을 지원하지 않습니다. 자체 Rust 디코더는 solana-entry 4.2.x로 옮기는 것이 좋습니다.

Q. Unlimited Endpoint는 어떤 메서드를 지원하나요?

Unlimited Endpoints는 지연 시간이 낮은 표준 Solana RPC 호출을 위해 설계되었습니다. 지원 메서드는 다음과 같습니다.
  • getSlot
  • getBlockHeight
  • getLatestBlockhash
  • getBalance
  • getAccountInfo
  • getMultipleAccounts
  • getTransaction
  • sendTransaction
  • simulateTransaction
  • getSignatureStatuses
  • getRecentPrioritizationFees
  • getHealth
  • getVersion
  • getEpochInfo
  • getBlock
다른 메서드는 https://edge.erpc.global?api-key=<YOUR_API_KEY>을 사용하세요.

Q. 전용 노드의 거래 성공률이 낮습니다.

트랜잭션 성공률과 속도는 QoS(Quality of Service)라는 메커니즘의 영향을 크게 받습니다. ERPC는 전용 노드에 특화된 QoS를 제공합니다. 자세한 내용은 아래 페이지를 참고하거나 ERPC Web Dashboard를 통해 문의해 주세요.

Q. 가능한 한 가장 낮은 지연 시간을 달성하려면 어떻게 해야 하나요?

최저 지연 시간을 위한 이상적인 구성은 전용 RPC 노드와 저희 Bare-Metal 서버를 함께 사용하는 것입니다. 둘은 같은 네트워크를 공유하므로 약 0.1ms 수준의 ping으로 사설 거리 제로(zero-distance) 통신이 가능합니다.
자세한 내용은 ERPC Web Dashboard를 통해 문의해 주세요.