# Start
# Description
IPC:Supported by all RPC API
*nix(Linux Darwin):
~/.gvite/testdata/gvite.ipc
Windows:
\\.\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
,float
andbig.int
are 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 →