Quicknode는 RPC 엔드포인트에 대한 오류 로그를 제공합니다. 대시보드에서 직접 상세한 오류 정보를 확인하여 문제를 쉽게 파악하고 해결할 수 있습니다.
HTTP 오류 코드
이제 자주 발생하는 HTTP 오류와 그 의미, 그리고 이를 방지하기 위해 취할 수 있는 조치에 대해 살펴보겠습니다.
400잘못된 요청
Incorrect HTTP request type (e.g. using GET instead of POST) or invalid characters
401권한 없음
One or more security requirements not met such as incorrect token auth, IP not in whitelist, invalid JWT, etc
403접근 금지
Endpoint disabled (one reason could be a past due payment)
403Forbidden — custom trace not found in allowed custom traces
Custom trace code not whitelisted; submit a ticket to go through the approval process
404찾을 수 없음
Incorrect URL or incorrect method
413콘텐츠 크기가 너무 큽니다
요청 본문의 크기가 너무 큽니다
429요청이 너무 많습니다
The requests per second (RPS) of your requests are higher than your plan allows; see support docs for details
500서버 내부 오류
Submit a ticket for the support team to investigate as soon as possible
503서비스를 이용할 수 없습니다
Submit a ticket for the support team to investigate as soon as possible
HTTP 오류 코드 예시
{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}
Solana RPC Error Codes
When working with Solana, understanding its API error codes is essential for effective troubleshooting and smooth application operation.
-32002Transaction simulation failed / preflight check error
The transaction being sent has errors; double check params, signatures, and message
-32002Blockhash not found
The blockhash sent is not known by the validator yet; implement a retry mechanism
-32003Transaction signature verification failure
One or more signatures are invalid; verify private/public keys and signatures
-32004Block not available for slot
Timeout or block not retrievable; use a retry mechanism
-32005Node is unhealthy / behind by slots
Node is behind the tip; retry with backoff or try another endpoint
-32007Slot was skipped or missing due to snapshot jump
Requested block does not exist; verify the slot in a block explorer
-32009Slot was skipped or missing in long-term storage
The requested slot is missing from long-term storage; see support FAQ for details
-32010Key excluded from account secondary indexes
Unexpected payload or incorrect data for the method; ensure request body matches validator expectations
-32013Transaction signature length mismatch
Signature length is not as expected; re-encode or rebuild the transaction
-32014Block status not yet available
Block is pending or not yet synced; retry later
-32015Transaction version not supported
Use "maxSupportedTransactionVersion": 0 or upgrade client to support versioned transactions
-32016Minimum context slot not reached
The required context slot is too far in the future; lower the minimum context slot or retry later
-32602Invalid params
Flags/params are invalid; double check method parameters against Solana docs
Solana RPC Error Code Example
{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Invalid param: Invalid"
},
"id": 1
}
Quicknode는 문제 진단을 돕기 위해 RPC 엔드포인트에 대한 로그를 제공합니다. 다음 경로로 이동하면 Quicknode 대시보드에서 직접 로그를 확인할 수 있습니다:
- 사이드바의 엔드포인트
- 엔드포인트 선택
- '로그' 탭 열기
시간 범위, 응답 유형, 메서드 및 네트워크별로 로그를 필터링할 수 있습니다.
어떤 내용이 기록되는가
엔드포인트 요청
해당 엔드포인트로 전송된 요청으로, HTTP 상태, 요청 메서드, RPC 메서드 또는 경로, 타임스탬프 등이 포함됩니다.
오류 세부 정보
가능한 경우, 실패한 요청에는 RPC 오류 코드, 요청 및 응답 본문, 관련 문서 링크와 같은 오류 세부 정보가 포함됩니다.
로그 기록 제한 사항
로그 가용성은 메서드, 응답 유형, 네트워크 및 요금제에 따라 달라질 수 있습니다. 최적의 엔드포인트 성능을 유지하기 위해 로깅은 ‘최선의 노력’ 원칙에 따라 운영됩니다. 낮은 지연 시간을 유지하기 위해 트래픽이 많은 시간대에는 일부 로그가 누락될 수 있습니다.
보존 및 접근
Build 및 Scale 요금제에는 표준 로그 보존 기간이 적용된 대시보드 이용 권한이 포함됩니다. Enterprise 요금제는 더 긴 로그 보존 기간과 로그 조회를 위한 프로그래매틱 API 접근 권한을 제공합니다.
다른 오류 코드가 표시된다면, 티켓을 제출하여 저희에게 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.