IBAX 開発チュートリアル </a></li><li><a href="/ja/tutorials/tutorial.html" aria-current="page" class="active sidebar-link">IBAX 開発チュートリアル </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#getting-started-guide" class="sidebar-link">初めての利用ガイド </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#deployment" class="sidebar-link">デプロイ </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#advanced-guide" class="sidebar-link">高度なガイド </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#deploy-first-smart-contract-via-command-line-tool" class="sidebar-link">コマンドラインツールを使用して最初のスマートコントラクトをデプロイする </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#create-application" class="sidebar-link">アプリケーションの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#writing-contracts" class="sidebar-link">コントラクトの記述 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#create-contract" class="sidebar-link">コントラクトの作成 </a></li></ul></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#command-line-tool-eco-development" class="sidebar-link">コマンドラインツールのエコ開発 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-1-create-ecosystem" class="sidebar-link">ステップ 1 エコシステムの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-2-create-application" class="sidebar-link">ステップ 2 アプリケーションの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-3-create-table" class="sidebar-link">ステップ 3 テーブルの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-4-create-application-parameters" class="sidebar-link">ステップ 4 アプリケーションパラメータの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-5-create-contract-deploy-contract" class="sidebar-link">ステップ 5 コントラクトの作成コントラクトの展開 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-6-create-ecosystem-parameters" class="sidebar-link">ステップ 6 生態学的パラメータの作成 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-7-add-localization" class="sidebar-link">ステップ 7 ローカリゼーションを追加する </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#step-8-modify-the-contract" class="sidebar-link">ステップ 8 契約を変更する </a></li></ul></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#deploy-application-using-command-line-tools" class="sidebar-link">コマンドラインツールを使用したアプリケーションの展開 </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#export-application" class="sidebar-link">アプリケーションのエクスポート </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#import-application" class="sidebar-link">アプリケーションのインポート </a></li></ul></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#ecosystem-configuration-using-command-line-tool" class="sidebar-link">エコロジーの設定（コマンドラインツールを使用） </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#apply-to-join-the-ecosystem" class="sidebar-link">エコロジーへの参加を申請する </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#add-ecosystem-members" class="sidebar-link">エコロジーメンバーを追加する </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#freezing-of-accounts" class="sidebar-link">アカウントの凍結 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#role-management" class="sidebar-link">役割管理 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#issuance-of-token" class="sidebar-link">トークンの発行 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#eco-deduction" class="sidebar-link">エコ控除 </a></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#dao-governance-ecosystem" class="sidebar-link">DAO ガバナンスエコロジー </a></li></ul></li><li class="sidebar-sub-header"><a href="/ja/tutorials/tutorial.html#deploy-applications-using-application-packaging-tool" class="sidebar-link">アプリケーションパッケージングツールを使用してアプリケーションをデプロイする </a></li></ul></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="ibax-development-tutorial"><a href="#ibax-development-tutorial" class="header-anchor">#</a> IBAX 開発チュートリアル </h1> <h2 id="getting-started-guide"><a href="#getting-started-guide" class="header-anchor">#</a> 初めての利用ガイド </h2> <ul><li><a href="#deploy-first-smart-contract-via-command-line-tool">コマンドラインツールを使用して最初のスマートコントラクトをデプロイする</a></li> <li><a href="#command-line-tool-eco-development">コマンドラインツールを使用したエコ開発</a></li></ul> <h2 id="deployment"><a href="#deployment" class="header-anchor">#</a> デプロイ </h2> <ul><li><a href="#deploy-application-using-command-line-tools">コマンドラインツールを使用してアプリケーションをデプロイする</a></li> <li><a href="#ecosystem-configuration-using-command-line-tool">コマンドラインツールを使用したエコ設定</a></li></ul> <h2 id="advanced-guide"><a href="#advanced-guide" class="header-anchor">#</a> 高度なガイド </h2> <ul><li><a href="#deploy-applications-using-application-packaging-tool">アプリケーションパッケージングツールを使用してアプリケーションをデプロイする</a></li></ul> <h2 id="deploy-first-smart-contract-via-command-line-tool"><a href="#deploy-first-smart-contract-via-command-line-tool" class="header-anchor">#</a> コマンドラインツールを使用して最初のスマートコントラクトをデプロイする </h2> <p>IBAX ブロックチェーン上にスマートコントラクトをデプロイし、スマートコントラクトの呼び出し方を学ぶために、<a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">コマンドラインツール<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>を使用します。最初のスマートコントラクトとして、それを<a href="/ja/concepts/blockchain-layers.html">ローカルテストネットワーク</a>にデプロイします。ローカルネットワークのデプロイ方法については、<a href="/ja/howtos/deployment.html">ネットワークデプロイ</a>を参照してください。これにより、オーバーヘッドなしで自由にデプロイして実行できます。</p> <h3 id="create-application"><a href="#create-application" class="header-anchor">#</a> アプリケーションの作成 </h3> <p>@1NewApplication というコントラクトを呼び出して、アプリケーションを作成します。アプリケーション名のパラメータと<a href="/ja/concepts/about-the-platform.html#access-rights-control-mechanism">アクセス権制御メカニズム</a>の修正パラメータがあります。</p> <div class="language-text extra-class"><pre class="language-text"><code>1 $ ibax-cli console 2 3 Welcome to the IBAX console! 4 To exit, press ctrl-d or type exit 5 >callContract @1NewApplication {"Name": "testapp", "Conditions": "ContractConditions(\"@1DeveloperCondition\")"} 6 7 { 8 "block_id": 1217, 9 "hash": "6327161d2202c33c06d34ab4ed9b509c05fc2cbb15cf260c6d3d404a6f640028", 10 "penalty": 0, 11 "err": "31" 12 } </code></pre></div><p>以下は行ごとに説明されています：</p> <ul><li>1行目、コマンドラインターミナルを起動します。</li> <li>5行目、@1NewApplication コントラクトを呼び出して、アプリケーション名を <code>testapp</code>、アプリケーションの修正権限を <code>@1DeveloperCondition</code>（開発者権限）で作成します。</li> <li>8行目、トランザクションによって生成されたブロックIDです。</li> <li>9行目、トランザクションによって生成されたブロックハッシュです。</li> <li>10行目、トランザクションの実行が失敗した場合は (0: ペナルティなし 1: ペナルティあり) です。</li> <li>11行目、トランザクションの実行が失敗した場合はエラーテキストメッセージが返され、ブロックIDが返される場合は err フィールドがアプリケーションのIDです。</li></ul> <p>もちろん、このコントラクトで利用可能なフィールドやフィールドのタイプを確認したい場合は、<code>getContractInfo</code> メソッドを呼び出すことができます。以下はコントラクト情報の返り値です：</p> <div class="language-text extra-class"><pre class="language-text"><code>>getContractInfo @1NewApplication { "id": 5022, "state": 1, "tableid": "22", "walletid": "0", "tokenid": "1", "address": "0000-0000-0000-0000-0000", "fields": [ { "name": "Name", "type": "string", "optional": false }, { "name": "Conditions", "type": "string", "optional": false }, { "name": "VotingId", "type": "int", "optional": true } ], "name": "@1NewApplication", "app_id": 1, "ecosystem": 1, "conditions": "ContractConditions(\"@1DeveloperCondition\")" } </code></pre></div><p><code>fields</code> フィールドは、コントラクトのパラメータを含みます。パラメータの名前 <code>name</code>、<code>type</code>、<code>optional</code> が含まれています。 <code>Name</code> と <code>Conditions</code> は必須であり、<code>VotingId</code> はオプションです。<a href="/ja/reference/api2.html#contract-name">contract/name</a> API メソッドを参照してください。</p> <h3 id="writing-contracts"><a href="#writing-contracts" class="header-anchor">#</a> コントラクトの記述 </h3> <p><a href="/ja/topics/script.html#needle-contract-language">Needle</a> を使用して、以下のような簡単な足し算の操作を行うスマートコントラクトを記述します。コントラクトのソースコードは以下の通りであり、<code>SumMath.sim</code> として保存します。</p> <div class="language-text extra-class"><pre class="language-text"><code>1 contract SumMath { 2 data { 3 A int 4 B int 5 } 6 conditions { 7 8 } 9 action { 10 var sum int 11 sum = $A + $B 12 $result = sum 13 } 14 } </code></pre></div><p>以下は、行ごとに説明されています：</p> <ul><li>1行目では、SumMathという名前のコントラクトを定義しています。</li> <li>2行目では、<a href="/ja/topics/script.html#data-section">Dataセクション</a>を定義しています。</li> <li>3-4行目では、2つの入力64ビット整数型パラメータ <code>A B</code> を定義しています。</li> <li>6行目では、<a href="/ja/topics/script.html#conditions-section">Conditionalセクション</a>を定義しています。</li> <li>9行目では、<a href="/ja/topics/script.html#action-section">Operationsセクション</a>を定義しています。変数sumを定義し、A+Bの結果を受け取ります。</li></ul> <p>sumの値を$resultに代入し、コントラクトの結果として表示します。もちろん、A+Bの値を直接$resultに代入することも可能ですが、例として示すことができます。</p> <h3 id="create-contract"><a href="#create-contract" class="header-anchor">#</a> コントラクトの作成 </h3> <p>コントラクトの作成方法は2つありますが、最初の方法は以下の通りです：最初のステップでは、json形式のコントラクトパラメータファイルを作成します：</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">31</span><span class="token punctuation">,</span> <span class="token property">"Value"</span><span class="token operator">:</span> <span class="token string">"contract SumMath {\n data {\n A int\n B int\n }\n conditions {\n\n }\n action {\n var sum int\n sum = $A + $B\n $result = sum\n }\n}"</span><span class="token punctuation">,</span> <span class="token property">"Conditions"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"@1DeveloperCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>ApplicationId</code> はアプリケーション ID、<code>Value</code> はコントラクトのソースコード、特殊文字をエスケープする必要があります、<code>Conditions</code> はコントラクトの変更権限です</p> <p>SumMathParams.json という名前を付けました。</p> <p>2 番目のステップでは、コントラクトを作成する @1NewContract を呼び出します。</p> <div class="language- extra-class"><pre class="language-text"><code>1 >callContract @1NewContract -f=./data/SumMathParams.json 2 { 3 "block_id": 1238, 4 "hash": "f3fe7aff8a613c96299723b7e9af0682aa8cabe7becf67a485e2a77a974f58b6", 5 "penalty": 0, 6 "err": "328" 7 } </code></pre></div><p>2 番目の方法: 保存されたコントラクトソースファイルは、次のようにパラメータ形式 <code>paramsName</code> + <code>-</code> + "file",<code>paramsName-file</code> でコントラクトパラメータに直接渡されます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token number">1</span> <span class="token operator">></span>callContract @1NewContract <span class="token punctuation">{</span><span class="token string">"ApplicationId"</span><span class="token builtin class-name">:</span> <span class="token number">31</span>, <span class="token string">"Value-file"</span><span class="token builtin class-name">:</span> <span class="token string">"SumMath.sim"</span>, <span class="token string">"Conditions"</span><span class="token builtin class-name">:</span> <span class="token string">"true"</span><span class="token punctuation">}</span> <span class="token number">2</span> <span class="token punctuation">{</span> <span class="token number">3</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">2055</span>, <span class="token number">4</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"cdf25060669cf7cba137278...26ca463fd5d458f3402a5f0137f693db"</span>, <span class="token number">5</span> <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token number">6</span> <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"368"</span> <span class="token number">7</span> <span class="token punctuation">}</span> </code></pre></div><p>以下を行ごとに説明します。</p> <ul><li>行 1: コントラクト @1NewContract を呼び出してコントラクトを作成します。 -f はファイルを使用してコントラクトパラメーターをインポートします。</li> <li>行 3、トランザクションによって生成されたブロック ID</li> <li>行 4、トランザクションによって生成されたブロックハッシュ</li> <li>5 行目、トランザクションの実行が失敗した場合 (0: ペナルティなし 1: ペナルティ)</li> <li>6 行目、トランザクションの実行が失敗した場合、エラーテキストメッセージが返され、ブロック ID が返された場合、err フィールドはコントラクトの ID になります。</li></ul> <p>デプロイしたばかりのコントラクトを呼び出してみましょう</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token number">1</span> <span class="token operator">></span>callContract @5SumMath <span class="token punctuation">{</span><span class="token string">"A"</span>:1, <span class="token string">"B"</span>:2<span class="token punctuation">}</span> <span class="token number">2</span> <span class="token number">3</span> <span class="token punctuation">{</span> <span class="token number">4</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1239</span>, <span class="token number">5</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"7fa09da0b9f65634119a910f9d91aaf4927208278efd62961499ef7e4f4c8c9c"</span>, <span class="token number">6</span> <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token number">7</span> <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"3"</span> <span class="token number">8</span> <span class="token punctuation">}</span> </code></pre></div><p>呼び出しは完了し、以下の行ごとに説明されているように、結果は期待どおりになります。</p> <ul><li>最初の行はコントラクトを呼び出します。ここでは、エコロジー ID 5 のエコロジーにコントラクトをデプロイします。もちろん、現在のエコロジー ID が 5 の場合は、同じエコロジー内で <code>callContract SumMath {"A":1 を呼び出すこともできます。 , "B":2}</code> このように</li> <li>行 3、トランザクションによって生成されたブロック ID</li> <li>行 4、トランザクションによって生成されたブロックハッシュ</li> <li>5 行目、トランザクションの実行が失敗した場合 (0: ペナルティなし 1: ペナルティ)</li> <li>6 行目、トランザクションの実行が失敗した場合、エラーテキストメッセージが返され、ブロック ID が返された場合、err フィールドはコントラクトの結果、つまり <code>$result</code> の値になります。</li></ul> <h2 id="command-line-tool-eco-development"><a href="#command-line-tool-eco-development" class="header-anchor">#</a> コマンドラインツールのエコ開発 </h2> <p>このチュートリアルでは、次の方法を学びます。</p> <ul><li>1.<a href="#step-1-create-ecosystem">エコシステムの作成</a></li> <li>2.<a href="#step-2-create-application">アプリケーションの作成</a></li> <li>3.<a href="#step-3-create-table">テーブルの作成</a></li> <li>4.<a href="#step-4-create-application-parameters">アプリケーションパラメータの作成</a></li> <li>5.<a href="#step-5-create-contract-deploy-contract">コントラクトの作成とデプロイ</a></li> <li>6.<a href="#step-6-create-ecosystem-parameters">生態パラメータの作成</a></li> <li>7.<a href="#step-7-add-localization">ローカリゼーションを追加</a></li> <li>8.<a href="#step-8-modify-the-contract">契約変更</a></li> <li>9.<a href="#step-9-modify-data-table-permissions">データテーブル権限の変更</a></li></ul> <p>以下は、IBAXのエコロジーとアプリケーションがどのようなものであり、それらが何をするのかをより明確に理解するために、エコロジーとアプリケーションがどこに所属するべきかを理解することが好ましいです。簡単なマインドマップでより良く理解できます:</p> <p><img src="/ibax-eco.png" alt="image"></p> <p>IBAXネットワークには複数の<a href="/ja/concepts/about-the-platform.html#ecolib">エコロジー</a>が存在することがわかります。各エコロジーには複数の<a href="/ja/concepts/about-the-platform.html#applications">アプリケーション</a>が存在することができます。各アプリケーションには<a href="/ja/concepts/thesaurus.html#smart-contract">スマートコントラクト</a>が存在します。 <a href="/ja/concepts/about-the-platform.html#tables">テーブル</a>もあります。エコロジーにはエコロジーパラメータ、アプリケーションにはアプリケーションパラメータがあります。</p> <h3 id="step-1-create-ecosystem"><a href="#step-1-create-ecosystem" class="header-anchor">#</a> ステップ 1 エコシステムの作成 </h3> <p>まず、<a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">コマンドラインツール<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>を使用してエコシステムを作成します。@1NewEcosystemコントラクトを呼び出します。エコシステム名を変更したい場合は、<code>@1EditEcosystemName</code>コントラクトを呼び出すことができます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token number">1</span> $ ibax-cli console <span class="token number">2</span> <span class="token number">3</span> Welcome to the IBAX console<span class="token operator">!</span> <span class="token number">4</span> To exit, press ctrl-d or <span class="token builtin class-name">type</span> <span class="token builtin class-name">exit</span> <span class="token number">5</span> <span class="token operator">></span>callContract @1NewEcosystem <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"goodBoy school"</span><span class="token punctuation">}</span> <span class="token number">6</span> <span class="token number">7</span> <span class="token punctuation">{</span> <span class="token number">8</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1199</span>, <span class="token number">9</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"a1dc90c1772545c16394b9521...227676b27b145743556a8973dd"</span>, <span class="token number">10</span> <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token number">11</span> <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"18"</span> <span class="token number">12</span> <span class="token punctuation">}</span> </code></pre></div><p>以下の内容を行ごとに説明します：</p> <ul><li>行1: コマンドラインコンソールプログラムを起動します。</li> <li>行5: <code>@1NewEcosystem</code>コントラクトを呼び出して、テストエコシステムという名前のエコシステムを作成します。</li> <li>行8: トランザクションによって生成されたブロックIDです。</li> <li>行9: トランザクションによって生成されたブロックハッシュです。</li> <li>行10: トランザクションの実行が失敗した場合のステータスです（0: ペナルティなし 1: ペナルティあり）。</li> <li>行11: トランザクションの実行が失敗した場合、エラーテキストメッセージが返されます。ブロックIDが返された場合、エラーフィールドはエコロジーのIDとなります（18）。</li></ul> <p>次に、コマンドツールの<code>config.yml</code>を設定し、作成したエコシステムのecid（18）を<code>ecosystem</code>に設定し、コマンドラインコンソールプログラムを再起動します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>exit INFO<span class="token punctuation">[</span>0002<span class="token punctuation">]</span> Exit $ <span class="token function">vim</span> data/config.yml $ ibax-cli console Welcome to the IBAX console<span class="token operator">!</span> To exit, press ctrl-d or <span class="token builtin class-name">type</span> <span class="token builtin class-name">exit</span> <span class="token operator">></span> </code></pre></div><h3 id="step-2-create-application"><a href="#step-2-create-application" class="header-anchor">#</a> ステップ 2 アプリケーションの作成 </h3> <p><code>@1NewApplication</code>コントラクトを呼び出して、アプリケーションを作成します。このコントラクトにはアプリケーション名のパラメータと変更権限のパラメータがあります。</p> <p><a href="/ja/concepts/about-the-platform.html#access-rights-control-mechanism">Permission Parameter</a>については、アクセス権制御メカニズムのドキュメントを参照してください。</p> <div class="language-text extra-class"><pre class="language-text"><code>1 >callContract @1NewApplication {"Name": "GradesRecorder", "Conditions": "ContractConditions(\"@1DeveloperCondition\")"} 2 3 { 4 "block_id": 1246, 5 "hash": "85ab8953d26d0d1047fc610866115331babfaf88c80792d50b41826185c9f6f8", 6 "penalty": 0, 7 "err": "47" 8 } </code></pre></div><p>アプリケーションの権限を変更する必要がある場合は、<code>EditApplication</code> コントラクトを呼び出すことができます。</p> <p>以下を行ごとに説明します。</p> <ul><li>1 行目、コントラクト @1NewApplication を呼び出してアプリケーションを作成します。アプリケーション名は <code>GradesRecorder</code>、アプリケーションの変更権限は開発者権限 <code>@1DeveloperCondition</code> です。</li> <li>行 4、トランザクションによって生成されたブロック ID</li> <li>行 5、トランザクションによって生成されたブロックハッシュ</li> <li>6 行目、トランザクションの実行が失敗した場合 (0: ペナルティなし 1: ペナルティ)</li> <li>7 行目、トランザクションの実行が失敗した場合はエラーテキストメッセージが返され、ブロック ID が返された場合は、アプリケーションの ID である err フィールドは <code>47</code> になります。</li></ul> <p>学生の成績を記録するアプリケーションのシンプルな例を書いてみましょう。データテーブルのフィールドには、学生情報、成績（<code>grade</code>）、クラス（<code>class</code>）、科目の成績（<code>mathematics</code>、<code>physics</code>、<code>literature</code>）、総合スコア（<code>overall_score</code>）、評価（<code>score</code>）、作成タイムスタンプ（ミリ秒）（<code>created_at</code>）が含まれます。</p> <h3 id="step-3-create-table"><a href="#step-3-create-table" class="header-anchor">#</a> ステップ 3 テーブルの作成 </h3> <p>最初のステップでは、コントラクトパラメータファイルを json 形式で作成します。</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">47</span><span class="token punctuation">,</span> <span class="token property">"Name"</span><span class="token operator">:</span> <span class="token string">"grade_info"</span><span class="token punctuation">,</span> <span class="token property">"ColumnsArr"</span><span class="token operator">:</span> <span class="token punctuation">[</span> <span class="token string">"student"</span><span class="token punctuation">,</span> <span class="token string">"grade"</span><span class="token punctuation">,</span> <span class="token string">"class"</span><span class="token punctuation">,</span> <span class="token string">"mathematics"</span><span class="token punctuation">,</span> <span class="token string">"physics"</span><span class="token punctuation">,</span> <span class="token string">"literature"</span><span class="token punctuation">,</span> <span class="token string">"overall_score"</span><span class="token punctuation">,</span> <span class="token string">"score"</span><span class="token punctuation">,</span> <span class="token string">"created_at"</span> <span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token property">"TypesArr"</span><span class="token operator">:</span> <span class="token punctuation">[</span> <span class="token string">"varchar"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"varchar"</span><span class="token punctuation">,</span> <span class="token string">"number"</span> <span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token property">"InsertPerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span><span class="token punctuation">,</span> <span class="token property">"UpdatePerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span><span class="token punctuation">,</span> <span class="token property">"ReadPerm"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"NewColumnPerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>ApplicationId</code> はアプリケーション ID、<code>Name</code> は作成されたデータテーブル <code>test_teble</code> の名前です。 <code>ColumnsArr</code> はデータテーブルフィールドの配列であり、<code>TypesArr</code> は 9 つの <a href="/ja/concepts/about-the-platform.html#tables">タイプ</a> を含むデータテーブルフィールドのタイプです。 <code>varchar</code>,<code>character</code>,<code>json</code>,<code>number</code>,<code>datetime</code>,<code>double</code>,<code>money</code>,<code>text</code>,<code>bytea</code>、フィールド名とフィールド型は 1 対 1 に対応します。データテーブルの新規エントリ権限の場合は <code>InsertPerm</code>、データテーブルの更新エントリ権限の場合は <code>UpdatePerm</code>、データテーブルのデータ読み取り権限の場合は <code>ReadPerm</code>、データテーブルの新規フィールド権限の場合は <code>NewColumnPerm</code> <a href="/ja/concepts/about-the-platform.html#access-rights-control-mechanism">Permission Control</a> を参照すると、現在のエコシステム作成者はここで「ContractConditions("MainCondition")」を利用できます。</p> <p>これに createTable.json という名前を付け、データテーブル <code>@1NewTableJoint</code> を作成するコントラクトを呼び出します</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @1NewTableJoint -f ./createTestTable.json </code></pre></div><h4 id="modify-data-table-field-permissions"><a href="#modify-data-table-field-permissions" class="header-anchor">#</a> データテーブルフィールドの権限を変更する </h4> <p>データテーブルフィールドの権限を変更できます。データテーブルフィールドの権限には、読み取り権限と更新権限が含まれます。読み取り権限には、 <code>DBFind.Columns</code> フィルターフィールドまたは <a href="/ja/reference/api2.html#list-name-limit-offset-columns">list</a> クエリなどのインターフェイスを使用するコントラクト内で、権限がない場合は、権限エラーが報告されます。更新権限は、データテーブルのフィールドを更新する権限です。ここでは<code>student</code>フィールドの読み取りおよび更新権限を「false」に設定していますが、もちろん、何らかの契約によって操作可能に設定することもできます。 <code>@1EditColumn</code> コントラクトを呼び出して、データテーブルのフィールド権限を変更します</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditColumn <span class="token punctuation">{</span><span class="token string">"TableName"</span><span class="token builtin class-name">:</span> <span class="token string">"grade_info"</span>, <span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"student"</span>, <span class="token string">"UpdatePerm"</span><span class="token builtin class-name">:</span> <span class="token string">"false"</span>, <span class="token string">"ReadPerm"</span><span class="token builtin class-name">:</span> <span class="token string">"false"</span><span class="token punctuation">}</span> </code></pre></div><p>いくつかのアプリケーションパラメータ<code>grade_best_type</code>、<code>grade_type_a+</code>、<code>grade_type_a</code>、<code>grade_type_b+</code>、<code>grade_type_b</code>、<code>grade_type_c</code>、グレード評価タイプを作成できます。</p> <h3 id="step-4-create-application-parameters"><a href="#step-4-create-application-parameters" class="header-anchor">#</a> ステップ 4 アプリケーションパラメータの作成 </h3> <p>コントラクト <code>@1NewAppParam</code> を呼び出してアプリケーションパラメータを作成します。アプリケーションパラメータを変更したい場合は、コントラクト <code>@1EditAppParam</code> を呼び出すことができます。</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_best_type", "Value": "A+", "Conditions": "ContractConditions(\"MainCondition\")"} >callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_type_a+", "Value": "{\"max\": 101,\"min\": 90}", "Conditions": "ContractConditions(\"MainCondition\")"} >callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_type_a", "Value": "{\"max\": 90,\"min\": 80}", "Conditions": "ContractConditions(\"MainCondition\")"} >callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_type_b+", "Value": "{\"max\": 80,\"min\": 70}", "Conditions": "ContractConditions(\"MainCondition\")"} >callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_type_b", "Value": "{\"max\": 70,\"min\": 60}", "Conditions": "ContractConditions(\"MainCondition\")"} >callContract @1NewAppParam {"ApplicationId": 47, "Name": "grade_type_c", "Value": "{\"max\": 60,\"min\": 0}", "Conditions": "ContractConditions(\"MainCondition\")"} </code></pre></div><p><code>grade_best_type</code>は最高の評価タイプです。 <code>grade_type_a+</code>は<code>A+</code>の評価でトリガーされる条件で、スコアが90以上101未満の場合、評価は<code>A+</code>となります。他のパラメータも同様です。</p> <h3 id="step-5-create-contract-deploy-contract"><a href="#step-5-create-contract-deploy-contract" class="header-anchor">#</a> ステップ 5 コントラクトの作成コントラクトの展開 </h3> <p>学生の成績情報と各教科の最終評価を記録するための契約を作成し、情報を入力する際には学生の成績クラスと成績を各教科ごとに入力します。各教科の入力スコアに基づいて平均計算を行い、総合スコア<code>overallScore</code>と最終評価<code>score</code>を取得します。契約が呼び出されると、私たちが作成したデータテーブル<code>grade_info</code>にレコードが作成されます。</p> <p>まず、契約を作成し、<code>NewRecord.sim</code>という名前を付けます。</p> <div class="language-text extra-class"><pre class="language-text"><code>1 contract NewRecord { 2 data { 3 Student string 4 Grade int 5 Class int 6 Mathematics int 7 Physics int 8 Literature int 9 } 10 func getScore(a b c int) map{ 11 var m map 12 var overallScore int 13 overallScore = (a+b+c) / 3 14 m["overallScore"] = overallScore 15 if overallScore >= $gradeTypeABest["min"] && overallScore < $gradeTypeABest["max"] { 16 m["score"] = "A+" 17 }elif overallScore >= $gradeTypeA["min"] && overallScore < $gradeTypeA["max"] { 18 m["score"] = "A" 19 }elif overallScore >= $gradeTypeBBest["min"] && overallScore < $gradeTypeBBest["max"] { 20 m["score"] = "B+" 21 }elif overallScore >= $gradeTypeB["min"] && overallScore < $gradeTypeB["max"] { 22 m["score"] = "B" 23 }elif overallScore >= $gradeTypeC["min"] && overallScore < $gradeTypeC["max"]{ 24 m["score"] = "C" 25 }else{ 26 m["score"] = "Notset" 27 } 28 return m 29 } 30 func safeJsonDecode(m string) map { 31 var res map 32 if Size(m) > 0 { 33 res = JSONDecode(m) 34 } 35 return res 36 } 37 38 conditions { 39 if Size($Student) == 0 { 40 warning "Student Can not be empty" 41 } 42 if $Class <= 0{ 43 warning "Class cannot be less than or equal to zero" 44 } 45 if $Grade <= 0{ 46 warning "Grade cannot be less than or equal to zero" 47 } 48 if $Mathematics < 0 { 49 warning "Mathematics cannot be less than zero" 50 } 51 if $Physics < 0 { 52 warning "Physics cannot be less than zero" 53 } 54 if $Literature < 0 { 55 warning "Literature cannot be less than zero" 56 } 57 if $Mathematics > 100 || $Physics > 100 || $Literature > 100{ 58 warning "Score cannot exceed 100" 59 } 60 var app map 61 app = DBFind("@1applications").Columns("id,ecosystem").Where({"ecosystem": 18,"name":"GradesRecorder","deleted":0}).Row() 62 if !app { 63 warning LangRes("@1app_not_found") 64 } 65 66 var app_id int 67 app_id = Int(app["id"]) 68 $eId = Int(app["ecosystem"]) 69 $gradeBestType = AppParam(app_id, "grade_best_type", $eId) 70 $gradeTypeABest = safeJsonDecode(AppParam(app_id, "grade_type_a+", $eId)) 71 $gradeTypeA = safeJsonDecode(AppParam(app_id, "grade_type_a", $eId)) 72 $gradeTypeBBest = safeJsonDecode(AppParam(app_id, "grade_type_b+", $eId)) 73 $gradeTypeB = safeJsonDecode(AppParam(app_id, "grade_type_b", $eId)) 74 $gradeTypeC = safeJsonDecode(AppParam(app_id, "grade_type_c", $eId)) 75 } 76 action { 77 var m map 78 m = getScore($Mathematics,$Physics,$Literature) 79 var in map 80 in["student"] = $Student 81 in["class"] = $Class 82 in["grade"] = $Grade 83 in["mathematics"] = $Mathematics 84 in["physics"] = $Physics 85 in["literature"] = $Literature 86 in["overall_score"] = m["overallScore"] 87 in["score"] = m["score"] 88 in["created_at"] = $time 89 DBInsert("@"+ Str($eId)+"grade_info", in) 90 } 91 } </code></pre></div><p>以下は各行の説明です：</p> <ul><li>2行目は、<a href="/ja/topics/script.html#data-section">データセクション</a>で、入力パラメータ<code>Student</code>（学生の名前）、<code>Grade</code>（成績）、<code>Class</code>（クラス）、<code>Mathematics</code>（数学の得点）、<code>Physics</code>（物理の得点）、<code>Literature</code>（文学の得点）を定義しています。</li> <li>10行目は、各教科の得点に基づいて総合スコアと最終評価を算出する<code>getScore</code>関数です。</li> <li>30行目は、文字列をJSONデコードしてマップに変換する<code>safeJsonDecode</code>関数です。</li> <li>38行目は、<a href="/ja/topics/script.html#conditions-section">条件セクション</a>です。</li> <li>39行目は、<a href="/ja/topics/script.html#action-section">操作セクション</a>です。</li></ul> <p>契約が呼び出されると、まず条件部分を実行し、契約の入力パラメータが有効かどうかを検証します。たとえば、学生の名前<code>if Size($Student) == 0 {</code>が空であるかどうかを検証し、空である場合はエラーメッセージ<code>"Student Can not be empty"</code>を返します（30行目）。すべての入力パラメータが検証された後、61行目で<a href="/ja/topics/script.html#dbfind">DBFind</a>を使用して、ecid <code>18</code>およびアプリケーション名<code>GradesRecorder</code>を持つアプリケーションのデータベースから情報を取得し、<code>deleted=0</code>で削除されていないアプリケーション情報を取得します。 69行目から74行目では、<a href="/ja/topics/script.html#appparam">AppParam</a>を使用してアプリケーションパラメータを取得します。たとえば、<code>$gradeBestType = AppParam(app_id, "grade_best_type", $eId)</code>（69行目）です。アプリケーションパラメータがJSON形式で格納されている場合は、<code>grade_type_a</code>などのように、<code>safeJsonDecode(AppParam(app_id, "grade_type_a+", $eId))</code>を参照して、safeJsonDecode関数でアプリケーションパラメータをマップ形式に変換できます。</p> <p>その後、操作部分に進み、getScore関数を呼び出して総合スコアと最終評価を取得します（10行目）。結果をマップに保存し、79行目で学生の成績情報を保存するためのマップを定義し、<a href="/ja/topics/script.html#dbinsert">DBInsert</a>を使用してデータをデータテーブル<code>@18grade_info</code>に挿入します。</p> <p>契約を作成する方法は2つありますが、最初の方法は次のとおりです。まず、JSON形式の契約パラメータファイルを作成します：</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">47</span><span class="token punctuation">,</span> <span class="token property">"Value"</span><span class="token operator">:</span> <span class="token string">"contract NewRecord {\n data {\n Student string\n Grade int\n Class int\n Mathematics int\n Physics int\n Literature int\n }\n func getScore(a b c int) map{\n var m map\n var overallScore int\n overallScore = (a+b+c) / 3\n m[\"overallScore\"] = overallScore\n if overallScore >= $gradeTypeABest[\"min\"] && overallScore < $gradeTypeABest[\"max\"] {\n m[\"score\"] = \"A+\"\n }elif overallScore >= $gradeTypeA[\"min\"] && overallScore < $gradeTypeA[\"max\"] {\n m[\"score\"] = \"A\"\n }elif overallScore >= $gradeTypeBBest[\"min\"] && overallScore < $gradeTypeBBest[\"max\"] {\n m[\"score\"] = \"B+\"\n }elif overallScore >= $gradeTypeB[\"min\"] && overallScore < $gradeTypeB[\"max\"] {\n m[\"score\"] = \"B\"\n }elif overallScore >= $gradeTypeC[\"min\"] && overallScore < $gradeTypeC[\"max\"]{\n m[\"score\"] = \"C\"\n }else{\n m[\"score\"] = \"Notset\"\n }\n return m\n }\n func safeJsonDecode(m string) map {\n var res map\n if Size(m) > 0 {\n res = JSONDecode(m)\n }\n return res\n }\n\n conditions {\n if Size($Student) == 0 {\n warning \"Student Can not be empty\"\n }\n if $Class <= 0{\n warning \"Class cannot be less than or equal to zero\"\n }\n if $Grade <= 0{\n warning \"Grade cannot be less than or equal to zero\"\n }\n if $Mathematics < 0 {\n warning \"Mathematics cannot be less than zero\"\n }\n if $Physics < 0 {\n warning \"Physics cannot be less than zero\"\n }\n if $Literature < 0 {\n warning \"Literature cannot be less than zero\"\n }\n if $Mathematics > 100 || $Physics > 100 || $Literature > 100{\n warning \"Score cannot exceed 100\"\n }\n var app map\n app = DBFind(\"@1applications\").Columns(\"id,ecosystem\").Where({\"ecosystem\": 18,\"name\":\"GradesRecorder\",\"deleted\":0}).Row()\n if !app {\n warning LangRes(\"@1app_not_found\")\n }\n\n var app_id int\n app_id = Int(app[\"id\"])\n $eId = Int(app[\"ecosystem\"])\n $gradeBestType = AppParam(app_id, \"grade_best_type\", $eId)\n $gradeTypeABest = safeJsonDecode(AppParam(app_id, \"grade_type_a+\", $eId))\n $gradeTypeA = safeJsonDecode(AppParam(app_id, \"grade_type_a\", $eId))\n $gradeTypeBBest = safeJsonDecode(AppParam(app_id, \"grade_type_b+\", $eId))\n $gradeTypeB = safeJsonDecode(AppParam(app_id, \"grade_type_b\", $eId))\n $gradeTypeC = safeJsonDecode(AppParam(app_id, \"grade_type_c\", $eId))\n }\n action {\n var m map \n m = getScore($Mathematics,$Physics,$Literature)\n var in map\n in[\"student\"] = $Student\n in[\"class\"] = $Class\n in[\"grade\"] = $Grade\n in[\"mathematics\"] = $Mathematics\n in[\"physics\"] = $Physics \n in[\"literature\"] = $Literature \n in[\"overall_score\"] = m[\"overallScore\"]\n in[\"score\"] = m[\"score\"]\n in[\"created_at\"] = $time\n DBInsert(\"@\"+ Str($eId)+\"grade_info\", in)\n }\n}"</span><span class="token punctuation">,</span> <span class="token property">"Conditions"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"@1DeveloperCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>ApplicationId</code> はアプリケーション ID であり、特殊文字を使用するにはエスケープする必要があります。また、<code>Conditions</code> はコントラクト変更権限です。 <code>Value</code>コントラクトのソースコード。<code>NewRecordParams.json</code>として保存します。</p> <p>コントラクトを作成した後、CreateContract<code>@1NewContract</code> を呼び出してコントラクトをデプロイする必要があります。</p> <div class="language-text extra-class"><pre class="language-text"><code>1 >>callContract @1NewContract -f=./data/NewRecordParams.json 2 { 3 "block_id": 1262, 4 "hash": "d896f12f685835f6cf71705e1ba...4d8bcc0a1406f7b0b6482b2d230fc", 5 "penalty": 0, 6 "err": "348" 7 } </code></pre></div><p>以下は、行ごとに説明します：</p> <ul><li>1行目：契約を作成するために<code>@1NewContract</code>契約を呼び出します。-fオプションは、契約パラメータとして作成したファイル<code>NewRecord.json</code>をインポートするために使用されます。</li> <li>3行目：トランザクションによって生成されたブロックID</li> <li>4行目：トランザクションによって生成されたブロックハッシュ</li> <li>5行目：トランザクションの実行が失敗した場合（0：ペナルティなし 1：ペナルティあり）</li> <li>6行目：トランザクションの実行が失敗した場合、エラーテキストメッセージが返され、ブロックIDが返された場合、エラーフィールドに契約のIDが示されます（348）</li></ul> <p>2番目の方法：保存された契約のソースファイルを、パラメータ形式の<code>paramsName</code> + <code>-</code> + "file"で直接契約のパラメータとして渡します。<code>paramsName-file</code>は次のようになります：</p> <div class="language-shell extra-class"><pre class="language-shell"><code>callContract @1NewContract <span class="token punctuation">{</span><span class="token string">"ApplicationId"</span><span class="token builtin class-name">:</span> <span class="token number">47</span>, <span class="token string">"Value-file"</span><span class="token builtin class-name">:</span> <span class="token string">"NewRecord.sim"</span>, <span class="token string">"Conditions"</span><span class="token builtin class-name">:</span> <span class="token string">"ContractConditions(<span class="token entity" title="\"">\"</span>@1DeveloperCondition\ "</span><span class="token punctuation">)</span>"<span class="token punctuation">}</span> </code></pre></div><p>先ほど作成したコントラクトを呼び出してみましょう</p> <div class="language-text extra-class"><pre class="language-text"><code>1 >callContract @18NewRecord {"Student": "tom", "Grade": 1, "Class": 1, "Mathematics": 18, "Physics": 57, "Literature": 93} 2 3 { 4 "block_id": 1263, 5 "hash": "1b964a47fe6c5fd43ea55a752d01edb5ad576432fd6f63315344d87999a0473d", 6 "penalty": 0, 7 "err": "" 8 } </code></pre></div><p>呼び出しが完了したら、データテーブルにレコードが保存されているかどうかを確認します。</p> <div class="language-text extra-class"><pre class="language-text"><code>>getList @18grade_info { "count": 1, "list": [ { "class": "1", "created_at": "1683698914109", "grade": "1", "id": "9", "literature": "93", "mathematics": "18", "overall_score": "56", "physics": "57", "score": "C", "student": "tom" } ] } </code></pre></div><p>データテーブルには、総合評価 56、グレード C の「student」トムというレコードがすでに存在していることがわかります。</p> <p>上記の例は調査研究のみを目的としており、データテーブルの書き込み権限や契約変更権限など、実際の状況に応じて関連パラメータを変更する必要があります。</p> <p>たとえば、この新しいレコードコントラクトを 1 人だけが呼び出すことができ、他の人は呼び出せないように指定したい場合は、エコロジカルパラメータ <code>new_record_account</code> を設定できます。</p> <h3 id="step-6-create-ecosystem-parameters"><a href="#step-6-create-ecosystem-parameters" class="header-anchor">#</a> ステップ 6 生態学的パラメータの作成 </h3> <p>コントラクト <code>@1NewParameter</code> を呼び出すと、エコパラメータが作成されます <code>@1parameters</code> テーブルの <code>new_record_account</code> で、エコパラメータを変更する必要がある場合は、<code>@1EditParameter</code> を呼び出します。</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @1NewParameter {"Name": "new_record_account", "Value": "6667782293976713160", "Conditions": "ContractConditions(\"MainCondition\")"} { "block_id": 1416, "hash": "12fc87ce6a70e2fc993ab9ffe623311f1c50edd1157595ce6183c38c93960cae", "penalty": 0, "err": "273" } </code></pre></div><p>エコロジカルパラメータ <code>new_record_account</code> を作成し、値を keyId <code>6667782293976713160</code> に設定し、権限を <code>ContractConditions("MainCondition")</code> に変更します。これは、現在のエコロジカル作成者が変更できることを意味します。トランザクションが正常に実行された場合、「err」フィールドの生態パラメータ ID は「273」になります。</p> <h3 id="step-7-add-localization"><a href="#step-7-add-localization" class="header-anchor">#</a> ステップ 7 ローカリゼーションを追加する </h3> <p><code>@1NewLangJoint</code> コントラクトを呼び出してローカリゼーションパラメーター<code>account_not_access</code> を作成すると、<code>@1langages</code> テーブルにパラメーターが作成され、<code>@1EditLangJoint</code> を介してローカリゼーションパラメーターを変更できます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code>callContract @1NewLangJoint <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"account_not_access"</span>, <span class="token string">"LocaleArr"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span><span class="token string">"en"</span>, <span class="token string">"ja"</span><span class="token punctuation">]</span>, <span class="token string">"ValueArr"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span><span class="token string">"Sorry, you do not have access to this action"</span>, <span class="token string">"申し訳ありませんが、このアクションにアクセスする権限がありません"</span><span class="token punctuation">]</span><span class="token punctuation">}</span> </code></pre></div><h3 id="step-8-modify-the-contract"><a href="#step-8-modify-the-contract" class="header-anchor">#</a> ステップ 8 契約を変更する </h3> <p>次に、次のコードを <code>conditions</code> に追加して、コントラクトソースコードの <code>conditions</code> セクションを変更する必要があります。</p> <div class="language-text extra-class"><pre class="language-text"><code>conditions { if EcosysParam("new_record_account") != $key_id { warning LangRes("account_not_access") } } </code></pre></div><p>コントラクト @1EditContract を変更するために呼び出します。<code>Id</code> はコントラクト ID、<code>Value</code>: はコントラクトのソースコードです。</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @1EditContract {"Id": 348, "Value": "contract NewRecord {\n data {\n Student string\n Grade int\n Class int\n Mathematics int\n Physics int\n Literature int\n }\n func getScore(a b c int) map{\n var m map\n var overallScore int\n overallScore = (a+b+c) / 3\n m[\"overallScore\"] = overallScore\n if overallScore >= $gradeTypeABest[\"min\"] && overallScore < $gradeTypeABest[\"max\"] {\n m[\"score\"] = \"A+\"\n }elif overallScore >= $gradeTypeA[\"min\"] && overallScore < $gradeTypeA[\"max\"] {\n m[\"score\"] = \"A\"\n }elif overallScore >= $gradeTypeBBest[\"min\"] && overallScore < $gradeTypeBBest[\"max\"] {\n m[\"score\"] = \"B+\"\n }elif overallScore >= $gradeTypeB[\"min\"] && overallScore < $gradeTypeB[\"max\"] {\n m[\"score\"] = \"B\"\n }elif overallScore >= $gradeTypeC[\"min\"] && overallScore < $gradeTypeC[\"max\"]{\n m[\"score\"] = \"C\"\n }else{\n m[\"score\"] = \"Notset\"\n }\n return m\n }\n func safeJsonDecode(m string) map {\n var res map\n if Size(m) > 0 {\n res = JSONDecode(m)\n }\n return res\n }\n\n conditions {\n if EcosysParam(\"new_record_account\") != $key_id {\n warning LangRes(\"account_not_access\")\n }\n if Size($Student) == 0 {\n warning \"Student Can not be empty\"\n }\n if $Class <= 0{\n warning \"Class cannot be less than or equal to zero\"\n }\n if $Grade <= 0{\n warning \"Grade cannot be less than or equal to zero\"\n }\n if $Mathematics < 0 {\n warning \"Mathematics cannot be less than zero\"\n }\n if $Physics < 0 {\n warning \"Physics cannot be less than zero\"\n }\n if $Literature < 0 {\n warning \"Literature cannot be less than zero\"\n }\n if $Mathematics > 100 || $Physics > 100 || $Literature > 100{\n warning \"Score cannot exceed 100\"\n }\n var app map\n app = DBFind(\"@1applications\").Columns(\"id,ecosystem\").Where({\"ecosystem\": 18,\"name\":\"GradesRecorder\",\"deleted\":0}).Row()\n if !app {\n warning LangRes(\"@1app_not_found\")\n }\n\n var app_id int\n app_id = Int(app[\"id\"])\n $eId = Int(app[\"ecosystem\"])\n $gradeBestType = AppParam(app_id, \"grade_best_type\", $eId)\n $gradeTypeABest = safeJsonDecode(AppParam(app_id, \"grade_type_a+\", $eId))\n $gradeTypeA = safeJsonDecode(AppParam(app_id, \"grade_type_a\", $eId))\n $gradeTypeBBest = safeJsonDecode(AppParam(app_id, \"grade_type_b+\", $eId))\n $gradeTypeB = safeJsonDecode(AppParam(app_id, \"grade_type_b\", $eId))\n $gradeTypeC = safeJsonDecode(AppParam(app_id, \"grade_type_c\", $eId))\n }\n action {\n var m map \n m = getScore($Mathematics,$Physics,$Literature)\n var in map\n in[\"student\"] = $Student\n in[\"class\"] = $Class\n in[\"grade\"] = $Grade\n in[\"mathematics\"] = $Mathematics\n in[\"physics\"] = $Physics \n in[\"literature\"] = $Literature \n in[\"overall_score\"] = m[\"overallScore\"]\n in[\"score\"] = m[\"score\"]\n in[\"created_at\"] = $time\n DBInsert(\"@\"+ Str($eId)+\"grade_info\", in)\n }\n}"} </code></pre></div><h4 id="step-9-modify-data-table-permissions"><a href="#step-9-modify-data-table-permissions" class="header-anchor">#</a> ステップ 9 データテーブルの権限を変更する </h4> <p>ここでは、データテーブルの挿入権限、ecreator の元の権限 <code>ContractConditions("MainCondition")</code>、および ecreator ではないコントラクト設定 <code>new_record_account</code> を変更する必要があります。したがって、<code>ContractConditions("MainCondition")</code> を変更して、コントラクトが <code>ContractAccess("@18NewRecord")</code> で操作できるように指定するだけです。データテーブルのアクセス許可を変更するには、コントラクト <code>@1EditTable</code> を呼び出します。</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @1EditTable {"Name": "@18grade_info", "InsertPerm": "ContractAccess(\"@18NewRecord\")", "UpdatePerm": "ContractConditions(\"MainCondition\")", "ReadPerm": "true", "NewColumnPerm": "ContractConditions(\"MainCondition\")"} </code></pre></div><p>次に、変更したばかりのコントラクトを呼び出し、新しいレコードを作成します</p> <div class="language-text extra-class"><pre class="language-text"><code>1 >callContract @18NewRecord {"Student": "tom", "Grade": 1, "Class": 1, "Mathematics": 18, "Physics": 57, "Literature": 93} 2 3 { 4 "block_id": 1435, 5 "hash": "7d4b06d3738133f9c2ec775935478cd2d6c20fd04eca275769afd0f8e6a4f687", 6 "penalty": 1, 7 "err": "{\"type\":\"warning\",\"error\":\"Sorry, you do not have access to this action\"}" 8 } </code></pre></div><p>先ほど設定したローカリゼーションパラメータ<code>account_not_access</code>が機能していることがわかります。</p> <p>権限エラーが報告され、現在のユーザーには操作権限がないことがわかりました。keyId <code>6667782293976713160</code> のアカウントに切り替えます。コマンドラインツール <code>アカウント情報</code> を使用して現在のユーザーの情報を取得できます。コマンドラインツール config.yml を設定し、keyId <code>6667782293976713160</code> のアカウントに切り替えます。設定完了後、再度契約を呼び出します</p> <div class="language-text extra-class"><pre class="language-text"><code>>callContract @18NewRecord {"Student": "tini", "Grade": 1, "Class": 3, "Mathematics": 69, "Physics": 89, "Literature": 98} { "block_id": 1436, "hash": "93327dafb7bae9f9f66718eb87020a7bca4c00060f4bd0a243b49eea304c52e6", "penalty": 0, "err": "" } </code></pre></div><p>T呼び出しは完了し、<code>getList @18grade_info</code> を介してデータテーブルをクエリし、結果は期待通りです。</p> <p>この記事がIBAXネットワークの動作や明確で安全な<code>Needle</code>コードの書き方についての理解に役立つことを願っています。</p> <h2 id="deploy-application-using-command-line-tools"><a href="#deploy-application-using-command-line-tools" class="header-anchor">#</a> コマンドラインツールを使用したアプリケーションの展開 </h2> <p>このチュートリアルでは、以下の手順を学びます：</p> <ul><li><ol><li><a href="#export-application">アプリケーションのエクスポート</a></li></ol></li> <li><ol start="2"><li><a href="#import-application">アプリケーションのインポート</a></li></ol></li></ul> <p>このチュートリアルを始める前に、独自のアプリケーションを持っていてエコロジーとアプリケーションの概念を理解している必要があります。<a href="#getting-started-guide">はじめにガイド</a>を参照してください。 <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">コマンドラインツール<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> を使用してIBAXブロックチェーンにアプリケーションをインポートします。Export Application</p> <h3 id="export-application"><a href="#export-application" class="header-anchor">#</a> アプリケーションのエクスポート </h3> <p>現在のアカウント情報をクエリするために <code>account info</code> を呼び出します。ここでログインしているエコロジーIDは <code>9</code> です。現在のエコロジーIDでアプリケーションをクエリするために <code>getList</code> コマンドを呼び出します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ibax-cli console Welcome to the IBAX console<span class="token operator">!</span> To exit, press ctrl-d or <span class="token builtin class-name">type</span> <span class="token builtin class-name">exit</span> <span class="token operator">></span>account info <span class="token punctuation">{</span> <span class="token string">"public_key"</span><span class="token builtin class-name">:</span> <span class="token string">"04d11ea197fe23152562c6f54c4...889c074dfd9080099982d8b2d4d100315e1cebc7"</span>, <span class="token string">"ecosystem_id"</span><span class="token builtin class-name">:</span> <span class="token number">9</span>, <span class="token string">"key_id"</span><span class="token builtin class-name">:</span> <span class="token number">6660819</span><span class="token punctuation">..</span>.78795186, <span class="token string">"account"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-0819-...-7879-5186"</span> <span class="token punctuation">}</span> <span class="token operator">></span>getList @1applications <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">9</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">6</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"conditions"</span><span class="token builtin class-name">:</span> <span class="token string">"true"</span>, <span class="token string">"deleted"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token string">"9"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"36"</span>, <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"testapp"</span>, <span class="token string">"uuid"</span><span class="token builtin class-name">:</span> <span class="token string">"00000000-0000-0000-0000-000000000000"</span> <span class="token punctuation">}</span> <span class="token punctuation">..</span>. <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>現在のエコロジーには 6 つのアプリケーションがあることがわかります。<code>export</code>コマンドを使用して、<code>id</code>が<code>36</code>のアプリケーションをエクスポートします。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>export <span class="token number">36</span> <span class="token parameter variable">-f</span><span class="token operator">=</span>./data.json <span class="token punctuation">{</span> <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"./data.json"</span>, <span class="token string">"type"</span><span class="token builtin class-name">:</span> <span class="token string">"application/json"</span>, <span class="token string">"value"</span><span class="token builtin class-name">:</span> <span class="token string">""</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで -f パラメータを指定すると、エクスポートされたアプリケーションが現在のディレクトリの <code>data.json</code> ファイルに保存されます。 -f パラメータがない場合、アプリケーションデータはコマンドターミナルに出力されます。</p> <p><code>export</code>コマンドは、アプリケーションをエクスポートする手順をカプセル化します。上記のコマンドを使用してアプリケーションをエクスポートすることも、次の手順を使用することもできます。新しいアプリケーションをエクスポートするためにコントラクト <code>@1ExportNewApp</code> を呼び出すと、エクスポートされたアプリケーションのレコードが <code>1_buffer_data</code> テーブルに生成されます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1ExportNewApp <span class="token punctuation">{</span><span class="token string">"ApplicationId"</span><span class="token builtin class-name">:</span> <span class="token number">36</span><span class="token punctuation">}</span> </code></pre></div><p>コントラクト <code>@1Export</code> を呼び出してアプリケーションをエクスポートし、選択したアプリケーションを <code>1_buffer_data</code> テーブルで見つけて、すべてのアプリケーションリソースを生成された JSON 文字列にエクスポートします。生成された JSON 文字列は、現在のエコシステムの「1_binaries」テーブルに書き込まれます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1Export </code></pre></div><p><code>getList</code> コマンドを使用して、<code>1_binaries</code> テーブル内のデータをクエリします。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1binaries <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"export"</span>, <span class="token string">"account"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-0819-...-7879-5186"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">9</span>, <span class="token string">"app_id"</span><span class="token builtin class-name">:</span> <span class="token number">36</span><span class="token punctuation">}</span> <span class="token parameter variable">-l</span><span class="token operator">=</span><span class="token number">1</span> <span class="token parameter variable">-c</span><span class="token operator">=</span><span class="token string">"id,hash"</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"8542cb57b77e0ae2c...92c3e05dbbe35ab646789be5b8ba8"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"14"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>バイナリIDとハッシュを取得する <code>binaryVerify</code> コマンドを呼び出してバイナリファイルをエクスポートします</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>binaryVerify <span class="token number">14</span> 8542cb57b77e0ae2c<span class="token punctuation">..</span>.92c3e05dbbe35ab646789be5b8ba8 <span class="token parameter variable">-f</span><span class="token operator">=</span>./data.json <span class="token punctuation">{</span> <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"./data.json"</span>, <span class="token string">"type"</span><span class="token builtin class-name">:</span> <span class="token string">"application/json"</span>, <span class="token string">"value"</span><span class="token builtin class-name">:</span> <span class="token string">""</span> <span class="token punctuation">}</span> </code></pre></div><h3 id="import-application"><a href="#import-application" class="header-anchor">#</a> アプリケーションのインポート </h3> <p><code>import</code> コマンドを使用してアプリケーションをインポートし、<code>-f</code> パラメータを使用してインポートするアプリケーションファイルを指定します</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ibax-cli console Welcome to the IBAX console<span class="token operator">!</span> To exit, press ctrl-d or <span class="token builtin class-name">type</span> <span class="token builtin class-name">exit</span> <span class="token operator">></span>import <span class="token parameter variable">-f</span> <span class="token builtin class-name">.</span> /data.json </code></pre></div><p><code>import</code>コマンドはアプリケーションをインポートする手順をカプセル化しています。上記のコマンドを使用してアプリケーションをインポートできます。</p> <p>または、調査と研究を容易にするために、次の手順を使用します。</p> <ul><li>ステップ1 新しいアプリケーションをインポートするためにコントラクト <code>@1ImportUpload</code> を呼び出すと、エクスポートされたアプリケーションのレコードが <code>1_buffer_data</code> テーブルに生成されます。 <code>@1ImportUpload</code> コントラクトパラメーター <code>Data</code> は <code>file</code> <a href="/ja/topics/vm.html#types">type</a> です。キーワード「Name」ファイル名（文字列）、「MimeType」ファイルタイプ（文字列）、「Body」（[]バイト）ファイル内容が含まれます。アプリケーションファイルデータをbase64エンコードして「Body」に渡す必要があります。「base64Encode」コマンドを使用してbase64エンコードできます。</li></ul> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>base64Encode <span class="token parameter variable">-f</span><span class="token operator">=</span>./data.json Encode:ewoJIm5hbWUiOiAid<span class="token punctuation">..</span>.CQkJIlR5cGUiOiAiY29udHJhY3RzIiwKCQkJIk5hbWUiOiAiSGVsbG9Xb3JsZCIsCgkJCSJWYWx1ZSI6<span class="token punctuation">..</span>. <span class="token operator">></span>callContract @1ImportUpload <span class="token punctuation">{</span><span class="token string">"Data"</span><span class="token builtin class-name">:</span> <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"filename"</span>, <span class="token string">"MimeType"</span><span class="token builtin class-name">:</span> <span class="token string">"mimeType"</span>, <span class="token string">"Body"</span><span class="token builtin class-name">:</span> <span class="token string">"ewoJIm5hbWUiOiAid...CQkJIlR5cGUiOiAiY29udHJhY3RzIiwKCQkJIk5hbWUiOiAiSGVsbG9Xb3JsZCIsCgkJCSJWYWx1ZSI6..."</span><span class="token punctuation">}</span><span class="token punctuation">}</span> </code></pre></div><ul><li>ステップ12 呼び出しが完了したら、<code>getList</code>コマンドを使用して「1_buffer_data」テーブル内のデータをクエリします。</li></ul> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1buffer_data <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"key"</span><span class="token builtin class-name">:</span> <span class="token string">"import"</span>, <span class="token string">"account"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-0819-xxxx-7879-5186"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">19</span><span class="token punctuation">}</span> <span class="token parameter variable">-l</span><span class="token operator">=</span><span class="token number">1</span> <span class="token parameter variable">-c</span><span class="token operator">=</span>value-<span class="token operator">></span><span class="token string">'data'</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"22"</span>, <span class="token string">"value.data"</span><span class="token builtin class-name">:</span> <span class="token string">"[{"</span>Data<span class="token string">": "</span><span class="token punctuation">[</span>a,b<span class="token punctuation">]</span><span class="token string">"}, {"</span>Data<span class="token string">": "</span><span class="token punctuation">[</span>c,d<span class="token punctuation">]</span><span class="token string">"}]"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><ul><li>ステップ3 value.data->Data のデータを 1 次元配列 [a,b,c,d] に組み立てます。次に、次の内容を含むコントラクトパラメーターファイル<code>importParams.json</code>を作成します。</li></ul> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span><span class="token property">"Data"</span><span class="token operator">:</span><span class="token string">"[a,b,c,d]"</span><span class="token punctuation">}</span> </code></pre></div><ul><li>ステップ4 コントラクト <code>@1Import</code> を呼び出してアプリケーションデータをインポートします</li></ul> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1Import <span class="token parameter variable">-f</span><span class="token operator">=</span>./importParams.json </code></pre></div><h2 id="ecosystem-configuration-using-command-line-tool"><a href="#ecosystem-configuration-using-command-line-tool" class="header-anchor">#</a> エコロジーの設定（コマンドラインツールを使用） </h2> <p>このチュートリアルでは、以下の手順を実行します:</p> <ol><li><a href="#apply-to-join-the-ecosystem">エコロジーへの参加申請</a></li> <li><a href="#add-ecosystem-members">エコロジーメンバーの追加</a></li> <li><a href="#freezing-of-accounts">アカウントの凍結</a></li> <li><a href="#role-management">役割管理</a></li> <li><a href="#issuance-of-token">トークンの発行</a></li> <li><a href="#eco-deduction">エコロジー控除</a></li> <li><a href="#dao-governance-ecosystem">DAOガバナンスエコロジー</a></li></ol> <p>このチュートリアルを開始する前に、独自のアプリケーションを用意し、エコロジーとアプリケーションの概念を理解する必要があります。<a href="#getting-started-guide">スタートガイド</a> を参照してください。 <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">コマンドラインツール<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> を使用して、IBAX ブロックチェーン上でエコロジー構成を実行します。</p> <h3 id="apply-to-join-the-ecosystem"><a href="#apply-to-join-the-ecosystem" class="header-anchor">#</a> エコロジーへの参加を申請する </h3> <p><code>@1MembershipRequest</code> コントラクトを呼び出して、エコロジーへの参加をリクエストできます。次の例:</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1MembershipRequest <span class="token punctuation">{</span><span class="token string">"EcosystemId"</span><span class="token builtin class-name">:</span> <span class="token number">19</span><span class="token punctuation">}</span> </code></pre></div><p>エコロジー ID <code>19</code> でエコロジーへの参加をリクエストする場合、<code>@1MembershipRequest</code> コントラクトはエコロジーの呼び出しに制限を設けており、基本エコロジーでのみ呼び出すことができます。申請が成功すると対象エコロジー管理者に申請が届き、エコロジー管理者が申請を承認した場合のみ対象エコロジーに参加したとみなされます。もちろん、ターゲットのエコロジーが公開されている場合は、ターゲットのエコロジーに直接参加することもできます</p> <h3 id="add-ecosystem-members"><a href="#add-ecosystem-members" class="header-anchor">#</a> エコロジーメンバーを追加する </h3> <p>エコロジーが作成されたばかりの場合、エコロジーメンバーはエコロジー作成者のみです。他のメンバーを参加に招待する必要がある場合は、招待された人の公開鍵を知っていて、コントラクト <code>@1MembershipAdd</code> を呼び出してメンバーを追加する必要があります。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1MembershipAdd <span class="token punctuation">{</span><span class="token string">"Keys"</span><span class="token builtin class-name">:</span> <span class="token string">"04f2c1780ca0aa0f343d0e541c77811...3b0d5bf3a9903253aad6e78c966b5f91ffb32703884020"</span><span class="token punctuation">}</span> </code></pre></div><p>エコロジーがパブリックで誰でも参加できる場合は、エコロジーパラメーター <code>free_membership</code> = 1 を設定できますが、これはデフォルトではパブリックではありません。一度設定したら、エコシステムへの参加を承認する必要はありません</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewParameter <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"free_membership"</span>, <span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token string">"1"</span>, <span class="token string">"Conditions"</span><span class="token builtin class-name">:</span> <span class="token string">"ContractConditions(<span class="token entity" title="\"">\"</span>MainCondition<span class="token entity" title="\"">\"</span>)"</span><span class="token punctuation">}</span> </code></pre></div><p>パラメータ <code>free_membership</code> を設定しない場合、他のメンバーがあなたのエコロジーへの参加を申請したときに、申請通知を受け取ります。</p> <p><code>@1MembershipDecide</code> 契約承認アプリケーションを呼び出し、契約パラメータ <code>NotificId</code> は通知 ID、'Accept' は解決マーク、解決マーク '1' が渡されます</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1MembershipDecide <span class="token punctuation">{</span><span class="token string">"NotificId"</span><span class="token builtin class-name">:</span> <span class="token number">6</span>, <span class="token string">"Accept"</span><span class="token builtin class-name">:</span> <span class="token number">1</span><span class="token punctuation">}</span> </code></pre></div><h3 id="freezing-of-accounts"><a href="#freezing-of-accounts" class="header-anchor">#</a> アカウントの凍結 </h3> <p><code>@1DeleteMember</code> コントラクトを呼び出してアカウントを凍結します。この操作は復元できないことに注意してください</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1DeleteMember <span class="token punctuation">{</span><span class="token string">"MemberAccount"</span><span class="token builtin class-name">:</span> <span class="token string">"1539-2715-xxxx-1679-5385"</span><span class="token punctuation">}</span> </code></pre></div><h3 id="role-management"><a href="#role-management" class="header-anchor">#</a> 役割管理 </h3> <ul><li><a href="#new-role-creation">新しいロールの作成</a></li> <li><a href="#adding-role-members">ロールメンバーを追加</a></li> <li><a href="#delete-role-members">ロールメンバーを削除</a></li> <li><a href="#modify-role-manager">ロールマネージャーを変更</a></li> <li><a href="#delete-role">ロールの削除</a></li></ul> <h4 id="new-role-creation"><a href="#new-role-creation" class="header-anchor">#</a> 新しい役割の作成 </h4> <p><code>@1RolesCreate</code> コントラクトを呼び出して、新しいロール、ロール名 <code>student</code>、タイプ <code>2</code> (1 - 割り当て可能 2 - 投票タイプ 3 - システム) を作成します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesCreate <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"student"</span>, <span class="token string">"Type"</span><span class="token builtin class-name">:</span> <span class="token number">2</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1685</span>, <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"5321f2231a...d0d80158b62766395f14d0ff7"</span>, <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"21"</span> <span class="token punctuation">}</span> </code></pre></div><p>返される結果にはロール ID <code>21</code> が含まれます</p> <h4 id="adding-role-members"><a href="#adding-role-members" class="header-anchor">#</a> ロールメンバーの追加 </h4> <p>2 つのメソッドがあります。1 つ目のメソッドは、エコロジカルメンバーがアプリケーションを開始し、コントラクト <code>@1RolesRequest</code> リクエストを呼び出してロールのメンバーとして追加するリクエストです。ここで、<code>Rid</code> はロール ID です</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesRequest <span class="token punctuation">{</span><span class="token string">"Rid"</span><span class="token builtin class-name">:</span> <span class="token number">21</span><span class="token punctuation">}</span> </code></pre></div><p>2 番目の方法では、ロールマネージャーがロールメンバーを割り当て、ロールマネージャーがコントラクト <code>@1RolesAssign</code> を呼び出してメンバーをロールに追加します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesAssign <span class="token punctuation">{</span><span class="token string">"MemberAccount"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-7782-xxxx-7671- 3160"</span>, <span class="token string">"Rid"</span><span class="token builtin class-name">:</span> <span class="token number">21</span><span class="token punctuation">}</span> </code></pre></div><h4 id="delete-role-members"><a href="#delete-role-members" class="header-anchor">#</a> ロールメンバーを削除する </h4> <p>まず、ロールにどのようなメンバーが含まれているかを確認します。これは、次のように getList を介してクエリできます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1roles_participants <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">18</span>, <span class="token string">"role->id"</span><span class="token builtin class-name">:</span> <span class="token string">"21"</span>, <span class="token string">"deleted"</span><span class="token builtin class-name">:</span> <span class="token number">0</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">3</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"appointed"</span><span class="token builtin class-name">:</span> <span class="token string">"{<span class="token entity" title="\"">\"</span>account<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>1273-2644-xxxx-5846-6598<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>image_id<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>0<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>member_name<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>founder<span class="token entity" title="\"">\"</span>}"</span>, <span class="token string">"date_created"</span><span class="token builtin class-name">:</span> <span class="token string">"1684916023"</span>, <span class="token string">"date_deleted"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"deleted"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token string">"18"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"21"</span>, <span class="token string">"member"</span><span class="token builtin class-name">:</span> <span class="token string">"{<span class="token entity" title="\"">\"</span>account<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>1273-2644-xxxx-5846-6598<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>image_id<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>0<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>member_name<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>founder<span class="token entity" title="\"">\"</span>}"</span>, <span class="token string">"role"</span><span class="token builtin class-name">:</span> <span class="token string">"{<span class="token entity" title="\"">\"</span>id<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>20<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>name<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>teacher<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>type<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>1<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>image_id<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>0<span class="token entity" title="\"">\"</span>}"</span> <span class="token punctuation">}</span> <span class="token punctuation">..</span>. <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>where</code>条件<code>ecosystem</code>はエコロジーを指定し、<code>role->id</code>はロール ID を指定し、<code>deleted</code>: 0 は削除されないことを指定します。メンバー <code>1273-2644-xxxx-5846-6598</code> のロール、つまり <code>id</code> が <code>21</code> のロールを削除する場合、行が 3 つあることがわかります。管理者は、次のようにコントラクト <code>@1RolesUnassign</code> を呼び出してロールメンバーを削除できます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesUnassign <span class="token punctuation">{</span><span class="token string">"RowId"</span><span class="token builtin class-name">:</span> <span class="token number">21</span><span class="token punctuation">}</span> </code></pre></div><h4 id="modify-role-manager"><a href="#modify-role-manager" class="header-anchor">#</a> 役割マネージャーの変更 </h4> <p>現在の生態学的役割を見てみましょう</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1roles <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">18</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">5</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"company_id"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"creator"</span><span class="token builtin class-name">:</span> <span class="token string">"{<span class="token entity" title="\"">\"</span>account<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>1273-2644-xxxx-5846-6598<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>image_id<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>0<span class="token entity" title="\"">\"</span>, <span class="token entity" title="\"">\"</span>member_name<span class="token entity" title="\"">\"</span>: <span class="token entity" title="\"">\"</span>founder<span class="token entity" title="\"">\"</span>}"</span>, <span class="token string">"date_created"</span><span class="token builtin class-name">:</span> <span class="token string">"1684910917"</span>, <span class="token string">"date_deleted"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"default_page"</span><span class="token builtin class-name">:</span> <span class="token string">""</span>, <span class="token string">"deleted"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token string">"18"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"20"</span>, <span class="token string">"image_id"</span><span class="token builtin class-name">:</span> <span class="token string">"0"</span>, <span class="token string">"role_name"</span><span class="token builtin class-name">:</span> <span class="token string">"teacher"</span>, <span class="token string">"role_type"</span><span class="token builtin class-name">:</span> <span class="token string">"1"</span>, <span class="token string">"roles_access"</span><span class="token builtin class-name">:</span> <span class="token string">"[]"</span> <span class="token punctuation">}</span> <span class="token punctuation">..</span>. <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>roles_access</code>は現在のロールの管理ロールであり、配列であり、複数を持つことができます。 <code>@1RolesAccessManager</code> コントラクトを呼び出して、管理ロールをロール <code>Teacher</code> に追加します。ここで、コントラクトのパラメータは <code>Action</code> 管理演算子 (<code>clean</code>、<code>remove</code>、<code>add</code>)、<code>Rid</code> のロール ID です。管理対象の<code>ManagerRid</code>ロールの Rid マネージャー</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesAccessManager <span class="token punctuation">{</span><span class="token string">"Action"</span><span class="token builtin class-name">:</span> <span class="token string">"add"</span>, <span class="token string">"Rid"</span><span class="token builtin class-name">:</span> <span class="token number">20</span>, <span class="token string">"ManagerRid"</span><span class="token builtin class-name">:</span> <span class="token number">13</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1745</span>, <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"e2eb8ff0dc309ec7652db...bbbe58bca4ca574804e46c2f63653eb73104"</span>, <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">""</span> <span class="token punctuation">}</span> </code></pre></div><h4 id="delete-role"><a href="#delete-role" class="header-anchor">#</a> 役割の削除 </h4> <p><code>@1RolesDelete</code> コントラクトを呼び出してロールを削除できます。コントラクトパラメータの <code>Rid</code> は管理対象のロールの ID、<code>Ops</code> は演算子です (<code>D</code> は削除、<code>R</code> は復元)</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1RolesDelete <span class="token punctuation">{</span><span class="token string">"Rid"</span><span class="token builtin class-name">:</span> <span class="token number">24</span>, <span class="token string">"Ops"</span><span class="token builtin class-name">:</span> <span class="token string">"D"</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1785</span>, <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"1ebf99a04f504fc3d2...4ecfbdfc419bf3dbf39df0013dca913f844"</span>, <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">""</span> <span class="token punctuation">}</span> </code></pre></div><h3 id="issuance-of-token"><a href="#issuance-of-token" class="header-anchor">#</a> トークンの発行 </h3> <ul><li><a href="#create-ecosystem">エコロジーをクリエイト</a></li> <li><a href="#installing-basic-applications">基本アプリケーションのインストール</a></li> <li><a href="#token-issuance">トークン発行</a></li></ul> <h4 id="create-ecosystem"><a href="#create-ecosystem" class="header-anchor">#</a> エコロジーを創造する </h4> <p>エコロジーを作成し、<code>@1NewEcosystem</code> コントラクトを呼び出します</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewEcosystem <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"Test Ecosystem"</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1787</span>, <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"384f35ef93243c9dd4f53b9298873b356b25b31cf7c6a6be7600ee7694d77006"</span>, <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"21"</span> <span class="token punctuation">}</span> </code></pre></div><p>次に、コマンドラインツールの設定を変更して、この新しく作成されたエコシステムにログインします:「21」</p> <h4 id="installing-basic-applications"><a href="#installing-basic-applications" class="header-anchor">#</a> 基本アプリケーションのインストール </h4> <p>次のように、コントラクトを呼び出して基本アプリケーションをインストールします。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token number">1</span> <span class="token operator">></span>callContract @1PlatformAppsInstall <span class="token number">2</span> <span class="token operator">></span>callContract @1RolesInstall <span class="token number">3</span> <span class="token operator">></span>callContract @1AppInstall <span class="token punctuation">{</span><span class="token string">"ApplicationId"</span><span class="token builtin class-name">:</span> <span class="token number">5</span><span class="token punctuation">}</span> <span class="token number">4</span> <span class="token operator">></span>callContract @1AppInstall <span class="token punctuation">{</span><span class="token string">"ApplicationId"</span><span class="token builtin class-name">:</span> <span class="token number">6</span><span class="token punctuation">}</span> </code></pre></div><p>1行目、プラットフォームアプリケーションをインストールします 2行目、デフォルトの役割をインストールします行 3 ～ 4 では、エコ構成およびトークン発行アプリケーションをインストールします。ここで、アプリケーション ID <code>5,6</code> は、次のように getList を介してクエリできます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1applications <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"<span class="token variable">$or</span>"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span><span class="token punctuation">{</span><span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"Token emission"</span><span class="token punctuation">}</span>,<span class="token punctuation">{</span><span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"Ecosystems catalog"</span><span class="token punctuation">}</span><span class="token punctuation">]</span><span class="token punctuation">}</span> <span class="token parameter variable">-c</span><span class="token operator">=</span><span class="token string">"name,ecosystem"</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">2</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token string">"1"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"5"</span>, <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"Token emission"</span> <span class="token punctuation">}</span>, <span class="token punctuation">{</span> <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token string">"1"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"6"</span>, <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"Ecosystems catalog"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><h4 id="token-issuance"><a href="#token-issuance" class="header-anchor">#</a> トークンの発行 </h4> <p>新しいエコロジーであるため、トークンの発行を設定する必要があります。<code>@1TeSettings</code> コントラクトを呼び出して、トークンを発行できるロールを指定します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeSettings <span class="token punctuation">{</span><span class="token string">"RoleDeveloper"</span><span class="token builtin class-name">:</span> <span class="token number">30</span><span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>RoleDeveloper</code>は現在のエコロジーロール ID であり、「@1roles」データテーブルから取得できます。</p> <p><strong>トークンの発行</strong> <code>@1NewToken</code> コントラクトを呼び出してトークンを発行します</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewToken <span class="token punctuation">{</span><span class="token string">"Symbol"</span><span class="token builtin class-name">:</span> <span class="token string">"TEST"</span>, <span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"TEST Coin"</span>, <span class="token string">"Amount"</span><span class="token builtin class-name">:</span> <span class="token string">"10000000000000000"</span> ,<span class="token string">"Digits"</span><span class="token builtin class-name">:</span> <span class="token string">"12"</span><span class="token punctuation">}</span> </code></pre></div><p>ここで、コントラクトパラメータの <code>Symbol</code> はトークンシンボル、<code>Name</code> はトークン名、<code>Amount</code> は合計金額、<code>Digits</code> は精度です。</p> <p><strong>トークンの発行</strong></p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeEmission <span class="token punctuation">{</span><span class="token string">"Amount"</span><span class="token builtin class-name">:</span> <span class="token number">1000000000000</span><span class="token punctuation">}</span> </code></pre></div><p><strong>トークンを破壊する</strong></p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeBurn <span class="token punctuation">{</span><span class="token string">"Amount"</span><span class="token builtin class-name">:</span> <span class="token number">1000000000000</span><span class="token punctuation">}</span> </code></pre></div><p>デフォルトのトークンの増分とトークンの破棄が許可されています。<code>@1TeChange</code> によってそれをオフに設定できます。ここで、<code>TypeChange</code> はタイプ (<code>emission</code> の増分、<code>withdraw</code> の破棄) です。 <code>Value</code> はオン/オフのステータス (<code>1</code> がオン、<code>2</code> がオフ) です。例: <strong>追加機能を閉じる</strong> 注: 閉じた後はオンにできません</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeChange <span class="token punctuation">{</span><span class="token string">"TypeChange"</span><span class="token builtin class-name">:</span> <span class="token string">"emission"</span>, <span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token number">2</span><span class="token punctuation">}</span> </code></pre></div><p><strong>破壊をオフにします</strong>。再度破壊をオンにしたい場合は、<code>値</code>を<code>1</code>に設定するだけです。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeChange <span class="token punctuation">{</span><span class="token string">"TypeChange"</span><span class="token builtin class-name">:</span> <span class="token string">"withdraw"</span>, <span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token number">2</span><span class="token punctuation">}</span> </code></pre></div><h3 id="eco-deduction"><a href="#eco-deduction" class="header-anchor">#</a> エコ控除 </h3> <p>エコ控除を設定する前に、<a href="https://github.com/IBAX-io/whitepaper" target="_blank" rel="noopener noreferrer">ホワイトペーパー<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> に記載されている IBAX 料金モデルを理解する必要があります。</p> <p>まずエコウォレットのアドレスを設定し、<code>@1EditParameter</code> コントラクトを呼び出してエコパラメータを変更します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditParameter <span class="token punctuation">{</span><span class="token string">"Id"</span><span class="token builtin class-name">:</span> <span class="token number">334</span>, <span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token string">"1273-2644-xxxx-5846-6598"</span><span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>Id</code> は ecowallet (エコシステムウォレット) の <code>ecosystem_wallet</code> パラメーター ID であり、次のようにクエリできます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1parameters <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">22</span>, <span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"ecosystem_wallet"</span><span class="token punctuation">}</span> </code></pre></div><p><code>Value</code>値はバインドされるエコウォレットのアドレスであり、契約によりガス料金が生成され、そのアドレスによって支払われます。アドレスには現在のエコロジーに十分なトークンが必要であり、変更が成功する前にバインドされたアドレスによって同意される必要があります。</p> <p>次のように、<code>@1EcoFeeModeManage</code> コントラクトを呼び出して、マルチエコロジー控除を設定します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EcoFeeModeManage <span class="token punctuation">{</span><span class="token string">"FollowFuel"</span><span class="token builtin class-name">:</span> <span class="token number">0.01</span>, <span class="token string">"CombustionFlag"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"VmCostFlag"</span><span class="token builtin class-name">:</span> <span class="token number">2</span>, <span class="token string">"VmCostConversionRate"</span><span class="token builtin class-name">:</span> <span class="token number">100</span>, <span class="token string">"StorageConversionRate"</span><span class="token builtin class-name">:</span> <span class="token number">100</span>, <span class="token string">"StorageFlag"</span><span class="token builtin class-name">:</span> <span class="token number">2</span>, <span class="token string">"ExpediteFlag"</span><span class="token builtin class-name">:</span> <span class="token number">1</span><span class="token punctuation">}</span> </code></pre></div><p>ここで、コントラクトパラメータフィールドは次のように定義されます。</p> <ul><li><code>FollowFuel</code> パラメータは、follow eco1 レートの倍数です。</li> <li><code>CombustionFlag</code> エコトレードガス料金の燃焼をオンにするかどうか、1-いいえ、2-はい</li> <li><code>CombustionPercent</code> 燃焼パーセンテージ。ガス料金燃焼がオンになっている場合にのみ有効です。値は 1 ～ 100 で、オンになっていない場合は 0 になります。</li> <li><code>VmCostFlag</code> VM コストフラグ、直接支払いまたは代理支払いを設定、1 - 直接支払い、2 - 代理支払い</li> <li><code>StorageFlag</code> 保管料金フラグ、直接支払いまたは代理支払いを設定、1 - 直接支払い、2 - 代理支払い</li> <li><code>ExpediteFlag</code> 急送料金フラグ、直接支払いまたは代理支払いを設定、1 - 直接支払い、2 - 代理支払い</li> <li><code>VmCostConversionRate</code> 仮想マシンのコスト変換率、小数点以下 2 桁、代理支払いの場合にのみ有効、0 より大きい</li> <li><code>StorageConversionRate</code> ストレージコストの換算率（小数点以下 2 桁）、代理支払いの場合にのみ有効、0 より大きい</li></ul> <p>上記の設定を使用する場合、ユーザーがエコロジー内でコントラクトを呼び出すことによって発生するすべての取引手数料は、現在のエコロジー設定のエコロジカルウォレットによって支払われます。すべてのユーザーは、エコロジー内で発生するガス料金のみを支払う必要があります。もちろん、実際のニーズに応じてコストパラメータを調整できます</p> <h3 id="dao-governance-ecosystem"><a href="#dao-governance-ecosystem" class="header-anchor">#</a> DAO ガバナンスエコロジー </h3> <p>DAO ガバナンスエコロジーに変更する前に、現在のエコロジーがトークンを発行していることを確認する必要があります。DAO ガバナンスエコロジーに変更した後、エコロジーのすべての提案はガバナンス委員会のメンバーによって投票されます。 DAO 統治委員会はもはやエコ開発業者だけによって運営されることはなく、エコホールディングスの上位 50 人の代表者が選出されます。</p> <p><code>@1EditControlMode</code> コントラクトを呼び出して、エコガバナンスモードを DAO ガバナンスモードに変更します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditControlMode <span class="token punctuation">{</span><span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token number">2</span><span class="token punctuation">}</span> </code></pre></div><p>ここで、<code>Value</code>パラメータの<code>1</code>は作成者モデルを表し、「2」は DAO ガバナンスモデルを表します。</p> <p>アプリケーションを作成してみます</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewApplication <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"testApp"</span>, <span class="token string">"Conditions"</span><span class="token builtin class-name">:</span> <span class="token string">"ContractConditions(<span class="token entity" title="\"">\"</span>@1DeveloperCondition<span class="token entity" title="\"">\"</span>)"</span><span class="token punctuation">}</span> </code></pre></div><p>この時点で、DAO ガバナンス提案が生成され、アプリケーションが作成される前に DAO ガバナンス委員会によって投票されます。有効な提案には、投じられた投票の 75% のうち 68% の支持率が必要です。 DAO ガバナンスの範囲には以下が含まれます。</p> <ol><li>アプリケーション、コントラクト、ページ、コードスニペット、タブ、メニュー、アプリケーションパラメータ、データテーブルおよびフィールドの追加、削除、および変更</li> <li>多言語の変更</li> <li>DAOとクリエイターモデルの切り替え</li> <li>生態パラメータを編集する</li> <li>ロール、ロールメンバーの割り当てを削除</li> <li>追加破壊通貨発行</li> <li>プラットフォームパラメータを変更する</li> <li>生態情報の変更</li> <li>遅延した契約の変更</li> <li>投票テンプレートを変更する</li></ol> <h2 id="deploy-applications-using-application-packaging-tool"><a href="#deploy-applications-using-application-packaging-tool" class="header-anchor">#</a> アプリケーションパッケージングツールを使用してアプリケーションをデプロイする </h2> <p>このチュートリアルを開始する前に、<a href="https://github.com/IBAX-io/app-tool" target="_blank" rel="noopener noreferrer">IBAX アプリケーションパッケージングツール<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> をダウンロードする必要があります。このツールを使用して IBAX アプリケーションをパッケージ化する必要があります。</p> <p>次のディレクトリ構造に従ってアプリケーションファイルを保存する必要があります。</p> <div class="language-text extra-class"><pre class="language-text"><code>- APP Name - app_params params1.csv params2.csv ... - contracts contract1.sim contract2.sim ... - tables tableName1.json tableName2.json ... config.json </code></pre></div><p>以下に示すように:</p> <div class="language-shell extra-class"><pre class="language-shell"><code>airdrop$ <span class="token function">ls</span> * config.json app_params: dedicated_account.csv lock_percent.csv per_period_sec.csv period_count.csv contracts: AddAirdrop.sim ClaimAirdrop.sim SpeedAirdrop.sim tables: airdrop_info.json </code></pre></div><p><code>app_params</code> ディレクトリには、パラメータ名 + ファイル形式 <code>.csv</code> を使用して名前が付けられたアプリケーションパラメータファイルが保存されます。ファイルの内容はパラメータ値です。 <code>contracts</code> ディレクトリには契約が <code>.sim</code> ファイル形式で保持され、ファイルの内容は契約のソースコードです。 <code>tables</code>ディレクトリには、次のようにアプリケーションデータテーブル構造が<code>json</code>ファイル形式で保持されます。</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"account"</span><span class="token punctuation">,</span> <span class="token property">"conditions"</span><span class="token operator">:</span> <span class="token string">"{\"read\": \"true\", \"update\": \"ContractConditions(\"MainCondition\")\"}"</span><span class="token punctuation">,</span> <span class="token property">"type"</span><span class="token operator">:</span> <span class="token string">"varchar"</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">{</span> <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"balance_amount"</span><span class="token punctuation">,</span> <span class="token property">"conditions"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"type"</span><span class="token operator">:</span> <span class="token string">"money"</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">{</span> <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"stake_amount"</span><span class="token punctuation">,</span> <span class="token property">"conditions"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"type"</span><span class="token operator">:</span> <span class="token string">"money"</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">{</span> <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"surplus"</span><span class="token punctuation">,</span> <span class="token property">"conditions"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"type"</span><span class="token operator">:</span> <span class="token string">"number"</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">{</span> <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"total_amount"</span><span class="token punctuation">,</span> <span class="token property">"conditions"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"type"</span><span class="token operator">:</span> <span class="token string">"money"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> </code></pre></div><p><code>name</code> はデータテーブルのフィールド名、<code>conditions</code> はデータテーブルのフィールド権限、<code>type</code> はフィールドのタイプです。</p> <p>ステップ 1 では、config.json ファイルを生成し、次の内容で airdrop ディレクトリに保存します。</p> <div class="language-text extra-class"><pre class="language-text"><code>{ "name": "Airdrop", "conditions": "ContractConditions(\"@1MainCondition\")" } </code></pre></div><p>ここで、<code>name</code> はアプリケーションの名前、<code>conditions</code>: はアプリケーションを変更して airdrop ディレクトリに保存する権限です。</p> <p>ステップ 2: アプリケーションをパッケージ化します。次のコマンドにより、現在のディレクトリにアプリケーション <code>airdrop.json</code> が生成されます。コントラクトまたはアプリケーションのパラメータを変更した場合は、アプリケーションを再パッケージ化する必要があります。</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ./app-tool airdrop/ </code></pre></div><p>次のように、<a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">コマンドラインツール<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> を介してアプリケーションをインポートできます。 <code>import</code> コマンドを使用してアプリケーションをインポートし、<code>-f</code> パラメータを使用してインポートするアプリケーションファイルを指定します。</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ibax-cli console Welcome to the IBAX console<span class="token operator">!</span> To exit, press ctrl-d or <span class="token builtin class-name">type</span> <span class="token builtin class-name">exit</span> <span class="token operator">></span>import <span class="token parameter variable">-f</span> ./airdrop.json </code></pre></div><p>もちろん、アプリケーションをお持ちの場合は、次のコマンドを使用して完全なディレクトリ構造を生成することもできます。</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ app-tool.exe airdrop.json </code></pre></div></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/IBAX-io/documentation/edit/master/docs/ja/tutorials/tutorial.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="/ja/tutorials/app_tutorial.html" class="prev"> アプリケーション開発チュートリアル {#tutorial-for-application-development} </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/103.25320011.js" defer></script> </body> </html>