Tutoriel de développement IBAX </a></li><li><a href="/fr/tutorials/tutorial.html" aria-current="page" class="active sidebar-link">Tutoriel de développement IBAX </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#getting-started-guide" class="sidebar-link">Guide de démarrage </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#deployment" class="sidebar-link">Déploiement </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#advanced-guide" class="sidebar-link">Guide Avancé </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#deploy-first-smart-contract-via-command-line-tool" class="sidebar-link">Déployer le premier smart contract via l'outil en ligne de commande </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#create-application" class="sidebar-link">Créer une application </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#writing-contracts" class="sidebar-link">Rédaction de contrats </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#create-contract" class="sidebar-link">Créer un contrat </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#command-line-tool-eco-development" class="sidebar-link">Outil en ligne de commande pour le développement écologique </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-1-create-ecosystem" class="sidebar-link">Étape 1 : Créer un écosystème </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-2-create-application" class="sidebar-link">Étape 2 : Créer une application </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-3-create-table" class="sidebar-link">Étape 3 : Créer une table </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-4-create-application-parameters" class="sidebar-link">Étape 4 : Créer les paramètres de l'application </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-5-create-contract-deploy-contract" class="sidebar-link">Étape 5 : Créer un contrat et le déployer. </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-6-create-ecosystem-parameters" class="sidebar-link">Étape 6 : Créer des paramètres écologiques </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-7-add-localization" class="sidebar-link">Étape 7 : ajouter la localisation </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#step-8-modify-the-contract" class="sidebar-link">Étape 8 Modifier le contrat </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#deploy-application-using-command-line-tools" class="sidebar-link">Déployer une application à l'aide d'outils en ligne de commande </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#export-application" class="sidebar-link">Exporter l'application </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#import-application" class="sidebar-link">Importer l'application </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#ecosystem-configuration-using-command-line-tool" class="sidebar-link">Configuration écologique à l'aide d'un outil en ligne de commande </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#apply-to-join-the-ecosystem" class="sidebar-link">Postuler pour rejoindre l'écosystème{#apply-to-join-the-ecosystem}</a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#add-ecosystem-members" class="sidebar-link">Ajouter des membres de l'écosystème </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#role-management" class="sidebar-link">Gestion des rôles </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#issuance-of-token" class="sidebar-link">Émission de jeton </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#eco-deduction" class="sidebar-link">Déduction de l'écosystème </a></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#dao-governance-ecosystem" class="sidebar-link">Écosystème de gouvernance DAO </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/tutorials/tutorial.html#deploy-applications-using-application-packaging-tool" class="sidebar-link">Déployer des applications à l'aide d'un outil d'emballage d'applications </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> Tutoriel de développement IBAX </h1> <h2 id="getting-started-guide"><a href="#getting-started-guide" class="header-anchor">#</a> Guide de démarrage </h2> <ul><li><a href="#deploy-first-smart-contract-via-command-line-tool">Déployer le premier contrat intelligent via l'outil en ligne de commande</a></li> <li><a href="#command-line-tool-eco-development">Développement de l'écosystème de l'outil en ligne de commande</a></li></ul> <h2 id="deployment"><a href="#deployment" class="header-anchor">#</a> Déploiement </h2> <ul><li><a href="#deploy-application-using-command-line-tools">Déployer une application à l'aide des outils en ligne de commande</a></li> <li><a href="#ecosystem-configuration-using-command-line-tool">Configuration écologique à l'aide de l'outil en ligne de commande</a></li></ul> <h2 id="advanced-guide"><a href="#advanced-guide" class="header-anchor">#</a> Guide Avancé </h2> <ul><li><a href="#deploy-applications-using-application-packaging-tool">Déployer des applications à l'aide de l'outil d'emballage d'application</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> Déployer le premier smart contract via l'outil en ligne de commande </h2> <p>Nous allons déployer des <a href="/fr/concepts/thesaurus.html#smart-contract">smart contracts</a> sur la blockchain IBAX via l'<a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">outil en ligne de commande<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> et apprendre comment invoquer des smart contracts. En tant que premier smart contract, nous l'avons déployé sur le <a href="/fr/concepts/blockchain-layers.html">réseau de test local</a>. Pour savoir comment déployer un réseau local, vous pouvez vous référer à <a href="/fr/howtos/deployment.html">Déploiement du réseau</a>, ainsi vous pouvez le déployer et l'exécuter comme vous le souhaitez sans aucun surcoût.</p> <h3 id="create-application"><a href="#create-application" class="header-anchor">#</a> Créer une application </h3> <p>Appelez le contrat @1NewApplication pour créer l'application, qui a un paramètre de nom d'application et un paramètre de <a href="/fr/concepts/about-the-platform.html#access-rights-control-mechanism">permission de modification</a>.</p> <div class="language-text extra-class"><pre class="language-text"><code>1 $ ibax-cli console 2 3 Bienvenue dans la console IBAX ! 4 Pour quitter, appuyez sur ctrl-d ou tapez 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>Les éléments suivants sont expliqués par ligne :</p> <ul><li>Ligne 1, démarrer le terminal de ligne de commande</li> <li>Ligne 5, appeler le contrat @1NewApplication pour créer une application avec le nom d'application <code>testapp</code> et la permission de modification de l'application <code>@1DeveloperCondition</code> avec la permission du développeur</li> <li>Ligne 8, l'identifiant de bloc généré par la transaction</li> <li>Ligne 9, le hachage de bloc généré par la transaction</li> <li>Ligne 10, si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité)</li> <li>Ligne 11, si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'identifiant de bloc est renvoyé, le champ err est l'identifiant de l'application</li></ul> <p>Bien sûr, si vous souhaitez voir quels champs et types de champs sont disponibles dans ce contrat, vous pouvez appeler la méthode <code>getContractInfo</code>, qui renverra les informations sur le contrat comme suit:</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>Le champ <code>fields</code> est constitué des paramètres du contrat, incluant le nom du paramètre <code>name</code>, <code>type</code>, <code>optional</code>, <code>Name</code> et <code>Conditions</code> sont requis, <code>VotingId</code> est optionnel, consultez la méthode API <a href="/fr/reference/api2.html#contract-name">contract/name</a></p> <h3 id="writing-contracts"><a href="#writing-contracts" class="header-anchor">#</a> Rédaction de contrats </h3> <p>Nous utilisons <a href="/fr/topics/script.html#needle-contract-language">Needle</a> pour écrire un contrat intelligent. Nous implémentons une opération d'addition simple, le code source du contrat est le suivant, nous enregistrons le contrat sous le nom <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>Le suivant est expliqué par ligne :</p> <ul><li>À la ligne 1, nous définissons un contrat avec le nom SumMath.</li> <li>Ligne 2, <a href="/fr/topics/script.html#data-section">Section des données</a>.</li> <li>Aux lignes 3-4, nous définissons deux paramètres de type entier 64 bits en entrée, <code>A</code> et <code>B</code>.</li> <li>Ligne 6, <a href="/fr/topics/script.html#conditions-section">Section conditionnelle</a>.</li> <li>Ligne 9, <a href="/fr/topics/script.html#action-section">Section des opérations</a>. Nous définissons une variable <code>sum</code> pour recevoir le résultat de A+B. Nous assignons la valeur de <code>sum</code> à <code>$result</code>, en tant que résultat du contrat. Bien sûr, il est possible d'assigner directement la valeur de A+B à <code>$result</code>, mais cela peut être montré comme un exemple.</li></ul> <h3 id="create-contract"><a href="#create-contract" class="header-anchor">#</a> Créer un contrat </h3> <p>Il existe deux façons de créer un contrat, dont la première est la suivante : Dans la première étape, nous rédigeons un fichier de paramètres de contrat au format json :</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">31</span><span class="token punctuation">,</span> <span class="token property">"Value"</span><span class="token operator">:</span> <span class="token string">"contract SumMath {\n data {\n A int\n B int\n }\n conditions {\n\n }\n action {\n var sum int\n sum = $A + $B\n $result = sum\n }\n}"</span><span class="token punctuation">,</span> <span class="token property">"Conditions"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"@1DeveloperCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>où <code>ApplicationId</code> est l'identifiant de l'application, <code>Value</code> est le code source du contrat, il est nécessaire d'échapper les caractères spéciaux, <code>Conditions</code> sont les droits de modification du contrat.</p> <p>Nous l'avons nommé SumMathParams.json.</p> <p>La deuxième étape consiste à appeler la création d'un contrat @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>Deuxième méthode : Le fichier source du contrat enregistré est directement transmis aux paramètres du contrat dans le format de paramètre <code>nomParamètre</code> + <code>-</code> + "fichier", <code>nomParamètre-fichier</code> comme suit :</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>Le suivant est expliqué par ligne :</p> <ul><li>Ligne 1 : Appeler le contrat @1NewContract pour créer le contrat, -f utilise le fichier pour importer les paramètres du contrat</li> <li>Ligne 3 : L'identifiant de bloc généré par la transaction</li> <li>Ligne 4 : Le hachage de bloc généré par la transaction</li> <li>Ligne 5 : Si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité)</li> <li>Ligne 6 : Si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'identifiant de bloc est renvoyé, le champ err est l'identifiant du contrat</li></ul> <p>Essayons d'appeler le contrat que nous venons de déployer.</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>L'appel est terminé et le résultat est conforme aux attentes, comme expliqué ci-dessous par ligne :</p> <ul><li>La première ligne appelle le contrat, ici nous déployons le contrat dans l'écosystème avec l'identifiant écologique 5. Bien sûr, si l'identifiant écologique actuel est 5, dans le même écosystème, vous pouvez également appeler <code>callContract SumMath {"A":1, "B":2}</code> de cette manière.</li> <li>Ligne 3, l'identifiant de bloc généré par la transaction.</li> <li>Ligne 4, le hachage de bloc généré par la transaction.</li> <li>Ligne 5, si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité).</li> <li>Ligne 6, si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'identifiant de bloc est renvoyé, le champ err est le résultat du contrat, qui est la valeur de <code>$result</code>.</li></ul> <h2 id="command-line-tool-eco-development"><a href="#command-line-tool-eco-development" class="header-anchor">#</a> Outil en ligne de commande pour le développement écologique </h2> <p>Dans ce tutoriel, vous apprendrez comment :</p> <ul><li><ol><li><a href="#step-1-create-ecosystem">Créer un écosystème</a></li></ol></li> <li><ol start="2"><li><a href="#step-2-create-application">Créer une application</a></li></ol></li> <li><ol start="3"><li><a href="#step-3-create-table">Créer une table</a></li></ol></li> <li><ol start="4"><li><a href="#step-4-create-application-parameters">Créer des paramètres d'application</a></li></ol></li> <li><ol start="5"><li><a href="#step-5-create-contract-deploy-contract">Créer et déployer un contrat</a></li></ol></li> <li><ol start="6"><li><a href="#step-6-create-ecological-parameters">Créer des paramètres écologiques</a></li></ol></li> <li><ol start="7"><li><a href="#step-7-add-localization">Ajouter la localisation</a></li></ol></li> <li><ol start="8"><li><a href="#step-8-modify-the-contract">Modifier le contrat</a></li></ol></li> <li><ol start="9"><li><a href="#step-9-modify-data-table-permissions">Modifier les autorisations de la table de données</a></li></ol></li></ul> <p>Afin de comprendre plus clairement à quoi ressemble l'écosystème et les applications IBAX et ce qu'ils font, il est préférable de comprendre où l'écosystème et les applications devraient appartenir, et nous pouvons mieux comprendre avec une carte mentale simple : <img src="/ibax-eco.png" alt="image"></p> <p>Il est possible de constater que les réseaux IBAX peuvent avoir de nombreux <a href="/fr/concepts/about-the-platform.html#ecolib">Écosystèmes</a>. Chaque écosystème peut avoir plusieurs <a href="/fr/concepts/about-the-platform.html#applications">applications</a>. Chaque application possède un <a href="/fr/concepts/thesaurus.html#smart-contract">contrat</a>. <a href="/fr/concepts/about-the-platform.html#tables">Tables</a>. Chaque écosystème possède des paramètres écologiques, chaque application possède des paramètres d'application.</p> <h3 id="step-1-create-ecosystem"><a href="#step-1-create-ecosystem" class="header-anchor">#</a> Étape 1 : Créer un écosystème </h3> <p>Nous commençons par créer un écosystème en utilisant l'outil en ligne de commande (https://github.com/IBAX-io/ibax-cli), en appelant le contrat @1NewEcosystem. Si vous souhaitez changer le nom de l'écosystème, vous pouvez appeler le contrat @1EditEcosystemName.</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>Les éléments suivants sont expliqués par ligne :</p> <ul><li>Ligne 1, qui lance le programme de console de ligne de commande</li> <li>Ligne 5, appelle le contrat <code>@1NewEcosystem</code> pour créer un écosystème avec le nom "test ecosystem"</li> <li>Ligne 8, l'identifiant de bloc généré par la transaction</li> <li>Ligne 9, le hachage de bloc généré par la transaction</li> <li>Ligne 10, si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité)</li> <li>Ligne 11, si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'identifiant de bloc est renvoyé, le champ d'erreur est l'identifiant de l'écosystème en tant que <code>18</code></li></ul> <p>Ensuite, nous configurons l'outil de commande <code>config.yml</code>, nous définissons <code>ecosystem</code> sur l'ecid créé <code>18</code> et redémarrons le programme de console de ligne de commande:</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> Étape 2 : Créer une application </h3> <p>Appeler le contrat <code>@1NewApplication</code> pour créer l'application, qui a un paramètre de nom d'application et un paramètre de modification <a href="/fr/concepts/about-the-platform.html#access-rights-control-mechanism">Paramètre de Permission</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>Si vous devez modifier les autorisations de l'application, vous pouvez appeler le contrat <code>EditApplication</code>.</p> <p>Ce qui suit est expliqué par ligne :</p> <ul><li>Ligne 1, appelez le contrat @1NewApplication pour créer une application, le nom de l'application est <code>GradesRecorder</code>, la permission de modification de l'application est la permission du développeur <code>@1DeveloperCondition</code>.</li> <li>Ligne 4, l'ID de bloc généré par la transaction.</li> <li>Ligne 5, le hachage de bloc généré par la transaction.</li> <li>Ligne 6, si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité).</li> <li>Ligne 7, si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'ID de bloc est renvoyé, le champ err contient l'ID de l'application qui est <code>47</code>.</li></ul> <p>Écrivons un exemple simple d'une application qui suit les notes des étudiants. Les champs de la table de données comprennent les informations sur l'étudiant, la note <code>grade</code>, la classe <code>class</code>, les notes de matières <code>mathématiques, physique, littérature</code>, le score global <code>overall_score</code>, la note <code>score</code>, le timestamp de création (ms) <code>created_at</code>.</p> <h3 id="step-3-create-table"><a href="#step-3-create-table" class="header-anchor">#</a> Étape 3 : Créer une table </h3> <p>Dans la première étape, nous rédigeons un fichier de paramètres de contrat au format json :</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">47</span><span class="token punctuation">,</span> <span class="token property">"Name"</span><span class="token operator">:</span> <span class="token string">"grade_info"</span><span class="token punctuation">,</span> <span class="token property">"ColumnsArr"</span><span class="token operator">:</span> <span class="token punctuation">[</span> <span class="token string">"student"</span><span class="token punctuation">,</span> <span class="token string">"grade"</span><span class="token punctuation">,</span> <span class="token string">"class"</span><span class="token punctuation">,</span> <span class="token string">"mathematics"</span><span class="token punctuation">,</span> <span class="token string">"physics"</span><span class="token punctuation">,</span> <span class="token string">"literature"</span><span class="token punctuation">,</span> <span class="token string">"overall_score"</span><span class="token punctuation">,</span> <span class="token string">"score"</span><span class="token punctuation">,</span> <span class="token string">"created_at"</span> <span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token property">"TypesArr"</span><span class="token operator">:</span> <span class="token punctuation">[</span> <span class="token string">"varchar"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"number"</span><span class="token punctuation">,</span> <span class="token string">"varchar"</span><span class="token punctuation">,</span> <span class="token string">"number"</span> <span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token property">"InsertPerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span><span class="token punctuation">,</span> <span class="token property">"UpdatePerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span><span class="token punctuation">,</span> <span class="token property">"ReadPerm"</span><span class="token operator">:</span> <span class="token string">"true"</span><span class="token punctuation">,</span> <span class="token property">"NewColumnPerm"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"MainCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>où <code>ApplicationId</code> est l'identifiant de l'application, <code>Name</code> est le nom de la table de données créée <code>test_table</code>. <code>ColumnsArr</code> est un tableau de champs de la table de données, <code>TypesArr</code> est le type des champs de la table de données, comprenant 9 <a href="/fr/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>, le nom du champ et le type de champ sont en correspondance un à un. <code>InsertPerm</code> pour la permission de nouvelle entrée dans la table de données, <code>UpdatePerm</code> pour la permission de mise à jour des entrées de la table de données, <code>ReadPerm</code> pour la permission de lecture des données de la table de données, <code>NewColumnPerm</code> pour la permission de nouveau champ de la table de données.</p> <p>En référence au <a href="/fr/concepts/about-the-platform.html#access-rights-control-mechanism">Contrôle des autorisations</a>, ici <code>ContractConditions(\"MainCondition\")</code> est disponible pour le créateur de l'écosystème actuel.</p> <p>Nous l'appelons createTable.json, puis nous appelons le contrat pour créer la table de données <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> Modifier les autorisations des champs de la table de données </h4> <p>Nous pouvons modifier les autorisations des champs de la table de données. Les autorisations des champs de la table de données comprennent les autorisations de lecture et de mise à jour. Les autorisations de lecture permettent d'utiliser le filtre <code>DBFind.Columns</code> dans le contrat ou des interfaces telles que <a href="/fr/reference/api2.html#list-name-limit-offset-columns">list</a> pour effectuer des requêtes. Si aucune autorisation n'est accordée, une erreur de permission sera signalée. La permission de mise à jour est la permission de modifier les champs de la table de données. Nous avons défini les autorisations de lecture et de mise à jour du champ "student" sur "false", mais bien sûr, elles peuvent être rendues opérationnelles par certains contrats. Appelez le contrat <code>@1EditColumn</code> pour modifier les autorisations des champs de la table de données.</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>Nous pouvons créer plusieurs paramètres d'application : <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>, type de notation des grades.</p> <h3 id="step-4-create-application-parameters"><a href="#step-4-create-application-parameters" class="header-anchor">#</a> Étape 4 : Créer les paramètres de l'application </h3> <p>Appelez le contrat <code>@1NewAppParam</code> pour créer les paramètres de l'application. Si vous souhaitez modifier les paramètres de l'application, vous pouvez appeler le contrat <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>Où <code>grade_best_type</code> est le meilleur type de notation.</p> <p><code>grade_type_a+</code> est la condition déclenchée par la notation <code>A+</code>, lorsque le score est supérieur ou égal à 90 et inférieur à 101, la notation est <code>A+</code>, les autres paramètres sont similaires.</p> <h3 id="step-5-create-contract-deploy-contract"><a href="#step-5-create-contract-deploy-contract" class="header-anchor">#</a> Étape 5 : Créer un contrat et le déployer. </h3> <p>Nous créons un contrat pour enregistrer les informations de notes des étudiants et leur note finale pour chaque matière, et nous saisissons la classe et la note de l'étudiant pour chaque matière lors de la saisie des informations.</p> <p>En fonction des notes saisies pour chaque matière, nous effectuons un calcul de moyenne pour obtenir la note globale <code>overallScore</code> et la note finale <code>score</code>. Lorsque le contrat est appelé, il créera un enregistrement dans la table de données que nous venons de créer <code>grade_info</code>.</p> <p>D'abord, nous écrivons un contrat et le nommons <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>Ce qui suit est expliqué par ligne:</p> <ul><li>Ligne 2, <a href="/fr/topics/script.html#data-section">section des données</a> définit les paramètres d'entrée <code>Student</code> nom de l'étudiant, <code>Grade</code> classe, <code>Class</code> classe, <code>Mathematics</code> score en mathématiques, <code>Physics</code> score en physique, <code>Literature</code> score en littérature.</li> <li>Ligne 10, la fonction getScore, produit un score composite et une note finale basée sur le score de chaque matière.</li> <li>Ligne 30, la fonction safeJsonDecode, décode la chaîne JSON et la convertit en map.</li> <li>Ligne 38, <a href="/fr/topics/script.html#conditions-section">section conditionnelle</a>.</li> <li>Ligne 39, <a href="/fr/topics/script.html#action-section">section des opérations</a>.</li></ul> <p>Comme vous pouvez le voir, lorsque le contrat est appelé, il passe d'abord par la partie conditionnelle, vérifiant que les paramètres d'entrée du contrat sont valides, tels que le nom de l'étudiant <code>if Size($Student) == 0 {</code> est vide (ligne 39), et s'il l'est, un message d'erreur est renvoyé <code>"L'étudiant ne peut pas être vide"</code> (ligne 30). Après avoir vérifié tous les paramètres d'entrée, à la ligne 61, utilisez <a href="/fr/topics/script.html#dbfind">DBFind</a> pour récupérer les informations de la base de données pour l'application avec l'ecid <code>18</code> et le nom de l'application <code>GradesRecorder</code> et les informations de l'application avec <code>deleted=0</code> ne sont pas supprimées.</p> <p>Aux lignes 69-74, utilisez <a href="/fr/topics/script.html#appparam">AppParam</a> pour récupérer les paramètres de l'application, par exemple <code>$gradeBestType = AppParam(app_id, "grade_best_type", $ eId)</code> (ligne 69).</p> <p>Si le paramètre de l'application est stocké au format json, tel que <code>grade_type_a</code>, vous pouvez vous référer à <code>$gradeTypeABest = safeJsonDecode(AppParam(app_id, "grade_type_a+", $eId))</code>, qui obtiendra le paramètre de l'application par la fonction safeJsonDecode au format map.</p> <p>Ensuite, passez à la partie opérationnelle, appelez la fonction getScore pour obtenir le score composite résultant et la note finale (ligne 10), utilisez une map pour stocker, ligne 79, définissez une map pour stocker les informations de réussite de l'étudiant, et <a href="/fr/topics/script.html#dbinsert">DBInsert</a> Insérez les données dans la table de données <code>@18grade_info</code>.</p> <p>Il existe deux façons de créer un contrat, la première consiste à: Tout d'abord, nous écrivons un fichier de paramètres de contrat au format json:</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span> <span class="token property">"ApplicationId"</span><span class="token operator">:</span> <span class="token number">47</span><span class="token punctuation">,</span> <span class="token property">"Value"</span><span class="token operator">:</span> <span class="token string">"contract NewRecord {\n data {\n Student string\n Grade int\n Class int\n Mathematics int\n Physics int\n Literature int\n }\n func getScore(a b c int) map{\n var m map\n var overallScore int\n overallScore = (a+b+c) / 3\n m[\"overallScore\"] = overallScore\n if overallScore >= $gradeTypeABest[\"min\"] && overallScore < $gradeTypeABest[\"max\"] {\n m[\"score\"] = \"A+\"\n }elif overallScore >= $gradeTypeA[\"min\"] && overallScore < $gradeTypeA[\"max\"] {\n m[\"score\"] = \"A\"\n }elif overallScore >= $gradeTypeBBest[\"min\"] && overallScore < $gradeTypeBBest[\"max\"] {\n m[\"score\"] = \"B+\"\n }elif overallScore >= $gradeTypeB[\"min\"] && overallScore < $gradeTypeB[\"max\"] {\n m[\"score\"] = \"B\"\n }elif overallScore >= $gradeTypeC[\"min\"] && overallScore < $gradeTypeC[\"max\"]{\n m[\"score\"] = \"C\"\n }else{\n m[\"score\"] = \"Notset\"\n }\n return m\n }\n func safeJsonDecode(m string) map {\n var res map\n if Size(m) > 0 {\n res = JSONDecode(m)\n }\n return res\n }\n\n conditions {\n if Size($Student) == 0 {\n warning \"Student Can not be empty\"\n }\n if $Class <= 0{\n warning \"Class cannot be less than or equal to zero\"\n }\n if $Grade <= 0{\n warning \"Grade cannot be less than or equal to zero\"\n }\n if $Mathematics < 0 {\n warning \"Mathematics cannot be less than zero\"\n }\n if $Physics < 0 {\n warning \"Physics cannot be less than zero\"\n }\n if $Literature < 0 {\n warning \"Literature cannot be less than zero\"\n }\n if $Mathematics > 100 || $Physics > 100 || $Literature > 100{\n warning \"Score cannot exceed 100\"\n }\n var app map\n app = DBFind(\"@1applications\").Columns(\"id,ecosystem\").Where({\"ecosystem\": 18,\"name\":\"GradesRecorder\",\"deleted\":0}).Row()\n if !app {\n warning LangRes(\"@1app_not_found\")\n }\n\n var app_id int\n app_id = Int(app[\"id\"])\n $eId = Int(app[\"ecosystem\"])\n $gradeBestType = AppParam(app_id, \"grade_best_type\", $eId)\n $gradeTypeABest = safeJsonDecode(AppParam(app_id, \"grade_type_a+\", $eId))\n $gradeTypeA = safeJsonDecode(AppParam(app_id, \"grade_type_a\", $eId))\n $gradeTypeBBest = safeJsonDecode(AppParam(app_id, \"grade_type_b+\", $eId))\n $gradeTypeB = safeJsonDecode(AppParam(app_id, \"grade_type_b\", $eId))\n $gradeTypeC = safeJsonDecode(AppParam(app_id, \"grade_type_c\", $eId))\n }\n action {\n var m map \n m = getScore($Mathematics,$Physics,$Literature)\n var in map\n in[\"student\"] = $Student\n in[\"class\"] = $Class\n in[\"grade\"] = $Grade\n in[\"mathematics\"] = $Mathematics\n in[\"physics\"] = $Physics \n in[\"literature\"] = $Literature \n in[\"overall_score\"] = m[\"overallScore\"]\n in[\"score\"] = m[\"score\"]\n in[\"created_at\"] = $time\n DBInsert(\"@\"+ Str($eId)+\"grade_info\", in)\n }\n}"</span><span class="token punctuation">,</span> <span class="token property">"Conditions"</span><span class="token operator">:</span> <span class="token string">"ContractConditions(\"@1DeveloperCondition\")"</span> <span class="token punctuation">}</span> </code></pre></div><p>Où <code>ApplicationId</code> est l'identifiant de l'application, qui doit être échappé pour les caractères spéciaux, et <code>Conditions</code> est la permission de modification du contrat.</p> <p>Code source du contrat <code>Value</code>, que nous enregistrons sous le nom <code>NewRecordParams.json</code>.</p> <p>Après avoir rédigé le contrat, nous devons le déployer en appelant 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>La ligne suivante est expliquée par ligne :</p> <ul><li>Ligne 1 : appeler le contrat <code>@1NewContract</code> pour créer le contrat, -f utilise le fichier pour importer le fichier <code>NewRecord.json</code> nouvellement créé en tant que paramètre du contrat.</li> <li>Ligne 3 : l'identifiant de bloc généré par la transaction.</li> <li>Ligne 4 : le hachage de bloc généré par la transaction.</li> <li>Ligne 5 : si l'exécution de la transaction échoue (0 : pas de pénalité, 1 : pénalité).</li> <li>Ligne 6 : si l'exécution de la transaction échoue, un message d'erreur est renvoyé, et si l'identifiant de bloc est renvoyé, le champ d'erreur contient l'identifiant du contrat qui est <code>348</code>.</li></ul> <p>Deuxième méthode : Le fichier source du contrat enregistré est directement transmis aux paramètres du contrat dans le format de paramètre <code>nomParamètre</code> + <code>-</code> + "fichier", <code>nomParamètre-fichier</code> comme suit :</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>Essayons d'appeler le contrat que nous venons de créer.</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>Vous pouvez voir qu'il y a déjà un enregistrement dans la table de données, <code>student</code> tom avec une note globale de 56 et une note de C.</p> <p>L'exemple ci-dessus est uniquement à des fins d'étude et de recherche, vous devez modifier les paramètres pertinents en fonction de la situation réelle, tels que la permission d'écriture dans la table de données, la permission de modification de contrat, etc.</p> <p>Par exemple, si nous voulons spécifier qu'une seule personne peut appeler ce nouveau contrat et que personne d'autre ne peut l'appeler, nous pouvons définir un paramètre écologique <code>new_record_account</code>.</p> <h3 id="step-6-create-ecosystem-parameters"><a href="#step-6-create-ecosystem-parameters" class="header-anchor">#</a> Étape 6 : Créer des paramètres écologiques </h3> <p>Appeler le contrat <code>@1NewParameter</code> créera l'éco-paramètre <code>new_record_account</code> dans la table <code>@1parameters</code>. Si vous avez besoin de modifier l'éco-paramètre, vous pouvez appeler <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>Nous créons un paramètre d'écosystème appelé <code>new_record_account</code>, nous définissons la valeur sur la cléId <code>6667782293976713160</code>, nous modifions les permissions pour <code>ContractConditions("MainCondition")</code>, ce qui signifie que le créateur écologique actuel peut modifier. Lorsque la transaction est exécutée avec succès, l'identifiant du paramètre écologique dans le champ "err" est <code>273</code>.</p> <h3 id="step-7-add-localization"><a href="#step-7-add-localization" class="header-anchor">#</a> Étape 7 : ajouter la localisation </h3> <p>Vous pouvez appeler le contrat <code>@1NewLangJoint</code> pour créer le paramètre de localisation <code>account_not_access</code>, qui créera le paramètre dans la table <code>@1languages</code>, et vous pouvez modifier le paramètre de localisation 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> Étape 8 Modifier le contrat </h3> <p>Ensuite, nous devons modifier la section <code>conditions</code> du code source du contrat en ajoutant le code suivant aux <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>Appeler pour modifier le contrat @1EditContract, où <code>Id</code> est l'identifiant du contrat, <code>Value</code> est le code source du contrat.</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> Étape 9 Modifier les autorisations de la table de données </h4> <p>Ici, nous devons modifier l'autorisation d'insertion de la table de données, l'autorisation d'origine <code>ContractConditions("MainCondition")</code> pour l'écréateur, et le paramètre de contrat <code>new_record_account</code> n'est pas l'écréateur.</p> <p>Donc, il suffit de modifier <code>ContractConditions("MainCondition")</code> pour spécifier que le contrat peut opérer sur <code>ContractAccess("@18NewRecord")</code>.</p> <p>Appelez le contrat <code>@1EditTable</code> pour modifier les autorisations de la table de données.</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>Ensuite, appelez le contrat que vous venez de modifier et créez un nouvel enregistrement.</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>Vous pouvez voir que le paramètre de localisation que nous venons de définir, <code>account_not_access</code>, fonctionne.</p> <p>Nous avons constaté que l'erreur de permission est signalée, l'utilisateur actuel n'a pas l'autorisation d'effectuer des opérations. Nous passons au compte avec l'identifiant de clé <code>6667782293976713160</code> et nous pouvons obtenir les informations de l'utilisateur actuel à l'aide de l'outil en ligne de commande <code>account info</code>.</p> <p>Configurez le fichier de configuration de l'outil en ligne de commande config.yml et passez au compte avec l'identifiant de clé <code>6667782293976713160</code>.</p> <p>Une fois la configuration terminée, appelez à nouveau le contrat.</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>L'appel est terminé, interrogeant la table de données via <code>getList @18grade_info</code>, et le résultat est conforme aux attentes.</p> <p>Nous espérons que cet article vous a aidé à en savoir plus sur le fonctionnement du réseau IBAX et sur la façon d'écrire un code <code>Needle</code> clair et sécurisé.</p> <h2 id="deploy-application-using-command-line-tools"><a href="#deploy-application-using-command-line-tools" class="header-anchor">#</a> Déployer une application à l'aide d'outils en ligne de commande </h2> <p>Dans ce tutoriel, vous apprendrez comment :</p> <ul><li><ol><li><a href="#export-application">Exporter une application</a></li></ol></li> <li><ol start="2"><li><a href="#import-application">Importer une application</a></li></ol></li></ul> <p>Avant de commencer ce tutoriel, vous devez avoir votre propre application et connaître le concept d'écosystème et d'application. Vous pouvez vous référer au <a href="#getting-started-guide">Guide de démarrage</a>.</p> <p>Nous importerons l'application sur la blockchain IBAX via l'outil en ligne de commande <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">ibax-cli<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>. Exporter une application.</p> <h3 id="export-application"><a href="#export-application" class="header-anchor">#</a> Exporter l'application </h3> <p>Appeler <code>account info</code> pour interroger les informations du compte actuel, ici le login ecid est <code>9</code>, appeler la commande <code>getList</code> pour interroger les applications associées à l'ecid actuel.</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>Nous pouvons voir que l'écosystème actuel compte 6 applications. Nous utilisons la commande <code>export</code> pour exporter l'application avec l'<code>id</code> de <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>Le paramètre -f ici enregistre l'application exportée dans le fichier <code>data.json</code> dans le répertoire actuel. Si aucun paramètre -f n'est spécifié, les données de l'application seront affichées dans le terminal de commande.</p> <p>La commande <code>export</code> encapsule les étapes pour exporter une application. Vous pouvez utiliser la commande ci-dessus pour exporter une application, ou suivre les étapes suivantes, comme suit :</p> <p>Appeler le contrat <code>@1ExportNewApp</code> pour exporter une nouvelle application générera un enregistrement dans la table <code>1_buffer_data</code> pour l'application exportée.</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>Appelez le contrat <code>@1Export</code> pour exporter l'application, recherchez l'application sélectionnée dans la table <code>1_buffer_data</code>, et exportez toutes les ressources de l'application vers la chaîne JSON générée.</p> <p>La chaîne JSON générée sera écrite dans la table <code>1_binaries</code> de l'écosystème actuel.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1Export </code></pre></div><p>Interrogez les données dans la table <code>1_binaries</code> avec la commande <code>getList</code>.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1binaries <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"export"</span>, <span class="token string">"account"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-0819-...-7879-5186"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">9</span>, <span class="token string">"app_id"</span><span class="token builtin class-name">:</span> <span class="token number">36</span><span class="token punctuation">}</span> <span class="token parameter variable">-l</span><span class="token operator">=</span><span class="token number">1</span> <span class="token parameter variable">-c</span><span class="token operator">=</span><span class="token string">"id,hash"</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"8542cb57b77e0ae2c...92c3e05dbbe35ab646789be5b8ba8"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"14"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>Obtenez l'identifiant binaire et le hachage.</p> <p>Appelez la commande <code>binaryVerify</code> pour exporter le fichier binaire.</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> Importer l'application </h3> <p>Utilisez la commande <code>import</code> pour importer une application, avec le paramètre <code>-f</code> pour spécifier le fichier d'application à importer.</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>Étape 1 : Appeler le contrat <code>@1ImportUpload</code> pour importer une nouvelle application générera un enregistrement dans la table <code>1_buffer_data</code> pour l'application exportée. <code>@1ImportUpload</code> Le paramètre du contrat <code>Data</code> est <code>file</code> <a href="/fr/topics/vm.html#types">type</a>. Il contient les mots-clés <code>Name</code> pour le nom du fichier (chaîne de caractères), <code>MimeType</code> pour le type de fichier (chaîne de caractères), <code>Body</code> pour le contenu du fichier ([]byte). Vous devez encoder en base64 les données du fichier de l'application et les passer dans <code>Body</code>, vous pouvez utiliser la commande <code>base64Encode</code> pour les encoder en base64.</li></ul> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>base64Encode <span class="token parameter variable">-f</span><span class="token operator">=</span>./data.json Encode:ewoJIm5hbWUiOiAid<span class="token punctuation">..</span>.CQkJIlR5cGUiOiAiY29udHJhY3RzIiwKCQkJIk5hbWUiOiAiSGVsbG9Xb3JsZCIsCgkJCSJWYWx1ZSI6<span class="token punctuation">..</span>. <span class="token operator">></span>callContract @1ImportUpload <span class="token punctuation">{</span><span class="token string">"Data"</span><span class="token builtin class-name">:</span> <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"filename"</span>, <span class="token string">"MimeType"</span><span class="token builtin class-name">:</span> <span class="token string">"mimeType"</span>, <span class="token string">"Body"</span><span class="token builtin class-name">:</span> <span class="token string">"ewoJIm5hbWUiOiAid...CQkJIlR5cGUiOiAiY29udHJhY3RzIiwKCQkJIk5hbWUiOiAiSGVsbG9Xb3JsZCIsCgkJCSJWYWx1ZSI6..."</span><span class="token punctuation">}</span><span class="token punctuation">}</span> </code></pre></div><ul><li>Étape 2 : Après que l'appel est terminé, utilisez la commande <code>getList</code> pour interroger les données dans la table <code>1_buffer_data</code>.</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>Étape 3 : Assemblez les données de value.data->Data dans un tableau unidimensionnel, [a,b,c,d]. Ensuite, créez un fichier de paramètres de contrat <code>importParams.json</code>, avec le contenu suivant :</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>Étape 4 : Appelez le contrat <code>@1Import</code> pour importer les données de l'application.</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> Configuration écologique à l'aide d'un outil en ligne de commande </h2> <p>Dans ce tutoriel, vous apprendrez comment :</p> <ul><li><ol><li><a href="#apply-to-join-the-ecosystem">Postuler pour rejoindre l'écosystème</a></li></ol></li> <li><ol start="2"><li><a href="#add-ecosystem-members">Ajouter des membres de l'écosystème</a></li></ol></li> <li><ol start="3"><li><a href="#role-management">Gestion des rôles</a></li></ol></li> <li><ol start="4"><li><a href="#issuance-of-token">Émission de jetons</a></li></ol></li> <li><ol start="5"><li><a href="#eco-deduction">Déduction écologique</a></li></ol></li> <li><ol start="6"><li><a href="#dao-governance-ecosystem">Écosystème de gouvernance DAO</a></li></ol></li></ul> <p>Avant de commencer ce tutoriel, vous devez avoir votre propre application et connaître le concept d'écosystème et d'application. Vous pouvez vous référer au <a href="#getting-started-guide">Guide de démarrage</a>.</p> <p>Nous allons effectuer la configuration écologique sur la blockchain IBAX via l'outil en ligne de commande <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">ibax-cli<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> Postuler pour rejoindre l'écosystème{#apply-to-join-the-ecosystem}</h3> <p>Nous pouvons appeler le contrat <code>@1MembershipRequest</code> pour demander à rejoindre l'écosystème.</p> <p>L'exemple suivant:</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>Demande de rejoindre l'écosystème avec l'identifiant écologique <code>19</code>, le contrat <code>@1MembershipRequest</code> impose une restriction sur l'appel de l'écosystème, seul l'écosystème de base peut être appelé.</p> <p>Lorsque la demande est acceptée, le gestionnaire de l'écosystème cible recevra une demande et elle ne sera considérée comme faisant partie de l'écosystème cible que lorsque la demande sera approuvée par le gestionnaire de l'écosystème.</p> <p>Bien sûr, si l'écosystème cible est public, vous pouvez le rejoindre directement.</p> <h3 id="add-ecosystem-members"><a href="#add-ecosystem-members" class="header-anchor">#</a> Ajouter des membres de l'écosystème </h3> <p>Lorsque l'écosystème vient d'être créé, le seul membre de l'écosystème est le créateur de l'écosystème. Lorsque vous souhaitez inviter d'autres membres à rejoindre, vous devez connaître la clé publique de la personne invitée, puis appeler le contrat <code>@1MembershipAdd</code> pour ajouter des membres.</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>Si l'écosystème est public et permet à n'importe qui de rejoindre, vous pouvez définir le paramètre de l'écosystème <code>free_membership</code> = 1, qui n'est pas public par défaut.</p> <p>Une fois configuré, vous n'avez pas besoin d'être approuvé pour rejoindre votre écosystème.</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>Si vous ne définissez pas le paramètre <code>free_membership</code>, lorsque d'autres membres demandent à rejoindre votre écosystème, vous recevrez une notification de demande.</p> <p>Appelez l'application d'approbation du contrat <code>@1MembershipDecide</code>, les paramètres du contrat <code>NotificId</code> sont l'identifiant de la notification, 'Accept' est la marque de résolution, la marque de résolution <code>1</code> est acceptée.</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> Blocage des comptes </h4> <p>Appeler le contrat <code>@1DeleteMember</code> pour geler le compte, notez que cette opération ne peut pas être restaurée.</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> Gestion des rôles </h3> <ul><li><a href="#new-role-creation">Création d'un nouveau rôle</a></li> <li><a href="#adding-role-members">Ajouter un membre au rôle</a></li> <li><a href="#delete-role-members">Supprimer un membre du rôle</a></li> <li><a href="#modify-role-manager">Modifier le gestionnaire du rôle</a></li> <li><a href="#delete-role">Supprimer le rôle</a></li></ul> <h4 id="new-role-creation"><a href="#new-role-creation" class="header-anchor">#</a> Création d'un nouveau rôle </h4> <p>Appeler le contrat <code>@1RolesCreate</code> pour créer un nouveau rôle, nom du rôle <code>student</code>, type <code>2</code> (1 - Assignable 2 - Élu par vote 3 - Système).</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>Le résultat de retour contient l'identifiant de rôle <code>21</code>.</p> <h4 id="adding-role-members"><a href="#adding-role-members" class="header-anchor">#</a> Ajout de membres de rôle </h4> <p>Il existe deux méthodes, la première méthode consiste à ce que le membre de l'écosystème initie la demande d'application en appelant le contrat <code>@1RolesRequest</code> pour demander à être ajouté en tant que membre du rôle, où <code>Rid</code> est l'identifiant du rôle.</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>Dans la deuxième méthode, le gestionnaire de rôles attribue des membres de rôle, et le gestionnaire de rôles appelle le contrat <code>@1RolesAssign</code> pour ajouter des membres au rôle.</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> Supprimer les membres du rôle </h4> <p>Tout d'abord, nous voyons quels membres un rôle possède, que nous pouvons interroger via getList, comme suit:</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>Où la condition <code>where</code> <code>ecosystem</code> spécifie l'écosystème, <code>role->id</code> spécifie l'identifiant du rôle et <code>deleted</code>: 0 spécifie non supprimé.</p> <p>Nous pouvons voir que nous avons 3 lignes, si nous voulons supprimer le rôle avec le membre <code>1273-2644-xxxx-5846-6598</code>, c'est-à-dire le rôle avec l'<code>id</code> de <code>21</code>.</p> <p>Les administrateurs peuvent appeler le contrat <code>@1RolesUnassign</code> pour supprimer les membres du rôle, comme suit:</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> Modifier le gestionnaire de rôles </h4> <p>Regardons les rôles écologiques actuels :</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>où <code>roles_access</code> est le rôle administratif pour le rôle actuel, qui est un tableau et peut en avoir plusieurs.</p> <p>Nous ajoutons un rôle administratif au rôle <code>teacher</code> en appelant le contrat <code>@1RolesAccessManager</code>, où les paramètres du contrat sont <code>Action</code> l'opérateur administratif (<code>clean</code>, <code>remove</code>, <code>add</code>), <code>Rid</code> l'ID du rôle à gérer, <code>ManagerRid</code> l'ID du gestionnaire de rôle.</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> Supprimer le rôle </h4> <p>Nous pouvons appeler le contrat <code>@1RolesDelete</code> pour supprimer des rôles, où les paramètres du contrat <code>Rid</code> sont l'ID du rôle à gérer et <code>Ops</code> est l'opérateur (<code>D</code> pour supprimer, <code>R</code> pour restaurer).</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> Émission de jeton </h3> <ul><li><a href="#create-ecosystem">Créer un écosystème</a></li> <li><a href="#installing-basic-applications">Installer des applications de base</a></li> <li><a href="#token-issuance">Émission de jetons</a></li></ul> <h4 id="create-ecosystem"><a href="#create-ecosystem" class="header-anchor">#</a> Créer un écosystème </h4> <p>Créez un écosystème, appelez le contrat <code>@1NewEcosystem</code>.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewEcosystem <span class="token punctuation">{</span><span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"Test Ecosystem"</span><span class="token punctuation">}</span> <span class="token punctuation">{</span> <span class="token string">"block_id"</span><span class="token builtin class-name">:</span> <span class="token number">1787</span>, <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"384f35ef93243c9dd4f53b9298873b356b25b31cf7c6a6be7600ee7694d77006"</span>, <span class="token string">"penalty"</span><span class="token builtin class-name">:</span> <span class="token number">0</span>, <span class="token string">"err"</span><span class="token builtin class-name">:</span> <span class="token string">"21"</span> <span class="token punctuation">}</span> </code></pre></div><p>Ensuite, nous modifions la configuration de l'outil en ligne de commande pour se connecter à cet écosystème nouvellement créé : "21".</p> <h4 id="installing-basic-applications"><a href="#installing-basic-applications" class="header-anchor">#</a> Installation des applications de base </h4> <p>Appelez le contrat pour installer l'application de base, comme suit :</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>Ligne 1, installez l'application de plateforme ;</p> <p>Ligne 2, installez le rôle par défaut ;</p> <p>Ligne 3-4, installez l'application de configuration écologique et d'émission de jetons, où l'ID de l'application <code>5,6</code> peut être consulté via getList comme suit :</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> Émission de jetons </h4> <p>Parce qu'il s'agit d'un nouvel écosystème, vous devez configurer l'émission de jetons, appelez le contrat <code>@1TeSettings</code> pour spécifier les rôles pouvant émettre des jetons.</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>Où <code>RoleDeveloper</code> est l'identifiant actuel du rôle écologique, qui peut être obtenu via la table de données <code>@1roles</code>.</p> <p><strong>Émission de jetons</strong> Appeler le contrat <code>@1NewToken</code> pour émettre des jetons.</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>Où les paramètres du contrat <code>Symbol</code> sont le symbole du jeton, <code>Name</code> est le nom du jeton, <code>Amount</code> est le montant total et <code>Digits</code> est la précision.</p> <p><strong>Émission de jetons</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>Détruire les jetons</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>Incrément de jeton par défaut et destruction de jeton sont autorisés, vous pouvez les désactiver en utilisant <code>@1TeChange</code>, où <code>TypeChange</code> est le type (<code>emission</code> pour l'incrément, <code>withdraw</code> pour la destruction).</p> <p><code>Value</code> est l'état activé/désactivé (<code>1</code> activé, <code>2</code> désactivé), par exemple: <strong>Ajouts fermés</strong>.</p> <p>Note: Ne peut pas être activé après la fermeture.</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>Désactiver la destruction</strong>, si vous souhaitez réactiver la destruction, il suffit de définir la valeur de <code>Value</code> sur <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> Déduction de l'écosystème </h3> <p>Avant de mettre en place des déductions écologiques, vous devez comprendre le modèle de frais IBAX, qui peut être trouvé dans le <a href="https://github.com/IBAX-io/whitepaper" target="_blank" rel="noopener noreferrer">livre blanc<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>Nous commençons par définir l'adresse du portefeuille écologique, appelons le contrat <code>@1EditParameter</code> et modifions les paramètres écologiques.</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>Où <code>Id</code> est l'identifiant du paramètre <code>ecosystem_wallet</code> de l'ecowallet, qui peut être interrogé comme suit :</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>La valeur <code>Value</code> est l'adresse de l'ecowallet qui sera liée, et le contrat génère les frais de gaz, qui sont payés par cette adresse. L'adresse doit avoir suffisamment de jetons dans l'écosystème actuel et doit être approuvée par l'adresse liée avant que la modification ne soit réussie.</p> <p>Appeler le contrat <code>@1EcoFeeModeManage</code> pour configurer la déduction multi-écologique, comme suit :</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>Où les champs de paramètres du contrat sont définis comme suit :</p> <ul><li>Le paramètre <code>FollowFuel</code> est un multiple du taux d'éco-suivi 1.</li> <li><code>CombustionFlag</code> indique s'il faut activer la combustion des frais de gaz d'éco-échange, 1 - non, 2 - oui.</li> <li><code>CombustionPercent</code> est le pourcentage de combustion, uniquement valable lorsque la combustion des frais de gaz est activée, prend des valeurs de 1 à 100, 0 lorsque ce n'est pas activé.</li> <li><code>VmCostFlag</code> est le drapeau des coûts de VM, définissant le paiement direct ou par procuration, 1 - paiement direct, 2 - paiement par procuration.</li> <li><code>StorageFlag</code> est le drapeau des frais de stockage, définissant le paiement direct ou par procuration, 1 - paiement direct, 2 - paiement par procuration.</li> <li><code>ExpediteFlag</code> est le drapeau des frais d'expédition accélérée, définissant le paiement direct ou par procuration, 1 - paiement direct, 2 - paiement par procuration.</li> <li><code>VmCostConversionRate</code> est le taux de conversion des coûts de la machine virtuelle, avec 2 décimales, uniquement valable pour les paiements par procuration, supérieur à zéro.</li> <li><code>StorageConversionRate</code> est le taux de conversion des coûts de stockage, avec 2 décimales, uniquement valable pour les paiements par procuration, supérieur à zéro.</li></ul> <p>Si vous utilisez les paramètres ci-dessus, tous les frais de transaction encourus par les utilisateurs invoquant des contrats au sein de l'écosystème seront payés par le portefeuille écologique de la configuration écologique actuelle.</p> <p>Tous les utilisateurs n'ont besoin de payer que les frais de gaz encourus au sein de l'écosystème. Bien sûr, vous pouvez ajuster les paramètres de coût selon vos besoins réels.</p> <h3 id="dao-governance-ecosystem"><a href="#dao-governance-ecosystem" class="header-anchor">#</a> Écosystème de gouvernance DAO </h3> <p>Avant de modifier vers un écosystème de gouvernance DAO, vous devez vous assurer que l'écosystème actuel a émis des jetons, et après la modification vers un écosystème de gouvernance DAO, toutes les propositions de l'écosystème seront soumises au vote des membres du comité de gouvernance.</p> <p>Le Conseil de gouvernance DAO n'est plus géré uniquement par les développeurs de l'écosystème, mais les 50 principaux représentants des détenteurs de l'écosystème sont élus.</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>Où le paramètre <code>Value</code> <code>1</code> représente le modèle du créateur et <code>2</code> représente le modèle de gouvernance DAO.</p> <p>Nous pouvons essayer de créer une 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>À ce stade, une proposition de gouvernance DAO est générée et votée par le Conseil de gouvernance de la DAO avant la création de l'application. Une proposition valide nécessite un taux d'approbation de 68% sur 75% des votes exprimés.</p> <p>Le champ d'application de la gouvernance DAO comprend :</p> <ol><li>Ajouter, supprimer et modifier des applications, des contrats, des pages, des extraits de code, des onglets, des menus, des paramètres d'application, des tables de données et des champs.</li> <li>Modifier le multilingue.</li> <li>Changer le modèle de DAO et de créateur.</li> <li>Modifier les paramètres écologiques.</li> <li>Rôle, assigner ou supprimer des membres de rôle.</li> <li>Émettre une monnaie de destruction supplémentaire.</li> <li>Modifier les paramètres de la plateforme.</li> <li>Modifier les informations écologiques.</li> <li>Modification des contrats différés.</li> <li>Modifier le modèle de vote.</li></ol> <h2 id="deploy-applications-using-application-packaging-tool"><a href="#deploy-applications-using-application-packaging-tool" class="header-anchor">#</a> Déployer des applications à l'aide d'un outil d'emballage d'applications </h2> <p>Avant de commencer ce tutoriel, vous devez télécharger <a href="https://github.com/IBAX-io/app-tool" target="_blank" rel="noopener noreferrer">Outil de conditionnement d'application IBAX<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>. Nous devons utiliser cet outil pour empaqueter l'application IBAX.</p> <p>Nous devons stocker les fichiers de l'application selon la structure de répertoire suivante :</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>Comme indiqué ci-dessous:</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>Le répertoire <code>app_params</code> stocke le fichier des paramètres de l'application, nommé en utilisant le nom du paramètre + le format de fichier <code>.csv</code>, le contenu du fichier étant la valeur du paramètre.</p> <p>Le répertoire <code>contracts</code> contient les contrats, au format de fichier <code>.sim</code>, et le contenu du fichier est le code source du contrat.</p> <p>Le répertoire <code>tables</code> contient la structure de la table de données de l'application au format de fichier <code>json</code>, comme suit:</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> est le nom du champ du tableau de données, <code>conditions</code> est la permission du champ du tableau de données, et <code>type</code> est le type de champ.</p> <p>À l'étape 1, nous générons un fichier config.json et le sauvegardons dans le répertoire airdrop avec le contenu suivant :</p> <div class="language-text extra-class"><pre class="language-text"><code>{ "name": "Airdrop", "conditions": "ContractConditions(\"@1MainCondition\")" } </code></pre></div><p>Là où <code>name</code> est le nom de l'application, <code>conditions</code> : est l'autorisation de modifier l'application, puis l'enregistrer dans le répertoire airdrop.</p> <p>Étape 2, empaquetez l'application, la commande suivante générera l'application <code>airdrop.json</code> dans le répertoire actuel. Si vous modifiez le contrat ou les paramètres de l'application, vous devez reconditionner l'application.</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ./app-tool airdrop/ </code></pre></div><p>Nous pouvons importer l'application via l'outil en ligne de commande <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> comme suit :</p> <p>Utilisez la commande <code>import</code> pour importer une application, avec le paramètre <code>-f</code> pour spécifier le fichier d'application à importer.</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>Bien sûr, si vous avez une application, vous pouvez également générer la structure complète du répertoire avec la commande suivante:</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/fr/tutorials/tutorial.md" target="_blank" rel="noopener noreferrer">Modifier cette page sur 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">Dernière mise à jour:</span> <span class="time">06/07/2023 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev"> ← <a href="/fr/tutorials/app_tutorial.html" class="prev"> Tutoriel pour le développement d'applications {#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/66.6687a523.js" defer></script> </body> </html>