# 开始
# 说明
IPC 方式：支持所有 API 调用
*nix(linux darwin):
Unix domain Socket文件名称~/.gvite/maindata/gvite.ipcWindows: Named Pipe 受限于 Windows 的规范 文件名就是
\\.\pipe\gvite.ipc
Http：仅支持公共 API (非 wallet 模块) 默认端口 48132
WebSocket：仅支持公共 API (非 wallet 模块) 默认端口 31420
注意:
- 尽量使用标准的 Json rpc2 的库
- 术语 交易（transaction 或者 Tx） = account block
注意
所有 byte 数组的类型，请转为 base64 传递，uint64、float 和 big.int 都用 string 传递
# 常见 RPC 错误汇总
| 描述 | code | message | example |
|---|---|---|---|
| 服务端尝试解析 json 出错 | -32700 | 语法解析错误 | {"code":-32700,"message":"missing request id"} |
| json 不是一个有效的请求对象，缺少必要字段或者字段取值错误 | -32600 | 无效请求 | {"code":-32600,"message":"Unable to parse subscription request"} |
方法不存在，请确认已经在 PublicModules 中配置相应的模块，并且方法存在 | -32601 | 方法不存在 | {"code":-32601,"message":"The method tx_sendRawTx does not exist/is not available"} |
| 方法参数错误，例如方法要求传 uint8，实际传了 string | -32602 | 无效参数 | {"code":-32602,"message":"missing value for required argument"} |
| 服务器已经停止服务 | -32000 | server is shutting down | {"code":-32000,"message":"server is shutting down"} |
| 服务器执行异常，稍后重试即可 | -32001 | server execute panic | {"code":-32001,"message":"server execute panic"} |
| 回调方法返回错误 | -32002 | call back error | {"code":-32002,"message":"notifications not supported"} |
# 常见业务错误汇总
| 描述 | code | message | example |
|---|---|---|---|
| 密码错误 | -34001 | error decrypting key | {"code":-34001,"message":"error decrypting key"} |
| 余额不足 | -35001 | insufficient balance for transfer | {"code":-35001,"message":"insufficient balance for transfer"} |
| 配额不足 | -35002 | out of quota | {"code":-35002,"message":"out of quota"} |
| 参数错误 | -35004 | invalid method param | {"code":-35004,"message":"invalid method param"} |
| 通过计算 PoW 获取配额操作过于频繁 | -35005 | calc PoW twice referring to one snapshot block | {"code":-35005,"message":"calc PoW twice referring to one snapshot block"} |
| 合约方法不存在 | -35006 | abi: method not found | {"code":-35006,"message":"abi: method not found"} |
| 创建合约时确认次数非法 | -35007 | invalid confirm time | {"code":-35007,"message":"invalid confirm time"} |
| 合约地址不存在 | -35008 | contract not exists | {"code":-35008,"message":"contract not exists"} |
| 创建合约时配额翻倍数非法 | -35010 | invalid quota ratio | {"code":-35010,"message":"invalid quota ratio"} |
| 全网拥堵时，PoW 服务不可用 | -35011 | PoW service not supported | {"code":-35011,"message":"PoW service not supported"} |
| 超过交易最大可用配额 | -35012 | quota limit for block reached | {"code":-35012,"message":"quota limit for block reached"} |
| 出块地址不合法 | -36001 | block address not valid | {"code":-36001, "message":"general account's sendBlock.Height must be larger than 1"} |
| Hash 校验失败 | -36002 | verify hash failed | {"code":-36002,"message":"verify hash failed"} |
| 签名校验失败 | -36003 | verify signature failed | {"code":-36003,"message":"verify signature failed"} |
| Pow 值校验失败 | -36004 | check pow nonce failed | {"code":-36004,"message":"check pow nonce failed"} |
| 校验依赖的前一个块 Hash 失败 | -36005 | verify prevBlock hash failed | {"code":-36005,"message":"verify prevBlock failed, incorrect use of prevHash or fork happened"} |
| 等待依赖的关联交易块 | -36006 | pending for the 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 →