Quicknode RPC 엔드포인트에 대한 오류 로그를 Quicknode . 대시보드에서 직접 상세한 오류 정보를 확인하여 문제를 손쉽게 파악하고 해결할 수 있습니다.
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
}
Bitcoin RPC Error Codes
Let's look at the common Bitcoin 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 접근 권한을 제공합니다.
다른 오류 코드가 표시되는 경우, 지원 티켓을 제출하여 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.