JSON-RPC API </a></li><li><a href="/kr/reference/platform-parameters.html" class="sidebar-link">플랫폼 매개변수 </a></li><li><a href="/kr/reference/backend-config.html" class="sidebar-link">서버 구성 파일 </a></li><li><a href="/kr/reference/desync_monitor.html" class="sidebar-link">실시간 모니터링 도구 </a></li><li><a href="/kr/reference/json-rpc.html" aria-current="page" class="active sidebar-link">JSON-RPC API </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#client-side-implementation" class="sidebar-link">클라이언트 측 구현 </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#curl-example" class="sidebar-link">Curl 예제 </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#covenant" class="sidebar-link">계약 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#hex" class="sidebar-link">Hex </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#request-type" class="sidebar-link">요청 유형 </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#special-markers" class="sidebar-link">특수 표시{#special-markers}</a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#batch-requests" class="sidebar-link">일괄 요청 </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#error-response-handling" class="sidebar-link">오류 응답 처리{#error-response-handling}</a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/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="/kr/reference/json-rpc.html#ibax-namespace" class="sidebar-link">ibax Namespace </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#net-namespace" class="sidebar-link">net Namespace </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#rpc-namespace" class="sidebar-link">rpc Namespace </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#admin-namespace" class="sidebar-link">admin Namespace </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#debug-namespace" class="sidebar-link">debug Namespace </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/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="/kr/reference/json-rpc.html#ibax-getuid" class="sidebar-link">ibax.getUid </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-login" class="sidebar-link">ibax.login </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getauthstatus" class="sidebar-link">ibax.getAuthStatus </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getversion" class="sidebar-link">ibax.getVersion </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getbalance" class="sidebar-link">ibax.getBalance </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getblockstxinfo" class="sidebar-link">ibax.getBlocksTxInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-detailedblocks" class="sidebar-link">ibax.detailedBlocks </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getkeyinfo" class="sidebar-link">ibax.getKeyInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-detailedblock" class="sidebar-link">ibax.detailedBlock </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-maxblockid" class="sidebar-link">ibax.maxBlockId </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getkeyscount" class="sidebar-link">ibax.getKeysCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-gettxcount" class="sidebar-link">ibax.getTxCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-gettransactioncount" class="sidebar-link">ibax.getTransactionCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getblockscountbynode" class="sidebar-link">ibax.getBlocksCountByNode </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-honornodescount" class="sidebar-link">ibax.honorNodesCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getecosystemcount" class="sidebar-link">ibax.getEcosystemCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-ecosysteminfo" class="sidebar-link">ibax.ecosystemInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-appparams" class="sidebar-link">ibax.appParams </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getecosystemparams" class="sidebar-link">ibax.getEcosystemParams </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-gettablecount" class="sidebar-link">ibax.getTableCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-gettable" class="sidebar-link">ibax.getTable </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getlist" class="sidebar-link">ibax.getList </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getsections" class="sidebar-link">ibax.getSections </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getrow" class="sidebar-link">ibax.getRow </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-systemparams" class="sidebar-link">ibax.systemParams </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-history" class="sidebar-link">ibax.history </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getpagerow" class="sidebar-link">ibax.getPageRow </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getmenurow" class="sidebar-link">ibax.getMenuRow </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getsnippetrow" class="sidebar-link">ibax.getSnippetRow </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getappcontent" class="sidebar-link">ibax.getAppContent </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getmember" class="sidebar-link">ibax.getMember </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getcontracts" class="sidebar-link">ibax.getContracts </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getcontractinfo" class="sidebar-link">ibax.getContractInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-sendtx" class="sidebar-link">ibax.sendTx </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-txstatus" class="sidebar-link">ibax.txStatus </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-txinfo" class="sidebar-link">ibax.txInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-txinfomultiple" class="sidebar-link">ibax.txInfoMultiple </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getpagevalidatorscount" class="sidebar-link">ibax.getPageValidatorsCount </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getpage" class="sidebar-link">ibax.getPage </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getmenu" class="sidebar-link">ibax.getMenu </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getsource" class="sidebar-link">ibax.getSource </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getpagehash" class="sidebar-link">ibax.getPageHash </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getcontent" class="sidebar-link">ibax.getContent </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getblockinfo" class="sidebar-link">ibax.getBlockInfo </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#ibax-getconfig" class="sidebar-link">ibax.getConfig </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#net-getnetwork" class="sidebar-link">net.getNetwork </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#net-status" class="sidebar-link">net.status </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#rpc-modules" class="sidebar-link">rpc.modules </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#admin-startjsonrpc" class="sidebar-link">admin.startJsonRpc </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#admin-stopjsonrpc" class="sidebar-link">admin.stopJsonRpc </a></li><li class="sidebar-sub-header"><a href="/kr/reference/json-rpc.html#debug-getnodebanstat" class="sidebar-link">debug.getNodeBanStat </a></li><li class="sidebar-sub-header"><a href="/kr/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 API </h1> <p>IBAX 네트워크와 상호 작용하기 위해 소프트웨어 응용 프로그램은 IBAX 네트워크 노드에 연결해야 합니다.</p> <p>기존 REST API 인터페이스의 일반성과 확장성으로 인해 인터페이스가 점점 더 많아지고 클라이언트가 다양해질수록 복잡해지는 것을 인식하였습니다. 우리는 인터페이스의 통일성을 중요시하고, 구체적인 노드와 클라이언트 구현에 관계없이 모든 클라이언트가 동일한 규격을 사용할 수 있도록 보장하고자 합니다.</p> <p>JSON-RPC는 상태를 가지지 않는 가벼운 원격 프로시저 호출(RPC) 프로토콜입니다. 데이터 구조와 처리 규칙을 정의합니다. 전송과는 관련이 없으며, 이러한 개념은 동일한 프로세스 내에서 인터페이스, HTTP 또는 다양한 메시지 전달 환경을 통해 사용할 수 있습니다. 데이터 형식으로 JSON(RFC 4627)을 사용합니다.</p> <p>JSON-RPC는 대부분의 REST API 인터페이스와 호환되며, 기존의 REST API 인터페이스를 유지하면서 REST API 인터페이스를 사용하는 클라이언트는 JSON-RPC 인터페이스로 쉽게 전환할 수 있습니다. 일부 인터페이스는 다음과 같습니다:</p> <ul><li><a href="/kr/reference/api2.html#data-id-data-hash">/data/{id}/data/{hash}</a></li> <li><a href="/kr/reference/api2.html#data-table-id-column-hash">/data/{table}/id/{column}/{hash}</a></li> <li><a href="/kr/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"을 사용하여 수동으로 헤더를 설정하십시오. 이러한 예제에는 또한 URL/인터넷 프로토콜 및 포트 조합이 포함되어 있지 않으며, 이 조합은 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>16진수 인코딩</strong></p> <p>바이트 배열, 해시 또는 바이트 코드 배열을 인코딩할 때는 각 바이트마다 두 개의 16진수 숫자로 표현하는 16진수 형식을 사용합니다.</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> 특수 표시{#special-markers}</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>블록 높이 또는 블록 해시, 예시:</p> <ol><li><ul><li><em>String</em> - 블록 높이 <code>"100"</code> 또는 블록 해시 <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> - 블록 해시, 예시: <code>{"hash":"d36b8996c...c616d3043a0d02a0f59"}</code></li></ul> <p><strong>블록 높이와 블록 해시 중 하나만 선택할 수 있습니다</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> 오류 응답 처리{#error-response-handling}</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 토큰을 생성하고 **<a href="#ibax.login">login</a>**을 호출할 때 토큰을 <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> - 해시 알고리즘입니다.</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> - 16진수 계정 공개 키.</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> 토큰의 유효한 만료 시간입니다.</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> 문자열</em> - 거래 해시입니다.</p></li> <li><p><strong>contract_name</strong> - <em>String</em> - 스마트 계약 이름입니다.</p></li> <li><p><strong>params</strong> - <em>객체</em> - 스마트 계약 매개변수입니다. 스마트 계약 필드는 <a href="#ibax-getcontractinfo">ibax.getContractInfo</a>를 통해 조회할 수 있습니다.</p></li> <li><p><strong>key_id</strong> - <em>숫자</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>숫자</em> - 조회할 시작 블록 높이입니다.</p></li> <li><p><strong>count</strong> - <em>숫자</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> - 트랜잭션 생성 타임스탬프 (단위: 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> - 블록 높이 또는 블록 해시.</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> - 트랜잭션 생성 타임스탬프 (단위: 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> - 블록 높이 또는 블록 해시입니다.</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>숫자</em> - 노드 인덱스.</p></li> <li><p><strong>consensusMode</strong> - <em>숫자</em> - 합의 모드, 매개변수 (1: 창시자 관리 모드 2: DAO 거버넌스 모드).</p></li></ul> <p><strong>반환 값</strong> <em>객체</em> - 노드 인덱스 패킹 수 객체를 가져옵니다.</p> <ul><li><strong>total_count</strong> - <em>숫자</em> - 총 블록 수입니다.</li> <li><strong>partial_count</strong> - <em>숫자</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.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> - 발행량 (첫 발행량, 발행되지 않은 경우 "0").</li> <li><strong>is_withdraw</strong> - <em>Bool</em> - 소각 가능 여부 (<code>true</code>: 소각 가능, <code>false</code>: 소각 불가능).</li> <li><strong>withdraw</strong> - <em>String</em> - 소각량 (소각 불가능하거나 소각되지 않은 경우 "0").</li> <li><strong>is_emission</strong> - <em>Bool</em> - 추가 발행 가능 여부 (<code>true</code>: 추가 발행 가능, <code>false</code>: 추가 발행 불가능).</li> <li><strong>emission</strong> - <em>String</em> - 추가 발행량 (추가 발행 불가능하거나 추가 발행되지 않은 경우 "0").</li> <li><strong>introduction</strong> - <em>String</em> - 생태계 소개.</li> <li><strong>logo</strong> - <em>Number</em> - 생태계 로고 ID (Binary 테이블 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>배열</em> - 응용 프로그램 매개 변수 목록.</p> <ul><li><strong>app_id</strong> - <em>숫자</em> - 응용 프로그램 ID.</li> <li><strong>list</strong> - <em>숫자</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>숫자</em> - <a href="#omitempty">Omitempty</a> 오프셋 값으로 기본값은 0입니다.</p></li> <li><p><strong>limit</strong> - <em>숫자</em> <a href="#omitempty">Omitempty</a> 항목 수로 기본값은 25이며 최대 100개입니다.</p></li></ul> <p><strong>반환 값</strong></p> <ul><li><p><strong>count</strong> - <em>숫자</em> - 현재 생태 데이터 테이블의 총 개수입니다.</p></li> <li><p><strong>list</strong> - <em>배열</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> - *String - 새로운 열 권한.</p></li> <li><p><strong>update</strong> - *String - 항목 변경 권한.</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> - *Array - 데이터 테이블 필드 관련 정보 배열:</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>쿼리 조건, 예: id>2 및 name = john을 조회하려면 <code>where:{"id":{"$gt":2},"name":{"$eq":"john"}}</code>를 사용할 수 있습니다.</p> <p>자세한 내용은 <a href="/kr/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> - 이 필드는 다국어 리소스 코드 또는 로캘을 지정합니다. 예를 들어: <em>en, kr</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> - 찾을 열 이름 (숫자 유형 열만 찾을 수 있음).</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></p> <p><strong>반환 값</strong></p> <ul><li><p><strong>list</strong> - <em>Array</em> - 각 요소는 요청된 항목의 변경 기록을 포함합니다.</p></li> <li><p><strong>이름</strong> - *String - 데이터 테이블 이름.</p></li> <li><p><strong>tableId</strong> - <em>Number</em> - 항목 ID.</p></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>현재 생태계 시스템의 페이지 데이터 테이블 필드 항목을 가져옵니다.</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>현재 생태계 메뉴 데이터 테이블의 필드 항목을 가져옵니다.</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>현재 생태계 스니펫 데이터 테이블의 필드 항목을 가져옵니다.</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>애플리케이션 관련 정보 (페이지, 스니펫, 메뉴 포함)를 가져옵니다.</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> - 아이디.</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> - 아이디.</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> - 아이디.</li> <li><strong>name</strong> - <em>String</em> - 계약 이름. <strong>예시</strong></li></ul></li></ul> <div class="language-text extra-class"><pre class="language-text"><code> //Request //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> - 생태 아이디.</p> <p><strong>반환 값</strong></p> <ul><li><strong>id</strong> - <em>Number</em> - 멤버 아이디.</li> <li><strong>member_name</strong> - <em>String</em> - 이름.</li> <li><strong>image_id</strong> - <em>Number</em> - 프로필 사진 아이디.</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>해시</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>데이터</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> - 블록 해시입니다.</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> - 트랜잭션 해시입니다.</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> - 트랜잭션 크기 단위: 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> - *Number - 해당 거래를 포함하는 블록의 ID입니다. 값이 <code>0</code>이면 해당 해시의 거래를 찾을 수 없습니다.</li> <li><strong>confirm</strong> - <em>Number</em> - 블록 ID가 있는 블록의 확인 수입니다.</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> - 블록 해시입니다.</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> - 거래 해시입니다.</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> - 거래 크기 단위: 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> 생태계 식별자.</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 모듈, 기본값: "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/kr/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="/kr/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/114.6e2de5c9.js" defer></script> </body> </html>