XPR
<p>[[toc]]</p>
<h3>修改历史</h3>
<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.19.250/xrp/account</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>
</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": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"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.19.250/xrp/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": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"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.19.250/xrp/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": "7f1b51210ca97f3b41c7457c072f8fa3b77016edfd82aade84f16f37d280e3f1"
}</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>5 查询余额</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定地址的余额</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.19.250:8080/xrp/account/[:address]/balance</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 http://47.254.19.250:8080/xrp/account/ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c/balance </code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"balance": "23.879944"
}</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>6 查询交易历史</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询指定地址的历史交易记录</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.19.250:8080/xrp/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.19.250:8080/xrp/account/ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c/history</code></p>
<p><strong>返回示例</strong></p>
<pre><code>{
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"transactions": [
"F39A8180D2D9890D4D1FED375A94987F8C476C8E5A54FFEBCAFF62645A26299A",
"C0E462560712D38AD4DC7BBD3B67C4395A574FEDDED402194F4F1F0DF01F8A9C",
"C595759B559800BE3EE73B888FE496EF76564500BD90EF6C1E6E24D3D2B2FC6D"
]
}</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>7 查询详细交易历史</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.19.250:8080/xrp/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.19.250:8080/xrp/account/ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c/history.detail</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"transactions": [
{
"from": {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"currency": "XRP",
"value": "0.2"
},
"to": {
"address": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"currency": "XRP",
"value": "0.2"
},
"hash": "4D36A740E2C6E268EAD14AEFB33F7198EF2FE2E20EB9ECC7476497E7BD7C97FC",
"timestamp": "1534936502",
"ledgerIndex": "40978891",
"fee": "0.000012",
"receive": "-0.2"
},
{
"from": {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"currency": "XRP",
"value": "0.1"
},
"to": {
"address": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"currency": "XRP",
"value": "0.1"
},
"hash": "F39A8180D2D9890D4D1FED375A94987F8C476C8E5A54FFEBCAFF62645A26299A",
"timestamp": "1534933181",
"ledgerIndex": "40977967",
"fee": "0.00001",
"receive": "-0.1"
},
{
"from": {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"currency": "XRP",
"value": "21"
},
"to": {
"address": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"currency": "XRP",
"value": "21"
},
"hash": "C0E462560712D38AD4DC7BBD3B67C4395A574FEDDED402194F4F1F0DF01F8A9C",
"timestamp": "1534932991",
"ledgerIndex": "40977916",
"fee": "0.000012",
"receive": "-21"
},
{
"from": {
"address": "r4YC1aD49aHtm33Az1vxhfBbLp3VCkvEuT",
"currency": "XRP",
"value": "44.98"
},
"to": {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"currency": "XRP",
"value": "44.98"
},
"hash": "C595759B559800BE3EE73B888FE496EF76564500BD90EF6C1E6E24D3D2B2FC6D",
"timestamp": "1534929182",
"ledgerIndex": "40976894",
"fee": "0.00001",
"receive": "44.98"
}
]
}</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>
</tbody>
</table>
<h2>8 发起交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>发起一笔交易</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://47.254.19.250/xrp/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;">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><strong>调用示例</strong></p>
<pre><code>//POST body
{
ansa, ansb, ansc, time, enc....
"to": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"amount": "25.0123",
"fee": "0.000012",
"uuid": "someuuid"
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"txid": "AB65C580D672AECF949C9EDACBD1014F24D9FD0E6ADFF232AF8DD5983F7AB6FF"
}</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;">txid</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.19.250:8080/xrp/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.19.250:8080/xrp/transaction/C0E462560712D38AD4DC7BBD3B67C4395A574FEDDED402194F4F1F0DF01F8A9C/info</code></p>
<p><strong>返回示例</strong></p>
<pre><code>// 成功的XRP到XRP的交易，result为tesSUCCESS
{
"ledgerIndex": "40977916",
"id": "C0E462560712D38AD4DC7BBD3B67C4395A574FEDDED402194F4F1F0DF01F8A9C",
"from": {
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"currency": "XRP",
"value": "21"
},
"to": {
"address": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"currency": "XRP",
"value": "21"
},
"timestamp": "1534932991",
"fee": "0.000012",
"result": "tesSUCCESS"
}
// 失败的交易，to中无currency和value字段，result也不为tesSUCCESS
{
"ledgerIndex": "40978257",
"id": "8F247B3482F60752F427B173C9D4A599DC10C6106C2C7A5348B90060E7F1C057",
"from": {
"address": "r9KG7Du7aFmABzMvDnwuvPaEoMu4Eurwok",
"currency": "XRP",
"value": "4199.9958"
},
"to": {
"address": "rHaans8PtgwbacHvXAL3u6TG28gTAtCwr8"
},
"timestamp": "1534934240",
"fee": "0.000011",
"result": "tecPATH_DRY"
}
// 成功的不同币之间的交易
{
"ledgerIndex": "40954602",
"id": "3834BE9C41F40FBC40B3F074F8A450820E96E6F5DB75D4CAB3C2E1FBF6DB9F2B",
"from": {
"address": "r9KG7Du7aFmABzMvDnwuvPaEoMu4Eurwok",
"currency": "XRP",
"value": "4199.9958"
},
"to": {
"address": "rHaans8PtgwbacHvXAL3u6TG28gTAtCwr8",
"currency": "GCB",
"value": "275.314895"
},
"timestamp": "1534846221",
"fee": "0.000011",
"result": "tesSUCCESS"
}</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;">ledgerIndex</td>
<td style="text-align: left;">string</td>
<td>账本号，相当于区块高度</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">string</td>
<td>txid</td>
</tr>
<tr>
<td style="text-align: left;">from</td>
<td style="text-align: left;">object</td>
<td>交易发起地址</td>
</tr>
<tr>
<td style="text-align: left;">to</td>
<td style="text-align: left;">object</td>
<td>交易目的地址，交易失败时，to中没有currency和value字段</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;">result</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>
<p><strong>NOTE</strong>
在确定充值是否到帐时，有几个点一定要注意</p>
<ul>
<li>检查to中address是否为充值地址，currency是否为XRP，充值金额以to中value为准，因为有时发起交易指定的金额与实际到帐金额不同</li>
<li>然后一定要检查result字段，只有当result为tesSUCCESS时，交易才算成功</li>
</ul>
<h2>10 估计手续费</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>获取手续费的估计值，这个值取决于最近几个区块中的所有交易的Gas Price的中位数</li>
<li>此值仅供参考</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.19.250:8080/xrp/transaction/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": "0.000012"
}</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>11 批量查询余额</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>查询多个地址的余额</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.19.250:8080/xrp/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":["r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e", "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c"]
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>[
{
"address": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"balance": "21.1"
},
{
"address": "ra6KthzhBp9QWDmQmGW2ENasBtmft7nF4c",
"balance": "23.879944"
}
]</code></pre>
<p><strong>返回参数说明</strong> </p>
<p>结果数组</p>
<h2>12 检查地址是否合法</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>检验地址是否正确，如果地址为全小写或者全大写，将会跳过校验和检查</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://47.254.19.250:8080/xrp/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.39.140:8080/ethereum/account/r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e/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>13 私钥发起交易</h2>
<p><strong>简要描述：</strong> </p>
<ul>
<li>使用私钥发起一笔交易，而不是助记词</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://47.254.19.250/xrp/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>//POST body
{
"priv": "abc",
"to": "r4orezWf5Adsct5xFms3nVyRWJG8DZDm2e",
"amount": "25.0123",
"fee": "0.000012",
"uuid": "someuuid"
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
"txid": "AB65C580D672AECF949C9EDACBD1014F24D9FD0E6ADFF232AF8DD5983F7AB6FF"
}</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;">txid</td>
<td style="text-align: left;">string</td>
<td>交易ID</td>
</tr>
</tbody>
</table>