본문으로 건너뛰기

X Layer Error Code Reference

업데이트됨:
Aug 28, 2026
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
}

EVM RPC Error Codes​

Let's look at the common EVM errors you can encounter, what they mean and what you can do to prevent it.

-32000Header not found / Block not foundRPC

요청한 블록이 해당 노드에 존재하지 않습니다. 블록 번호가 잘못되었거나, 접속 중인 노드가 아직 동기화되지 않은 상태일 수 있습니다. 점진적인 타임아웃을 적용하는 재시도 메커니즘을 사용하십시오.

-32000Stack limit reachedRPC

대개 스마트 계약 오류/버그 - 스택 한도 1024(1023)에 도달함

-32000Method handler crashedRPC

블록체인 클라이언트에서 발생한 내부 오류로, 클라이언트 버그일 가능성이 있습니다. 노드를 다시 확인할 수 있도록 티켓을 제출해 주세요.

-32000Execution timeoutRPC

기본 클라이언트 타임아웃을 재정의하려면 요청에 timeout 매개변수를 추가하세요.

-32000Nonce too lowRPC

귀하의 거래에 지정된 논스 값이 발신자 계정의 다음 유효한 논스보다 낮습니다.

-32000Filter not foundRPC

필터가 시간 초과되었습니다. 필터를 다시 생성해야 합니다.

-32001Resource Not FoundRPC

요청하신 리소스가 존재하지 않거나 사용할 수 없습니다.

-32002Resource UnavailableRPC

요청하신 리소스를 일시적 또는 영구적으로 이용할 수 없습니다.

-32003Transaction RejectedRPC

유효성 검사 실패 또는 리소스 부족으로 인해 트랜잭션을 생성할 수 없습니다.

-32004Method Not SupportedRPC

요청된 메서드는 서버에서 구현되지 않았거나 지원되지 않습니다.

-32005Limit ExceededRPC

이 요청은 허용된 한도 또는 할당량을 초과했습니다.

-32006JSON-RPC Version Not SupportedRPC

지정된 JSON-RPC 버전은 서버에서 지원되지 않습니다.

-32009Trace requests limitedRPC

노드의 과부하를 방지하기 위해 디버그 및 추적 메서드를 특정 RPS로 제한했습니다.

-32010Transaction cost exceeds gas limitRPC

가스 제한값이 너무 낮게 설정되어 있습니다.

-32011Network errorRPC

이 오류는 타임아웃이나 연결 끊김과 같이 클라이언트와 서버 간의 연결에 문제가 있을 때 발생합니다.

-32015VM execution errorRPC

스마트 계약 실행 오류

-32600Invalid requestRPC

JSON 요청의 형식이 올바르지 않거나 필수 필드가 누락되었습니다. 예상되는 형식을 따르는지 확인하십시오.

-32601Method not foundRPC

대개 메서드 이름에 오타가 있는 경우가 많으니, 철자 오류를 확인해 보세요.

-32601Failed to parse requestRPC

요청 본문이 올바르지 않습니다. 메서드 매개변수를 다시 한 번 확인해 주세요.

-32602Invalid params - missing 0x prefixRPC

요청이 올바르지 않습니다. 주소에서 0x가 누락되었습니다. 16진수

-32602Block range limit exceededRPC

eth_getLogs 및 eth_newFilter는 10,000 블록 범위 내에서만 사용할 수 있습니다. 자세한 내용은 지원 문서를 참조하십시오.

-32603Internal JSON-RPC errorRPC

이 오류는 대개 페이로드에 문제가 있거나 유효하지 않기 때문에 발생합니다.

-32700Parse errorRPC

유효하지 않은 JSON이 수신되었습니다. 서버에서 JSON 텍스트를 분석하는 동안 오류가 발생했습니다.

3Execution revertedRPC

이 트랜잭션은 실행 도중 롤백되었는데, 이는 조건 미충족, 가스 부족 또는 계약 오류 때문인 것으로 보입니다.

-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.

EVM RPC Error Code Example​

아래 코드 조각은 오류 코드 -32601의 예시입니다.

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
			"code": -32601,
			"message": "the method eth_randomMethod does not exist/is not available"
		}
}

위에서 정의한 RPC 오류들은 ETH, BSC, Polygon 같은 체인에서 개발하는 동안 발생할 수 있는 일반적인 오류들을 모아놓은 것입니다. 이러한 체인들은 각각 고유한 오류 정의를 가진 여러 클라이언트에서 실행됩니다. 노드 클라이언트 소스 코드에 언급된 오류들은 여기에서도 확인할 수 있습니다:


다른 오류 코드가 표시되는 경우, 지원 티켓을 제출하여 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.

최종 업데이트 ~에서