跳至主要內容

Zcash Error Code Reference

更新於
Apr 29, 2026
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 請求類型不正確(例如:使用 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
}

Zcash RPC Error Codes

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

-32700Parse errorRPC

Invalid JSON was received by the server; check JSON syntax and formatting

-32600Invalid RequestRPC

The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification

-32601Method not foundRPC

The method does not exist or is not available; verify method name spelling or check if the method requires a specific add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)

-32602Invalid paramsRPC

Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation

-32603Internal errorRPC

Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself

-1Miscellaneous errorRPC

General error that doesn't fit other categories; check error message for specific details

-2Forbidden by safe modeRPC

Server is in safe mode, and command is not allowed in safe mode

-3Type errorRPC

Unexpected type was passed as parameter; ensure parameter types match expected values

-4Wallet errorRPC

Unspecified problem with wallet (key not found etc.)

-5Invalid address or keyRPC

Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)

-6Insufficient fundsRPC

Not enough funds in wallet or account

-7Out of memoryRPC

Ran out of memory during operation

-8Invalid parameterRPC

Invalid, missing or duplicate parameter

-9Client not connectedRPC

Bitcoin is not connected

-10Client in initial downloadRPC

Still downloading initial blocks

-11Invalid account nameRPC

Invalid account name

-12Keypool ran outRPC

Keypool ran out, call keypoolrefill first

-13Wallet unlock neededRPC

Enter the wallet passphrase with walletpassphrase first

-14Wallet passphrase incorrectRPC

The wallet passphrase entered was incorrect

-15Wrong encryption stateRPC

Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)

-16Wallet encryption failedRPC

Failed to encrypt the wallet

-17Wallet already unlockedRPC

Wallet is already unlocked

-18Wallet not foundRPC

Invalid wallet specified

-19Wallet not specifiedRPC

No wallet specified (error when there are multiple wallets loaded)

-20Database errorRPC

Database read/write error; this may indicate corruption or disk issues

-22Deserialization errorRPC

Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted

-23Node already addedRPC

Node is already added

-24Node not addedRPC

Node has not been added before

-25Verify errorRPC

General error during transaction or block submission

-26Verify rejectedRPC

Transaction or block was rejected by network rules

-27Verify already in chainRPC

Transaction already in chain

-28Client in warmupRPC

Client still warming up

-29Node not connectedRPC

Node to disconnect not found in connected nodes

-30Invalid IP or subnetRPC

Invalid IP/Subnet

-31P2P disabledRPC

No valid connection manager instance found

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

Zcash RPC Error Code Example

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  },
  "id": 1
}

Endpoint

Quicknode 為您的 RPC 端點Quicknode 日誌,以協助您診斷問題。您可透過導航至以下位置,直接在Quicknode 查看日誌:


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

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

哪些內容會被記錄

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

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

記錄限制

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

保存與存取

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

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