issuecoin
功能:发行数字货币
参数:<Name>,数字货币名称
[Genesis block description],创世块描述信息
[Model],挖矿算法模型,默认为PARA
[Logo],数字货币标识logo
返回结果:返回该数字货币创世块上链交易标识gid
备注:发行数字货币即数字货币创世块信息发送上链。gid是数字货币创世块元数据的hash。创世块上链成功前,应用程序可通过gid2rid方法获取上链交易在交易提交节点的交易状态查询句柄rid。创世块上链成功后,应用程序可通过querygenesisblock方法通过gid获取创世块信息。
调用样例:
{
"method":"issuecoin",
"params":[
"NewCoin",
"Hello NewCoin..."
],
"id":11222
}
返回结果样例:
{
"result": {
"gid": "a66798466b70a34bc50b3ada1b2b5c7bbc72e7e3d556aabe6287cda7fec2d25e"
},
"error": null,
"id": 11222
}
gid2rid
功能:获取gid对应的上链交易请求rid
参数:{GID},创世块上链交易查询id
返回结果:返回gid对应的请求id
备注:应用程序获得请求id后可用RestAPI接口GetOnchainState查询创世块上链状态
调用样例:
{
"method":"gid2rid",
"params":[" a66798466b70a34bc50b3ada1b2b5c7bbc72e7e3d556aabe6287cda7fec2d25e"],
"id":16
}
返回结果样例:
{
"result": {
"requestid": "4WeQfbxqidFTN85mqV2ZXuDQ6cvH"
},
"error": null,
"id": 16
}
querygenesisblock
功能:查询某币的创世块三元组地址
参数:{GID}
返回结果:返回创世块三元组地址
调用方式:
{
"method":"querygenesisblock",
"params":[" a66798466b70a34bc50b3ada1b2b5c7bbc72e7e3d556aabe6287cda7fec2d25e"],
"id":16
}
返回结果:
{
"result": {
"hyperblockId": 952,
"chainNum": 1,
"localblockId": 2
},
"error": null,
"id": 16
}
getcoininfo
功能:获取数字货币基本信息
参数:<hyperblockId, LocalchainId, localblockId>,数字货币创世块三元组地址
返回结果:返回数字货币创世块元信息
调用样例:
{
"method":"getcoininfo",
"params":[
"952",
"1",
"2"
],
"id":16
}
返回结果样例:
{
"result": {
"name": "NewCoin",
"message": "Hello NewCoin...",
"model": "PARA",
"logo": ""
},
"error": null,
"id": 16
}
importcoin
功能:在将数字货币信息导入到节点本地
参数:<hyperblockId, LocalchainId, localblockId>,数字货币创世块三元组地址
返回结果:返回数字货币创世块元信息
备注:导入完成后,应用程序可操作节点开始在数字货币上挖矿
调用样例:
{
"method":"importcoin",
"params":[
"952",
"1",
"2"
],
"id":16
}
返回结果:
{
"result": {
"name": "NewCoin",
"message": "Hello NewCoin...",
"model": "PARA",
"logo": ""
},
"error": null,
"id": 16
}
startmining
功能:指定数字货币启用挖矿
参数:[name|[hyperblockId,localchainId,localblockId]],数字货币名或者创世块三元组
返回结果:返回挖矿状态
备注:节点上运行多个数字货币时,只能独占对一种货币挖矿。调用本方法可自动切换挖矿币种。无输入参数时,默认启动最近挖矿的币种。
调用样例:
{
"method":"startmining",
"params":[],
"id":16
}
返回结果样例:
{
"result": null,
"error": {
"code": -2,
"message": "paracoin is mining"
},
"id": 16
}
stopmining
功能:停止数字货币挖矿
参数:无
返回结果:返回挖矿状态
调用样例:
{
"method":"stopmining",
"params":[],
"id":16
}
返回结果样例:
{
"result": {
"result": "ok, stopped"
},
"error": null,
"id": 16
}
queryminingstatus
功能:查询数字货币挖矿运行状态
参数:无
返回结果:挖矿状态信息
备注:状态码与状态信息信息如下
- Mining = 1,
- MiningWithWarning1 = 2, // Warning: Seed server’s block information is unknown
- MiningWithWarning2 = 3,// Block height less than seed server’s
- MiningWithWarning3 = 4,// Block hash different from seed server’s
- Switching = 0,// Switching to the best chain
- GenDisabled = -1, // Stopped or disabled, Specify \”-gen\” option to enable
- HyperBlockNotReady = -2,
- NoAnyNeighbor = -3,
- InvalidGenesisBlock = -4,
- MiningSettingClosed= -5,
- ManyBlocksNonChained= -6,
- ChainIncomplete = -7,
调用样例:
{
"method":"queryminingstatus",
"params":[],
"id":16
}
返回结果样例:
{
"result": {
"status": "mining",
"statuscode": 1,
"currentheight": 1652,
"statusdesc": "Mining"
},
"error": null,
"id": 16
}
或者
{
"result": {
"status": "stopped",
"statuscode": -5,
"currentheight": 1652,
"statusdesc": "Coin's mining setting is closed"
},
"error": null,
"id": 16
}
getdifficulty
功能:获取节点挖矿出块难度与最小难度的比值
参数:无
返回结果:挖矿难度比值。
调用样例:
{
"method":"getdifficulty",
"params":[],
"id":xxx
}
返回结果:
{
"result": 1.00000000,
"error": null,
"id": 2
}
getgenerate
功能:当前节点挖矿功能是否开启
参数:无
返回结果:true表示节点挖矿功能已开启,false表示未开启
调用样例:
{
"method":"getgenerate",
"params":[],
"id":xxx
}
返回结果样例:
{
"result": true,
"error": null,
"id": xxx
}
setgenerate
功能:启/停para节点挖矿功能
参数:[true | false]
返回结果:成功则result返回null,失败则返回error错误信息。
调用样例:
{
"method": "setgenerate",
"params":[true/false],
"id":xxx
}
返回结果样例:
{
"result": null,
"error": null,
"id": xxx
}