Quicknode provides Logs for your RPC endpoints. Easily identify and resolve issues by viewing detailed error information directly from your dashboard.
HTTP 오류 코드
자, 이제 자주 접하게 되는 HTTP 오류 코드와 그 의미, 그리고 이를 방지하기 위해 취할 수 있는 조치에 대해 살펴보겠습니다.
400잘못된 요청
잘못된 HTTP 요청 유형(예: POST 대신 GET 사용) 또는 유효하지 않은 문자
401무단 접근
이는 잘못된 토큰 인증, 화이트리스트에 포함되지 않은 IP, 유효하지 않은 JWT 등 하나 이상의 보안 요구 사항이 충족되지 않을 때 발생할 수 있습니다.
403접근 금지
Endpoint (이유 중 하나는 연체된 결제일 수 있습니다)
403접근 금지 - 사용자 정의 추적 정보를 찾을 수 없음
사용자 정의 추적 코드가 허용 목록에 포함되지 않았습니다(승인 절차를 진행하려면 티켓을 제출해 주세요).
404찾을 수 없음
잘못된 URL 또는 잘못된 메서드
413콘텐츠 용량이 너무 큽니다
요청 본문의 크기가 너무 큽니다
413요청 엔티티 크기가 너무 큽니다
eth_getLogs 및 eth_newFilter는 10,000 블록 범위로 제한됩니다. 로그 및 이벤트를 요청할 때 10,000 블록 범위의 제한을 적용합니다.
429요청이 너무 많습니다
요청의 초당 요청 수(RPS)가 요금제에서 허용하는 한도를 초과했습니다. 429 오류에 대한 자세한 내용은 지원 문서를 참조하십시오.
500서버 내부 오류
Submit a ticket for the support team to take a look at the errors asap
503서비스를 이용할 수 없습니다
Submit a ticket for the support team to take a look at the errors asap
HTTP 오류 코드 예시
아래 코드 조각은 오류 코드 4 29의 예시입니다.
{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}
Zcash RPC Error Codes
Let's look at the common Zcash RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
-32700Parse errorRPC
Invalid JSON was received by the server; check JSON syntax and formatting
-32600Invalid RequestRPC
The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification
-32601Method not foundRPC
The method does not exist or is not available; verify method name spelling or check if the method requires a specific add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)
-32602Invalid paramsRPC
Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation
-32603Internal errorRPC
Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself
-1Miscellaneous errorRPC
General error that doesn't fit other categories; check error message for specific details
-2Forbidden by safe modeRPC
Server is in safe mode, and command is not allowed in safe mode
-3Type errorRPC
Unexpected type was passed as parameter; ensure parameter types match expected values
-4Wallet errorRPC
Unspecified problem with wallet (key not found etc.)
-5Invalid address or keyRPC
Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)
-6Insufficient fundsRPC
Not enough funds in wallet or account
-7Out of memoryRPC
Ran out of memory during operation
-8Invalid parameterRPC
Invalid, missing or duplicate parameter
-9Client not connectedRPC
Bitcoin is not connected
-10Client in initial downloadRPC
Still downloading initial blocks
-11Invalid account nameRPC
Invalid account name
-12Keypool ran outRPC
Keypool ran out, call keypoolrefill first
-13Wallet unlock neededRPC
Enter the wallet passphrase with walletpassphrase first
-14Wallet passphrase incorrectRPC
The wallet passphrase entered was incorrect
-15Wrong encryption stateRPC
Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)
-16Wallet encryption failedRPC
Failed to encrypt the wallet
-17Wallet already unlockedRPC
Wallet is already unlocked
-18Wallet not foundRPC
Invalid wallet specified
-19Wallet not specifiedRPC
No wallet specified (error when there are multiple wallets loaded)
-20Database errorRPC
Database read/write error; this may indicate corruption or disk issues
-22Deserialization errorRPC
Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted
-23Node already addedRPC
Node is already added
-24Node not addedRPC
Node has not been added before
-25Verify errorRPC
General error during transaction or block submission
-26Verify rejectedRPC
Transaction or block was rejected by network rules
-27Verify already in chainRPC
Transaction already in chain
-28Client in warmupRPC
Client still warming up
-29Node not connectedRPC
Node to disconnect not found in connected nodes
-30Invalid IP or subnetRPC
Invalid IP/Subnet
-31P2P disabledRPC
No valid connection manager instance found
-32007Per-second request limit reachedQuicknode
You have exceeded your plan's per-second request limit. Reduce the number of calls per second or upgrade your plan at https://dashboard.quicknode.com/billing/plan.
-32008Per-minute request limit reachedQuicknode
You have exceeded your plan's per-minute request limit. Reduce the number of calls per minute or upgrade your plan at https://dashboard.quicknode.com/billing/plan.
-32011Method rate limit reachedQuicknode
You have exceeded a method-specific rate limit configured for the endpoint. Reduce calls to the method or adjust the method rate-limit rule.
-32604Unsupported request methodQuicknode
The request method is empty, missing, or unsupported. Provide a supported JSON-RPC method name.
-32611Request rejected by filter settingsQuicknode
The request was rejected by an endpoint security filter, such as a method allowlist or blocklist. Review the endpoint's request filter settings.
Quicknode 문제 진단을 돕기 위해 RPC 엔드포인트에 대한 로그를 Quicknode . 다음 경로로 이동하여 Quicknode 직접 로그를 확인할 수 있습니다:
사이드바의 엔드포인트
endpoint 선택
'로그' 탭 열기
시간 범위, 응답 유형, 메서드 및 네트워크별로 로그를 필터링할 수 있습니다.
어떤 내용이 기록되는가
Endpoint 해당 endpoint로 전송된 요청으로, HTTP 상태, 요청 메서드, RPC 메서드 또는 경로, 타임스탬프 등이 포함됩니다.
오류 세부 정보 가능한 경우, 실패한 요청에는 RPC 오류 코드, 요청 및 응답 본문, 관련 문서 링크와 같은 오류 세부 정보가 포함됩니다.
벌목 제한 사항
로그 가용성은 메서드, 응답 유형, 네트워크 및 요금제에 따라 달라질 수 있습니다. 최적의 endpoint 유지하기 위해 로깅은 ‘최선 노력(best-effort)’ 방식으로 운영됩니다. 낮은 지연 시간을 유지하기 위해 트래픽이 많은 시간대에는 일부 로그가 누락될 수 있습니다.
보존 및 접근
Build 및 Scale 요금제에는 표준 로그 보존 기간이 적용된 대시보드 이용 권한이 포함됩니다. Enterprise 요금제는 더 긴 로그 보존 기간과 로그 조회를 위한 프로그래매틱 API 접근 권한을 제공합니다.
다른 오류 코드가 표시되는 경우, 지원 티켓을 제출하여 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.