Translate

JSON RPC 错误码

JSON RPC 标准错误码

错误码	错误消息	描述
-32700	解析错误	非 JSON 格式数据
-32600	请求错误	含有错误的请求值
-32601	请求服务方法错误	调用方法不存在或错误
-32602	非法参数	调用方法参数错误
-32603	内部错误	内部错误(NotReady)
-32003	查询类错误	见示例
-32006	交易认证类错误	见示例
-32099	请求超时	见示例

常见错误

交易错误

• 交易 valid_until_block 过时

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32006,
        "message": "InvalidUntilBlock"
    }
}

• 重复交易

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32006,
        "message": "Dup"
    }
}

• 非法 nonce

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32006,
        "message": "InvalidNonce"
    }
}

• 处理交易繁忙

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32006,
        "message": "Busy"
    }
}

• 签名错误

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32006,
        "message": "BadSig"
    }
}

• 内部错误

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32603,
        "message": "NotReady"
    }
}

请求超时

$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendRawTransaction","params":["..."],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32099,
        "message": "System time out, please resend"
    }
}

请求错误

• 发送 POST 请求，而不是 GET：

$ curl -X GET --data '{"jsonrpc":"2.0","method":"blockNumber","params":[],"id":"1"}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": "1",
    "error": {
        "code": -32600,
        "message": "Invalid request"
    }
}

调用错误

• 应使用 peerCount 方法，而不是 perCount：

$ curl -X POST --data '{"jsonrpc":"2.0","method":"perCount","params":[],"id":74}' 127.0.0.1:1337 | jq

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

非法参数

• 参数格式不正确

$ curl -X POST --data '{"jsonrpc":"2.0","method":"getBlockByNumber","params":[249, true],"id":1}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32602,
        "message": "Invalid params: invalid type: integer `249`, expected a hex block number or 'latest', 'earliest'."
    }
}

• 参数个数不正确：

$ curl -X POST --data '{"jsonrpc":"2.0","method":"getTransaction","params":["0x0063187e6a84ae731cf9",true],"id":2}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 2,
    "error": {
        "code": -32602,
        "message": "Invalid JSON-RPC params length"
    }
}

其他错误

• 高度未达到

$ curl -X POST --data '{"jsonrpc":"2.0","method":"getBlockByNumber","params":["0x99999",true],"id":2}' 127.0.0.1:1337 | jq

{
    "jsonrpc": "2.0",
    "id": 2,
    "result": null
}

参考文档:

1. JSON RPC specification
2. Ethereum wiki/JSON RPC Error Codes Improvement Proposal