Quicknode는 RPC 엔드포인트에 대한 오류 로그를 제공합니다. 대시보드에서 직접 상세한 오류 정보를 확인하여 문제를 쉽게 파악하고 해결할 수 있습니다.
HTTP 오류 코드
자, 이제 여러분이 접할 수 있는 일반적인 HTTP 오류 코드와 그 의미, 그리고 이를 방지하기 위해 취할 수 있는 조치에 대해 살펴보겠습니다.
400잘못된 요청
잘못된 HTTP 요청 유형(예: POST 대신 GET 사용) 또는 유효하지 않은 문자
401권한 없음
이는 토큰 인증 오류, IP가 허용 목록에 포함되지 않은 경우, JWT가 유효하지 않은 경우 등 하나 이상의 보안 요구 사항이 충족되지 않을 때 발생할 수 있습니다.
403접근 금지
엔드포인트 비활성화됨 (이유 중 하나는 연체된 결제일 수 있습니다)
403접근 금지 - 사용자 정의 추적 정보를 찾을 수 없음
사용자 정의 추적 코드가 허용 목록에 포함되지 않았습니다(승인 절차를 진행하려면 티켓을 제출해 주세요).
404찾을 수 없음
잘못된 URL 또는 잘못된 메서드
413콘텐츠 크기가 너무 큽니다
요청 본문의 크기가 너무 큽니다
413요청 엔티티 크기가 너무 큽니다
eth_getLogs 및 eth_newFilter는 10,000 블록 범위로 제한됩니다. 로그 및 이벤트를 요청할 때 10,000 블록 범위의 제한을 적용합니다.
429요청이 너무 많습니다
요청의 초당 요청 수(RPS)가 요금제에서 허용하는 한도를 초과했습니다. 429 오류에 대한 자세한 내용은 지원 문서를 참조하십시오.
500서버 내부 오류
지원팀이 오류를 최대한 빨리 확인할 수 있도록 티켓을 제출해 주세요
503서비스를 이용할 수 없습니다
지원팀이 오류를 최대한 빨리 확인할 수 있도록 티켓을 제출해 주세요
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.
-32700구문 오류
Invalid JSON was received by the server; check JSON syntax and formatting
-32600Invalid Request
The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification
-32601메서드를 찾을 수 없음
The method does not exist or is not available; verify method name spelling or check if the method requires a specific marketplace add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)
-32602Invalid params
Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation
-32603Internal error
Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself
-1Miscellaneous error
General error that doesn't fit other categories; check error message for specific details
-2Forbidden by safe mode
Server is in safe mode, and command is not allowed in safe mode
-3Type error
Unexpected type was passed as parameter; ensure parameter types match expected values
-4Wallet error
Unspecified problem with wallet (key not found etc.)
-5Invalid address or key
Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)
-6Insufficient funds
Not enough funds in wallet or account
-7Out of memory
Ran out of memory during operation
-8Invalid parameter
Invalid, missing or duplicate parameter
-9Client not connected
Bitcoin is not connected
-10Client in initial download
Still downloading initial blocks
-11Invalid account name
Invalid account name
-12Keypool ran out
Keypool ran out, call keypoolrefill first
-13Wallet unlock needed
Enter the wallet passphrase with walletpassphrase first
-14Wallet passphrase incorrect
The wallet passphrase entered was incorrect
-15Wrong encryption state
Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)
-16Wallet encryption failed
Failed to encrypt the wallet
-17Wallet already unlocked
Wallet is already unlocked
-18Wallet not found
Invalid wallet specified
-19Wallet not specified
No wallet specified (error when there are multiple wallets loaded)
-20Database error
Database read/write error; this may indicate corruption or disk issues
-22Deserialization error
Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted
-23Node already added
Node is already added
-24Node not added
Node has not been added before
-25Verify error
General error during transaction or block submission
-26Verify rejected
Transaction or block was rejected by network rules