😟 API Errors and Troubleshooting

Troubleshooting the standard JSON-RPC errors.

Example Error Response

{
"jsonrpc":"2.0",
"id":1,
"error":{
"code":-32602, // this is the reference error code
"message":"invalid argument 0: json: cannot unmarshal hex string of odd length into Go value of type common.Address"
}
}

A typical error message returned in JSON contains the following key fields.

  1. CODE : The JSON-RPC error code, see below for extended description.

  2. MESSAGE : An explanation of what went wrong, and how you can correct it.

JSON-RPC Error Codes

Code

Return Message

Description

-32700

Parse error

Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.

-32600

Invalid Request

The JSON sent is not a valid Request object.

-32601

Method not found

The method does not exist / is not available.

-32602

Invalid params

Invalid method parameter(s).

-32603

Internal error

Internal JSON-RPC error.