Tempo Error Code Reference

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
}

Tempo RPC Error Codes

Let's look at the common Tempo RPC Error Codes you can encounter, what they mean and what you can do to prevent them.

-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 버전은 서버에서 지원되지 않습니다.

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

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

Endpoint

Quicknode 문제 진단을 돕기 위해 RPC 엔드포인트에 대한 로그를 Quicknode . 다음 경로로 이동하여 Quicknode 직접 로그를 확인할 수 있습니다:

사이드바의 엔드포인트
endpoint 선택
'로그' 탭 열기

시간 범위, 응답 유형, 메서드 및 네트워크별로 로그를 필터링할 수 있습니다.

어떤 내용이 기록되는가

Endpoint
해당 endpoint로 전송된 요청으로, HTTP 상태, 요청 메서드, RPC 메서드 또는 경로, 타임스탬프 등이 포함됩니다.

오류 세부 정보
가능한 경우, 실패한 요청에는 RPC 오류 코드, 요청 및 응답 본문, 관련 문서 링크와 같은 오류 세부 정보가 포함됩니다.

벌목 제한 사항

로그 가용성은 메서드, 응답 유형, 네트워크 및 요금제에 따라 달라질 수 있습니다. 최적의 endpoint 유지하기 위해 로깅은 ‘최선 노력(best-effort)’ 방식으로 운영됩니다. 낮은 지연 시간을 유지하기 위해 트래픽이 많은 시간대에는 일부 로그가 누락될 수 있습니다.

보존 및 접근

Build 및 Scale 요금제에는 표준 로그 보존 기간이 적용된 대시보드 이용 권한이 포함됩니다. Enterprise 요금제는 더 긴 로그 보존 기간과 로그 조회를 위한 프로그래매틱 API 접근 권한을 제공합니다.

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