HBB接口文档
<h2>1 创建账户</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>创建账户</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get</li>
</ul>
<p><strong>参数：</strong>
无</p>
<p><strong>调用示例</strong></p>
<pre><code>http://localhost:1234/account/createAddress </code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "0xFe0a3e1E6F4c097fE288c8E53a821590FB8b1e6D",
"private": "0x334b9cefc3ccb81ccee90ee8900bc65eca278c3aead2b20ebe907611c68e5ca3"
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">private</td>
<td style="text-align: left;">string</td>
<td>私钥</td>
</tr>
</tbody>
</table>
<h2>2 锁定账户</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>锁定账户(不能转账)</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账户地址</td>
</tr>
<tr>
<td style="text-align: left;">contactAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合约地址</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>http://localhost:1234/account/lock?address=0x15C9962C10C648E0A529e84762DFB165d250dbFc&contactAddress=0x5214d68c22d17cef4029857aaef977b2de7d6344</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{ "status":200, "msg": "冻结成功" }</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>信息</td>
</tr>
</tbody>
</table>
<h2>3 解锁账户</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>解锁账户</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>get</li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账户地址</td>
</tr>
<tr>
<td style="text-align: left;">contactAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合约地址</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>http://localhost:1234/account/unlock?address=0x15C9962C10C648E0A529e84762DFB165d250dbFc&contactAddress=0x5214d68c22d17cef4029857aaef977b2de7d6344</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{ "status":200, "msg": "解锁成功" }</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>信息</td>
</tr>
</tbody>
</table>
<h2>4 查询余额</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定地址的代币余额</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账户地址</td>
</tr>
<tr>
<td style="text-align: left;">contactAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合约地址</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>http://localhost:1234/account/getBalance?address=0x15C9962C10C648E0A529e84762DFB165d250dbFc&contactAddress=0x5214d68c22d17cef4029857aaef977b2de7d6344</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "0x15C9962C10C648E0A529e84762DFB165d250dbFc",
"coinName": "HBB",
"coinAddress": "0x5214d68c22d17cef4029857aaef977b2de7d6344",
"balance": "200.0000000000000001"
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">coinName</td>
<td style="text-align: left;">string</td>
<td>代币名称</td>
</tr>
<tr>
<td style="text-align: left;">coinAddress</td>
<td style="text-align: left;">string</td>
<td>代币地址</td>
</tr>
<tr>
<td style="text-align: left;">balance</td>
<td style="text-align: left;">string</td>
<td>余额</td>
</tr>
</tbody>
</table>
<h2>5 查询交易历史</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定地址的代币历史交易记录</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">contactAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合约地址</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>分页，默认为1</td>
</tr>
<tr>
<td style="text-align: left;">offset</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>每页数量，默认为10</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong>
<code>http://localhost:1234/transaction/getTokenHistory?address=0x2c1d5736df93d443091b5f4582953aa454b5a36a&contactAddress=0x5214d68c22d17cef4029857aaef977b2de7d6344&page=1&offset=10</code></p>
<p><strong>返回示例</strong></p>
<pre><code>{
"jsonStr": {
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "9277796",
"timeStamp": "1578986751",
"hash": "0xefc91d730e164d806b6732546f805e9da6a645f7412913bbe6c526cf8a2b5640",
"nonce": "13",
"blockHash": "0x2e021ad62f1b4f5b0cf90e799b31b1e9b6bcc721de9d831ef02c510fc29ffc8c",
"from": "0x2c1d5736df93d443091b5f4582953aa454b5a36a",
"contractAddress": "0x5214d68c22d17cef4029857aaef977b2de7d6344",
"to": "0x15c9962c10c648e0a529e84762dfb165d250dbfc",
"value": "100",
"tokenName": "HBB",
"tokenSymbol": "HBB",
"tokenDecimal": "18",
"transactionIndex": "33",
"gas": "54469",
"gasPrice": "3000000000",
"gasUsed": "54469",
"cumulativeGasUsed": "1751708",
"input": "deprecated",
"confirmations": "162969"
},
{
"blockNumber": "9435688",
"timeStamp": "1581080522",
"hash": "0x7cd419a0dbcea9f81737d163cc034249640d25d3c077ad055945a32726811c98",
"nonce": "17",
"blockHash": "0xb5a610c6de16d8881668c3e5b20002152c5deaa5cf368a574fa144d534ae63ed",
"from": "0x2c1d5736df93d443091b5f4582953aa454b5a36a",
"contractAddress": "0x5214d68c22d17cef4029857aaef977b2de7d6344",
"to": "0x15c9962c10c648e0a529e84762dfb165d250dbfc",
"value": "100000000000000000000",
"tokenName": "HBB",
"tokenSymbol": "HBB",
"tokenDecimal": "18",
"transactionIndex": "146",
"gas": "50000",
"gasPrice": "8000000000",
"gasUsed": "39541",
"cumulativeGasUsed": "7204943",
"input": "deprecated",
"confirmations": "5077"
}
]
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<h2>6 发起交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>发起一笔代币交易，from地址必须有足够余额支付手续费</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://localhost:1234/transaction/send</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">fromaddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>from地址</td>
</tr>
<tr>
<td style="text-align: left;">toaddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>目的地址</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>转账金额</td>
</tr>
<tr>
<td style="text-align: left;">contactAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合约地址</td>
</tr>
<tr>
<td style="text-align: left;">privatekey</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>私钥</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>参数body:
{
"fromaddress":"0x2c1d5736df93d443091b5f4582953aa454b5a36a",
"contactAddress":"0x5214d68c22d17cef4029857aaef977b2de7d6344",
"toaddress":"0x15C9962C10C648E0A529e84762DFB165d250dbFc",
"privatekey":"3A6CFB4D63E34270300E8557ECFE063B23B2D6BC2F3FA35EFFDCB1C41A3EB0EA",
"amount":"100"
}
</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"transactionHash": "0x0e99691b069d85d18798682f962c4ac6fc5a2df2799ebbcdccb8b2bf61bd33d0"
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">transactionHash</td>
<td style="text-align: left;">string</td>
<td>交易ID</td>
</tr>
</tbody>
</table>