跳至主要內容

Peaq Error Code Reference

更新於
2026年4月15日
Quicknode 為您的 RPC 端點Quicknode 錯誤日誌。您可直接從儀表板查看詳細的錯誤資訊,輕鬆識別並解決問題。

HTTP 錯誤代碼

讓我們來看看您可能會遇到的常見 HTTP 錯誤代碼、它們的含義,以及該如何預防這些錯誤。

400請求錯誤

HTTP 請求類型不正確(例如:使用 GET 而非 POST)或包含無效字元

401未經授權

當一項或多項安全性要求未獲滿足時,便可能發生此情況,例如:令牌驗證錯誤、IP 位址未在白名單中、JWT 無效等。

403存取遭拒

Endpoint (其中一個原因可能是款項逾期未繳)

403禁止存取 - 未找到自訂追蹤

自訂追蹤代碼未列入白名單(請提交工單以進行審核流程)

404未找到

網址不正確或方法不正確

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 錯誤代碼範例

以下程式碼片段是錯誤代碼429 的範例。

{
	"jsonrpc": "2.0",
	"error": {
		"code": 429,
		"message": "The requests per second (RPS) of your requests are higher than your plan allows."
	},
	"id": 1
}

Peaq RPC Error Codes

Let's look at the common Peaq 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

您交易中指定的非ce值低於發送者帳戶的下一個有效非ce值。

-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

Gas 限制設定過低

-32011Network errorRPC

當客戶端與伺服器之間的連線發生問題時(例如超時或連線中斷),便會出現此錯誤

-32015VM execution errorRPC

智慧合約執行錯誤

-32600Invalid requestRPC

JSON 請求格式不正確或缺少必填欄位。請確保其符合預期格式

-32601Method not foundRPC

通常是方法名稱中的拼寫錯誤;請檢查是否有拼寫錯誤

-32601Failed to parse requestRPC

請求正文不正確;請仔細檢查方法參數

-32602Invalid params - missing 0x prefixRPC

請求不正確;位址中缺少 0x。十六進位數

-32602Block range limit exceededRPC

eth_getLogs 和 eth_newFilter 的範圍上限為 10,000 個區塊。請參閱我們的支援文件以獲取詳細說明。

-32603Internal JSON-RPC errorRPC

此錯誤通常是因載荷有問題或無效所致

-32700Parse errorRPC

收到無效的 JSON。伺服器在解析 JSON 文字時發生錯誤

3Execution revertedRPC

該交易在執行過程中被撤銷,原因很可能是條件未滿足、Gas 不足或合約錯誤

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

Peaq 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 查看日誌:


  1. 側邊欄中的終點
  2. 選擇您的endpoint
  3. 開啟「日誌」分頁

您可以根據時間區間、回應類型、方法及網路來篩選日誌。

哪些內容會被記錄

Endpoint
發送至您endpoint請求,包括 HTTP 狀態碼、請求方法、RPC 方法或路徑,以及時間戳記。

錯誤詳細資訊
若有提供,失敗的請求將包含錯誤詳細資訊,例如 RPC 錯誤代碼、請求與回應正文,以及相關文件連結。

記錄限制

日誌的可用性可能因方法、回應類型、網路及方案而異。為維持最佳endpoint ,日誌記錄功能採「盡力而為」原則運作。在流量高峰期間,為維持低延遲,部分日誌可能會被捨棄。

保存與存取

「建置」與「擴展」方案包含儀表板存取權限,並提供標準的日誌保留期限。 「企業」方案則提供更長的保留期限,以及透過程式化 API 存取日誌的功能。

如果您遇到其他錯誤代碼,請透過提交服務單告知我們。我們非常樂意為您提供協助