2054 lines
62 KiB
HTML
2054 lines
62 KiB
HTML
<!DOCTYPE html>
|
||
|
||
<html>
|
||
<head>
|
||
<title>Protocol Documentation</title>
|
||
<meta charset="UTF-8">
|
||
<link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Ubuntu:400,700,400italic"/>
|
||
<style>
|
||
body {
|
||
width: 60em;
|
||
margin: 1em auto;
|
||
color: #222;
|
||
font-family: "Ubuntu", sans-serif;
|
||
padding-bottom: 4em;
|
||
}
|
||
|
||
h1 {
|
||
font-weight: normal;
|
||
border-bottom: 1px solid #aaa;
|
||
padding-bottom: 0.5ex;
|
||
}
|
||
|
||
h2 {
|
||
border-bottom: 1px solid #aaa;
|
||
padding-bottom: 0.5ex;
|
||
margin: 1.5em 0;
|
||
}
|
||
|
||
h3 {
|
||
font-weight: normal;
|
||
border-bottom: 1px solid #aaa;
|
||
padding-bottom: 0.5ex;
|
||
}
|
||
|
||
a {
|
||
text-decoration: none;
|
||
color: #567e25;
|
||
}
|
||
|
||
table {
|
||
width: 100%;
|
||
font-size: 80%;
|
||
border-collapse: collapse;
|
||
}
|
||
|
||
thead {
|
||
font-weight: 700;
|
||
background-color: #dcdcdc;
|
||
}
|
||
|
||
tbody tr:nth-child(even) {
|
||
background-color: #fbfbfb;
|
||
}
|
||
|
||
td {
|
||
border: 1px solid #ccc;
|
||
padding: 0.5ex 2ex;
|
||
}
|
||
|
||
td p {
|
||
text-indent: 1em;
|
||
margin: 0;
|
||
}
|
||
|
||
td p:nth-child(1) {
|
||
text-indent: 0;
|
||
}
|
||
|
||
|
||
.field-table td:nth-child(1) {
|
||
width: 10em;
|
||
}
|
||
.field-table td:nth-child(2) {
|
||
width: 10em;
|
||
}
|
||
.field-table td:nth-child(3) {
|
||
width: 6em;
|
||
}
|
||
.field-table td:nth-child(4) {
|
||
width: auto;
|
||
}
|
||
|
||
|
||
.extension-table td:nth-child(1) {
|
||
width: 10em;
|
||
}
|
||
.extension-table td:nth-child(2) {
|
||
width: 10em;
|
||
}
|
||
.extension-table td:nth-child(3) {
|
||
width: 10em;
|
||
}
|
||
.extension-table td:nth-child(4) {
|
||
width: 5em;
|
||
}
|
||
.extension-table td:nth-child(5) {
|
||
width: auto;
|
||
}
|
||
|
||
|
||
.enum-table td:nth-child(1) {
|
||
width: 10em;
|
||
}
|
||
.enum-table td:nth-child(2) {
|
||
width: 10em;
|
||
}
|
||
.enum-table td:nth-child(3) {
|
||
width: auto;
|
||
}
|
||
|
||
|
||
.scalar-value-types-table tr {
|
||
height: 3em;
|
||
}
|
||
|
||
|
||
#toc-container ul {
|
||
list-style-type: none;
|
||
padding-left: 1em;
|
||
line-height: 180%;
|
||
margin: 0;
|
||
}
|
||
#toc > li > a {
|
||
font-weight: bold;
|
||
}
|
||
|
||
|
||
.file-heading {
|
||
width: 100%;
|
||
display: table;
|
||
border-bottom: 1px solid #aaa;
|
||
margin: 4em 0 1.5em 0;
|
||
}
|
||
.file-heading h2 {
|
||
border: none;
|
||
display: table-cell;
|
||
}
|
||
.file-heading a {
|
||
text-align: right;
|
||
display: table-cell;
|
||
}
|
||
|
||
|
||
.badge {
|
||
width: 1.6em;
|
||
height: 1.6em;
|
||
display: inline-block;
|
||
|
||
line-height: 1.6em;
|
||
text-align: center;
|
||
font-weight: bold;
|
||
font-size: 60%;
|
||
|
||
color: #89ba48;
|
||
background-color: #dff0c8;
|
||
|
||
margin: 0.5ex 1em 0.5ex -1em;
|
||
border: 1px solid #fbfbfb;
|
||
border-radius: 1ex;
|
||
}
|
||
</style>
|
||
|
||
|
||
<link rel="stylesheet" type="text/css" href="stylesheet.css"/>
|
||
</head>
|
||
|
||
<body>
|
||
|
||
<h1 id="title">Protocol Documentation</h1>
|
||
|
||
<h2>Table of Contents</h2>
|
||
|
||
<div id="toc-container">
|
||
<ul id="toc">
|
||
|
||
|
||
<li>
|
||
<a href="#bdware%2fbdledger%2fapi%2fcommon.proto">bdware/bdledger/api/common.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Block"><span class="badge">M</span>Block</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Contract"><span class="badge">M</span>Contract</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Transaction"><span class="badge">M</span>Transaction</a>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Contract.ContractUnitRequestType"><span class="badge">E</span>Contract.ContractUnitRequestType</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.TransactionType"><span class="badge">E</span>TransactionType</a>
|
||
</li>
|
||
|
||
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware%2fbdledger%2fapi%2ferror_details.proto">bdware/bdledger/api/error_details.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.InvalidArgument"><span class="badge">M</span>InvalidArgument</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.InvalidArgument.FieldViolation"><span class="badge">M</span>InvalidArgument.FieldViolation</a>
|
||
</li>
|
||
|
||
|
||
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware%2fbdledger%2fapi%2fledger.proto">bdware/bdledger/api/ledger.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.CreateLedgerRequest"><span class="badge">M</span>CreateLedgerRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.CreateLedgerResponse"><span class="badge">M</span>CreateLedgerResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetLedgersResponse"><span class="badge">M</span>GetLedgersResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.SendTransactionRequest"><span class="badge">M</span>SendTransactionRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.SendTransactionRequest.Transaction"><span class="badge">M</span>SendTransactionRequest.Transaction</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.SendTransactionResponse"><span class="badge">M</span>SendTransactionResponse</a>
|
||
</li>
|
||
|
||
|
||
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Ledger"><span class="badge">S</span>Ledger</a>
|
||
</li>
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware%2fbdledger%2fapi%2fnode.proto">bdware/bdledger/api/node.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.ClientVersionResponse"><span class="badge">M</span>ClientVersionResponse</a>
|
||
</li>
|
||
|
||
|
||
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Node"><span class="badge">S</span>Node</a>
|
||
</li>
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware%2fbdledger%2fapi%2fquery.proto">bdware/bdledger/api/query.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.BlockFilter"><span class="badge">M</span>BlockFilter</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.BlocksRequest"><span class="badge">M</span>BlocksRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.CountBlocksResponse"><span class="badge">M</span>CountBlocksResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.CountTransactionsResponse"><span class="badge">M</span>CountTransactionsResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetBlockByHashRequest"><span class="badge">M</span>GetBlockByHashRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetBlockByHashResponse"><span class="badge">M</span>GetBlockByHashResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetBlocksResponse"><span class="badge">M</span>GetBlocksResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetTransactionByBlockHashAndIndexRequest"><span class="badge">M</span>GetTransactionByBlockHashAndIndexRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetTransactionByBlockHashAndIndexResponse"><span class="badge">M</span>GetTransactionByBlockHashAndIndexResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetTransactionByHashRequest"><span class="badge">M</span>GetTransactionByHashRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetTransactionByHashResponse"><span class="badge">M</span>GetTransactionByHashResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.GetTransactionsResponse"><span class="badge">M</span>GetTransactionsResponse</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.RecentBlocksRequest"><span class="badge">M</span>RecentBlocksRequest</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.TransactionFilter"><span class="badge">M</span>TransactionFilter</a>
|
||
</li>
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.TransactionsRequest"><span class="badge">M</span>TransactionsRequest</a>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.IncludeTransactions"><span class="badge">E</span>IncludeTransactions</a>
|
||
</li>
|
||
|
||
|
||
|
||
<li>
|
||
<a href="#bdware.bdledger.api.Query"><span class="badge">S</span>Query</a>
|
||
</li>
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
|
||
<li>
|
||
<a href="#google%2fprotobuf%2fempty.proto">google/protobuf/empty.proto</a>
|
||
<ul>
|
||
|
||
<li>
|
||
<a href="#google.protobuf.Empty"><span class="badge">M</span>Empty</a>
|
||
</li>
|
||
|
||
|
||
|
||
|
||
</ul>
|
||
</li>
|
||
|
||
<li><a href="#scalar-value-types">Scalar Value Types</a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="bdware/bdledger/api/common.proto">bdware/bdledger/api/common.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Block">Block</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>区块的哈希，当区块处于待确认状态时为`null` </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>creator</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>产块者账户地址 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>nonce</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>这个区块之前产块者产生的区块数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>parent_hashes</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td>repeated</td>
|
||
<td><p>父区块的哈希 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>witnesses</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td>repeated</td>
|
||
<td><p>见证者账户地址 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>区块产生时的 UNIX 时间戳，单位为秒 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>size</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>区块大小的字节数 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>transaction_count</td>
|
||
<td><a href="#uint32">uint32</a></td>
|
||
<td></td>
|
||
<td><p>区块包含的事务数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>transactions_root</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>区块的事务默克尔树根 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>transactions</td>
|
||
<td><a href="#bdware.bdledger.api.Transaction">Transaction</a></td>
|
||
<td>repeated</td>
|
||
<td><p>事务对象的数组，或为空 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>transaction_hashes</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td>repeated</td>
|
||
<td><p>20字节的事务哈希的数组，或为空 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>creator_signature</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>产块者签名 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>witness_signatures</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td>repeated</td>
|
||
<td><p>见证者签名 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Contract">Contract</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>contractName</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>合约名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>randomNum</td>
|
||
<td><a href="#uint32">uint32</a></td>
|
||
<td></td>
|
||
<td><p>合约执行的节点数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>operation</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>合约方法 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>arg</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>合约方法参数 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>path</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>合约文件路径(合约在IDE工程的相对路径) </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>content</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>合约内容(可为合约文件相对路径/合约脚本) </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>pubkey</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>用户公钥 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Transaction">Transaction</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>block_hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>事务所在的区块的哈希，当事务处于待确认状态时为`null` </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>block_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>事务所在的区块产生时的 UNIX 时间戳，单位为秒 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>index</td>
|
||
<td><a href="#uint32">uint32</a></td>
|
||
<td></td>
|
||
<td><p>事务在区块中的位置 index，当事务处于待确认状态时为`null` </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>事务的哈希 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>type</td>
|
||
<td><a href="#bdware.bdledger.api.TransactionType">TransactionType</a></td>
|
||
<td></td>
|
||
<td><p>事务类型 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>from</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>发送账户地址 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>nonce</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>这条事务之前发送者所发送的事务数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>to</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>接收账户地址，或者调用的合约地址，或者`null`如为合约创建 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>data</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>数据或合约代码 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>v</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>ECDSA recovery id </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>r</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>ECDSA signature r </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>s</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>ECDSA signature s </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Contract.ContractUnitRequestType">Contract.ContractUnitRequestType</h3>
|
||
<p></p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Name</td><td>Number</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>START</td>
|
||
<td>0</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>STOP</td>
|
||
<td>1</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>EXECUTE</td>
|
||
<td>2</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>REPLY</td>
|
||
<td>3</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>REQUEST</td>
|
||
<td>4</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>PREPREPARE</td>
|
||
<td>5</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>PREPARE</td>
|
||
<td>6</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>COMMIT</td>
|
||
<td>7</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ADDPEER</td>
|
||
<td>8</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>DROPPEER</td>
|
||
<td>9</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>STATESYNC</td>
|
||
<td>10</td>
|
||
<td><p></p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
<h3 id="bdware.bdledger.api.TransactionType">TransactionType</h3>
|
||
<p>事务类型</p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Name</td><td>Number</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>RECORD</td>
|
||
<td>0</td>
|
||
<td><p>通用数据记录</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>MESSAGE</td>
|
||
<td>1</td>
|
||
<td><p>消息</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>CONTRACT_CREATION</td>
|
||
<td>2</td>
|
||
<td><p>合约创建</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>CONTRACT_INVOCATION</td>
|
||
<td>3</td>
|
||
<td><p>合约调用</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>CONTRACT_STATUS</td>
|
||
<td>4</td>
|
||
<td><p>合约状态</p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="bdware/bdledger/api/error_details.proto">bdware/bdledger/api/error_details.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.InvalidArgument">InvalidArgument</h3>
|
||
<p>InvalidArgument indicates client specified an invalid argument.</p><p>Note that this differs from FailedPrecondition. It indicates arguments</p><p>that are problematic regardless of the state of the system</p><p>(e.g., a malformed file name).</p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>field_violations</td>
|
||
<td><a href="#bdware.bdledger.api.InvalidArgument.FieldViolation">InvalidArgument.FieldViolation</a></td>
|
||
<td>repeated</td>
|
||
<td><p>Describes all violations in a client request. </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.InvalidArgument.FieldViolation">InvalidArgument.FieldViolation</h3>
|
||
<p>A message type used to describe a single invalid field.</p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>field</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>A path leading to a field in the request body. The value will be a
|
||
sequence of dot-separated identifiers that identify a protocol buffer
|
||
field. E.g., "field_violations.field" would identify this field. </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>description</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>A description of why the request element is bad. </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="bdware/bdledger/api/ledger.proto">bdware/bdledger/api/ledger.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.CreateLedgerRequest">CreateLedgerRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>name</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>Ledger name
|
||
账本名称 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.CreateLedgerResponse">CreateLedgerResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ok</td>
|
||
<td><a href="#bool">bool</a></td>
|
||
<td></td>
|
||
<td><p>Boolean value indicating if the ledger is successfully created
|
||
是否创建成功 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetLedgersResponse">GetLedgersResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledgers</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td>repeated</td>
|
||
<td><p>List of ledger names
|
||
帐本名称列表 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.SendTransactionRequest">SendTransactionRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>Ledger name
|
||
账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>transaction</td>
|
||
<td><a href="#bdware.bdledger.api.SendTransactionRequest.Transaction">SendTransactionRequest.Transaction</a></td>
|
||
<td></td>
|
||
<td><p>Transaction info
|
||
事务信息 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.SendTransactionRequest.Transaction">SendTransactionRequest.Transaction</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>type</td>
|
||
<td><a href="#bdware.bdledger.api.TransactionType">TransactionType</a></td>
|
||
<td></td>
|
||
<td><p>事务类型，目前仅支持通用数据记录，即type为RECORD (0) </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>from</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>任意20字节的地址，用于区分使用同一节点的事务发起者 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>nonce</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>正整数，同一from每个nonce应只使用一次，防止重复的事务（可以每次发送事务+1） </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>to</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>对于通用数据记录不需传递，无意义 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>data</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>事务数据内容，字节数组 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.SendTransactionResponse">SendTransactionResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>Hash of the created transaction
|
||
事务哈希 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Ledger">Ledger</h3>
|
||
<p></p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>CreateLedger</td>
|
||
<td><a href="#bdware.bdledger.api.CreateLedgerRequest">CreateLedgerRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.CreateLedgerResponse">CreateLedgerResponse</a></td>
|
||
<td><p>Create a new ledger
|
||
创建一个新账本</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetLedgers</td>
|
||
<td><a href="#google.protobuf.Empty">.google.protobuf.Empty</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetLedgersResponse">GetLedgersResponse</a></td>
|
||
<td><p>Get all ledgers
|
||
查询所有帐本列表</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>SendTransaction</td>
|
||
<td><a href="#bdware.bdledger.api.SendTransactionRequest">SendTransactionRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.SendTransactionResponse">SendTransactionResponse</a></td>
|
||
<td><p>Send a new transaction
|
||
发送一个新事务</p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="bdware/bdledger/api/node.proto">bdware/bdledger/api/node.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.ClientVersionResponse">ClientVersionResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>version</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>Client version
|
||
节点客户端版本 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Node">Node</h3>
|
||
<p></p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ClientVersion</td>
|
||
<td><a href="#google.protobuf.Empty">.google.protobuf.Empty</a></td>
|
||
<td><a href="#bdware.bdledger.api.ClientVersionResponse">ClientVersionResponse</a></td>
|
||
<td><p>Get BDLedger node version
|
||
查询BDLedger节点版本</p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="bdware/bdledger/api/query.proto">bdware/bdledger/api/query.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.BlockFilter">BlockFilter</h3>
|
||
<p>暂不支持</p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.BlocksRequest">BlocksRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>filters</td>
|
||
<td><a href="#bdware.bdledger.api.BlockFilter">BlockFilter</a></td>
|
||
<td>repeated</td>
|
||
<td><p>暂不支持 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>include_transactions</td>
|
||
<td><a href="#bdware.bdledger.api.IncludeTransactions">IncludeTransactions</a></td>
|
||
<td></td>
|
||
<td><p>包含事务信息详细程度 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.CountBlocksResponse">CountBlocksResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>count</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>区块数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.CountTransactionsResponse">CountTransactionsResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>count</td>
|
||
<td><a href="#uint64">uint64</a></td>
|
||
<td></td>
|
||
<td><p>事务数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetBlockByHashRequest">GetBlockByHashRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>区块哈希 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>full_transactions</td>
|
||
<td><a href="#bool">bool</a></td>
|
||
<td></td>
|
||
<td><p>是否返回完整事务列表，而不是事务哈希列表 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetBlockByHashResponse">GetBlockByHashResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>block</td>
|
||
<td><a href="#bdware.bdledger.api.Block">Block</a></td>
|
||
<td></td>
|
||
<td><p>区块信息 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetBlocksResponse">GetBlocksResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>blocks</td>
|
||
<td><a href="#bdware.bdledger.api.Block">Block</a></td>
|
||
<td>repeated</td>
|
||
<td><p>区块列表 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetTransactionByBlockHashAndIndexRequest">GetTransactionByBlockHashAndIndexRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>block_hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>事务所属区块哈希 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>index</td>
|
||
<td><a href="#uint32">uint32</a></td>
|
||
<td></td>
|
||
<td><p>事务在区块中的位置 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetTransactionByBlockHashAndIndexResponse">GetTransactionByBlockHashAndIndexResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>transaction</td>
|
||
<td><a href="#bdware.bdledger.api.Transaction">Transaction</a></td>
|
||
<td></td>
|
||
<td><p>事务信息 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetTransactionByHashRequest">GetTransactionByHashRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p>事务哈希 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetTransactionByHashResponse">GetTransactionByHashResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>transaction</td>
|
||
<td><a href="#bdware.bdledger.api.Transaction">Transaction</a></td>
|
||
<td></td>
|
||
<td><p>事务信息 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.GetTransactionsResponse">GetTransactionsResponse</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>transactions</td>
|
||
<td><a href="#bdware.bdledger.api.Transaction">Transaction</a></td>
|
||
<td>repeated</td>
|
||
<td><p>事务列表 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>本次查询有效的查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.RecentBlocksRequest">RecentBlocksRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>offset</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>起始值 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>count</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>查询区块数量 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>include_transactions</td>
|
||
<td><a href="#bdware.bdledger.api.IncludeTransactions">IncludeTransactions</a></td>
|
||
<td></td>
|
||
<td><p>包含事务信息详细程度 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.TransactionFilter">TransactionFilter</h3>
|
||
<p>repeated Transaction/BlockFilters are combined by "&&"(and) operator;</p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>hash</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>from</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>to</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>timestamp</td>
|
||
<td><a href="#bytes">bytes</a></td>
|
||
<td></td>
|
||
<td><p> </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.TransactionsRequest">TransactionsRequest</h3>
|
||
<p></p>
|
||
|
||
|
||
<table class="field-table">
|
||
<thead>
|
||
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>ledger</td>
|
||
<td><a href="#string">string</a></td>
|
||
<td></td>
|
||
<td><p>账本名称 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>start_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>查询范围开始时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>end_timestamp</td>
|
||
<td><a href="#int64">int64</a></td>
|
||
<td></td>
|
||
<td><p>查询范围结束时间戳 </p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>filters</td>
|
||
<td><a href="#bdware.bdledger.api.TransactionFilter">TransactionFilter</a></td>
|
||
<td>repeated</td>
|
||
<td><p>暂不支持 </p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.IncludeTransactions">IncludeTransactions</h3>
|
||
<p>包含事务信息详细程度</p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Name</td><td>Number</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>NONE</td>
|
||
<td>0</td>
|
||
<td><p>不包含事务数据</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>HASH</td>
|
||
<td>1</td>
|
||
<td><p>包含事务哈希列表</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>FULL</td>
|
||
<td>2</td>
|
||
<td><p>包含完整事务列表</p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
|
||
<h3 id="bdware.bdledger.api.Query">Query</h3>
|
||
<p></p>
|
||
<table class="enum-table">
|
||
<thead>
|
||
<tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr>
|
||
<td>GetBlockByHash</td>
|
||
<td><a href="#bdware.bdledger.api.GetBlockByHashRequest">GetBlockByHashRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetBlockByHashResponse">GetBlockByHashResponse</a></td>
|
||
<td><p>Get a block identified by its hash
|
||
查询哈希所指定的区块</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetBlocks</td>
|
||
<td><a href="#bdware.bdledger.api.BlocksRequest">BlocksRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetBlocksResponse">GetBlocksResponse</a></td>
|
||
<td><p>Get blocks in a timestamp range
|
||
查询时间范围内的区块
|
||
Requirement: start_timestamp <= end_timestamp
|
||
If neither 'start_timestamp' nor 'end_timestamp' is specified, then 'start_timestamp' will be set to
|
||
the genesis block's timestamp, and 'end_timestamp' will be set to (start_timestamp + query.maxDuration)
|
||
(query.maxDuration is specified in go-bdledger's config file).
|
||
If only 'end_timestamp' is not specified, or (end_timestamp - start_timestamp > query.maxDuration),
|
||
then 'end_timestamp' will be set to (start_timestamp + query.maxDuration).
|
||
If only 'start_timestamp' is not specified, then 'start_timestamp' will be set to (end_timestamp - query.maxDuration).
|
||
In all cases, 'start_timestamp' will never be earlier than the genesis block's timestamp,
|
||
and 'end_timestamp' will never be later than the current timestamp when the node process the query request.</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>CountBlocks</td>
|
||
<td><a href="#bdware.bdledger.api.BlocksRequest">BlocksRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.CountBlocksResponse">CountBlocksResponse</a></td>
|
||
<td><p>Count all blocks in a ledger, or blocks in a timestamp range
|
||
查询帐本中的所有区块数量，或时间范围内的区块数量
|
||
Requirement: start_timestamp <= end_timestamp
|
||
If neither 'start_timestamp' nor 'end_timestamp' is specified, then count all blocks in the specified ledger.
|
||
If only 'end_timestamp' is not specified, then count all blocks with timestamps later than 'start_timestamp'.
|
||
If only 'start_timestamp' is not specified, then count all blocks with timestamps earlier than 'end_timestamp'.
|
||
In all cases, 'start_timestamp' will never be earlier than the genesis block's timestamp,
|
||
and 'end_timestamp' will never be later than the current timestamp when the node process the query request.</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetRecentBlocks</td>
|
||
<td><a href="#bdware.bdledger.api.RecentBlocksRequest">RecentBlocksRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetBlocksResponse">GetBlocksResponse</a></td>
|
||
<td><p>Get recent 'count' blocks (Only support IncludeTransactions=NONE for now)
|
||
查询最新的 'count' 个区块</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetTransactionByHash</td>
|
||
<td><a href="#bdware.bdledger.api.GetTransactionByHashRequest">GetTransactionByHashRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetTransactionByHashResponse">GetTransactionByHashResponse</a></td>
|
||
<td><p>Get a transaction identified by its hash
|
||
查询哈希所指定的事务</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetTransactionByBlockHashAndIndex</td>
|
||
<td><a href="#bdware.bdledger.api.GetTransactionByBlockHashAndIndexRequest">GetTransactionByBlockHashAndIndexRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetTransactionByBlockHashAndIndexResponse">GetTransactionByBlockHashAndIndexResponse</a></td>
|
||
<td><p>Get a transaction identified by hash of the block it belongs to and its index inside the block
|
||
查询所在区块的哈希与其在区块中的index所指定的事务</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>GetTransactions</td>
|
||
<td><a href="#bdware.bdledger.api.TransactionsRequest">TransactionsRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.GetTransactionsResponse">GetTransactionsResponse</a></td>
|
||
<td><p>Get transactions in a timestamp range
|
||
查询时间范围内的事务
|
||
'start_timestamp' and 'end_timestamp' follow the same requirements and rules as in 'GetBlocks'.</p></td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>CountTransactions</td>
|
||
<td><a href="#bdware.bdledger.api.TransactionsRequest">TransactionsRequest</a></td>
|
||
<td><a href="#bdware.bdledger.api.CountTransactionsResponse">CountTransactionsResponse</a></td>
|
||
<td><p>Count all transactions in a ledger, or transactions in a timestamp range
|
||
查询帐本中的所有事务数量，或时间范围内的事务数量
|
||
'start_timestamp' and 'end_timestamp' follow the same requirements and rules as in 'CountBlocks'.</p></td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
|
||
<div class="file-heading">
|
||
<h2 id="google/protobuf/empty.proto">google/protobuf/empty.proto</h2><a href="#title">Top</a>
|
||
</div>
|
||
<p></p>
|
||
|
||
|
||
<h3 id="google.protobuf.Empty">Empty</h3>
|
||
<p>A generic empty message that you can re-use to avoid defining duplicated</p><p>empty messages in your APIs. A typical example is to use it as the request</p><p>or the response type of an API method. For instance:</p><p>service Foo {</p><p>rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);</p><p>}</p><p>The JSON representation for `Empty` is empty JSON object `{}`.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<h2 id="scalar-value-types">Scalar Value Types</h2>
|
||
<table class="scalar-value-types-table">
|
||
<thead>
|
||
<tr><td>.proto Type</td><td>Notes</td><td>C++</td><td>Java</td><td>Python</td><td>Go</td><td>C#</td><td>PHP</td><td>Ruby</td></tr>
|
||
</thead>
|
||
<tbody>
|
||
|
||
<tr id="double">
|
||
<td>double</td>
|
||
<td></td>
|
||
<td>double</td>
|
||
<td>double</td>
|
||
<td>float</td>
|
||
<td>float64</td>
|
||
<td>double</td>
|
||
<td>float</td>
|
||
<td>Float</td>
|
||
</tr>
|
||
|
||
<tr id="float">
|
||
<td>float</td>
|
||
<td></td>
|
||
<td>float</td>
|
||
<td>float</td>
|
||
<td>float</td>
|
||
<td>float32</td>
|
||
<td>float</td>
|
||
<td>float</td>
|
||
<td>Float</td>
|
||
</tr>
|
||
|
||
<tr id="int32">
|
||
<td>int32</td>
|
||
<td>Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>int</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>integer</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="int64">
|
||
<td>int64</td>
|
||
<td>Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>int/long</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>integer/string</td>
|
||
<td>Bignum</td>
|
||
</tr>
|
||
|
||
<tr id="uint32">
|
||
<td>uint32</td>
|
||
<td>Uses variable-length encoding.</td>
|
||
<td>uint32</td>
|
||
<td>int</td>
|
||
<td>int/long</td>
|
||
<td>uint32</td>
|
||
<td>uint</td>
|
||
<td>integer</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="uint64">
|
||
<td>uint64</td>
|
||
<td>Uses variable-length encoding.</td>
|
||
<td>uint64</td>
|
||
<td>long</td>
|
||
<td>int/long</td>
|
||
<td>uint64</td>
|
||
<td>ulong</td>
|
||
<td>integer/string</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="sint32">
|
||
<td>sint32</td>
|
||
<td>Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>int</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>integer</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="sint64">
|
||
<td>sint64</td>
|
||
<td>Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>int/long</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>integer/string</td>
|
||
<td>Bignum</td>
|
||
</tr>
|
||
|
||
<tr id="fixed32">
|
||
<td>fixed32</td>
|
||
<td>Always four bytes. More efficient than uint32 if values are often greater than 2^28.</td>
|
||
<td>uint32</td>
|
||
<td>int</td>
|
||
<td>int</td>
|
||
<td>uint32</td>
|
||
<td>uint</td>
|
||
<td>integer</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="fixed64">
|
||
<td>fixed64</td>
|
||
<td>Always eight bytes. More efficient than uint64 if values are often greater than 2^56.</td>
|
||
<td>uint64</td>
|
||
<td>long</td>
|
||
<td>int/long</td>
|
||
<td>uint64</td>
|
||
<td>ulong</td>
|
||
<td>integer/string</td>
|
||
<td>Bignum</td>
|
||
</tr>
|
||
|
||
<tr id="sfixed32">
|
||
<td>sfixed32</td>
|
||
<td>Always four bytes.</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>int</td>
|
||
<td>int32</td>
|
||
<td>int</td>
|
||
<td>integer</td>
|
||
<td>Bignum or Fixnum (as required)</td>
|
||
</tr>
|
||
|
||
<tr id="sfixed64">
|
||
<td>sfixed64</td>
|
||
<td>Always eight bytes.</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>int/long</td>
|
||
<td>int64</td>
|
||
<td>long</td>
|
||
<td>integer/string</td>
|
||
<td>Bignum</td>
|
||
</tr>
|
||
|
||
<tr id="bool">
|
||
<td>bool</td>
|
||
<td></td>
|
||
<td>bool</td>
|
||
<td>boolean</td>
|
||
<td>boolean</td>
|
||
<td>bool</td>
|
||
<td>bool</td>
|
||
<td>boolean</td>
|
||
<td>TrueClass/FalseClass</td>
|
||
</tr>
|
||
|
||
<tr id="string">
|
||
<td>string</td>
|
||
<td>A string must always contain UTF-8 encoded or 7-bit ASCII text.</td>
|
||
<td>string</td>
|
||
<td>String</td>
|
||
<td>str/unicode</td>
|
||
<td>string</td>
|
||
<td>string</td>
|
||
<td>string</td>
|
||
<td>String (UTF-8)</td>
|
||
</tr>
|
||
|
||
<tr id="bytes">
|
||
<td>bytes</td>
|
||
<td>May contain any arbitrary sequence of bytes.</td>
|
||
<td>string</td>
|
||
<td>ByteString</td>
|
||
<td>str</td>
|
||
<td>[]byte</td>
|
||
<td>ByteString</td>
|
||
<td>string</td>
|
||
<td>String (ASCII-8BIT)</td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
</table>
|
||
</body>
|
||
</html>
|
||
|