JSON RPC errors

A list of codes and descriptions of errors that could be send back from the JSONRPC server. JSONRPC response messages could contains different set of errors in the following format:

注釈

Check Errors for details about the error structure.

In some cases the data field could be populated:

{
   "jsonrpc": "2.0",
   "error":{
      "code": 10,
      "message": "Unauthorized action",
      "data":[
         {
            "code": 2,
            "message":"Denied privileged API access for uid=XXX gid=XXX"
         }
      ]
   },
   "id":"5e273ec0-3e3b-4a81-90ec-aeee3d38073f"
}

Standard errors

Id

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

Custom errors

The following error list are defined by the server.

Id

Message

Description

1

Invalid version, 2.0 only

The server only accepts version field equal to 2.0.

2

Invalid version type, should be a string

Version field should be a literal string.

3

Missing version field

No version field present, version field is mandatory.

4

Invalid method type, should be a string

The method field should be a literal string.

5

Missing method field

No method field present, method field is mandatory.

6

Invalid params type. A Structured value is expected

Params field should be a structured type, list or structure. This is similar to -32602

7

Invalid id type

If field should be a literal string.

8

Use of null as id is discouraged

Id field value is null, as per the specs this is discouraged, the server will not accept it.

9

Error during execution

An error occurred during the execution of the RPC call. This error is used as a generic High level error. The specifics details about the error, in most cases are specified in the data field.

10

Unauthorized action

The rpc method will not be invoked because the action is not permitted by some constraint or authorization issue.Check Unauthorized action for mode details.

11

Use of an empty string as id is discouraged

An empty string "" as an id will not be accepted by the server.

Unauthorized action

Under this error, the data field could be populated with the following errors, eventually more than one could be in set.

"data":[
   {
      "code":2,
      "message":"Denied privileged API access for uid=XXX gid=XXX"
   }
]

Id

Message

Description

1

Error getting peer credentials: {}

Something happened while trying to get the peers credentials. The error string will show the error code(errno) returned by the server.

2

Denied privileged API access for uid={} gid={}

Permission denied. Unix Socket credentials were checked and they haven't meet the required policy. The handler was configured as restricted and the socket credentials failed to validate. Check TBC for more information.