Start
Description
IPC：Supported by all RPC API
*nix(Linux Darwin):
~/.gvite/testdata/gvite.ipcWindows:
\\.\pipe\gvite.ipc
Http：Supported by public API. Default port is 48132. Note: API in wallet module is excluded
WebSocket：Supported by public API. Default port is 31420. Note: API in wallet module is excluded
Note
- To avoid unexpected behaviors, using standard JSON RPC 2.0 library is highly recommended
- A transaction or tx is equivalent to an account block
- Byte array should be converted to base64 encoding before passing in
uint64,floatandbig.intare passed in string
Common RPC Errors
| Description | Code | Message | Example |
|---|---|---|---|
| Failed to parse JSON string | -32700 | JSON parse failure | {"code":-32700,"message":"missing request id"} |
| Invalid JSON request | -32600 | Invalid request | {"code":-32600,"message":"Unable to parse subscription request"} |
Method not found. Please check if corresponding module has been configured in PublicModules | -32601 | Method not found | {"code":-32601,"message":"The method tx_sendRawTx does not exist/is not available"} |
| Parameter type error | -32602 | Invalid parameter | {"code":-32602,"message":"missing value for required argument"} |
| Service stopped | -32000 | Server shut down | {"code":-32000,"message":"server is shutting down"} |
| Service temporarily unavailable. Please try again later | -32001 | Server panic | {"code":-32001,"message":"server execute panic"} |
| Callback error | -32002 | Callback error | {"code":-32002,"message":"notifications not supported"} |
Common Business Errors
| Description | Code | Message | Example |
|---|---|---|---|
| Wrong password | -34001 | Key decryption error | {"code":-34001,"message":"error decrypting key"} |
| Insufficient balance | -35001 | Insufficient balance for transfer | {"code":-35001,"message":"insufficient balance for transfer"} |
| Insufficient quota | -35002 | Out of quota | {"code":-35002,"message":"out of quota"} |
| Invalid parameter | -35004 | Invalid method param | {"code":-35004,"message":"invalid method param"} |
| Too many PoW requests | -35005 | PoW called twice in one snapshot block | {"code":-35005,"message":"calc PoW twice referring to one snapshot block"} |
| ABI Method not found | -35006 | ABI method not found | {"code":-35006,"message":"abi: method not found"} |
| Invalid response latency upon contract creation | -35007 | Invalid confirm time | {"code":-35007,"message":"invalid confirm time"} |
| Contract not found | -35008 | Contract not exist | {"code":-35008,"message":"contract not exists"} |
| Invalid quota multiplier upon contract creation | -35010 | Invalid quota ratio | {"code":-35010,"message":"invalid quota ratio"} |
| PoW not available due to network jam | -35011 | PoW service not supported | {"code":-35011,"message":"PoW service not supported"} |
| Maximum quota for single transaction reached | -35012 | quota limit for block reached | {"code":-35012,"message":"quota limit for block reached"} |
| Invalid block producing address | -36001 | Block producing address not valid | {"code":-36001, "message":"general account's sendBlock.Height must be larger than 1"} |
| Hash verification failure | -36002 | Hash verification failed | {"code":-36002,"message":"verify hash failed"} |
| Signature verification failure | -36003 | Signature verification failed | {"code":-36003,"message":"verify signature failed"} |
| Invalid PoW nonce | -36004 | PoW nonce check failed | {"code":-36004,"message":"check pow nonce failed"} |
| Hash verification failure for previous block | -36005 | PreHash verification failed | {"code":-36005,"message":"verify prevBlock failed, incorrect use of prevHash or fork happened"} |
| Waiting for block | -36006 | Pending for block referred to | {"code":-36006,"message":"verify referred block failed, pending for them"} |
JSON-RPC Support
| JSON-RPC 2.0 | HTTP | IPC | Publish–Subscribe | WebSocket |
|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ |
Wallet →