IBAX Development Tutorial </a></li><li><a href="/de/tutorials/tutorial.html" aria-current="page" class="active sidebar-link">IBAX Development Tutorial </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#getting-started-guide" class="sidebar-link">Getting Started Guide </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#deployment" class="sidebar-link">Deployment </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#advanced-guide" class="sidebar-link">Advanced Guide </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#deploy-first-smart-contract-via-command-line-tool" class="sidebar-link">Deploy first smart contract via command line tool </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#create-application" class="sidebar-link">Create application </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#writing-contracts" class="sidebar-link">Writing contracts </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#create-contract" class="sidebar-link">Create Contract </a></li></ul></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#command-line-tool-eco-development" class="sidebar-link">Command Line Tool Eco Development </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-1-create-ecosystem" class="sidebar-link">Step 1 Create Ecosystem </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-2-create-application" class="sidebar-link">Step 2 Create Application </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-3-create-table" class="sidebar-link">Step 3 Create Table </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-4-create-application-parameters" class="sidebar-link">Step 4 Create Application Parameters </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-5-create-contract-deploy-contract" class="sidebar-link">Step 5 Create Contract Deploy Contract </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-6-create-ecosystem-parameters" class="sidebar-link">Step 6 Create Ecosystem Parameters </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-7-add-localization" class="sidebar-link">Step 7 add localization </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#step-8-modify-the-contract" class="sidebar-link">Step 8 Modify the contract </a></li></ul></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#deploy-application-using-command-line-tools" class="sidebar-link">Deploy application using command line tools </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#export-application" class="sidebar-link">Export Application </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#import-application" class="sidebar-link">Import Application </a></li></ul></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#ecosystem-configuration-using-command-line-tool" class="sidebar-link">Ecosystem configuration using command line tool </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#apply-to-join-the-ecosystem" class="sidebar-link">Apply to join the ecosystem </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#add-ecosystem-members" class="sidebar-link">Add ecosystem members </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#role-management" class="sidebar-link">Role management </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#issuance-of-token" class="sidebar-link">Issuance of Token </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#eco-deduction" class="sidebar-link">Eco Deduction </a></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#dao-governance-ecosystem" class="sidebar-link">DAO Governance Ecology </a></li></ul></li><li class="sidebar-sub-header"><a href="/de/tutorials/tutorial.html#deploy-applications-using-application-packaging-tool" class="sidebar-link">Deploy applications using application packaging tool </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 Development Tutorial </h1> <h2 id="getting-started-guide"><a href="#getting-started-guide" class="header-anchor">#</a> Getting Started Guide </h2> <ul><li><a href="#deploy-first-smart-contract-via-command-line-tool">Deploy first smart contract via command line tool</a></li> <li><a href="#command-line-tool-eco-development">Command Line Tool Eco Development</a></li></ul> <h2 id="deployment"><a href="#deployment" class="header-anchor">#</a> Deployment </h2> <ul><li><a href="#deploy-application-using-command-line-tools">Deploy application using command line tools</a></li> <li><a href="#ecosystem-configuration-using-command-line-tool">Ecosystem configuration using command line tool</a></li></ul> <h2 id="advanced-guide"><a href="#advanced-guide" class="header-anchor">#</a> Advanced Guide </h2> <ul><li><a href="#deploy-applications-using-application-packaging-tool">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> Deploy first smart contract via command line tool </h2> <p>We will deploy <a href="/de/concepts/thesaurus.html#smart-contract">smart contracts</a> on the IBAX blockchain via the <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">command line tool<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>, and learn how to invoke smart contracts. As our first smart contract, we deployed it to <a href="/de/concepts/blockchain-layers.html">local test network</a> How to deploy a local network you can refer to <a href="/de/howtos/deployment.html">Network Deployment</a> , so you can deploy and run it as you like without any overhead.</p> <h3 id="create-application"><a href="#create-application" class="header-anchor">#</a> Create application </h3> <p>Call the contract @1NewApplication to create the application, which has an application name parameter and a modify <a href="/de/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 $ 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>The following is explained by line:</p> <ul><li>Line 1, start command line terminal</li> <li>Line 5, call the contract @1NewApplication to create an application with the application name <code>testapp</code> and the application modification permission <code>@1DeveloperCondition</code> with developer permission</li> <li>Row 8, the block id generated by the transaction</li> <li>Line 9, the block hash generated by the transaction</li> <li>Line 10, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>On line 11, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field is the id of the application</li></ul> <p>Of course if you want to see what fields and field types are available in this contract, you can call the <code>getContractInfo</code> method, which will return the contract information as follows:</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>The <code>fields</code> field is the parameters of the contract, including the name of the parameter <code>name</code>, <code>type</code>, <code>optional</code>, <code>Name</code> and <code>Conditions</code> are required, <code>VotingId</code> is optional, refer to <a href="/de/reference/api2.html#contract-name">contract/name</a> API method</p> <h3 id="writing-contracts"><a href="#writing-contracts" class="header-anchor">#</a> Writing contracts </h3> <p>We use <a href="/de/topics/script.html#needle-contract-language">Needle</a> to write a smart contract that We implement a simple addition operation, the source code of the contract is as follows, we save the contract as <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>The following is explained by line:</p> <ul><li>In line 1, we define a contract with the name SumMath</li> <li>Line 2, <a href="/de/topics/script.html#data-section">Data Section</a></li> <li>In lines 3-4, we define two input 64-bit integer-type parameters <code>A B</code></li> <li>Line 6, <a href="/de/topics/script.html#conditions-section">Conditional Section</a></li> <li>Line 9, <a href="/de/topics/script.html#action-section">Operations Section</a> We define a variable sum to receive the result of A+B. Assign the value of sum to $result, as the result of the contract. Of course it is possible to assign the value of A+B to $result directly, but it can be shown as an example.</li></ul> <h3 id="create-contract"><a href="#create-contract" class="header-anchor">#</a> Create Contract </h3> <p>There are two ways to create a contract, the first of which is: In the first step we write a contract parameter file in json format:</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>where <code>ApplicationId</code> is the application id, <code>Value</code> is the contract source code, need to escape special characters, <code>Conditions</code> is the contract modification rights</p> <p>We named it SumMathParams.json</p> <p>The second step calls to create a contract @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>Second method: The saved contract source file is passed directly into the contract parameters in the parameter format <code>paramsName</code> + <code>-</code> + "file",<code>paramsName-file</code> as follows:</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>The following is explained by line:</p> <ul><li>Line 1: Call the contract @1NewContract to create the contract, -f uses the file to import the contract parameters</li> <li>Row 3, the block id generated by the transaction</li> <li>Line 4, the block hash generated by the transaction</li> <li>Line 5, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>Line 6, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field is the id of the contract</li></ul> <p>Let's try calling the contract we just deployed</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>The call is completed and the result is as expected, as explained below by line:</p> <ul><li>The first line calls the contract, here we deploy the contract to the ecosystem with ecosystem id 5, of course, if the current ecosystem id is 5, in the same ecosystem, you can also call <code>callContract SumMath {"A":1, "B":2}</code> in this way</li> <li>Line 3, the block id generated by the transaction</li> <li>Line 4, the block hash generated by the transaction</li> <li>Line 5, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>Line 6, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field is the result of the contract, which is the value of <code>$result</code></li></ul> <h2 id="command-line-tool-eco-development"><a href="#command-line-tool-eco-development" class="header-anchor">#</a> Command Line Tool Eco Development </h2> <p>In this tutorial, you will learn how to:</p> <ul><li>1.<a href="#step-1-create-ecosystem">Create Ecosystem</a></li> <li>2.<a href="#step-2-create-application">Create Application</a></li> <li>3.<a href="#step-3-create-table">Create Table</a></li> <li>4.<a href="#step-4-create-application-parameters">Create Application Parameters</a></li> <li>5.<a href="#step-5-create-contract-deploy-contract">Create & Deploy Contract</a></li> <li>6.<a href="#step-6-create-ecosystem-parameters">Create Ecosystem Parameters</a></li> <li>7.<a href="#step-7-add-localization">Add Localization</a></li> <li>8.<a href="#step-8-modify-the-contract">Modify Contract</a></li> <li>9.<a href="#step-9-modify-data-table-permissions">Modify data table permissions</a></li></ul> <p>In order to understand more clearly how the IBAX ecosystem and applications are like and what they do, it is preferred that we understand where the ecosystem and applications should belong, and we can understand better with a simple mind map: <img src="/ibax-eco.png" alt="image"></p> <p>It can be seen that IBAX networks can have many <a href="/de/concepts/about-the-platform.html#ecolib">Ecosystems</a>. Each ecosystem can have multiple <a href="/de/concepts/about-the-platform.html#applications">applications</a>. Each application has <a href="/de/concepts/thesaurus.html#smart-contract">contract</a>. <a href="/de/concepts/about-the-platform.html#tables">Tables</a>. Ecology has ecosystem parameters, application has application parameters</p> <h3 id="step-1-create-ecosystem"><a href="#step-1-create-ecosystem" class="header-anchor">#</a> Step 1 Create Ecosystem </h3> <p>We start by creating an ecosystem using the <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">command line tool<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>, calling the contract @1NewEcosystem. If you want to change the ecosystem name, you can call the <code>@1EditEcosystemName</code> contract.</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>The following is explained by line:</p> <ul><li>Line 1, which starts the command line console program</li> <li>Line 5, call the contract <code>@1NewEcosystem</code> to create an ecosystem with the name test ecosystem</li> <li>Line 8, the block id generated by the transaction</li> <li>Line 9, the block hash generated by the transaction</li> <li>Line 10, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>Line 11, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field is the id of the ecosystem as <code>18</code></li></ul> <p>Then we configure the command tool <code>config.yml</code>, set <code>ecosystem</code> to the created ecid <code>18</code> and restart the command line console program</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> Step 2 Create Application </h3> <p>Call the contract <code>@1NewApplication</code> to create the application, which has an application name parameter and a modify <a href="/de/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>If you need to modify the application permissions, you can call the <code>EditApplication</code> contract</p> <p>The following is explained by line:</p> <ul><li>Line 1, call the contract @1NewApplication to create an application, the application name is <code>GradesRecorder</code>, the application modification permission is developer permission <code>@1DeveloperCondition</code></li> <li>Line 4, the block id generated by the transaction</li> <li>Line 5, the block hash generated by the transaction</li> <li>Line 6, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>Line 7, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field the id of the application is <code>47</code></li></ul> <p>Let's write a simple example of an application that keeps track of students' grades. The data table fields include student information, grade <code>grade</code>, class <code>class</code>, subject grades <code>mathematics,physics,literature</code>, and Composite score <code>overall_score</code>, rating <code>score</code>, creation timestamp (ms) <code>created_at</code></p> <h3 id="step-3-create-table"><a href="#step-3-create-table" class="header-anchor">#</a> Step 3 Create Table </h3> <p>In the first step we write a contract parameter file in json format:</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>where <code>ApplicationId</code> is the application id,<code>Name</code> is the name of the created data table <code>test_teble</code>. <code>ColumnsArr</code> is an array of data table fields, <code>TypesArr</code> is the type of data table fields, including 9 <a href="/de/concepts/about-the-platform.html#tables">types</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>, the field name and the field type are one-to-one correspondence. <code>InsertPerm</code> for data table new entry permission, <code>UpdatePerm</code> for data table update entry permission, <code>ReadPerm</code> for data table data read permission, <code>NewColumnPerm</code> for new data table field permission Referring to <a href="/de/concepts/about-the-platform.html#access-rights-control-mechanism">Permission Control</a> , here<code>ContractConditions(\"MainCondition\")</code> is available for the current ecosystem creator.</p> <p>We name it createTable.json, and then call the contract to create the data table <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> Modify data table field permissions </h4> <p>We can modify the data table field permissions, data table field permissions include read permissions and update permissions, where read permissions, in the contract using <code>DBFind.Columns</code> filter fields or interfaces such as <a href="/de/reference/api2.html#list-name-limit-offset-columns">list</a> query, if there is no permission, it will report a permission error. The update permission is the permission to update the data table fields. We set the <code>student</code> field read and update permissions to <code>false</code>, but of course it can be set to be operable by some contract. Call the <code>@1EditColumn</code> contract to modify the data table field permissions</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>We can create several application parameters<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>, grade rating type</p> <h3 id="step-4-create-application-parameters"><a href="#step-4-create-application-parameters" class="header-anchor">#</a> Step 4 Create Application Parameters </h3> <p>Call the contract <code>@1NewAppParam</code> to create the application parameters, if you want to modify the application parameters you can call the contract <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>where <code>grade_best_type</code> is the best rating type. <code>grade_type_a+</code> is the condition triggered by the rating <code>A+</code>, when the score is greater than or equal to 90 and less than 101, the rating is<code>A+</code>, other parameters are similar</p> <h3 id="step-5-create-contract-deploy-contract"><a href="#step-5-create-contract-deploy-contract" class="header-anchor">#</a> Step 5 Create Contract Deploy Contract </h3> <p>We create a contract to record the student's grade information and final rating for each subject, and enter the student's grade class and grade for each subject when entering the information. Based on the input scores of each subject, the average calculation is done to get the overall score <code>overallScore</code> and the final rating<code>score</code>. When the contract is called, it will create a record to the data table we just created <code>grade_info</code></p> <p>First we write a contract and name it <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>The following is explained by line:</p> <ul><li>Line 2, <a href="/de/topics/script.html#data-section">data section</a> defines the input parameters <code>Student</code> student name, <code>Grade</code> grade, <code>Class</code> class, <code>Mathematics</code> math score, <code>Physics</code>Physics score,<code>Literature</code>Literature score</li> <li>Line 10, the getScore function, produces a composite score and final rating based on each subject's score</li> <li>Line 30, safeJsonDecode function, json decode the string and convert to map</li> <li>Line 38, <a href="/de/topics/script.html#conditions-section">conditional section</a></li> <li>Line 39, <a href="/de/topics/script.html#action-section">operation section</a></li></ul> <p>As you can see, when the contract is called, it first goes through the conditional part, verifying that the contract input parameters are valid, such as whether the student name <code>if Size($Student) == 0 {</code> is empty (line 39), and if it is, then an error message is returned <code>"Student Can not be empty"</code> (line 30), after all input parameters have been verified, on line 61, use <a href="/de/topics/script.html#dbfind">DBFind</a> to retrieve the information from the database for the application with the ecid <code>18</code> and the application name <code>GradesRecorder</code> and the application information with <code>deleted=0</code> is not deleted. Lines 69-74, use <a href="/de/topics/script.html#appparam">AppParam</a> to retrieve the application parameters, e.g. <code>$gradeBestType = AppParam(app_id, "grade_best_type", $ eId)</code> (line 69). If the application parameter is stored in json format, such as <code>grade_type_a</code>, you can refer to <code>$gradeTypeABest = safeJsonDecode(AppParam(app_id, "grade_type_a+", $eId))</code>, which will get the application parameter by safeJsonDecode function to map format</p> <p>Then execute to the operation part, call the getScore function to get the resulting composite score and final rating (line 10), use map to store, line 79, define a map to store student achievement information, and <a href="/de/topics/script.html#dbinsert">DBInsert</a> Insert data to data table<code>@18grade_info</code>.</p> <p>There are two ways to create a contract, the first of which is: First we write a contract parameter file in json format:</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>Where <code>ApplicationId</code> is the application id, which needs to be escaped for special characters, and <code>Conditions</code> is the contract modification permission. <code>Value</code> contract source code, which we save as <code>NewRecordParams.json</code>:</p> <p>After writing the contract, we need to deploy the contract by calling 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>The following is explained by line:</p> <ul><li>Line 1: call contract <code>@1NewContract</code> to create the contract, -f uses the file to import the just created file <code>NewRecord.json</code> as the contract parameter</li> <li>Line 3, the block id generated by the transaction</li> <li>Line 4, the block hash generated by the transaction</li> <li>Line 5, if the transaction execution fails (0: no penalty 1: penalty)</li> <li>Line 6, if the transaction execution fails, an error text message is returned, and if the block id is returned, the err field the id of the contract is <code>348</code></li></ul> <p>Second method: The saved contract source file is passed directly into the contract parameters in the parameter format <code>paramsName</code> + <code>-</code> + "file",<code>paramsName-file</code> as follows:</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>Let's try to call the contract we just created</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>The call is complete, and then we check to see if the data table has saved a record</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>You can see that there is already a record in the data table, <code>student</code> tom with an overall rating of 56 and a grade of C</p> <p>The above example is only for study and research purposes, you need to change the relevant parameters according to the actual situation, such as the data table write permission, contract modification permission, etc.</p> <p>For example, if we want to specify that only one person can call this new record contract and no one else can call it, we can set an ecosystem parameter <code>new_record_account</code></p> <h3 id="step-6-create-ecosystem-parameters"><a href="#step-6-create-ecosystem-parameters" class="header-anchor">#</a> Step 6 Create Ecosystem Parameters </h3> <p>Calling the contract <code>@1NewParameter</code> will create the eco-parameter <code>new_record_account</code> in the <code>@1parameters</code> table, if you need to modify the eco-parameter you can call <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>We create an ecosystem parameter <code>new_record_account</code>, set the value to keyId <code>6667782293976713160</code>, modify the permission to<code>ContractConditions("MainCondition")</code> which means the current ecosystem creator can modify When the transaction is executed successfully, the ecosystem parameter id of the "err" field is <code>273</code>.</p> <h3 id="step-7-add-localization"><a href="#step-7-add-localization" class="header-anchor">#</a> Step 7 add localization </h3> <p>You can call the <code>@1NewLangJoint</code> contract to create the localization parameter<code>account_not_access</code>, which will create the parameter in the<code>@1languages</code> table, and you can modify the localization parameter via<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> Step 8 Modify the contract </h3> <p>Next, we need to modify the <code>conditions</code> section of the contract source code by adding the following code to <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>Call to modify the contract @1EditContract, where <code>Id</code> is the contract id, <code>Value</code>: is the contract source 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> Step 9 Modify data table permissions </h4> <p>Here we need to change the insert permission of the data table, the original permission <code>ContractConditions("MainCondition")</code> for the ecreator, and the contract setting <code>new_record_account</code> is not the ecreator. So just change <code>ContractConditions("MainCondition")</code> to specify that the contract can operate on <code>ContractAccess("@18NewRecord")</code>. Call the contract <code>@1EditTable</code> to modify the data table permissions</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>Then call the contract you just modified and create a new record</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>You can see that the localization parameter we just set,<code>account_not_access</code>, is working</p> <p>We found that the permission error is reported, the current user does not have permission to operate, we switch to the account with keyId <code>6667782293976713160</code>, we can get the current user's information through the command line tool<code>account info</code> Set up the command line tool config.yml and switch to the account with keyId <code>6667782293976713160</code> After the setup is complete, call the contract again</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>The call completes, querying the data table via <code>getList @18grade_info</code>, and the result is as expected</p> <p>We hope this article has helped you learn more about how the IBAX network works and how to write clear and secure <code>Needle</code> code.</p> <h2 id="deploy-application-using-command-line-tools"><a href="#deploy-application-using-command-line-tools" class="header-anchor">#</a> Deploy application using command line tools </h2> <p>In this tutorial, you will learn how to:</p> <ul><li><ol><li><a href="#export-application">Export Application</a></li></ol></li> <li><ol start="2"><li><a href="#import-application">Import Application</a></li></ol></li></ul> <p>Before starting this tutorial, you need to have an application of your own and know the concept of ecosystem and application, you can refer to <a href="#getting-started-guide">Getting Started Guide</a> We will import the application on the IBAX blockchain via the <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">command line tool<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>. Exporting an application</p> <h3 id="export-application"><a href="#export-application" class="header-anchor">#</a> Export Application </h3> <p>Call <code>account info</code> to query the current account information, here the login ecid is <code>9</code>, call <code>getList</code> command to query the current ecid which applications</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>We can see that the current ecosystem has 6 applications, we use the<code>export</code> command to export the application with <code>id</code> of <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>The -f parameter here saves the exported application to the <code>data.json</code> file in the current directory. If there is no -f parameter, the application data will be output in the command terminal</p> <p>The <code>export</code> command encapsulates the steps to export an application. You can use the above command to export an application, or use the following steps, as follows: Calling the contract <code>@1ExportNewApp</code> to export a new application will generate a record in the <code>1_buffer_data</code> table for the exported application</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>Call the contract <code>@1Export</code> to export the application, find the selected application in the <code>1_buffer_data</code> table, and export all application resources to the generated json string. The generated json string will be written to the <code>1_binaries</code> table of the current ecosystem</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1Export </code></pre></div><p>Query the data in the <code>1_binaries</code> table with the <code>getList</code> command</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>Get the binary id and hash Call the <code>binaryVerify</code> command to export the binary file</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> Import Application </h3> <p>Use the <code>import</code> command to import an application, with the <code>-f</code> parameter to specify the application file to be imported</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>The <code>import</code> command encapsulates the steps to import an application, you can use the above command to import an application</p> <p>Or use the following steps, which, for ease of study and research, are as follows:</p> <ul><li>Step 1 Calling the contract <code>@1ImportUpload</code> to import a new application will generate a record in the <code>1_buffer_data</code> table for the exported application <code>@1ImportUpload</code> The contract parameter <code>Data</code> is <code>file</code> <a href="/de/topics/vm.html#types">type</a>. Contains the keywords <code>Name</code> file name (string), <code>MimeType</code> file type (string), <code>Body</code> ([]byte) file content You need to base64 encode the application file data and pass it into <code>Body</code>, you can use the <code>base64Encode</code> command to base64 encode it</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>Step 2 After the call is completed, use the <code>getList</code> command to query the data in the <code>1_buffer_data</code> table</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>Step 3 Assemble the data in value.data->Data into a one-dimensional array, [a,b,c,d]. Then create a contract parameters file <code>importParams.json</code>, with the following content:</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>Step 4 Call the contract <code>@1Import</code> to import the application data</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> Ecosystem configuration using command line tool </h2> <p>In this tutorial, you will learn how to:</p> <ol><li><a href="#apply-to-join-the-ecosystem">Apply to join the ecosystem</a></li> <li><a href="#add-ecosystem-members">Add ecosystem members</a></li> <li><a href="#freezing-of-accounts">Freezing of accounts</a></li> <li><a href="#role-management">Role management</a></li> <li><a href="#issuance-of-token">Issuance of Token</a></li> <li><a href="#eco-deduction">Eco Deduction</a></li> <li><a href="#dao-governance-ecosystem">DAO Governance Ecology</a></li></ol> <p>Before starting this tutorial, you need to have an application of your own and know the concept of ecosystem and application, you can refer to <a href="#getting-started-guide">Getting Started Guide</a> We will do the ecosystem configuration on the IBAX blockchain via <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">command line tool<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <h3 id="apply-to-join-the-ecosystem"><a href="#apply-to-join-the-ecosystem" class="header-anchor">#</a> Apply to join the ecosystem </h3> <p>We can call the <code>@1MembershipRequest</code> contract to request to join the ecosystem The following example:</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>request to join the ecosystem with ecosystem id <code>19</code>, the <code>@1MembershipRequest</code> contract makes a restriction on calling the ecosystem, only in the base ecosystem can be called When the application is successful, the target ecosystem manager will receive an application, and only when the application is approved by the ecosystem manager will it be considered as joining the target ecosystem. Of course, if the target ecosystem is public, you can join the target ecosystem directly</p> <h3 id="add-ecosystem-members"><a href="#add-ecosystem-members" class="header-anchor">#</a> Add ecosystem members </h3> <p>When the ecosystem is just created, the ecosystem member is only the ecosystem creator, when you need to invite other members to join, you need to know the public key of the invited person, and then call the contract <code>@1MembershipAdd</code> to add members</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>If the ecosystem is public and allows anyone to join, you can set the ecosystem parameter <code>free_membership</code> = 1, which is not public by default. Once set up, you don't need to be approved to join your ecosystem</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>If you don't set the parameter <code>free_membership</code>, when other members apply to join your ecosystem, you will receive an application notification.</p> <p>Call <code>@1MembershipDecide</code> contract approval application, contract parameters <code>NotificId</code> is the notification id, 'Accept' is the resolution mark, resolution mark <code>1</code> is passed</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><h4 id="freezing-of-accounts"><a href="#freezing-of-accounts" class="header-anchor">#</a> Freezing of accounts </h4> <p>Call <code>@1DeleteMember</code> contract to freeze the account, note that this operation cannot be restored</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> Role management </h3> <ul><li><a href="#new-role-creation">New role creation</a></li> <li><a href="#adding-role-members">Add Role Member</a></li> <li><a href="#delete-role-members">delete role member</a></li> <li><a href="#modify-role-manager">Modify role manager</a></li> <li><a href="#delete-role">delete role</a></li></ul> <h4 id="new-role-creation"><a href="#new-role-creation" class="header-anchor">#</a> New role creation </h4> <p>Call <code>@1RolesCreate</code> contract to create a new role, role name <code>student</code>, type <code>2</code> (1 - Assignable 2 - Elected by vote type 3 - System)</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>The return result contains the role id <code>21</code></p> <h4 id="adding-role-members"><a href="#adding-role-members" class="header-anchor">#</a> Adding Role Members </h4> <p>There are two methods, the first method, the ecosystem member to initiate the application, call the contract <code>@1RolesRequest</code> request to add as a member of the role, where <code>Rid</code> is the role 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>In the second method, the role manager assigns role members, and the role manager calls the contract <code>@1RolesAssign</code> to add members to the role</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> Delete role members </h4> <p>First we see what members a role has, which we can query via getList, as follows:</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>where the <code>where</code> condition <code>ecosystem</code> specifies ecosystem, <code>role->id</code> specifies the role id, and <code>deleted</code>: 0 specifies not deleted. We can see that we have 3 rows, if we want to remove the role with member <code>1273-2644-xxxx-5846-6598</code>, that is, the role with <code>id</code> of <code>21</code>. Administrators can call the contract <code>@1RolesUnassign</code> to remove role members, as follows</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> Modify Role Manager </h4> <p>Let's look at the current ecosystem roles</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>where <code>roles_access</code> is the administrative role for the current role, which is an array and can have more than one. We add an administrative role to the role <code>teacher</code> by calling the <code>@1RolesAccessManager</code> contract, where the contract parameters <code>Action</code> administrative operator (<code>clean</code>, <code>remove</code>, <code>add</code>),<code>Rid</code> the role ID to be managed, <code>ManagerRid</code> the Rid Manager of the role</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> Delete Role </h4> <p>We can call the <code>@1RolesDelete</code> contract to delete roles, where the contract parameters <code>Rid</code> is the ID of the role to be managed and <code>Ops</code> is the operator (<code>D</code> is delete <code>R</code> is restore)</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> Issuance of Token </h3> <ul><li><a href="#create-ecosystem">Create Ecology</a></li> <li><a href="#installing-basic-applications">Installing Basic Applications</a></li> <li><a href="#token-issuance">Token Issuance</a></li></ul> <h4 id="create-ecosystem"><a href="#create-ecosystem" class="header-anchor">#</a> Create Ecology </h4> <p>Create an ecosystem, call <code>@1NewEcosystem</code> contract</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>Then we modify the command line tool configuration to log into this newly created ecosystem: "21"</p> <h4 id="installing-basic-applications"><a href="#installing-basic-applications" class="header-anchor">#</a> Installing Basic Applications </h4> <p>Call the contract to install the base application, as follows:</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>Line 1, install the platform application Line 2, install default role Line 3-4, install the eco-configuration and token issuance application, where the application id <code>5,6</code> can be queried via getList as follows:</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> Token Issuance </h4> <p>Because it is a new ecosystem, you need to set up the token issuance, call <code>@1TeSettings</code> contract to specify the roles that can issue tokens</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>where <code>RoleDeveloper</code> is the current ecosystem role id, which can be obtained through the <code>@1roles</code> data table</p> <p><strong>Token Issuance</strong> Call <code>@1NewToken</code> contract to issue tokens</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>where the contract parameters <code>Symbol</code> is the token symbol, <code>Name</code> is the token name, <code>Amount</code> is the total amount, and <code>Digits</code> is the precision.</p> <p><strong>Token Emission</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>Destroy tokens</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>Default token increment and token destruction is allowed, you can set it off by <code>@1TeChange</code>, where <code>TypeChange</code> is the type (<code>emission</code> increment,<code>withdraw</code> destruction). <code>Value</code> is the on/off status (<code>1</code> on, <code>2</code> off), e.g: <strong>Close Additions</strong> Note: Cannot be turned on after closing</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>Turn off destruction</strong>, if you want to turn on destruction again, just set <code>Value</code> to <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> Eco Deduction </h3> <p>Before setting up eco-deductions, you need to understand the IBAX fee model, which can be found in the <a href="https://github.com/IBAX-io/whitepaper" target="_blank" rel="noopener noreferrer">white paper<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>.</p> <p>We first set the eco-wallet address, call the <code>@1EditParameter</code> contract and modify the eco-parameters</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>where <code>Id</code> is the ecowallet <code>ecosystem_wallet</code> parameter id, which can be queried as follows:</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>The <code>Value</code> value is the address of the ecowallet that will be bound, and the contract generates the gas fee, which is paid by that address. The address must have enough tokens in the current ecosystem and needs to be agreed by the bound address before the modification will be successful</p> <p>Call <code>@1EcoFeeModeManage</code> contract to set up multi-ecosystem deduction, as follows:</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>where the contract parameter fields are defined as follows:</p> <ul><li><code>FollowFuel</code> parameter is a multiple of the follow eco1 rate</li> <li><code>CombustionFlag</code> whether to turn on ecotrade gas fee combustion, 1- no, 2-yes</li> <li><code>CombustionPercent</code> Combustion percentage, only effective when gas fee combustion is turned on, takes values 1 to 100, 0 when not turned on</li> <li><code>VmCostFlag</code> VM cost flag, set direct or proxy payment, 1 - direct payment, 2 - proxy payment</li> <li><code>StorageFlag</code> storage fee flag, set direct payment or proxy payment, 1 - direct payment, 2 - proxy payment</li> <li><code>ExpediteFlag</code> Expedited fee flag, set direct payment or payment on behalf of, 1 - direct payment, 2 - payment on behalf of</li> <li><code>VmCostConversionRate</code> Virtual machine cost conversion rate, 2 decimal places, only in effect for proxy payments, greater than zero</li> <li><code>StorageConversionRate</code> The storage cost conversion rate, 2 decimal places, only in effect for proxy payments, greater than zero</li></ul> <p>If you use the above settings, all transaction fees incurred by users invoking contracts within the ecosystem will be paid by the ecosystem wallet of the current ecosystem setup. All users only need to pay for the gas costs incurred within the ecosystem. Of course you can adjust the cost parameters according to your actual needs</p> <h3 id="dao-governance-ecosystem"><a href="#dao-governance-ecosystem" class="header-anchor">#</a> DAO Governance Ecology </h3> <p>Before modifying to DAO governance ecosystem, you need to ensure that the current ecosystem has issued tokens, and after modifying to DAO governance ecosystem, all proposals of the ecosystem will be voted on by the members of the governance committee. The DAO Governance Board is no longer managed by the eco-developers alone, and the top 50 representatives of the eco-holdings are elected.</p> <p>Call the <code>@1EditControlMode</code> contract to change the eco governance mode to DAO governance mode.</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>where the <code>Value</code> parameter <code>1</code> represents the creator model <code>2</code> represents the DAO governance model</p> <p>We can try to create an application</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>At this point a DAO governance proposal is generated and voted on by the DAO Governance Board before the application is created. A valid proposal requires a 68% approval rate out of 75% of the votes cast. The scope of DAO governance includes:</p> <ol><li>Add, delete and change applications, contracts, pages, code snippets, tabs, menus, application parameters, data tables and fields</li> <li>Modify multilingual</li> <li>DAO and creator model switch</li> <li>Edit ecosystem parameters</li> <li>role, assign remove role members</li> <li>Issue additional destruction currency</li> <li>Modify the platform parameters</li> <li>Modify ecosystem information</li> <li>Modification of delayed contracts</li> <li>Modify the voting template</li></ol> <h2 id="deploy-applications-using-application-packaging-tool"><a href="#deploy-applications-using-application-packaging-tool" class="header-anchor">#</a> Deploy applications using application packaging tool </h2> <p>Before starting this tutorial, you need to download <a href="https://github.com/IBAX-io/app-tool" target="_blank" rel="noopener noreferrer">IBAX Application Packaging Tool<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> , we need to use this tool to package IBAX application.</p> <p>We need to store the application files according to the following directory structure</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>As shown below:</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>The <code>app_params</code> directory stores the application parameters file, named using the parameter name + file format <code>.csv</code>, the content of the file is the parameter value. The <code>contracts</code> directory holds the contracts, in <code>.sim</code> file format, and the contents of the file are the contract source code. The <code>tables</code> directory holds the application data table structure in <code>json</code> file format, as follows:</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> is the datatable field name, <code>conditions</code> is the datatable field permission, and <code>type</code> is the field type.</p> <p>In step 1, we generate a config.json file and save it to the airdrop directory with the following contents:</p> <div class="language-text extra-class"><pre class="language-text"><code>{ "name": "Airdrop", "conditions": "ContractConditions(\"@1MainCondition\")" } </code></pre></div><p>Where <code>name</code> is the name of the application, <code>conditions</code>: is the permission to modify the application, and then save it to the airdrop directory.</p> <p>Step 2, package the application, the following command will generate the application <code>airdrop.json</code> in the current directory, if you modify the contract or application parameters, you need to repackage the application.</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ./app-tool airdrop/ </code></pre></div><p>We can import the application via <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">command line tool<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> as follows: Use the <code>import</code> command to import an application, with the <code>-f</code> parameter to specify the application file to be imported</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>Of course if you have an application, you can also generate the complete directory structure with the following command</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/de/tutorials/tutorial.md" target="_blank" rel="noopener noreferrer">Bearbeiten Sie diese Seite auf 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">Letzte Aktualisierung:</span> <span class="time">6.7.2023, 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev"> ← <a href="/de/tutorials/app_tutorial.html" class="prev"> Tutorial für die Anwendungsentwicklung {#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/30.6741f348.js" defer></script> </body> </html>