1. Home
  2. Docs
  3. Paralism 节点 RPC 接口
  4. RPC方法列表
  5. Coin相关RPC方法

Coin相关RPC方法

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
}
Was this article helpful to you? Yes No