以太坊经典
<p>[[toc]]</p>
<h3>修改历史</h3>
<ul>
<li><code>2018-08-03</code> 自定义助记词升级，修改<strong>创建账户</strong> 和<strong>发送交易</strong>，增加<strong>导入私钥</strong> 和<strong>导出私钥</strong>，删除<strong>根据私钥生成地址</strong></li>
<li><code>2018-07-17</code> 增加<strong>检查地址是否合法</strong>的接口</li>
<li><code>2018-07-17</code> 增加<strong>批量查询余额</strong>接口</li>
<li><code>2018-07-04</code> 发送交易增加uuid参数，保证幂等性</li>
<li><code>2018-07-04</code> 创建账户，根据私钥生成地址，发送交易改为强制使用HTTPS，使用443端口（HTTPS默认端口，可以不指定），请求时需要指定<a href="https://www.tapd.cn/21308131/documents/file_list/1121308131001000093">CA根证书</a></li>
</ul>
<h2>1 总体说明</h2>
<p>所有方法均返回JSON数据，所有调用应先检查status code，若不是<strong>200</strong>，则调用出错，返回的HTTP body中包含具体错误信息，如</p>
<pre><code> {
"error" : "some error message"
} </code></pre>
<h2>2 创建账户</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>创建账户</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://47.254.71.173/etc/account</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;"><strong>参数：</strong></th>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">ansa</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词a</td>
</tr>
<tr>
<td style="text-align: left;">ansb</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词b</td>
</tr>
<tr>
<td style="text-align: left;">ansc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词c</td>
</tr>
<tr>
<td style="text-align: left;">time</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>//POST body
{
"ansa":"22f5e8718e",
"ansb":"b62c9d94d3",
"ansc":"5e681fff9b",
"time":"ff3f4036a1164d1ddbad5b3edf9022addb3e1961a54a922708a6c1ffc49e5489"
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "0xBE2C0368D79e877C7C7743bF77975ACa5c8279c8",
"enc": "390B2305251C1F20494B48241F7D167748427248154214713C44113B0E3B6438663808317E0A352E5F3002282E26282C777B5474252223264E6C771A1D6A1F6A"
}</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;">enc</td>
<td style="text-align: left;">string</td>
<td>因子B</td>
</tr>
</tbody>
</table>
<h2>3 导入私钥</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>导入私钥</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://47.254.71.173/etc/account/import</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;">ansa</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词a</td>
</tr>
<tr>
<td style="text-align: left;">ansb</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词b</td>
</tr>
<tr>
<td style="text-align: left;">ansc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词c</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">priv</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>//POST body
{
"ansa":"22f5e8718e",
"ansb":"b62c9d94d3",
"ansc":"5e681fff9b",
"time":"ff3f4036a1164d1ddbad5b3edf9022addb3e1961a54a922708a6c1ffc49e5489",
"priv": "0x7f1b51210ca97f3b41c7457c072f8fa3b77016edfd82aade84f16f37d280e3f1"
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "0xBE2C0368D79e877C7C7743bF77975ACa5c8279c8",
"enc": "390B2305251C1F20494B48241F7D167748427248154214713C44113B0E3B6438663808317E0A352E5F3002282E26282C777B5474252223264E6C771A1D6A1F6A"
}</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;">enc</td>
<td style="text-align: left;">string</td>
<td>因子B</td>
</tr>
</tbody>
</table>
<h2>4 导出私钥</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>导入私钥</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://47.254.71.173/etc/account/dump</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;">ansa</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词a</td>
</tr>
<tr>
<td style="text-align: left;">ansb</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词b</td>
</tr>
<tr>
<td style="text-align: left;">ansc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词c</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">enc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>因子B</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>//POST body
{
"ansa":"22f5e8718e",
"ansb":"b62c9d94d3",
"ansc":"5e681fff9b",
"time":"ff3f4036a1164d1ddbad5b3edf9022addb3e1961a54a922708a6c1ffc49e5489",
"enc": "390B2305251C1F20494B48241F7D167748427248154214713C44113B0E3B6438663808317E0A352E5F3002282E26282C777B5474252223264E6C771A1D6A1F6A"
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"privateKey": "0x7f1b51210ca97f3b41c7457c072f8fa3b77016edfd82aade84f16f37d280e3f1"
}</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;">privateKey</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>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/account/[:address]/balance/[:lastnumber?]</code></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;">lastnumber</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>curl http://47.254.71.173:8080/etc/account/0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763/balance
curl http://47.254.71.173:8080/etc/account/0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763/balance/540000 </code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"address": "0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763",
"balance": "123"
}</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;">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>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/account/[:address]/history?page=1&pagesize=10</code></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;">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;">pagesize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>分页大小，默认为10</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong>
<code>curl http://47.254.71.173:8080/etc/account/0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763/history</code></p>
<p><strong>返回示例</strong></p>
<pre><code> {
"address": "0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763",
"transactions": [
"0x972b58d8331ad4bca2d6fd565ce1754bd4c35be40d29940c1b3cc5d4270be803",
"0x4c07834618eb6b45107981f239a2858194b9649c97ff420c52bf5c2ea7ef6f1b"
]
}</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;">transactions</td>
<td style="text-align: left;">array</td>
<td>交易ID</td>
</tr>
</tbody>
</table>
<h2>6 查询详细交易历史</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定地址的详细交易记录，除了交易ID，还附带from，to，value，timestamp</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/account/[:address]/history.detail?page=1&pagesize=10</code></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;">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;">pagesize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>分页大小，默认为10</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>curl http://47.254.71.173:8080/etc/account/0xeca692E0E5E118705988E499F09b4B579edDa0e6/history.detail</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "0x6FFD0E82A69c1f4955Fb99C36F8a5645Aa6D959c",
"transactions": [
{
"from": "0xDf7D7e053933b5cC24372f878c90E62dADAD5d42",
"to": "0x6FFD0E82A69c1f4955Fb99C36F8a5645Aa6D959c",
"amount": "10075602",
"hash": "0xc2866dd3db678a89b6854cd21280f851b1b2f8ea1f7cf964c6f774aac019abb9"
},
{
"from": "0xDf7D7e053933b5cC24372f878c90E62dADAD5d42",
"to": "0x6FFD0E82A69c1f4955Fb99C36F8a5645Aa6D959c",
"amount": "10128746",
"hash": "0x7db37b2c0701510cc96bde2531d379609884caff418bfb44f3b42d75879764ba"
},
{
"from": "0xDf7D7e053933b5cC24372f878c90E62dADAD5d42",
"to": "0x6FFD0E82A69c1f4955Fb99C36F8a5645Aa6D959c",
"amount": "10005825",
"hash": "0xceeff227a0eea976f7232eef562daf6f9dadcffdd73bb7746f3bc91d39a4e9f8"
}
]
}</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;">transactions</td>
<td style="text-align: left;">array</td>
<td>交易记录</td>
</tr>
<tr>
<td style="text-align: left;">transactions.from</td>
<td style="text-align: left;">string</td>
<td>交易发起者</td>
</tr>
<tr>
<td style="text-align: left;">transactions.to</td>
<td style="text-align: left;">string</td>
<td>交易目标</td>
</tr>
<tr>
<td style="text-align: left;">transactions.value</td>
<td style="text-align: left;">string</td>
<td>交易金额</td>
</tr>
<tr>
<td style="text-align: left;">transactions.hash</td>
<td style="text-align: left;">string</td>
<td>交易ID</td>
</tr>
</tbody>
</table>
<h2>7 发起交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>发起一笔交易</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transaction</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;">ansa</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词a</td>
</tr>
<tr>
<td style="text-align: left;">ansb</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词b</td>
</tr>
<tr>
<td style="text-align: left;">ansc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义助记词c</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">enc</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>因子B</td>
</tr>
<tr>
<td style="text-align: left;">to</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;">gas</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>gas数量，未花费的gas会退回</td>
</tr>
<tr>
<td style="text-align: left;">fee</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手续费</td>
</tr>
<tr>
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>通用唯一识别码，请确保每次交易uuid不同</td>
</tr>
</tbody>
</table>
<p><em>交易手续费为：实际使用的gas数量乘以gasPrice</em></p>
<p><strong>调用示例</strong></p>
<pre><code>curl --cacert ROOT.crt -H "Content-Type:application/json" -X POST –data \
'{"privateKey": "0x965da9d169db3da5b81f4d02a76eb2b403a0e505836050e250e947c4345df89b", \
"to": "0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763", "amount":"50000000", "gas":"21000", \
"fee":"21001", "uuid":"abc"}' https://47.254.71.173/etc/transaction
</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"transactionHash": "0x972b58d8331ad4bca2d6fd565ce1754bd4c35be40d29940c1b3cc5d4270be803"
}</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>
<h2>8 发送已签名交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>发送一笔已经用私钥签名了的交易</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transaction/sendsigned/[:rawTransaction]</code></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;">rawTransaction</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>已签名交易的hex string</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong>
<code>curl http://47.254.71.173:8080/etc/transaction/sendsigned/789abcd</code></p>
<p><strong>返回示例</strong></p>
<pre><code> {
"transactionHash": "0x972b58d8331ad4bca2d6fd565ce1754bd4c35be40d29940c1b3cc5d4270be803"
}</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>
<h2>9 查看交易确认次数</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查看一笔交易的确认次数</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transaction/[:hash]/confirmation</code></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;">hash</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>transactionHash</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>curl http://47.254.71.173:8080/etc/transaction/0x4c07834618eb6b45107981f239a2858194b9649c97ff420c52bf5c2ea7ef6f1b/confirmation </code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"number": 564678
}</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;">number</td>
<td style="text-align: left;">string</td>
<td>交易确认次数</td>
</tr>
</tbody>
</table>
<h2>10 查询交易打包信息</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询一个交易的信息</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transaction/[:txhash]/info</code></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;">txhash</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易哈希</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong>
<code>curl http://47.254.71.173:8080/etc/transaction/0x736da00bef4e305f17f865b9a0dcbf4cd3329624e42b2fbc80803ee7420e8acb/info</code></p>
<p><strong>返回示例</strong></p>
<pre><code>{
"blockHash": "0x37efbf02c8cc5a09044ad99f170750870d2fe8d52f61ac95d709561f74c4493e",
"blockNumber": "5452344",
"from": "0x97da025f8204a24a56d4c9414bba8406b279623e",
"to": "0x085fb4f24031eaedbc2b611aa528f22343eb52db",
"fee": "42000",
"timestamp": "1519555340"
}</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;">blockHash</td>
<td style="text-align: left;">string</td>
<td>交易所在区块的哈希</td>
</tr>
<tr>
<td style="text-align: left;">blockNumber</td>
<td style="text-align: left;">string</td>
<td>交易所在区块的序号</td>
</tr>
<tr>
<td style="text-align: left;">from</td>
<td style="text-align: left;">string</td>
<td>交易发起地址</td>
</tr>
<tr>
<td style="text-align: left;">to</td>
<td style="text-align: left;">string</td>
<td>交易目的地址</td>
</tr>
<tr>
<td style="text-align: left;">fee</td>
<td style="text-align: left;">string</td>
<td>实际手续费</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">uinx time</td>
<td>交易所在区块的时间戳</td>
</tr>
</tbody>
</table>
<h2>11 估计手续费</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>获取手续费的估计值，这个值取决于最近几个区块中的所有交易的Gas Price的中位数</li>
<li>此值仅供参考</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transation/fee</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数：</strong> </p>
<ul>
<li>
<p>None</p>
<p><strong>返回示例</strong></p>
</li>
</ul>
<pre><code> {
"fee": "42001"
}</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;">fee</td>
<td style="text-align: left;">string</td>
<td>手续费</td>
</tr>
</tbody>
</table>
<h2>12 查询指定区块中的交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定区块中的交易，可指定地址</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/block/[:blockHashOrNumber]/[:address?]</code></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;">blockHashOrNumber</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>要查询区块的hash或者number</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>如果指定地址，则只返回该地址的交易记录，不指定则返回所有交易</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong>
<code>curl http://47.254.71.173:8080/etc/block/5823165/0xE9b651a522253e7e9a597DAFB4b69aB972cf6dAe</code></p>
<p><strong>返回示例</strong></p>
<pre><code>{
"number": "5831482",
"hash": "0xd6058428eabd6afe1c5025ef05ce49e5f821e290f60faa9962d2422da8e01e03",
"transactions": [
{
"from": "0xE9b651a522253e7e9a597DAFB4b69aB972cf6dAe",
"to": "0x88FB9d24188a26056765AdC39E4c210Cb4eB17E3",
"amout": "500750000"
},
{
"from": "0x703cD80b71c9E137fc9CFF29dD3f580FAF63681A",
"to": "0xc2723db938E3e6A8a8B6F4b5480a2d9238F9F27c",
"amout": "90512845"
}
],
"timestamp": "1526013962"
}</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;">number</td>
<td style="text-align: left;">string</td>
<td>区块number</td>
</tr>
<tr>
<td style="text-align: left;">hash</td>
<td style="text-align: left;">string</td>
<td>区块hash</td>
</tr>
<tr>
<td style="text-align: left;">transactions</td>
<td style="text-align: left;">array</td>
<td>交易数组（若查询不到指定地址的交易，则为空数组）</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">unix time</td>
<td>区块时间戳</td>
</tr>
</tbody>
</table>
<h2>13 批量查询余额</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询多个地址的余额</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/balances</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;">addr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>地址数组</td>
</tr>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>// POST BODY
{
"addrs":["0x6A7Ed14d74e0df014824B4E6B788fCa99bAF04e9", "0x00f5ba4Dc5461AA61C2A0f620f823D5814f14eD2"]
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>[
{
"address": "0x6A7Ed14d74e0df014824B4E6B788fCa99bAF04e9",
"balance": "62760"
},
{
"address": "0x00f5ba4Dc5461AA61C2A0f620f823D5814f14eD2",
"balance": "24715503954874"
}
]</code></pre>
<p><strong>返回参数说明</strong> </p>
<p>结果数组</p>
<h2>14 检查地址是否合法</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>检验地址是否正确，如果地址为全小写或者全大写，将会跳过校验和检查</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http:/47.254.71.173:8080/etc/account/:address/check</code></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>
</tbody>
</table>
<p><strong>调用示例</strong></p>
<pre><code>curl 47.254.71.173:8080/etc/account/0x915d7915f2b469bb654A7D903A5d4417Cb8eA7Df/check</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"result": true
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;"><strong>返回参数说明</strong></th>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">bool</td>
<td>结果</td>
</tr>
</tbody>
</table>
<h2>15 私钥发起交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>发起一笔交易</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.71.173:8080/etc/transaction/admin</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;">privateKey</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>私钥</td>
</tr>
<tr>
<td style="text-align: left;">to</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;">gas</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>gas数量，未花费的gas会退回</td>
</tr>
<tr>
<td style="text-align: left;">fee</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手续费</td>
</tr>
<tr>
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>通用唯一识别码，请确保每次交易uuid不同</td>
</tr>
</tbody>
</table>
<p><em>交易手续费为：实际使用的gas数量乘以gasPrice</em></p>
<p><strong>调用示例</strong></p>
<pre><code>curl --cacert ROOT.crt -H "Content-Type:application/json" -X POST –data \
'{"privateKey": "0x965da9d169db3da5b81f4d02a76eb2b403a0e505836050e250e947c4345df89b", \
"to": "0x1dbe35dB279c0e0Ce0d0e1b92173d2216606d763", "amount":"50000000", "gas":"21000", \
"fee":"21001", "uuid":"abc"}' https://47.254.71.173/etc/transaction
</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"transactionHash": "0x972b58d8331ad4bca2d6fd565ce1754bd4c35be40d29940c1b3cc5d4270be803"
}</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>