JSON-RPC 应用程序接口 </a></li><li><a href="/zh-CN/reference/platform-parameters.html" class="sidebar-link">平台参数 </a></li><li><a href="/zh-CN/reference/backend-config.html" class="sidebar-link">服务端配置文件 </a></li><li><a href="/zh-CN/reference/desync_monitor.html" class="sidebar-link">同步监控工具 </a></li><li><a href="/zh-CN/reference/json-rpc.html" aria-current="page" class="active sidebar-link">JSON-RPC 应用程序接口 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#client-side-implementation" class="sidebar-link">客户端实现 </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#curl-example" class="sidebar-link">Curl示例 </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#covenant" class="sidebar-link">约定 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#hex" class="sidebar-link">Hex </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#request-type" class="sidebar-link">请求类型 </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#special-markers" class="sidebar-link">特殊标记 </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#batch-requests" class="sidebar-link">批量请求 </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#error-response-handling" class="sidebar-link">错误响应处理 </a></li></ul></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#json-rpc-namespaces" class="sidebar-link">JSON-RPC Namespaces </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-namespace" class="sidebar-link">ibax Namespace </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#net-namespace" class="sidebar-link">net Namespace </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#rpc-namespace" class="sidebar-link">rpc Namespace </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#admin-namespace" class="sidebar-link">admin Namespace </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#debug-namespace" class="sidebar-link">debug Namespace </a></li></ul></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#json-rpc-interface-methods" class="sidebar-link">JSON-RPC 接口方法 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getuid" class="sidebar-link">ibax.getUid </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-login" class="sidebar-link">ibax.login </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getauthstatus" class="sidebar-link">ibax.getAuthStatus </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getversion" class="sidebar-link">ibax.getVersion </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getbalance" class="sidebar-link">ibax.getBalance </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getblockstxinfo" class="sidebar-link">ibax.getBlocksTxInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-detailedblocks" class="sidebar-link">ibax.detailedBlocks </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getkeyinfo" class="sidebar-link">ibax.getKeyInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-detailedblock" class="sidebar-link">ibax.detailedBlock </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-maxblockid" class="sidebar-link">ibax.maxBlockId </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getkeyscount" class="sidebar-link">ibax.getKeysCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-gettxcount" class="sidebar-link">ibax.getTxCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-gettransactioncount" class="sidebar-link">ibax.getTransactionCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getblockscountbynode" class="sidebar-link">ibax.getBlocksCountByNode </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-honornodescount" class="sidebar-link">ibax.honorNodesCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getecosystemcount" class="sidebar-link">ibax.getEcosystemCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-ecosysteminfo" class="sidebar-link">ibax.ecosystemInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-appparams" class="sidebar-link">ibax.appParams </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getecosystemparams" class="sidebar-link">ibax.getEcosystemParams </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-gettablecount" class="sidebar-link">ibax.getTableCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-gettable" class="sidebar-link">ibax.getTable </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getlist" class="sidebar-link">ibax.getList </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getsections" class="sidebar-link">ibax.getSections </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getrow" class="sidebar-link">ibax.getRow </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-systemparams" class="sidebar-link">ibax.systemParams </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-history" class="sidebar-link">ibax.history </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getpagerow" class="sidebar-link">ibax.getPageRow </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getmenurow" class="sidebar-link">ibax.getMenuRow </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getsnippetrow" class="sidebar-link">ibax.getSnippetRow </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getappcontent" class="sidebar-link">ibax.getAppContent </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getmember" class="sidebar-link">ibax.getMember </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getcontracts" class="sidebar-link">ibax.getContracts </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getcontractinfo" class="sidebar-link">ibax.getContractInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-sendtx" class="sidebar-link">ibax.sendTx </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-txstatus" class="sidebar-link">ibax.txStatus </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-txinfo" class="sidebar-link">ibax.txInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-txinfomultiple" class="sidebar-link">ibax.txInfoMultiple </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getpagevalidatorscount" class="sidebar-link">ibax.getPageValidatorsCount </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getpage" class="sidebar-link">ibax.getPage </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getmenu" class="sidebar-link">ibax.getMenu </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getsource" class="sidebar-link">ibax.getSource </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getpagehash" class="sidebar-link">ibax.getPageHash </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getcontent" class="sidebar-link">ibax.getContent </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getblockinfo" class="sidebar-link">ibax.getBlockInfo </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#ibax-getconfig" class="sidebar-link">ibax.getConfig </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#net-getnetwork" class="sidebar-link">net.getNetwork </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#net-status" class="sidebar-link">net.status </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#rpc-modules" class="sidebar-link">rpc.modules </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#admin-startjsonrpc" class="sidebar-link">admin.startJsonRpc </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#admin-stopjsonrpc" class="sidebar-link">admin.stopJsonRpc </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#debug-getnodebanstat" class="sidebar-link">debug.getNodeBanStat </a></li><li class="sidebar-sub-header"><a href="/zh-CN/reference/json-rpc.html#debug-getmemstat" class="sidebar-link">debug.getMemStat </a></li></ul></li></ul></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="json-rpc-application-programming-interface"><a href="#json-rpc-application-programming-interface" class="header-anchor">#</a> JSON-RPC 应用程序接口 </h1> <p>为了让软件应用程序与IBAX区块链交互（获取区块数据或向网络发送交易）,它必须连接到IBAX网络节点.</p> <p>由于原有REST API接口的通用性与扩展性，它会随着接口越来越多，客户端的不同而变得越来越复杂，我们意识到接口统一重要性，保证所有客户端都能使用同一套规范，无论具体的节点与客户端实现如何。</p> <p>JSON-RPC 是一种无状态的、轻量级远程过程调用 (RPC) 协议。它定义了一些数据结构及其处理规则。它与传输无关，因为这些概念可以在同一进程，通过接口、超文本传输协议或许多不同的消息传递环境中使用。它使用 JSON (RFC 4627) 作为数据格式。</p> <p>JSON-RPC兼容了大部分REST API接口，保留了原有的REST API接口，使用REST API接口的客户端可以很方便的向JSON-RPC接口转移，部分接口：</p> <ul><li><a href="/zh-CN/reference/api2.html#data-id-data-hash">/data/{id}/data/{hash}</a></li> <li><a href="/zh-CN/reference/api2.html#data-table-id-column-hash">/data/{table}/id/{column}/{hash}</a></li> <li><a href="/zh-CN/reference/api2.html#avatar-ecosystem-member">avatar/{ecosystem}/{member}</a></li></ul> <p>可通过REST API接口获取。</p> <h2 id="client-side-implementation"><a href="#client-side-implementation" class="header-anchor">#</a> 客户端实现 </h2> <p>每个客户端在执行 JSON-RPC 规范时可以使用不同的编程语言，你可以使用<a href="https://github.com/IBAX-io/go-ibax-sdk" target="_blank" rel="noopener noreferrer">GO-SDK<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> 。</p> <h2 id="curl-example"><a href="#curl-example" class="header-anchor">#</a> Curl示例 </h2> <p>下面提供了通过向IBAX节点发出 curl 请求来使用 JSON_RPC 应用程序接口的示例。每个示例都包括对特定端点、其参数、返回类型的描述，以及应该如何使用它的工作示例。</p> <p>Curl 请求可能会返回与内容类型相关的错误消息。这是因为 --data 选项将内容类型设置为 application/x-www-form-urlencoded。如果你的请求有此问题，请通过在调用开始时放置 -H "Content-Type: application/json" 来手动设置标头。这些示例也未包括网址/互联网协议与端口组合，该组合必须是 curl 的最后一个参数（例如 127.0.0.1:7079 包含这些附加数据的完整 curl 请求采用以下形式：</p> <div class="language-text extra-class"><pre class="language-text"><code>curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.maxBlockId","params":[],"id":1}' http://127.0.0.1:7079 </code></pre></div><h2 id="covenant"><a href="#covenant" class="header-anchor">#</a> 约定 </h2> <h3 id="hex"><a href="#hex" class="header-anchor">#</a> Hex </h3> <p><strong>十六进制编码</strong></p> <p>当对字节数组、哈希、字节码数组进行编码时：编码为十六进制，每字节两个十六进制数字。</p> <h3 id="request-type"><a href="#request-type" class="header-anchor">#</a> 请求类型 </h3> <p><strong>统一使用</strong></p> <ul><li>Content-Type: application/json</li></ul> <h3 id="special-markers"><a href="#special-markers" class="header-anchor">#</a> 特殊标记 </h3> <h4 id="omitempty"><a href="#omitempty" class="header-anchor">#</a> Omitempty </h4> <p>此字段为可选参数。</p> <p>如果存在连续多个<code>Omitempty</code>字段，但是只想传某个字段的值，那么需要将不需要的字段置为空(该字段类型空值)，例：</p> <ul><li><strong>id</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> id</li> <li><strong>name</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> 名称</li> <li><strong>column</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> 筛选列名</li></ul> <p>如果只传name的值，那么请求参数按如下传递：</p> <div class="language- extra-class"><pre><code>`"params":[0,"testname"]` - *Number* 空值为0 </code></pre></div><p>如果只传column的值，那么请求参数按如下传递：</p> <div class="language- extra-class"><pre><code>`"params":[0,"","title,page"]` - *String* 空值为"" </code></pre></div><h4 id="authorization"><a href="#authorization" class="header-anchor">#</a> Authorization </h4> <p>Authorization 授权标头，请求头添加Authorization，示例：</p> <p><strong>name</strong> : Authorization <strong>value</strong> : Bearer +<a href="#ibax-login">login token</a></p> <p>Example:</p> <div class="language-text extra-class"><pre class="language-text"><code> //request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ey...." -d '{"jsonrpc":"2.0","method":"ibax.getContractInfo","params":["@1TokensSend"],"id":1}' http://127.0.0.1:7079 </code></pre></div><h4 id="accountorkeyid"><a href="#accountorkeyid" class="header-anchor">#</a> AccountOrKeyId </h4> <p>账户地址参数,可以使用两种格式的地址,例:</p> <ol><li><ul><li><em>String</em> - 账户地址 <code>"XXXX-XXXX-XXXX-XXXX-XXXX"</code> 或账户Id <code>"64842...538120"</code></li></ul></li> <li><ul><li><em>Object</em> - 地址对象</li> <li><strong>key_id</strong> - <em>Number</em> - 账户Id,例: <code>{"key_id":-64842...38120}</code></li> <li><strong>account</strong> - <em>String</em> - 账户地址,例: <code>{"account":"1196-...-...-...-3496"}</code></li></ul> <p><strong>账户地址和账户Id同时存在时优先使用账户Id</strong>.</p></li></ol> <h4 id="blockorhash"><a href="#blockorhash" class="header-anchor">#</a> BlockOrHash </h4> <p>区块高度或区块HASH，例:</p> <ol><li><ul><li><em>String</em> - 区块高度 <code>"100"</code> 或区块HASH <code>"4663aa47...a60753c18d9ba9cb4"</code></li></ul></li> <li><ul><li><p><em>Object</em> - 区块信息对象</p> <ul><li><strong>id</strong> - <em>Number</em> - 区块高度,例: <code>{"id":2}</code></li> <li><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 区块HASH,例: <code>{"hash":"d36b8996c...c616d3043a0d02a0f59"}</code></li></ul> <p><strong>区块高度和区块HASH只能选一个</strong>.</p></li></ul></li></ol> <h3 id="batch-requests"><a href="#batch-requests" class="header-anchor">#</a> 批量请求 </h3> <p>此功能可用于减少网络延迟，特别是在获取大量基本独立的数据对象时。</p> <p>下面是一个获取最高区块和总交易数例子：</p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '[{"jsonrpc":"2.0","method":"ibax.getTxCount","id":1,"params":[]},{"jsonrpc":"2.0","method":"ibax.maxBlockId","id":2,"params":[]}]' http://127.0.0.1:7079 //Response [ { "jsonrpc": "2.0", "id": 1, "result": 149100 }, { "jsonrpc": "2.0", "id": 2, "result": 797 } ] </code></pre></div><h3 id="error-response-handling"><a href="#error-response-handling" class="header-anchor">#</a> 错误响应处理 </h3> <p>在请求执行成功的情况下返回状态 <code>200</code>。</p> <p>如果出现错误，将返回带有以下字段的JSON对象：</p> <ul><li><p>jsonrpc</p> <p>错误标识符。</p></li> <li><p>id</p> <p>错误文本信息。</p></li> <li><p>error</p> <ul><li><p>code</p> <p>响应状态码</p></li> <li><p>message</p> <p>响应状态描述</p></li></ul></li></ul> <div class="language-text extra-class"><pre class="language-text"><code>{ "jsonrpc": "2.0", "id": 1, "error": { "code": -32014, "message": "Unauthorized" } } </code></pre></div><h2 id="json-rpc-namespaces"><a href="#json-rpc-namespaces" class="header-anchor">#</a> JSON-RPC Namespaces </h2> <h3 id="ibax-namespace"><a href="#ibax-namespace" class="header-anchor">#</a> ibax Namespace </h3> <h4 id="authentication-interface"><a href="#authentication-interface" class="header-anchor">#</a> 认证接口 </h4> <ul><li><a href="#ibax-getuid">ibax.getuid</a></li> <li><a href="#ibax-login">ibax.login</a></li> <li><a href="#ibax-getauthstatus">ibax.getAuthStatus</a></li></ul> <h4 id="server-side-command-interface"><a href="#server-side-command-interface" class="header-anchor">#</a> 服务端命令接口 </h4> <ul><li><a href="#ibax-getversion">ibax.getVersion</a></li></ul> <h4 id="data-request-function-interface"><a href="#data-request-function-interface" class="header-anchor">#</a> 数据请求功能接口 </h4> <ul><li><a href="#ibax-getbalance">ibax.getBalance</a></li> <li><a href="#ibax-getblockstxinfo">ibax.getBlocksTxInfo</a></li> <li><a href="#ibax-detailedblocks">ibax.detailedBlocks</a></li> <li><a href="#ibax-getkeyinfo">ibax.getKeyInfo</a></li> <li><a href="#ibax-detailedblock">ibax.detailedBlock</a></li></ul> <h4 id="get-metrics-interface"><a href="#get-metrics-interface" class="header-anchor">#</a> 获取指标接口 </h4> <ul><li><a href="#ibax-maxblockid">ibax.maxBlockId</a></li> <li><a href="#ibax-getkeyscount">ibax.getKeysCount</a></li> <li><a href="#ibax-gettxcount">ibax.getTxCount</a></li> <li><a href="#ibax-gettransactioncount">ibax.getTransactionCount</a></li> <li><a href="#ibax-getblockscountbynode">ibax.getBlocksCountByNode</a></li> <li><a href="#ibax-honornodescount">ibax.honorNodesCount</a></li> <li><a href="#ibax-getecosystemcount">ibax.getEcosystemCount</a></li></ul> <h4 id="ecosystem-interface"><a href="#ecosystem-interface" class="header-anchor">#</a> 生态系统接口 </h4> <ul><li><a href="#ibax-ecosysteminfo">ibax.ecosystemInfo</a></li> <li><a href="#ibax-appparams">ibax.appParams</a></li> <li><a href="#ibax-getecosystemparams">ibax.getEcosystemParams</a></li> <li><a href="#ibax-gettablecount">ibax.getTableCount</a></li> <li><a href="#ibax-gettable">ibax.getTable</a></li> <li><a href="#ibax-getlist">ibax.getList</a></li> <li><a href="#ibax-getsections">ibax.getSections</a></li> <li><a href="#ibax-getrow">ibax.getRow</a></li> <li><a href="#ibax-systemparams">ibax.systemParams</a></li> <li><a href="#ibax-history">ibax.history</a></li> <li><a href="#ibax-getpagerow">ibax.getPageRow</a></li> <li><a href="#ibax-getmenurow">ibax.getMenuRow</a></li> <li><a href="#ibax-getsnippetrow">ibax.getSnippetRow</a></li> <li><a href="#ibax-getappcontent">ibax.getAppContent</a></li> <li><a href="#ibax-getmember">ibax.getMember</a></li></ul> <h4 id="contract-function-interface"><a href="#contract-function-interface" class="header-anchor">#</a> 合约功能接口 </h4> <ul><li><a href="#ibax-getcontracts">ibax.getContracts</a></li> <li><a href="#ibax-getcontractinfo">ibax.getContractInfo</a></li> <li><a href="#ibax-sendtx">ibax.sendTx</a></li> <li><a href="#ibax-txstatus">ibax.txStatus</a></li> <li><a href="#ibax-txinfo">ibax.txInfo</a></li> <li><a href="#ibax-txinfomultiple">ibax.txInfoMultiple</a></li> <li><a href="#ibax-getpagevalidatorscount">ibax.getPageValidatorsCount</a></li> <li><a href="#ibax-getpage">ibax.getPage</a></li> <li><a href="#ibax-getmenu">ibax.getMenu</a></li> <li><a href="#ibax-getsource">ibax.getSource</a></li> <li><a href="#ibax-getpagehash">ibax.getPageHash</a></li> <li><a href="#ibax-getcontent">ibax.getContent</a></li> <li><a href="#ibax-getblockinfo">ibax.getBlockInfo</a></li> <li><a href="#ibax-getconfig">ibax.getConfig</a></li></ul> <h3 id="net-namespace"><a href="#net-namespace" class="header-anchor">#</a> net Namespace </h3> <ul><li><a href="#net-getnetwork">net.getNetwork</a></li> <li><a href="#net-status">net.status</a></li></ul> <h3 id="rpc-namespace"><a href="#rpc-namespace" class="header-anchor">#</a> rpc Namespace </h3> <ul><li><a href="#rpc-modules">rpc.modules</a></li></ul> <h3 id="admin-namespace"><a href="#admin-namespace" class="header-anchor">#</a> admin Namespace </h3> <ul><li><a href="#admin-startjsonrpc">admin.startJsonRpc</a></li> <li><a href="#admin-stopjsonrpc">admin.stopJsonRpc</a></li></ul> <h3 id="debug-namespace"><a href="#debug-namespace" class="header-anchor">#</a> debug Namespace </h3> <ul><li><a href="#debug-getnodebanstat">debug.getNodeBanStat</a></li> <li><a href="#debug-getmemstat">debug.getMemStat</a></li></ul> <h2 id="json-rpc-interface-methods"><a href="#json-rpc-interface-methods" class="header-anchor">#</a> JSON-RPC 接口方法 </h2> <h3 id="ibax-getuid"><a href="#ibax-getuid" class="header-anchor">#</a> <strong>ibax.getUid</strong> </h3> <p><a href="#authorization">Authorization</a> <a href="#omitempty">Omitempty</a></p> <p>生成临时JWT令牌,在调用 <strong><a href="#ibax.login">login</a></strong> 时需要将令牌传递给 <a href="#authorization"><strong>Authorization</strong></a></p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><p><strong>uid</strong> - <em>String</em> - 签名数字。</p></li> <li><p><strong>token</strong> - <em>String</em> - 登录时传递的临时令牌(临时令牌的生命周期为5秒)。</p></li> <li><p><strong>network_id</strong> - <em>String</em> - 网络标识符。</p></li> <li><p><strong>cryptoer</strong> - <em>String</em> - 椭圆曲线算法。</p></li> <li><p><strong>hasher</strong> - <em>String</em> - hash算法。</p></li></ul> <p>在不需要授权的情况下(请求包含<a href="#authorization">Authorization</a>)，将返回以下信息:</p> <ul><li><p><strong>expire</strong> - <em>String</em> - 过期时间。</p></li> <li><p><strong>ecosystem</strong> - <em>String</em> - 生态系统ID。</p></li> <li><p><strong>key_id</strong> - <em>String</em> - 账户地址。</p></li> <li><p><strong>address</strong> - <em>String</em> - 钱包地址 <code>XXXX-XXXX-XXXX-XXXX-XXXX</code>。</p></li> <li><p><strong>network_id</strong> - <em>String</em> - 网络标识符。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request1 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getUid","params":[],"id":1}' http://127.0.0.1:7079 //Response1 { "jsonrpc": "2.0", "id": 1, "result": { "uid": "5823391950439015186", "token": "ey....", "network_id": "1", "cryptoer": "ECC_Secp256k1", "hasher": "KECCAK256" } } //Request2 curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer ey...." -d '{"jsonrpc":"2.0","method":"ibax.getUid","params":[],"id":1}' http://127.0.0.1:7079 //Response2 { "jsonrpc": "2.0", "id": 1, "result": { "expire": "7h59m49.5361126s", "ecosystem_id": "1", "key_id": "6667782293976713160", "address": "0666-7782-2939-7671-3160", "network_id": "1", "cryptoer": "ECC_Secp256k1", "hasher": "KECCAK256" } } </code></pre></div><h3 id="ibax-login"><a href="#ibax-login" class="header-anchor">#</a> <strong>ibax.login</strong> </h3> <p>用户身份验证。<a href="#authorization">Authorization</a></p> <p>应首先调用 <a href="#ibax-getuid"><strong>ibax.getUid</strong></a> 命令，以便接收唯一值并对其进行签名。getuid的临时JWT令牌需要放在请求头中传递。如果请求成功，则响应中收到的令牌包含在 <a href="#authorization"><strong>Authorization</strong></a> 中。</p> <p><strong>参数</strong></p> <p><em>Object</em> - 身份认证调用对象</p> <ul><li><p><strong>ecosystem_id</strong> - <em>Number</em> - 生态系统ID。如果未指定，默认为第一生态系统ID。</p></li> <li><p><strong>expire</strong> - <em>Number</em> - JWT令牌的生命周期，以秒为单位，默认为28800,8小时。</p></li> <li><p><strong>public_key</strong> - <em><a href="#hex">Hex</a> String</em> - 十六进制账户公钥。</p></li> <li><p><strong>key_id</strong> - <em>String</em> -</p> <blockquote><p>账户地址 <code>XXXX-...-XXXX</code>。</p> <p>在公钥已经存储在区块链中的情况下使用此参数。不能与 <em>pubkey</em> 参数一起使用。</p></blockquote></li> <li><p><strong>signature</strong> - <em>String</em> - 使用私钥对getuid收到的uid签名。</p> <p>签名数据内容:LOGIN+{$network_id}+uid。</p></li> <li><p><strong>role_id</strong> - <em>Number</em> - 角色ID，默认角色0。</p></li></ul> <p><strong>返回值</strong> <em>Object</em> - 身份认证对象</p> <ul><li><p><strong>token</strong> - <em>String</em> - JWT令牌。</p></li> <li><p><strong>ecosystem_id</strong> - <em>String</em> - 生态系统ID。</p></li> <li><p><strong>key_id</strong> - <em>String</em> - 账户地址ID。</p></li> <li><p><strong>account</strong> - <em>String</em> - 钱包地址 <code>XXXX-XXXX-XXXX-XXXX-XXXX</code>。</p></li> <li><p><strong>notify_key</strong> - <em>String</em> - 通知ID。</p></li> <li><p><strong>isnode</strong> - <em>Bool</em> - 该账户地址是否是该节点的所有者。值： <code>true,false</code>。</p></li> <li><p><strong>isowner</strong> - <em>Bool</em> - 该账户地址是否是该生态系统的创建者。值： <code>true,false</code>。</p></li> <li><p><strong>clb</strong> - <em>Bool</em> - 登录的生态系统是否为 CLB 。值： <code>true,false</code>。</p></li> <li><p><strong>timestamp</strong> - <em>String</em> - 当前时间戳。</p></li> <li><p><strong>roles</strong> - <em>Array</em> 角色列表，如没有角色，字段为nil。</p> <ul><li><strong>role_id</strong> - <em>Number</em> - 角色ID。</li> <li><strong>role_name</strong> - <em>String</em> - 角色名称。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.login","params":[{"ecosystem_id":1,"public_key":"04....","signature","46...","role_id":0}],"id":1}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "token": "ey...", "ecosystem_id": "1", "key_id": "6660819716178795186", "account": "0666-xxxx-xxxx-xxxx-5186", "notify_key": "ey....", "isnode": false, "isowner": false, "clb": false, "timestamp": "1678336163", "roles": nil //[{"role_id": 1, "role_name": "Developer"},{"role_id": 2, "role_name": "DevelopGovernancerer"}] } } </code></pre></div><h3 id="ibax-getauthstatus"><a href="#ibax-getauthstatus" class="header-anchor">#</a> <strong>ibax.getAuthStatus</strong> </h3> <p>用户身份认证状态。 <a href="#authorization">Authorization</a></p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong> <em>Object</em> - 身份认证状态对象。</p> <ul><li><p><strong>active</strong> - <em>Bool</em> - 当前用户身份认证状态，值： <code>true,false</code>。</p></li> <li><p><strong>exp</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> Token有效截止时间戳。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getAuthStatus","id":1}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "active": true, "exp": 1678354136 } } </code></pre></div><h3 id="ibax-getversion"><a href="#ibax-getversion" class="header-anchor">#</a> <strong>ibax.getVersion</strong> </h3> <p>返回当前服务器版本。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>vesion</strong> - <em>String</em> - 版本号(<code>big Version</code> + <code>branch name</code> + <code>git commit</code> + <code>time</code> + <code>node status</code>)。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getVersion","id":1}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": "1.3.0 branch.main commit.b57d4194 time.2023-03-08-09:30:29(UTC) node server status is running" } </code></pre></div><h3 id="ibax-getbalance"><a href="#ibax-getbalance" class="header-anchor">#</a> <strong>ibax.getBalance</strong> </h3> <p>获取帐户地址余额。</p> <p><strong>参数</strong></p> <ul><li><p><strong>key_id or account</strong> - <em><a href="#accountorkeyid">AccountOrKeyId</a></em> - 账户地址 <code>XXXX-XXXX-XXXX-XXXX-XXXX</code> 或账户ID。</p></li> <li><p><strong>ecosystem_id</strong> - <em>Number</em> - 生态系统ID <a href="#omitempty">Omitempty</a> 默认生态1。</p></li></ul> <p><strong>返回值</strong> <em>Object</em> - 获取余额对象。</p> <ul><li><p><strong>amount</strong> - <em>String</em> - 最小单位的合约帐户余额。</p></li> <li><p><strong>total</strong> - <em>String</em> - 最小单位帐户总余额(amount + utxo）。</p></li> <li><p><strong>utxo</strong> - <em>String</em> - 最小单位UTXO帐户余额。</p></li> <li><p><strong>digits</strong> - <em>Number</em> - 精度。</p></li> <li><p><strong>token_symbol</strong> - <em>String</em> - 代币符号。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request1 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBalance","id":1,"params":["648...8120"]}' http://127.0.0.1:7079 //Request2 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBalance","id":1,"params":["1196-...-...-...-3496",1]}' http://127.0.0.1:7079 //Request3 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBalance","id":1,"params":[{"key_id":{$key_id}},1]}' http://127.0.0.1:7079 //keyId or account //Response { "jsonrpc": "2.0", "id": 1, "result": { "amount": "9915319240441612", "digits": 12, "total": "9915319240441612", "utxo": "0", "token_symbol": "IBXC" } } </code></pre></div><h3 id="ibax-getblockstxinfo"><a href="#ibax-getblockstxinfo" class="header-anchor">#</a> <strong>ibax.getBlocksTxInfo</strong> </h3> <p>返回其中包含每个区块中交易的相关附加信息列表。</p> <p><strong>参数</strong></p> <ul><li><p><strong>block_id</strong> - <em>Number</em> - 要查询的起始区块高度。</p></li> <li><p><strong>count</strong> - <em>Number</em> - 区块数量，默认为25，最大请求100。</p></li></ul> <p><strong>返回值</strong> <em>Object</em> - 获取区块信息对象。</p> <ul><li><p><strong>block_id</strong> - <em>String</em> - 区块高度。</p></li> <li><p>区块中的交易列表以及每个交易的附加信息：</p> <ul><li><p><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 交易哈希。</p></li> <li><p><strong>contract_name</strong> - <em>String</em> - 合约名称。</p></li> <li><p><strong>params</strong> - <em>Object</em> - 合约参数,合约字段可通过 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a> 查询。</p></li> <li><p><strong>key_id</strong> - <em>Number</em> - 对于第一个区块，是签署该交易的第一个区块的账户地址。</p> <p>对于所有其他区块，是签署该交易的账户地址。</p></li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBlocksTxInfo","id":1,"params":[1,2]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "1": [ //block_id { "hash": "uXSaSrMWlbHpNlu049J5BDypC6MzBQ0/5VEfGQf+5aQ=", "contract_name": "", "params": null, "key_id": 6667782293976713160 } ], "2": [ //block_id { "hash": "r8U9IKjtZ5Be5D4ak3zxLlDwn36CTdfIAsVvQhx7P3w=", "contract_name": "@1NewUser", "params": { "Ecosystem": 1, "NewPubkey": "d11ea197fe23152562c6f54c46335d9093f245ab5d22b13ff3e0e2132dc9ff38da77aa093945280c4cf5ad9e889c074dfd9080099982d8b2d4d100315e1cebc7" }, "key_id": 6667782293976713160 } ] } } </code></pre></div><h3 id="ibax-detailedblocks"><a href="#ibax-detailedblocks" class="header-anchor">#</a> <strong>ibax.detailedBlocks</strong> </h3> <p>返回其中包含每个区块中交易的详细附加信息列表。</p> <p><strong>参数</strong></p> <ul><li><p><strong>block_id</strong> - <em>Number</em> - 要查询的起始区块高度。</p></li> <li><p><strong>count</strong> - <em>Number</em> - 区块数量，默认为25，最大请求100。</p></li></ul> <p><strong>返回值</strong> <em>Object</em> - 获取区块详情对象。</p> <ul><li><strong>block_id</strong> - <em>String</em> - 区块高度。 <ul><li><strong>header</strong> - <em>Object</em> - 区块头区块头包含以下字段: <ul><li><strong>block_id</strong> - <em>Number</em> - 区块高度。</li> <li><strong>time</strong> - <em>Number</em> - 区块生成时间戳。</li> <li><strong>key_id</strong> - <em>Number</em> - 签署该区块的账户地址。</li> <li><strong>node_position</strong> - <em>Number</em> - 在荣誉节点列表中生成区块的节点的位置。</li> <li><strong>version</strong> - <em>Number</em> - 区块结构版本。</li></ul></li> <li><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 区块哈希。</li> <li><strong>node_position</strong> - <em>Number</em> - 在荣誉节点列表中生成区块的节点的位置。</li> <li><strong>key_id</strong> - <em>Number</em> - 签署该区块的账户地址。</li> <li><strong>time</strong> - <em>Number</em> - 区块生成时间戳。</li> <li><strong>tx_count</strong> - <em>Number</em> - 该区块内的交易数。</li> <li><strong>size</strong> - <em>String</em> - 该区块大小。</li> <li><strong>rollback_hash</strong> - <em><a href="#hex">Hex</a> String</em> - 区块回滚哈希值。</li> <li><strong>merkle_root</strong> - <em><a href="#hex">Hex</a> String</em> - 该区块交易的默克尔树。</li> <li><strong>bin_data</strong> - <em><a href="#hex">Hex</a> String</em> - 区块头、区块内所有交易、上一个区块哈希和生成该区块的节点私钥的序列化。</li> <li><strong>transactions</strong> - <em>Object</em> - 交易区块中的交易列表以及每个交易的附加信息： <ul><li><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 交易哈希。</li> <li><strong>contract_name</strong> - <em>String</em> - 合约名称。</li> <li><strong>params</strong> - <em>Object</em> - 合约参数,合约字段可通过 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a> 查询。</li> <li><strong>key_id</strong> - <em>Number</em> - 签署该交易的账户地址。</li> <li><strong>time</strong> - <em>Number</em> - 交易生成时间戳（unit：ms）。</li> <li><strong>type</strong> - <em>Number</em> - 交易类型。</li> <li><strong>size</strong> - <em>String</em> - 交易大小。</li></ul></li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.detailedBlocks","id":1,"params":[1,2]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "1": { //block id "header": { "block_id": 1, "time": 1676512422, "key_id": 6667782293976713160, "node_position": 0, "version": 3 }, "hash": "0d7d51b4c14bacbf45d812f73497ede8f22d678bc4be6e6848193f3b7262ac91", "node_position": 0, "key_id": 6667782293976713160, "time": 1676512422, "tx_count": 1, "size": "660.00B", "rollbacks_hash": "1a829923f2c9b1e259fdfb42cc1bc255e144dbfb352af7e072d0b9d61a94df15", "merkle_root": "36373332663064383331353264316333653639346431656436383734373634363463616363616564636632353232646335633736643066623737343931366363", "bin_data": "Cp4BCAEQppm...", "stop_count": 0, "transactions": [ { "hash": "b9749a4ab31695b1e9365bb4e3d279043ca90ba333050d3fe5511f1907fee5a4", "contract_name": "", "params": null, "key_id": 6667782293976713160, "time": 1676512422406, "type": 1, "size": "250.00B" } ] }, "2": { //block id "header": { "block_id": 2, "time": 1676536235, "key_id": 6667782293976713160, "node_position": 0, "version": 3 }, "hash": "dd13a30661d35e01df82027a6e6607eb47ee00765d69767dbb99e151676c2c96", "node_position": 0, "key_id": 6667782293976713160, "time": 1676536235, "tx_count": 1, "size": "1.53KiB", "rollbacks_hash": "9041312d69e6bcd37c91a2bfa066abaeb53b8398708937a618a89960bfadab3d", "merkle_root": "65366537383931353662613230356565396466353061316538656538643636323332316636616265623764633539616166346635343030383135386538643130", "bin_data": "Cp4BCAIQq9O...", "stop_count": 0, "transactions": [ { "hash": "afc53d20a8ed67905ee43e1a937cf12e50f09f7e824dd7c802c56f421c7b3f7c", "contract_name": "@1NewUser", "params": { "Ecosystem": 1, "NewPubkey": "d11ea197fe23152562c6f54c46335d9093f245ab5d22b13ff3e0e2132dc9ff38da77aa093945280c4cf5ad9e889c074dfd9080099982d8b2d4d100315e1cebc7" }, "key_id": 6667782293976713160, "time": 1676536233945, "type": 3, "size": "390.00B" } ] } } } </code></pre></div><h3 id="ibax-getkeyinfo"><a href="#ibax-getkeyinfo" class="header-anchor">#</a> <strong>ibax.getKeyInfo</strong> </h3> <p>返回一个生态系统列表，其中包含注册了指定地址的角色。</p> <p><strong>参数</strong></p> <ul><li><strong>account</strong> - <em>String</em> - 账户地址。</li></ul> <p><strong>返回值</strong> <em>Object</em> - 指定地址生态列表对象。</p> <ul><li><strong>account</strong> - <em>String</em> - 账户地址。</li> <li><strong>ecosystems</strong> - <em>Array</em> - 生态列表。 <ul><li><strong>ecosystem</strong> - <em>String</em> - 生态系统id。</li> <li><strong>name</strong> - <em>String</em> - 生态系统名称。</li> <li><strong>digits</strong> - <em>Number</em> - 精度。</li> <li><strong>roles</strong> - <em>Array</em> - 角色列表。 <ul><li><strong>id</strong> - <em>String</em> - 角色id 。</li> <li><strong>name</strong> - <em>String</em> - 角色名称。</li></ul></li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getKeyInfo","id":1,"params":["0666-XXXX-XXXX-XXXX-5186"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "account": "0666-XXXX-XXXX-XXXX-5186", "ecosystems": [ { "ecosystem": "1", "name": "platform ecosystem", "digits": 12, "roles": [ { "id": "1", "name": "Developer" }, { "id": "2", "name": "Governancer" } ] } ] } } </code></pre></div><h3 id="ibax-detailedblock"><a href="#ibax-detailedblock" class="header-anchor">#</a> <strong>ibax.detailedBlock</strong> </h3> <p>返回区块中交易的详细附加信息列表。</p> <p><strong>参数</strong></p> <ul><li><strong>Block or Hash</strong> - <em><a href="#blockorhash">BlockOrHash</a></em> - 区块高度或区块Hash。</li></ul> <p><strong>返回值</strong> <em>Object</em> - 获取区块详情对象。</p> <ul><li><p><strong>header</strong> - <em>Object</em> - 区块头区块头包含以下字段:</p> <ul><li><strong>block_id</strong> - <em>Number</em> - 区块高度。</li> <li><strong>time</strong> - <em>Number</em> - 区块生成时间戳。</li> <li><strong>key_id</strong> - <em>Number</em> - 签署该区块的账户地址。</li> <li><strong>node_position</strong> - <em>Number</em> - 在荣誉节点列表中生成区块的节点的位置。</li> <li><strong>version</strong> - <em>Number</em> - 区块结构版本。</li></ul></li> <li><p><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 区块哈希。</p></li> <li><p><strong>node_position</strong> - <em>Number</em> - 在荣誉节点列表中生成区块的节点的位置。</p></li> <li><p><strong>key_id</strong> - <em>Number</em> - 签署该区块的账户地址。</p></li> <li><p><strong>time</strong> - <em>Number</em> - 区块生成时间戳。</p></li> <li><p><strong>tx_count</strong> - <em>Number</em> - 该区块内的交易数。</p></li> <li><p><strong>size</strong> - <em>String</em> - 该区块大小。</p></li> <li><p><strong>rollback_hash</strong> - <em><a href="#hex">Hex</a> String</em> - 区块回滚哈希值。</p></li> <li><p><strong>merkle_root</strong> - <em><a href="#hex">Hex</a> String</em> - 该区块交易的默克尔树。</p></li> <li><p><strong>bin_data</strong> - <em><a href="#hex">Hex</a> String</em> - 区块头、区块内所有交易、上一个区块哈希和生成该区块的节点私钥的序列化。</p></li> <li><p><strong>transactions</strong> - <em>Array</em> - 交易区块中的交易列表以及每个交易的附加信息：</p> <ul><li><strong>hash</strong> - <em><a href="#hex">Hex</a> String</em> - 交易哈希。</li> <li><strong>contract_name</strong> - <em>String</em> - 合约名称。</li> <li><strong>params</strong> - <em>Object</em> - 合约参数,合约字段可通过 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a> 查询。</li> <li><strong>key_id</strong> - <em>Number</em> - 签署该交易的账户地址。</li> <li><strong>time</strong> - <em>Number</em> - 交易生成时间戳（unit：ms）。</li> <li><strong>type</strong> - <em>Number</em> - 交易类型。</li> <li><strong>size</strong> - <em>String</em> - 交易大小。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request1 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.detailedBlock","id":1,"params":["1"]}' http://127.0.0.1:7079 //Request2 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.detailedBlock","id":1,"params":["0d7d51b4c14bacbf45d812f7349...e6e6848193f3b7262ac91"]}' http://127.0.0.1:7079 //Request3 curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.detailedBlock","id":1,"params":[{"id":1}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "header": { "block_id": 1, "time": 1676512422, "key_id": 6667782293976713160, "node_position": 0, "version": 3 }, "hash": "0d7d51b4c14bacbf45d812f7349...e6e6848193f3b7262ac91", "node_position": 0, "key_id": 6667782293976713160, "time": 1676512422, "tx_count": 1, "size": "660.00B", "rollbacks_hash": "1a829923f2c9b1e259fdfb42cc1bc255e144dbfb352af7e072d0b9d61a94df15", "merkle_root": "3637333266306438333135...623737343931366363", "bin_data": "Cp4BCAEQppm2nwYgyI/8gLSVrsRcMkAFGTK6nxD86hfhgQX0dWzO8aYZExDN9UPm8sKkqeUbwrNliYuCJHvvdX+txINnM7+gDqtMF/1K43kc0gYC0u8uOiANfVG0wUusv0XYEvc0l+3o8i1ni8S+bmhIGT87cmKskUIgBEhSsqZwreVAfnj7KGPFHen8uWVCoHGG/jrtpruKEW1IA1ABYAESRDogQBBdW8EBBcF/1yuTqPczaeLubu5NRxS3v3vzwvFW5gFCIARIUrKmcK3lQH54+yhjxR3p/LllQqBxhv467aa7ihFtGkA2NzMyZjBkODMxNTJkMWMzZTY5NGQxZWQ2ODc0NzY0NjRjYWNjYWVkY2YyNTIyZGM1Yzc2ZDBmYjc3NDkxNmNjKugCeJxibFvmk5+enlp0YK1LUkhRYl5xYnJJZn7egSUuiSWJ7Uu9Uys9XS7HdOxY7SDPfmJJSGZu6mUGBgaG5Lc9y1YGlCblZCZ7p1YecejvOPzyp63tWeYpWS+nxBTv3biTOUTqg7vfgedPuXdbnjsmYX49a9mXA025NT4TbjQ65bQwbloQcjbQRG3ZudjjUxuL1/rlp6QimTfLcZNH0o/bie/SfiskTNm1tPrfmrrlbdfMklamXHR53XpxwSODSb1hX3Kvyb1fU+awbZVG8yaXmGqtO3wR8jPsP6y7vTW4JL/AL7WkPL8o2zm1qMSpNC8lJ/XAkpDU4hKwBxgYGBg3BhRlliWWpDrl5CdnJ2ckZuadh0oxrAT5tLgkMbfgMgMDY1v42yy2ZSEVHonFGUcUdpbM8tosNnXjS7PoLY8vVbLYrORebMzKa/80UF6S/d/TJcsDEitz8hNTjvwaueEHCAAA//+pZRGv", "stop_count": 0, "transactions": [ { "hash": "b9749a4ab31695b1e9365bb4e3d279043ca90ba333050d3fe5511f1907fee5a4", "contract_name": "", "params": null, "key_id": 6667782293976713160, "time": 1676512422406, "type": 1, "size": "250.00B" } ] } } </code></pre></div><h3 id="ibax-maxblockid"><a href="#ibax-maxblockid" class="header-anchor">#</a> <strong>ibax.maxBlockId</strong> </h3> <p>获取当前节点上的最高区块ID。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><em>Number</em> - 当前节点上的最高区块。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.maxBlockId","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 774 } </code></pre></div><h3 id="ibax-getkeyscount"><a href="#ibax-getkeyscount" class="header-anchor">#</a> <strong>ibax.getKeysCount</strong> </h3> <p>获取当前节点上的总地址数。</p> <p><strong>参数</strong> 无 <strong>返回值</strong></p> <ul><li><strong>Count</strong> - <em>Number</em> - 总地址数。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getKeysCount","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 11 } </code></pre></div><h3 id="ibax-gettxcount"><a href="#ibax-gettxcount" class="header-anchor">#</a> <strong>ibax.getTxCount</strong> </h3> <p>获取当前节点总交易数。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>Count</strong> - <em>Number</em> - 总交易数。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getTxCount","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 149068 } </code></pre></div><h3 id="ibax-gettransactioncount"><a href="#ibax-gettransactioncount" class="header-anchor">#</a> <strong>ibax.getTransactionCount</strong> </h3> <p>获取区块交易数。</p> <p><strong>参数</strong></p> <ul><li><strong>block or hash</strong> - <em><a href="#blockorhash">BlockOrHash</a></em> - 区块高度或区块Hash。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>Count</strong> - <em>Number</em> - 区块总数量。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getTransactionCount","id":1,"params":["efc386f7573269610a34af9cc722f775cca8183ccaa0ed7a96db61ef0bde6d1c"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 337 } </code></pre></div><h3 id="ibax-getblockscountbynode"><a href="#ibax-getblockscountbynode" class="header-anchor">#</a> <strong>ibax.getBlocksCountByNode</strong> </h3> <p>获取节点位置打包区块数。 <strong>参数</strong></p> <ul><li><p><strong>nodePosition</strong> - <em>Number</em> - 节点下标。</p></li> <li><p><strong>consensusMode</strong> - <em>Number</em> - 共识模式，参数（1: 创建者管理模式 2:DAO治理模式）。</p></li></ul> <p><strong>返回值</strong> <em>Object</em> - 获取节点下标打包数对象。</p> <ul><li><p><strong>total_count</strong> - <em>Number</em> - 总区块数。</p></li> <li><p><strong>partial_count</strong> - <em>Number</em> - 节点下标打包区块数。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBlocksCountByNode","id":1,"params":[0,1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "total_count": 774, "partial_count": 774 } } </code></pre></div><h3 id="ibax-honornodescount"><a href="#ibax-honornodescount" class="header-anchor">#</a> <strong>ibax.honorNodesCount</strong> </h3> <p>获取荣誉节点数量。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>Count</strong> - <em>Number</em> - 节点数量。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.honorNodesCount","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 1 } </code></pre></div><h3 id="ibax-getecosystemcount"><a href="#ibax-getecosystemcount" class="header-anchor">#</a> <strong>ibax.getEcosystemCount</strong> </h3> <p>获取生态系统的数量。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>Count</strong> - <em>Number</em> - 生态数。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getEcosystemCount","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": 2 } </code></pre></div><h3 id="ibax-ecosysteminfo"><a href="#ibax-ecosysteminfo" class="header-anchor">#</a> <strong>ibax.ecosystemInfo</strong> </h3> <p>获取生态信息。</p> <p><strong>参数</strong></p> <ul><li><strong>ecosystem id</strong> - <em>Number</em> - 生态ID。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 生态ID。</li> <li><strong>name</strong> - <em>String</em> - 生态名称。</li> <li><strong>digits</strong> - <em>Number</em> - 精度。</li> <li><strong>token_symbol</strong> - <em>String</em> - 代币符号。</li> <li><strong>token_name</strong> - <em>String</em> - 代币名称。</li> <li><strong>total_amount</strong> - <em>String</em> - 发行量（第一次发行量，如未发行则为 <code>"0"</code>）。</li> <li><strong>is_withdraw</strong> - <em>Bool</em> - 可销毁 <code>true:可销毁 false:不可销毁</code>。</li> <li><strong>withdraw</strong> - <em>String</em> - 销毁量（如不可销毁，或未销毁则为 <code>"0"</code>）。</li> <li><strong>is_emission</strong> - <em>Bool</em> - 可增发 <code>true:可增发 false:不可增发</code>。</li> <li><strong>emission</strong> - <em>String</em> - 增发量 (如不可增发，或未增发则为 <code>"0"</code>)。</li> <li><strong>introduction</strong> - <em>String</em> - 生态简介。</li> <li><strong>logo</strong> - <em>Number</em> - 生态Logo Id（对应Binary table id），可通过RESTFUL API 获取。</li> <li><strong>creator</strong> - <em>String</em> - 生态创建者。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.ecosystemInfo","id":1,"params":[1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 2, "result": { "id": 5, "name": "test name", "digits": 6, "token_symbol": "test", "token_name": "test Coin", "total_amount": "10000", "is_withdraw": true, "withdraw": "100000000000900000", "is_emission": true, "emission": "100000000001000000", "introduction": "this is a test introduction", "logo": 6, "creator": "0666-0819-7161-7879-5186" } } </code></pre></div><h3 id="ibax-appparams"><a href="#ibax-appparams" class="header-anchor">#</a> <strong>ibax.appParams</strong> </h3> <p>返回当前或指定生态系统中的应用程序参数列表。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><p><strong>appid</strong> - <em>Number</em> - 应用程序ID。</p></li> <li><p><strong>ecosystem</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> - 生态系统ID；</p> <p>如果未指定或为0，将返回当前生态系统的参数。</p></li> <li><p><strong>names</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> - 筛选应用参数名称。</p> <p>由逗号分隔的名称列表，例如: <code>name1,name2</code>。</p></li> <li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</p></li> <li><p><strong>limit</strong> - <em>Number</em> <a href="#omitempty">Omitempty</a> 条目条数，默认10条,最多100条。</p></li></ul> <p><strong>返回值</strong></p> <p><em>Array</em> - 应用参数列表。</p> <ul><li><strong>app_id</strong> - <em>Number</em> - 应用程序ID。</li> <li><strong>list</strong> - <em>Number</em> - 数组中的每个元素包含以下参数。 <ul><li><strong>id</strong> - <em>String</em> - 参数ID，唯一；</li> <li><strong>name</strong> - <em>String</em> - 参数名称；</li> <li><strong>value</strong> - <em>String</em> - 参数值；</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.appParams","id":1,"params":[1,1,"role_developer,role_governancer"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "app_id": 1, "list": [ { "id": "4", "name": "role_developer", "value": "1", "conditions": "ContractConditions(\"MainCondition\")" }, { "id": "5", "name": "role_governancer", "value": "2", "conditions": "ContractConditions(\"MainCondition\")" } ] } } </code></pre></div><h3 id="ibax-getecosystemparams"><a href="#ibax-getecosystemparams" class="header-anchor">#</a> <strong>ibax.getEcosystemParams</strong> </h3> <p>获取生态系统参数列表。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><p><strong>ecosystem</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> - 生态系统ID。</p> <p>如果为0或者无此参数时，默认：当前生态id。</p></li> <li><p><strong>names</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> - 筛选参数名称。</p> <p>由逗号分隔的名称列表，例如: <code>name1,name2</code>。</p> <p>当有筛选参数时,<em>offset</em> 与 <em>limit</em> 参数无效。</p></li> <li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</p></li> <li><p><strong>limit</strong> - <em>Number</em> <a href="#omitempty">Omitempty</a> 条目条数，默认10条,最多100条。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>list</strong> - <em>Array</em> - 数组中的每个元素包含以下参数： <ul><li><strong>id</strong> - <em>String</em> - 参数id，唯一。</li> <li><strong>name</strong> - <em>String</em> - 参数名称。</li> <li><strong>value</strong> - <em>String</em> - 参数值。</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getEcosystemParams","id":1,"params":[0,"changing_app_params,changing_language"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "list": [ { "id": "9", "name": "changing_app_params", "value": "ContractConditions(\"DeveloperCondition\")", "conditions": "ContractConditions(\"DeveloperCondition\")" }, { "id": "4", "name": "changing_language", "value": "ContractConditions(\"DeveloperCondition\")", "conditions": "ContractConditions(\"DeveloperCondition\")" } ] } } </code></pre></div><h3 id="ibax-gettablecount"><a href="#ibax-gettablecount" class="header-anchor">#</a> <strong>ibax.getTableCount</strong> </h3> <p>返回当前生态系统的数据表列表。</p> <p>可以设置偏移量和条目条数。</p> <p><a href="#authorization">Authorization</a> <strong>参数</strong></p> <ul><li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</p></li> <li><p><strong>limit</strong> - <em>Number</em> <a href="#omitempty">Omitempty</a> 条目条数，默认25条,最多100条。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>count</strong> - <em>Number</em> - 当前生态数据表总张数。</p></li> <li><p><strong>list</strong> - <em>Array</em> - 数组中的每个元素包含以下参数：</p> <ul><li><strong>name</strong> - <em>String</em> - 无前缀的数据表名称。</li> <li><strong>count</strong> - <em>String</em> - 数据表中的条目数。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getTableCount","id":1,"params":[0,2]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "count": 32, "list": [ { "name": "app_params", "count": "41" }, { "name": "applications", "count": "7" } ] } } </code></pre></div><h3 id="ibax-gettable"><a href="#ibax-gettable" class="header-anchor">#</a> <strong>ibax.getTable</strong> </h3> <p>返回当前生态系统请求数据表的相关信息。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>tableName</strong> - <em>String</em> - 数据表名称。</li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>name</strong> - <em>String</em> - 数据表名称。</p></li> <li><p><strong>insert</strong> - <em>String</em> - 新增条目的权限。</p></li> <li><p><strong>new_column</strong> - <em>String</em> - 新增字段权限。</p></li> <li><p><strong>update</strong> - <em>String</em> - 更改条目权限。</p></li> <li><p><strong>app_id</strong> - <em>String</em> - 应用程序id。</p></li> <li><p><strong>conditions</strong> - <em>String</em> - 更改权限的条件。</p></li> <li><p><strong>columns</strong> - <em>Array</em> - 数据表字段相关信息数组：</p> <ul><li><strong>name</strong> - <em>String</em> - 字段名称。</li> <li><strong>type</strong> - <em>String</em> - 字段数据类型。</li> <li><strong>perm</strong> - <em>String</em> - 更改该字段值的权限。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getTable","id":1,"params":["app_params"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "name": "app_params", "insert": "ContractConditions(\"DeveloperCondition\")", "new_column": "ContractConditions(\"@1MainCondition\")", "update": "ContractAccess(\"@1EditAppParam\")", "conditions": "ContractConditions(\"@1MainCondition\")", "app_id": "1", "columns": [ { "name": "value", "type": "text", "perm": "ContractAccess(\"@1EditAppParam\")" }, { "name": "app_id", "type": "number", "perm": "ContractAccess(\"@1ItemChangeAppId\")" }, { "name": "ecosystem", "type": "number", "perm": "false" }, { "name": "conditions", "type": "text", "perm": "ContractAccess(\"@1EditAppParam\")" }, { "name": "permissions", "type": "json", "perm": "ContractConditions(\"@1MainCondition\")" }, { "name": "name", "type": "varchar", "perm": "false" } ] } } </code></pre></div><h3 id="ibax-getlist"><a href="#ibax-getlist" class="header-anchor">#</a> <strong>ibax.getList</strong> </h3> <p>返回指定数据表的条目。</p> <p>可以指定要返回的列。</p> <p>可以设置偏移量和条目条数。</p> <p>可以设置查询条件。</p> <p>对数据表中类型为<em>BYTEA</em>(字节数组、哈希、字节码数组)做16进制编码处理。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong> <em>Object</em> - 获取数据表对象。</p> <ul><li><p><strong>name</strong> - <em>String</em> - 数据表名称。</p></li> <li><p><strong>limit</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 条目条数，默认25条。</p></li> <li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</p></li> <li><p><strong>order</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> 排序方式，默认id ASC。</p></li> <li><p><strong>columns</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> 请求列的列表，以逗号分隔，如果未指定，将返回所有列。</p> <p>在所有情况下都会返回id列。</p></li> <li><p><strong>where</strong> - <em>Object</em> - <a href="#omitempty">Omitempty</a></p> <p>查询条件，Example:如果要查询 id>2 和 name = john，</p> <p>你可以使用 <code>where:{"id":{"$gt":2},"name":{"$eq":"john"}}</code>，</p> <p>详情请参考<a href="/zh-CN/topics/script.html#dbfind">DBFind</a> where 语法。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>count</strong> - <em>Number</em> - 条目总数。</p></li> <li><p><strong>list</strong> - <em>Array</em> - 数组中的每个元素包含以下参数：</p> <ul><li><strong>id</strong> - <em>String</em> - 条目ID。</li> <li><strong>...</strong> - 数据表其他列。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getList","id":1,"params":[{"name":"@1history","where":{"$and": [{"id":{"$gt": 2}}, {"id":{"$lt": 5}}]}}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "count": 2, "list": [ { "amount": "1000000000000000000", "block_id": "4", "comment": "UTXO", "created_at": "1676538080433", "ecosystem": "1", "id": "3", "recipient_balance": "1000000000000000000", "recipient_id": "666...160", "sender_balance": "1000000000000000000", "sender_id": "666...3160", "status": "0", "txhash": "2ac156c0ce55c10fd485cb9d59f50e3f9b269fb9bb69571d3c2eeae033d6c6cc", "type": "24", "value_detail": "NULL" } ] } } </code></pre></div><h3 id="ibax-getsections"><a href="#ibax-getsections" class="header-anchor">#</a> <strong>ibax.getSections</strong> </h3> <p>返回当前生态系统的选项卡表条目的列表，可以设置偏移量和条目条数。</p> <p>如果 <em>role_access</em>字段包含角色列表，并且不包括当前角色，则不会返回记录。<em>title</em>字段内数据将被请求头的 <em>Accept-Language</em> 语言资源替换。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><em>Object</em> - 获取sections请求对象。 <ul><li><p><strong>limit</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> - 条目条数，默认25条。</p></li> <li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> - 偏移量，默认为0。</p></li> <li><p><strong>lang</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> -</p> <p>该字段指定多语言资源代码或本地化，例如：<em>en，tr</em>。如果未找到指定的多语言资源，例如：<em>en-US</em>，则在多语言资源组, <strong>default</strong>: <strong>en</strong> 中搜索。</p></li></ul></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>count</strong> - <em>Number</em> - 选项卡条目总数。</p></li> <li><p><strong>list</strong> - <em>Array</em> - 数组中每个元素都包含sections表中所有列的信息。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getSections","id":1,"params":[{"offset":0,"limit":2}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "count": 2, "list": [ { "ecosystem": "1", "id": "1", "page": "default_page", "roles_access": "[]", "status": "2", "title": "Home", "urlname": "home" }, { "ecosystem": "1", "id": "2", "page": "developer_index", "roles_access": "[]", "status": "1", "title": "Developer", "urlname": "developer" } ] } } </code></pre></div><h3 id="ibax-getrow"><a href="#ibax-getrow" class="header-anchor">#</a> <strong>ibax.getRow</strong> </h3> <p>返回当前生态系统中指定数据表的条目。可以指定要返回的列。</p> <p><a href="#authorization">Authorization</a> <strong>参数</strong></p> <ul><li><p><strong>tableName</strong> - <em>String</em> - 数据表名称。</p></li> <li><p><strong>id</strong> - <em>Number</em> - 条目ID。</p></li> <li><p><strong>columns</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a></p> <p>请求列的列表，以逗号分隔，如果未指定，将返回所有列。</p> <p>如不筛选可置空""。</p> <p>在所有情况下都会返回id列。</p></li> <li><p><strong>whereColumn</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> - 查找列名（只可查找Number类型列）。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>value</strong>- <em>Object</em> - 接收列值的对象。 <ul><li><strong>id</strong> - <em>String</em> - 条目ID。</li> <li><strong>...</strong> - 请求列的序列。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getRow","id":1,"params":["@1history",4,"id,sender_id,recipient_id,amount,ecosystem,created_at","id"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "value": { "amount": "680388766240", "created_at": "1677222830899", "ecosystem": "1", "id": "296", "recipient_id": "6667782293976713160", "sender_id": "6660819716178795186" } } } </code></pre></div><h3 id="ibax-systemparams"><a href="#ibax-systemparams" class="header-anchor">#</a> <strong>ibax.systemParams</strong> </h3> <p>返回平台参数列表。</p> <p><a href="#authorization">Authorization</a> <strong>参数</strong></p> <ul><li><p><strong>names</strong> - <em>String</em> <a href="#omitempty">Omitempty</a> - 请求参数列表，用逗号分隔。</p> <p>例如 <code>names="name1,name2"</code>。当有筛选参数时,<em>offset</em> 与 <em>limit</em> 参数无效。</p></li> <li><p><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</p></li> <li><p><strong>limit</strong> - <em>Number</em> <a href="#omitempty">Omitempty</a> 条目条数，默认10条,最多100条。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>list</strong> - <em>Array</em> - 数组中每个元素包含以下参数： <ul><li><strong>id</strong> - <em>String</em> - 唯一id。</li> <li><strong>name</strong> - <em>String</em> - 参数名称。</li> <li><strong>value</strong> - <em>String</em> - 参数值。</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.systemParams","id":1,"params":["gap_between_blocks,honor_nodes"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "list": [ { "id": "4", "name": "gap_between_blocks", "value": "2", "conditions": "ContractAccess(\"@1UpdatePlatformParam\")" }, { "id": "6", "name": "honor_nodes", "value": "", "conditions": "ContractAccess(\"@1UpdatePlatformParam\")" } ] } } </code></pre></div><h3 id="ibax-history"><a href="#ibax-history" class="header-anchor">#</a> <strong>ibax.history</strong> </h3> <p>返回当前生态系统中指定数据表中条目的更改记录。</p> <p><a href="#authorization">Authorization</a> <strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 数据表名称。</li> <li><strong>tableId</strong> - <em>Number</em> - 条目ID。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>list</strong> - <em>Array</em> - 数组中每个元素包含所请求条目的更改记录。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.history","id":1,"params":["contracts",1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "list": [ { "conditions": "ContractConditions(\"MainCondition\")", "ecosystem": "1", "value": "// This contract is used to set \"developer\" rights....." } ] } } </code></pre></div><h3 id="ibax-getpagerow"><a href="#ibax-getpagerow" class="header-anchor">#</a> <strong>ibax.getPageRow</strong> </h3> <p>获取当前生态系统pages数据表字段的条目。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 指定表中条目的名称。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 条目ID。</li> <li><strong>name</strong> - <em>String</em> - 条目名称。</li> <li><strong>value</strong> - <em>String</em> - 内容。</li> <li><strong>menu</strong> - <em>String</em> - 目录。</li> <li><strong>nodesCount</strong> - <em>Number</em> - 页面所需验证的节点数。</li> <li><strong>app_id</strong> - <em>Number</em> - 应用Id。</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getPageRow","id":1,"params":["default_page"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "id": 5, "name": "default_page", "value": "If(#account_id# == #guest_account#){\n Include(@1apps_description)\n}.Else{\n Include(@1profile)\n}", "menu": "default_menu", "nodesCount": 1, "app_id": 1, "conditions": "ContractConditions(\"@1DeveloperCondition\")" } } </code></pre></div><h3 id="ibax-getmenurow"><a href="#ibax-getmenurow" class="header-anchor">#</a> <strong>ibax.getMenuRow</strong> </h3> <p>获取当前生态系统menu数据表字段的条目。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 指定表中条目的名称。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 条目ID。</li> <li><strong>name</strong> - <em>String</em> - 条目名称。</li> <li><strong>title</strong> - <em>String</em> - 标题。</li> <li><strong>value</strong> - <em>String</em> - 内容。</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getMenuRow","id":1,"params":["default_menu"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "id": 2, "name": "default_menu", "title": "default", "value": "\nMenuItem.....", "conditions": "ContractConditions(\"@1DeveloperCondition\")" } } </code></pre></div><h3 id="ibax-getsnippetrow"><a href="#ibax-getsnippetrow" class="header-anchor">#</a> <strong>ibax.getSnippetRow</strong> </h3> <p>获取当前生态系统snippet数据表字段的条目。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 指定表中条目的名称。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 条目ID。</li> <li><strong>name</strong> - <em>String</em> - 条目名称。</li> <li><strong>value</strong> - <em>String</em> - 内容。</li> <li><strong>conditions</strong> - <em>String</em> - 更改参数的权限。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getSnippetRow","id":1,"params":["welcome"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "id": 12, "name": "welcome", "value": "Div(content-wrapper)....", "conditions": "ContractConditions(\"@1DeveloperCondition\")" } } </code></pre></div><h3 id="ibax-getappcontent"><a href="#ibax-getappcontent" class="header-anchor">#</a> <strong>ibax.getAppContent</strong> </h3> <p>获取应用相关信息（包括page、snippet、menu）。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 应用id。</li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>snippets</strong> - <em>Array</em> - 代码片段信息数组。</p> <ul><li><strong>id</strong> - <em>Number</em> - id。</li> <li><strong>name</strong> - <em>String</em> - 代码片段名称。</li></ul></li> <li><p><strong>pages</strong> - <em>Array</em> - 页面信息数组。</p> <ul><li><strong>id</strong> - <em>Number</em> - id。</li> <li><strong>name</strong> - <em>String</em> - 页面名称。</li></ul></li> <li><p><strong>contracts</strong> - <em>Array</em> - 合约信息数组。</p> <ul><li><strong>id</strong> - <em>Number</em> - id。</li> <li><strong>name</strong> - <em>String</em> - 合约名称。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}}" -d '{"jsonrpc":"2.0","method":"ibax.getAppContent","id":1,"params":[1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "snippets": [ //if not app snippets is null array,example:[] { "id": 2, "name": "developer_link" }, { "id": 3, "name": "export_info" } ], "pages": [ //if not app pages is null array,example:[] { "id": 6, "name": "menus_list" }, { "id": 7, "name": "params_edit" } ], "contracts": [ //if not app contracts is null array,example:[] { "id": 2, "name": "MainCondition" }, { "id": 33, "name": "NodeOwnerCondition" } ] } } </code></pre></div><h3 id="ibax-getmember"><a href="#ibax-getmember" class="header-anchor">#</a> <strong>ibax.getMember</strong> </h3> <p>获取成员信息。</p> <p><strong>参数</strong> <strong>account</strong> - <em>String</em> - 成员信息。</p> <p><strong>ecosystemId</strong> - <em>Number</em> - 生态id。</p> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 成员id。</li> <li><strong>member_name</strong> - <em>String</em> - 名称。</li> <li><strong>image_id</strong> - <em>Number</em> - 头像id。</li> <li><strong>member_info</strong> - <em>String</em> - 简介。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}}" -d '{"jsonrpc":"2.0","method":"ibax.getMember","id":1,"params":["1497-2036-4953-3607-1121",1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "id": 14, "member_name": "som", "image_id": 5, "member_info": "{\"information\": \"Everything will be okay in the end. If it's not okay, it's not the end.\"}" } } </code></pre></div><h3 id="ibax-getcontracts"><a href="#ibax-getcontracts" class="header-anchor">#</a> <strong>ibax.getContracts</strong> </h3> <p>获取当前生态系统中的合约列表，可以设置偏移量和条目条数。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>offset</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 偏移量，默认为0。</li> <li><strong>limit</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 条目条数，默认25条。</li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>count</strong> - <em>Number</em> - 条目总数。</p></li> <li><p><strong>list</strong> - <em>Array</em> - 数组中每个元素包含以下参数：</p> <ul><li><strong>id</strong> - <em>String</em> - 合约ID。</li> <li><strong>name</strong> - <em>String</em> - 合约名称。</li> <li><strong>value</strong> - <em>String</em> - 合约内容。</li> <li><strong>wallet_id</strong> - <em>String</em> - 合约绑定的账户地址。</li> <li><strong>address</strong> - <em>String</em> - 合约绑定的钱包地址 <code>XXXX-...-XXXX</code>。</li> <li><strong>ecosystem_id</strong> - <em>String</em> - 合约所属的生态系统ID。</li> <li><strong>app_id</strong> - <em>String</em> - 合约所属的应用程序ID。</li> <li><strong>conditions</strong> - <em>String</em> - 更改合约的权限。</li> <li><strong>token_id</strong> - <em>String</em> - 作为支付合约费用的通证所在的生态系统ID。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getContracts","id":1,"params":[0,1]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "count": 293, "list": [ { "address": "0000-0000-0000-0000-0000", "app_id": "1", "conditions": "ContractConditions(\"@1DeveloperCondition\")", "ecosystem_id": "1", "id": "1", "name": "DeveloperCondition", "token_id": "1", "value": "// This contract is used to ...", "wallet_id": "0" } ] } } </code></pre></div><h3 id="ibax-getcontractinfo"><a href="#ibax-getcontractinfo" class="header-anchor">#</a> <strong>ibax.getContractInfo</strong> </h3> <p>返回指定合约的相关信息。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>contractName</strong> - <em>String</em> - 合约名称。格式为 <code>@ecosystem_id%%contractName%</code>,例@1contractName(指定生态1合约名称contractName)或者contractName(当前生态合约名称contractName)。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - VM中合约ID。</li> <li><strong>name</strong> - <em>String</em> - 带生态系统ID的合约名称 <code>@1MainCondition</code>。</li> <li><strong>state</strong> - <em>Number</em> - 合约所属的生态系统ID。</li> <li><strong>walletid</strong> - <em>String</em> - 合约绑定的账户地址</li> <li><strong>tokenid</strong> - <em>String</em> - 作为支付合约费用的通证所在的生态系统ID。</li> <li><strong>address</strong> - <em>String</em> - 合约绑定的钱包地址 <code>XXXX-...-XXXX</code>。</li> <li><strong>tableid</strong> - <em>String</em> - <em>contracts</em> 表中合约所在的条目ID。</li> <li><strong>fields</strong> - <em>Array</em> - 数组中包含合约 <strong>data</strong> 部分每个参数的结构信息： <ul><li><strong>name</strong> - <em>String</em> - 参数名称。</li> <li><strong>type</strong> - <em>String</em> - 参数类型。</li> <li><strong>optional</strong> - <em>Bool</em> - 参数选项，<code>true</code> 表示可选参数，<code>false</code> 表示必选参数。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getContractInfo","id":1,"params":["@1TokensSend"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "id": 5098, "state": 1, "tableid": "98", "walletid": "0", "tokenid": "1", "address": "0000-0000-0000-0000-0000", "fields": [ { "name": "Amount", "type": "money", "optional": false }, { "name": "Recipient", "type": "string", "optional": true }, { "name": "iName", "type": "string", "optional": true }, { "name": "Comment", "type": "string", "optional": true }, { "name": "Ecosystem", "type": "int", "optional": true } ], "name": "@1TokensSend" } } </code></pre></div><h3 id="ibax-sendtx"><a href="#ibax-sendtx" class="header-anchor">#</a> <strong>ibax.sendTx</strong> </h3> <p>接收参数中的交易并将其添加到交易队列，如果请求执行成功，则返回交易哈希。该哈希可获得区块内对应的交易，在发生错误响应时，该哈希包含在错误文本信息中。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><em>Object</em> - 交易数据对象 <ul><li><strong>tx_key</strong> - <em>String</em> - 交易内容，该参数可指定任何名称，支持接收多个交易。</li></ul></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>hashes</strong> - <em>Array</em> - 交易哈希数组： <ul><li><strong>tx1</strong> - <em>String</em> - 交易1的哈希。</li> <li><strong>txN</strong> - <em>String</em> - 交易N的哈希。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.sendTx","id":1,"params":[{"tx1":...,"txN":...}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "hashes":[ {"hash1":"hash1"}, {"hashN":"hashN"} ] } } </code></pre></div><h3 id="ibax-txstatus"><a href="#ibax-txstatus" class="header-anchor">#</a> <strong>ibax.txStatus</strong> </h3> <p>获取指定交易哈希的区块ID和错误信息，如果区块ID和错误文本信息的返回值为空，则该交易尚未包含在区块中。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>hashes</strong> - <em>String</em> - 交易哈希,使用 <code>,</code> 分割。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>hash</strong> - <em>Object</em> - 交易哈希。 <ul><li><p><strong>blockid</strong> - <em>String</em> - 如果交易执行成功，则返回区块ID；</p> <p>如果交易执行失败，则 <em>blockid</em> 为 <code>0</code>, 如果交易执行错误被惩罚会返回对应区块ID。</p></li> <li><p><strong>result</strong> - <em>String</em> - 通过 <strong>$result</strong> 变量返回交易结果。</p></li> <li><p><strong>errmsg</strong> - <em>Object</em> - <a href="#omitempty">Omitempty</a> 如果执行交易失败，则返回错误文本信息。</p> <ul><li><strong>type</strong> - <em>String</em> - 错误类型。</li> <li><strong>error</strong> - <em>String</em> - 错误信息。</li></ul></li> <li><p><strong>penalty</strong> - <em>Number</em> - 如果交易执行失败，（0：无惩罚 1：惩罚）。</p></li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.txStatus","id":1,"params":["cf46ef1ce7ecfcf48ccf209577fb8a2130426b71adc3a3855aff7f68d114fca9,4a458232de2ab2a3f5361da68e409b925c775346d14139263a69c0e8ecf0166b"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 2, "result": { "4a458232de2ab2a3f5361da68e409b925c775346d14139263a69c0e8ecf0166b": { "blockid": "793", "result": "", "penalty": 0 }, "cf46ef1ce7ecfcf48ccf209577fb8a2130426b71adc3a3855aff7f68d114fca9": { "blockid": "793", "errmsg": { "type": "warning", "error": "platform ecosystem can not be burning Tokens" }, "result": "", "penalty": 1 } } } </code></pre></div><h3 id="ibax-txinfo"><a href="#ibax-txinfo" class="header-anchor">#</a> <strong>ibax.txInfo</strong> </h3> <p>返回指定哈希的交易相关信息，包括区块ID和确认数。如果指定可选参数，还可返回合约名称及其相关参数。</p> <p><strong>参数</strong></p> <ul><li><p><strong>hash</strong> - <em>String</em> - 交易哈希。</p></li> <li><p><strong>contractinfo</strong> - <em>Bool</em> <a href="#omitempty">Omitempty</a> - 合约详细参数标识，获取该交易相关的合约详情,默认为<code>false</code>。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>blockid</strong> - <em>Number</em> - 包含该交易的区块ID。如果该值为 <code>0</code>，则找不到该哈希的交易。如果交易发生在当前节点上，可通过<a href="#ibax-txstatus">ibax.txStatus</a>获取。</p></li> <li><p><strong>confirm</strong> - <em>Number</em> - 该区块 <em>blockid</em> 的节点确认数。</p></li> <li><p><strong>data</strong> - <em>Object</em> - 如果指定了 <code>contentinfo=true</code>，则返回合约详情信息。未指定时为null。</p> <ul><li><strong>block_id</strong> - <em>Number</em> - 区块高度。</li> <li><strong>block_hash</strong> - <em>String</em> - 区块hash。</li> <li><strong>address</strong> - <em>String</em> - 交易创建地址。</li> <li><strong>ecosystem</strong> - <em>String</em> - 交易发送生态id。</li> <li><strong>hash</strong> - <em>String</em> - 交易hash。</li> <li><strong>expedite</strong> - <em>String</em> - 加急费,如果没有则为""。</li> <li><strong>contract_name</strong> - <em>String</em> - 合约名称。</li> <li><strong>params</strong> - <em>Object</em> - 合约参数,合约字段可通过 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a> 查询。</li> <li><strong>created_at</strong> - <em>Number</em> - 交易产生时间。</li> <li><strong>size</strong> - <em>String</em> - 交易大小 unit：B;KiB;MiB;GiB;TiB。</li> <li><strong>status</strong> - <em>String</em> - 状态（0:成功 1:惩罚）。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.txInfo","id":1,"params":["020d8c004b3a0c00a6bfffa36e2746509295e5ea6dbb14e7cd6098c3d906bb58",true]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "blockid": "796", "confirm": 0, "data": { "block_id": 796, "block_hash": "bccbc3cf47b49bee5fb7321810884db49b73f5114b0a6fcd234dd3fdf9c22ef4", "address": "0666-7782-2939-7671-3160", "ecosystem": 2, "hash": "020d8c004b3a0c00a6bfffa36e2746509295e5ea6dbb14e7cd6098c3d906bb58", "expedite": "1", "contract_name": "@1TokensSend", "params": { "Amount": "1000000000000", "Recipient": "0666-7782-2939-7671-3160" }, "created_at": 1678774455841, "size": "213.00B", "status": 1 } } } </code></pre></div><h3 id="ibax-txinfomultiple"><a href="#ibax-txinfomultiple" class="header-anchor">#</a> <strong>ibax.txInfoMultiple</strong> </h3> <p>返回指定哈希列表的交易相关信息。</p> <p><strong>参数</strong></p> <ul><li><p><strong>hashes</strong> - <em>Array</em> - 交易哈希列表。</p></li> <li><p><strong>contractinfo</strong> - <em>Bool</em> <a href="#omitempty">Omitempty</a> - 合约详细参数标识，获取该交易相关的合约详情,默认为<code>false</code>。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>results</strong> - <em>Array</em> - 数据字典中交易哈希作为键，交易详细作为值。 <ul><li><strong>hash</strong> - <em>String</em> - 交易哈希。 <ul><li><strong>blockid</strong> - <em>Number</em> - 包含该交易的区块ID。如果该值为 <code>0</code>，则找不到该哈希的交易。</li> <li><strong>confirm</strong> - <em>Number</em> - 该区块 <em>blockid</em> 的确认数。</li> <li><strong>data</strong> - <em>Object</em> - 如果指定了 <code>contentinfo=true</code>，则合约详情返回给该参数。未指定时为null。 <ul><li><strong>block_id</strong>- <em>Number</em> - 区块高度。</li> <li><strong>block_hash</strong> - <em>String</em> - 区块hash。</li> <li><strong>address</strong> - <em>String</em> - 交易创建地址。</li> <li><strong>ecosystem</strong> - <em>String</em> - 交易发送生态id。</li> <li><strong>hash</strong> - <em>String</em> - 交易hash。</li> <li><strong>expedite</strong> - <em>String</em> - 加急费,如果没有则为""</li> <li><strong>contract_name</strong> - <em>String</em> - 合约名称。</li> <li><strong>params</strong> - <em>Object</em> - 合约参数,合约字段可通过 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a> 查询。</li> <li><strong>created_at</strong> - <em>Number</em> - 交易产生时间</li> <li><strong>size</strong> - <em>String</em> - 交易大小 unit：B;KiB;MiB;GiB;TiB。</li> <li><strong>status</strong> - <em>String</em> - 状态（0:成功 1:惩罚）。</li></ul></li></ul></li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getPageValidatorsCount","id":1,"params":[["1875b4fc02a8bf5ccf0d3fbce83011dd6711d8d325c7d731ac659b8beffc0284","4a458232de2ab2a3f5361da68e409b925c775346d14139263a69c0e8ecf0166b"],true]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "results": { "1875b4fc02a8bf5ccf0d3fbce83011dd6711d8d325c7d731ac659b8beffc0284": { "blockid": 0, "confirm": 0, "data": null }, "4a458232de2ab2a3f5361da68e409b925c775346d14139263a69c0e8ecf0166b": { "blockid": 793, "confirm": 0, "data": { "block_id": 793, "block_hash": "ef3b2f2e18662e0b8bba136a209e30c5aae76d9a82e0b21209786f62fe5676e4", "address": "0666-0819-7161-7879-5186", "ecosystem": 1, "hash": "4a458232de2ab2a3f5361da68e409b925c775346d14139263a69c0e8ecf0166b", "expedite": "1", "contract_name": "@1TokensSend", "params": { "Amount": "200", "Comment": "Hello Dear", "Recipient": "1196-2490-5275-7101-3496" }, "created_at": 1678765099072, "size": "297.00B", "status": 0 } } } } } </code></pre></div><h3 id="ibax-getpagevalidatorscount"><a href="#ibax-getpagevalidatorscount" class="header-anchor">#</a> <strong>ibax.getPageValidatorsCount</strong> </h3> <p>返回指定页面所需验证的节点数。</p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 页面名称，格式为 <code>@ecosystem_id%%page_name%</code>,例@1params_list(指定生态1页面名称params_list)或者params_list(当前生态页面名称params_list)。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>validate_count</strong> - <em>Number</em> - 指定页面所需验证的节点数。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getPageValidatorsCount","id":1,"params":["@1params_list"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "validate_count": 1 } } </code></pre></div><h3 id="ibax-getpage"><a href="#ibax-getpage" class="header-anchor">#</a> <strong>ibax.getPage</strong> </h3> <p>获取指定页面名称的代码JSON对象树，这是模版引擎处理的结果。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><p><strong>name</strong> - <em>String</em> - 带生态系统ID的页面名称，格式为 <code>@ecosystem_id%%page_name%</code>，例如 <code>@1main_page</code>。</p> <p>如果不带生态系统ID，则默认查找当前生态的页面，例如 <code>main_page</code>。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>menu</strong> - <em>String</em> - 页面所属的菜单名称。</p></li> <li><p><strong>menutree</strong> - <em>Array</em> - 页面的菜单JSON对象树。</p></li> <li><p><strong>tree</strong> - <em>Array</em> - 页面JSON对象树。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getPage","id":1,"params":["@1params_list"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "menu": "developer_menu", "menutree": [ { "tag": "menuitem", "attr": { "icon": "icon-cloud-upload", "page": "@1import_upload", "title": "Import" } } ... ], "tree": [ { .... } ... ], "nodesCount": 1 } } </code></pre></div><h3 id="ibax-getmenu"><a href="#ibax-getmenu" class="header-anchor">#</a> <strong>ibax.getMenu</strong> </h3> <p>获取指定菜单名称的代码JSON对象树，这是模版引擎处理的结果。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - <blockquote><p>带生态系统ID的菜单名称，格式为 <code>@ecosystem_id%%menu_name%</code>，例如 <code>@1main_menu</code>。如果不带生态系统ID，则默认查找当前生态的菜单，例如 <code>main_menu</code></p></blockquote></li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>title</strong> - <em>String</em> - 菜单标题。</p></li> <li><p><strong>tree</strong> - <em>Array</em> - 菜单JSON对象树。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getMenu","id":1,"params":["@1default_menu"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "title": "default", "tree": [ { "tag": "menuitem", "attr": { "icon": "icon-cloud-upload", "page": "@1import_upload", "title": "Import" } } ... ] } } </code></pre></div><h3 id="ibax-getsource"><a href="#ibax-getsource" class="header-anchor">#</a> <strong>ibax.getSource</strong> </h3> <p>返回指定页面名称的代码JSON对象树。不执行任何函数或接收任何数据。返回的JSON对象树对应于页面模版，可以在可视化页面设计器中使用。如果找不到页面，则返回404错误。</p> <p><a href="#authorization">Authorization</a></p> <p><strong>参数</strong></p> <ul><li><strong>name</strong> - <em>String</em> - 带生态系统ID的页面名称，格式为 <code>@ecosystem_id%%page_name%</code>，例如 <code>@1main_page</code>。如果不带生态系统ID，则默认查找当前生态的页面例如 <code>main_page</code>。</li></ul> <p><strong>返回值</strong></p> <ul><li><strong>tree</strong> - <em>Array</em> - 页面的JSON对象树。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer {$Token}" -d '{"jsonrpc":"2.0","method":"ibax.getSource","id":1,"params":["@1params_list"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "tree": [ { "tag": "dbfind", "attr": { "name": "@1applications" }, "tail": [ { "tag": "where", "attr": { "where": "{\"ecosystem\": \"#ecosystem_id#\", \"name\": \"System\"}" } } ... ] }, { "tag": "setvar", "attr": { "name": "role_developer_id", "value": "AppParam(Ecosystem: #ecosystem_id#, App: #application_id#, Name: role_developer)" } }, { "tag": "dbfind", "attr": { "name": "@1roles_participants" }, "tail": [ { "tag": "where", "attr": { "where": "{\"ecosystem\": \"#ecosystem_id#\", \"$and\": [{\"role->id\": {\"$in\": [#role_developer_id#]}}, {\"role->id\": \"#role_id#\"}], \"member->account\": \"#account_id#\", \"deleted\": 0}" } } ... ] }, { "tag": "if", "attr": { "condition": "#developer_access_id#>0" }, "children": [ { "tag": "setvar", "attr": { "name": "this_page", "value": "@1params_list" } } ... ], "tail": [ { "tag": "else", "children": [ { "tag": "settitle", "attr": { "title": "$@1ecosystem_parameters$" } } ... ] } ] } ] } } </code></pre></div><h3 id="ibax-getpagehash"><a href="#ibax-getpagehash" class="header-anchor">#</a> <strong>ibax.getPageHash</strong> </h3> <p>返回指定页面名称的SHA256哈希，如果找不到页面，则返回404错误。</p> <p>要向其他节点发出请求时接收正确的哈希，还必须传递 <em>ecosystem,key_id,role_id</em>参数。要从其他生态系统接收页面，生态系统ID必须在页面名称中添加前缀。例如：<code>@2mypage</code>。</p> <p><strong>参数</strong></p> <ul><li><p><strong>name</strong> - <em>String</em> - 带生态系统ID的页面名称。格式为 <code>@ecosystem_id%%page_name%</code>，例如 <code>@1main_page</code>,可指定生态ID</p></li> <li><p><strong>ecosystem</strong> - <em>Number</em> - <a href="#omitempty">Omitempty</a> 生态系统ID。</p></li> <li><p><em>Object</em> - <a href="#omitempty">Omitempty</a> 获取指定页面对象。</p> <ul><li><strong>key_id</strong> - <em>String</em> - 账户地址。</li> <li><strong>role_id</strong> - <em>String</em> - 角色ID。</li></ul></li></ul> <p><strong>返回值</strong></p> <ul><li><em>Object</em> - <ul><li><strong>hash</strong> - <em>String</em> - 十六进制哈希值。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getPageHash","id":1,"params":["@1params_list",0,{"role_id":"1","key_id":"-6484253546138538120"}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "hash": "fc5ed3b5e879dd5521dfb792e815019bd8411851e850e75a3590d71e950a0465" } } </code></pre></div><h3 id="ibax-getcontent"><a href="#ibax-getcontent" class="header-anchor">#</a> <strong>ibax.getContent</strong> </h3> <p>从 <strong>template</strong> 参数返回页面代码的JSON对象数，如果将可选参数。<strong>source</strong> 指定为 <code>true</code>，则该JSON对象树不执行任何函数和接收数据。该JSON对象树可以在可视化页面设计器中使用。</p> <p><strong>参数</strong></p> <ul><li><em>Object</em> <ul><li><p><strong>template</strong> - <em>String</em> - 页面代码。</p></li> <li><p><strong>source</strong> - <em>Bool</em> - 如果指定为 <code>true</code>，则JSON对象树不执行任何函数和接收数据。</p></li></ul></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>tree</strong> - <em>Object</em> - JSON对象树。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getContent","id":1,"params":[{"template","..."source":true}]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "tree": { "type":"......", "children": [ {...}, {...} ] } } } </code></pre></div><h3 id="ibax-getblockinfo"><a href="#ibax-getblockinfo" class="header-anchor">#</a> <strong>ibax.getBlockInfo</strong> </h3> <p>返回指定区块ID的相关信息。</p> <p><strong>参数</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 区块高度。</li></ul> <p><strong>返回值</strong></p> <ul><li><p><strong>hash</strong> - <em>String</em> - 区块哈希值。</p></li> <li><p><strong>key_id</strong> - <em>Number</em> - 签署该区块的账户地址。</p></li> <li><p><strong>time</strong> - <em>Number</em> 区块生成时间戳。</p></li> <li><p><strong>tx_count</strong> - <em>Number</em> - 该区块内的交易总数。</p></li> <li><p><strong>rollbacks_hash</strong> - <em>String</em> - 区块回滚哈希值。</p></li> <li><p><strong>node_position</strong> - <em>Number</em> - 该区块在荣誉节点列表的位置。</p></li> <li><p><strong>consensus_mode</strong> <em>Number</em> - 共识模式，参数（1: 创建者管理模式 2:DAO治理模式）</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getBlockInfo","id":1,"params":[12]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "hash": "Hl+/VvYFFu4iq4zLrRDGHBhm7DM7llEAfEJyaX2Q3is=", "key_id": 6667782293976713160, "time": 1677134955, "tx_count": 1, "rollbacks_hash": "o37QAighKMb8WqbEHAqCQb5bOfMvOqV0WoTaN631q74=", "node_position": 0, "consensus_mode": 1 } } </code></pre></div><h3 id="ibax-getconfig"><a href="#ibax-getconfig" class="header-anchor">#</a> <strong>ibax.getConfig</strong> </h3> <p>获取centrifugo的主机地址和端口。</p> <p><strong>参数</strong></p> <ul><li><p><strong>option</strong> - <em>String</em> - 配置项。</p> <p>1."centrifugo" - 消息服务。</p></li></ul> <p><strong>返回值</strong></p> <ul><li><strong>centrifugo</strong> - <em>String</em> - <a href="#omitempty">Omitempty</a> centrifugo的主机地址和端口结果格式 <code>http://address:port</code>，例如: <code>http://127.0.0.1:8100</code>。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"ibax.getConfig","id":1,"params":["centrifugo"]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "centrifugo":"http://127.0.0.1:8100" } } </code></pre></div><h3 id="net-getnetwork"><a href="#net-getnetwork" class="header-anchor">#</a> <strong>net.getNetwork</strong> </h3> <p>获取节点信息。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>network_id</strong> - <em>String</em> - 网络标识符。</li> <li><strong>centrifugo_url</strong> - <em>String</em> - centrifugo消息服务地址。</li> <li><strong>test</strong> - <em>Bool</em> - 是否为测试链。</li> <li><strong>private</strong> - <em>Bool</em> - 是否为私有链。</li> <li><strong>honor_nodes</strong> - <em>Object</em> - 荣誉节点列表。 <ul><li><strong>tcp_address</strong> - <em>String</em> - tcp地址。</li> <li><strong>api_address</strong> - <em>String</em> - api地址。</li> <li><strong>public_key</strong> - <em>String</em> - 节点公钥。</li> <li><strong>unban_time</strong> - <em>String</em> - 解锁时间。</li></ul></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"net.getNetwork","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "network_id": "1", "centrifugo_url": "127.0.0.1", "test": false, "private": false, "honor_nodes": [ { "tcp_address": "127.0.0.1:7078", "api_address": "http://127.0.0.1:7078", "public_key": "049a41b24862f8db61ee66fb206094baa57bfeac7ea786d63662a964d144eb85d1a0e230928d56f46dd61eefac7640b6aa2883b2445c7b2adc0e581f983ff0aedb", "unban_time": "-62135596800" } ] } } </code></pre></div><h3 id="net-status"><a href="#net-status" class="header-anchor">#</a> <strong>net.status</strong> </h3> <p>获取当前节点状态。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><strong>status</strong> - <em>String</em> - 节点状态。 "node server status is running" - 节点运行中。 "node server is updating" - 节点更新中。 "node server is stopped" - 节点暂停。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"net.status","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": "node server status is running" } </code></pre></div><h3 id="rpc-modules"><a href="#rpc-modules" class="header-anchor">#</a> <strong>rpc.modules</strong> </h3> <p>获取当前已注册的JSON-RPC接口。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><em>Array</em> - JSON-RPC接口数组。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"rpc.modules","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": [ "net.getNetwork", "ibax.getAppContent", "ibax.honorNodesCount", "ibax.maxBlockId", "ibax.detailedBlock", "ibax.getConfig", "ibax.getTableCount", "ibax.getMenu" ] } </code></pre></div><h3 id="admin-startjsonrpc"><a href="#admin-startjsonrpc" class="header-anchor">#</a> <strong>admin.startJsonRpc</strong> </h3> <p>可用于切换JSON-RPC更改命名空间服务。</p> <p><strong>参数</strong> <strong>methods</strong> - <em>String</em> - JSON-RPC 模块,default: "ibax,net"。</p> <p><strong>返回值</strong></p> <ul><li><em>bool</em> - 执行状态。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"admin.startJsonRpc","id":1,"params":["ibax,net,admin"]}' http://127.0.0.1:8385 //Response { "jsonrpc": "2.0", "id": 1, "result": true } </code></pre></div><h3 id="admin-stopjsonrpc"><a href="#admin-stopjsonrpc" class="header-anchor">#</a> <strong>admin.stopJsonRpc</strong> </h3> <p>关闭JSON-RPC服务。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><em>bool</em> - 执行状态。</li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"admin.stopJsonRpc","id":1,"params":[]}' http://127.0.0.1:8385 //Response { "jsonrpc": "2.0", "id": 1, "result": true } </code></pre></div><h3 id="debug-getnodebanstat"><a href="#debug-getnodebanstat" class="header-anchor">#</a> <strong>debug.getNodeBanStat</strong> </h3> <p>获取节点禁用状态。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><p><strong>node_position</strong> - <em>Number</em> - 节点下标。</p></li> <li><p><strong>status</strong> - <em>Bool</em> - 禁用状态，<code>true</code>禁令状态，<code>false</code>未禁用。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"debug.getNodeBanStat","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": [ { "node_position": 0, "status": true } ] } </code></pre></div><h3 id="debug-getmemstat"><a href="#debug-getmemstat" class="header-anchor">#</a> <strong>debug.getMemStat</strong> </h3> <p>获取当前节点内存使用情况。</p> <p><strong>参数</strong> 无</p> <p><strong>返回值</strong></p> <ul><li><p><strong>alloc</strong> - <em>Number</em> - 已申请且仍在使用的字节数。</p></li> <li><p><strong>sys</strong> - <em>Number</em> - 从系统中获取的字节数。</p></li></ul> <p><strong>示例</strong></p> <div class="language-text extra-class"><pre class="language-text"><code> //Request curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"debug.getMemStat","id":1,"params":[]}' http://127.0.0.1:7079 //Response { "jsonrpc": "2.0", "id": 1, "result": { "alloc": 11537432, "sys": 35329248 } } </code></pre></div></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/IBAX-io/documentation/edit/master/docs/zh-CN/reference/json-rpc.md" target="_blank" rel="noopener noreferrer">在 GitHub 上编辑此页</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">上次更新:</span> <span class="time">2023/7/6 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev"> ← <a href="/zh-CN/reference/desync_monitor.html" class="prev"> 同步监控工具 </a></span> </p></div> </main></div><div class="global-ui"></div></div> <script src="/assets/js/app.d049f7ab.js" defer></script><script src="/assets/js/2.8d94a0db.js" defer></script><script src="/assets/js/161.3315e863.js" defer></script> </body> </html>