为方便开发者更容易的开发或者使用HPB钱包,HPB的钱包开发者们准备了一份常用的API接口介绍。

一、HPB版本控制器

1、查询版本号

描述:应用钱包查询版本号。

请求说明

请求方式: POST 
请求URL:http://47.75.96.163:9888/HpbComponent/cms/version

调用示例:

[

  "1","0"

]

请求参数说明:
图一

返回数据示例:

[

  "000000",                                                                                                 //响应状态(000000:成功;999999:失败)

  "成功",                                                                                                                            //响应消息提示
  {
 
 "map": {},                                                                                                                     //预留map

  "id": 36,                                                                                                                         //当前版本id

  "verNo": "1.0.0",                                                                                                         //版本号

  "downloadUrl": "https://fir.im/mw6r",                             
//下载地址

  "mobileType": 1,                                                                                      //手机类型 0-安卓 1-IOS 2-其它

  "remark": "1.0.2测试1120180806111",                       
//备注

  "createTime": 1533547987870,                                      
//创建时间戳

  "updateTime": 1534570817329,                                     
//更新时间戳

  "state": "1",                                                                                                    //状态:1-生效;0-失效

  "userId": 1,                                                                                                 //用户id

  "isForceFlag": "0",                                                                                    //是否强制更新:1-是;0-否

  "langType": "0",                                                                                                          //语言类型:0-中文;1-英文

  "verContent": "a1.0.2"                                                         //版本内容

  }

]

二、个人账户

1、获取账户余额

描述:应用钱包用户获取账户余额。

请求方式: POST 
请求URL:http://47.75.96.163:9888/HpbComponent/personal/getBalance

调用示例

[

  "0x09a0e8893efd605e6aaae9b0c8285a3f16e5f198"

]

请求参数说明
图二
返回数据示例:

[

  "000000",                                                                                                                      //响应状态(000000:成功;999999:失败)

  "成功",                                                                                                                                              //响应消息提示

  0                                                                                                   //余额

]

2、获取账户nonce

描述:应用钱包用户获取账户的随机数。

请求说明:

请求方式: POST 
请求URL:http://47.75.96.163:9888/HpbComponent/personal/getNonce

调用示例:

[

  "0x09a0e8893efd605e6aaae9b0c8285a3f16e5f198"

]

请求参数说明:
图三
返回数据示例:

[

   "000000",                                                                                                                     //响应状态(000000:成功;999999:失败)

  "成功",                                                                                                                                              //响应消息提示

  {
  "gasLimit": "50000",                                                                               // gasLimit

  "nonce": 0,                                                                                                 //nonce

  "gasPrice": "18000000000"                                                                 // gasPrice  
  }                                                                                  

]

三、个人查询

1、查询交易

描述:应用钱包根据交易哈希查询交易。

请求说明:

请求方式: POST 
请求URL:http://47.75.96.163:9888/HpbComponent/transaction/getTransactionByHash

调用示例:

[

  " 0x78a7012f467035e4ca1a8f6dffe6e138e1a24e591ba4945de5ef74bbcb69cd63"

]

请求参数说明:
图四
返回数据示例

[

  " 0x847af04fbd21a909726cf00aaa06acd820035d5a","0","1"

]

请求参数说明:
图五
返回数据示例:

[

  "000000",                                                                                  

//响应状态(000000:成功;999999:失败)

  "成功",                                                                                                                                              

//响应消息提示

  {

 "pageNum": 1,                                                                        //当前页码数

 "pageSize": 10,                                                                        //当前页大小

 "size": 6,                                                                                   //数据量

 "startRow": 1,                                                                          //开始行

 "endRow": 6,                                                                            //结束行

  "total": 6,                                                                                  //总记录数

  "pages": 1,                                                                                //总页数

  "list": [                                                                                       //数据list

   {

  "map": {},                                                                                //预留map

  "transactionHash": "0xf467c92777a820cb92f75556b5d06f69b635197c997b910c7dc4219a83f85ef9",
                                                                                                               //交易hash

  "fromAccount": "0x847af04fbd21a909726cf00aaa06acd820035d5a",             

//发起方

 "toAccount": "0x3795435afaec3bfb2388a1e2ef58108f564d3e07",                    

//接收方

  "nonce": 4,                                                                                  //nonce

 "tValue": "0",                                                                            //金额

  "gas": "90000",                                                                      //gas

 "gasPrice": "18000000000",                                                   //gasPrice

 "status": "0x1",                                                                    //状态

 "blockHash": "0x9163f7ff6b4611b3bd6957c4560ff3a45d4cc31f85753f6ec6819bd33d67eb34",                                                                                                   //所在块的hash

 "blockNumber": 150612,                                                  
 //块高

 "transactionIndex": null,                                                    //交易在块中的序号

 "tTimestap": 1534820055,                                                
//时间戳

  "gasUsed": "633",                                                               //gas费用

 "remark": null,                                                                     //

 "tInput": null,                                                                       //输入参数字段

 "actulTxFee": "11394000000000"

   }      

],

  "prePage": 0,                                                                             //前一页

  "nextPage": 0,                                                                           //下一页

  "isFirstPage": true,                                                                   //是否是第一页

  "isLastPage": true,                                                                   //是否是最后一页

  "hasPreviousPage": false,                                                      //是否有前一页

   "hasNextPage": false,                                                             //是否有下一页

   "navigatePages": 8,                                                                 //可显示的最大页数

   "navigatepageNums": [         //页数字段                                                 
      1
    ],

    "navigateFirstPage": 1,                                                               //第一页

    "navigateLastPage": 1,                                                               //最后一页

    "firstPage": 1,                                                                              //第一页

    "lastPage": 1                                                                                //最后一页

  }                                              

]

3、发送交易

描述:应用钱包用户发起交易。

请求说明:

请求方式: POST 
请求URL:http://47.75.96.163:9888/HpbComponent/transaction/sendRawTransaction

调用示例:

[

  " 0xf467c92777a820cb92f75556b5d06f69b635197c997b910c7dc4219a83f85ef9"

]

请求参数说明:
图六
返回数据示例

[
  "000000",                                                                                  //响应状态(000000:成功;999999:失败)

  "成功",                                                                                                                                              //响应消息提示

  {
  "hash": "0xdd19d1946bc000294d5d5e2ee01943bdd07165576460bd20e739964029214071",                                                                                                                                                          //交易hash

  "nonce": 2,                                                                                                  //nonce

  "blockHash": null,                                                                  //交易还在打包,块值为空

  "blockNumber": null,                                                            //交易还在打包,块值为空

  "transactionIndex": null,                                                      //交易还在打包

  "from": "0x847af04fbd21a909726cf00aaa06acd820035d5a",                                  //发送方

  "to": "0x3795435afaec3bfb2388a1e2ef58108f564d3e07",                      
//接收方

 "value": 0,                                                                                                  //值

 "gasPrice": 18000000000,                                                  //gasPrice

 "gas": 90000,                                                                          // gas number

 "input": null,                                                                            // input字段

 "creates": null,  
// null

  "publicKey": null,                                                                     // null

  }                                              

]

更多技术咨询

1.如果你想了解更多关于HPB的技术信息,请访问我们的GitHub WiKi:
HPB WiKi of GitHub

2.如果你想获得更多HPB信息,请关注我们的官方网站:
HPB Website


汪晓明
7 声望6 粉丝

HPB芯链创始人,巴比特专栏作家。十余年金融大数据、区块链技术开发经验,曾参与创建银联大数据。主创区块链教学视频节目《明说》30多期,编写了《以太坊官网文档中文版》,并作为主要作者编写了《区块链开发指南...