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
}
Starknet RPC Error Codes
When working with Starknet, understanding its API error codes is essential for effective troubleshooting and smooth application operation.
1Failed to receive transaction
Sequencer rejected the transaction during validation. Verify transaction format and required fields
10No trace available
Trace data not available for the transaction. Verify the transaction hash is correct and exists on the network
20Contract not found
The specified contract address does not exist on the network
21Invalid message selector
Function selector does not exist in the contract ABI
22Invalid call data
Calldata is malformed or contains invalid parameters. Verify parameter types and encoding
24Block not found
The requested block does not exist. Check block number/hash or wait for sync
26Invalid block hash
Block hash format is invalid. Ensure it's a valid hexadecimal string with correct length
27Invalid transaction index
Transaction index is out of range for this block
28Class hash not found
The specified class hash has not been declared on the network
29Transaction hash not found
No transaction found with the provided hash
31Page size too big
Page size exceeds the maximum allowed limit.
32No blocks
No blocks available in the specified range
33Invalid continuation token
The continuation token is invalid or has expired
34Too many keys in filter
Filter contains more keys than the maximum allowed
40Contract error
An error occurred during contract execution
41Transaction execution error
Transaction failed to execute. Check contract logic and resource limits
51Class already declared
Class already exists on the network. Duplicate declarations are not allowed
52Invalid transaction nonce
Invalid nonce for the account. Use the correct sequential nonce value
53Insufficient max fee
Max fee too low. Increase the fee to cover transaction costs
54Insufficient account balance
Account balance too low. Ensure sufficient funds to cover the transaction fee
55Validation failure
Account validation failed. Check your signature and account contract logic
56Compilation failed
Contract compilation failed. Fix Cairo code syntax and compilation errors
57Contract class size is too large
Contract class too large. Reduce the contract size to fit within network limits
58Non account
Sender is not an account contract. Only account contracts can send transactions
59Duplicate transaction
Transaction already exists in mempool. Avoid submitting duplicate transactions
60Compiled class hash mismatch
The compiled class hash does not match the declared hash
61Unsupported transaction version
Transaction version not supported. Use a compatible transaction version
62Unsupported contract class version
Contract class version not supported. Use a compatible Cairo compiler version
63Unexpected error
Unexpected server error occurred. Submit a ticket if the issue persists
Starknet RPC Error Code Example
The code snippet below is an example of Error Code 20.
{
"error": {
"code": 20,
"message": "Contract not found"
},
"id": 1,
"jsonrpc": "2.0"
}
Quicknode는 문제 진단을 돕기 위해 RPC 엔드포인트에 대한 로그를 제공합니다. 다음 경로로 이동하면 Quicknode 대시보드에서 직접 로그를 확인할 수 있습니다:
- 사이드바의 엔드포인트
- 엔드포인트 선택
- '로그' 탭 열기
시간 범위, 응답 유형, 메서드 및 네트워크별로 로그를 필터링할 수 있습니다.
어떤 내용이 기록되는가
엔드포인트 요청
해당 엔드포인트로 전송된 요청으로, HTTP 상태, 요청 메서드, RPC 메서드 또는 경로, 타임스탬프 등이 포함됩니다.
오류 세부 정보
가능한 경우, 실패한 요청에는 RPC 오류 코드, 요청 및 응답 본문, 관련 문서 링크와 같은 오류 세부 정보가 포함됩니다.
로그 기록 제한 사항
로그 가용성은 메서드, 응답 유형, 네트워크 및 요금제에 따라 달라질 수 있습니다. 최적의 엔드포인트 성능을 유지하기 위해 로깅은 ‘최선의 노력’ 원칙에 따라 운영됩니다. 낮은 지연 시간을 유지하기 위해 트래픽이 많은 시간대에는 일부 로그가 누락될 수 있습니다.
보존 및 접근
Build 및 Scale 요금제에는 표준 로그 보존 기간이 적용된 대시보드 이용 권한이 포함됩니다. Enterprise 요금제는 더 긴 로그 보존 기간과 로그 조회를 위한 프로그래매틱 API 접근 권한을 제공합니다.
다른 오류 코드가 표시된다면, 티켓을 제출하여 저희에게 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.