Tutorial para desarrolladores de redes IBAX </a></li><li><a href="/es/tutorials/tutorial.html" aria-current="page" class="active sidebar-link">Tutorial para desarrolladores de redes IBAX </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#getting-started-guide" class="sidebar-link">Guía de inicio </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#deployment" class="sidebar-link">Despliegue </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#advanced-guide" class="sidebar-link">Guía avanzada </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#deploy-first-smart-contract-via-command-line-tool" class="sidebar-link">Para implementar el primer contrato inteligente a través de la herramienta de línea de comandos: </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#create-application" class="sidebar-link">Crear una aplicación. </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#writing-contracts" class="sidebar-link">Escribir un contrato inteligente. </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#create-contract" class="sidebar-link">Crear un contrato inteligente. </a></li></ul></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#command-line-tool-eco-development" class="sidebar-link">Desarrollo de la ecología de herramientas de línea de comandos. </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-1-create-ecosystem" class="sidebar-link">Paso 1 - Crear un ecosistema </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-2-create-application" class="sidebar-link">Paso 2 - Crear una aplicación </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-3-create-table" class="sidebar-link">Paso 3 - Crear tabla de datos </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-4-create-application-parameters" class="sidebar-link">Paso 4 - Crear parámetros de la aplicación </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-5-create-contract-deploy-contract" class="sidebar-link">Paso 5 - Crear un contrato inteligente y desplegarlo </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-6-create-ecosystem-parameters" class="sidebar-link">Paso 6 - Configuración de los parámetros ecosistema. </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-7-add-localization" class="sidebar-link">Paso 7 - Agregar idioma de localización </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#step-8-modify-the-contract" class="sidebar-link">Paso 8 - Modificar el contrato inteligente </a></li></ul></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#deploy-application-using-command-line-tools" class="sidebar-link">Implementar aplicaciones usando herramientas de línea de comandos </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#export-application" class="sidebar-link">Aplicación de exportación </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#import-application" class="sidebar-link">Importar aplicación. </a></li></ul></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#ecosystem-configuration-using-command-line-tool" class="sidebar-link">Configurar el ecosistema usando herramientas de línea de comandos </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#apply-to-join-the-ecosystem" class="sidebar-link">Solicitar unirse al ecosistema </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#add-ecosystem-members" class="sidebar-link">Agregar miembros al ecosistema </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#freezing-of-accounts" class="sidebar-link">Congelar cuenta </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#role-management" class="sidebar-link">Gestión de roles </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#issuance-of-token" class="sidebar-link">Emisión de tokens ecosistema </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#eco-deduction" class="sidebar-link">Deducción de tarifas ecosistema </a></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#dao-governance-ecosystem" class="sidebar-link">Gobernanza DAO del ecosistema </a></li></ul></li><li class="sidebar-sub-header"><a href="/es/tutorials/tutorial.html#deploy-applications-using-application-packaging-tool" class="sidebar-link">Deploying an application using an application packaging tool </a></li></ul></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="ibax-development-tutorial"><a href="#ibax-development-tutorial" class="header-anchor">#</a> Tutorial para desarrolladores de redes IBAX </h1> <h2 id="getting-started-guide"><a href="#getting-started-guide" class="header-anchor">#</a> Guía de inicio </h2> <ul><li><a href="#deploy-first-smart-contract-via-command-line-tool">Deployar el primer contrato inteligente a través de la herramienta de línea de comandos</a></li> <li><a href="#command-line-tool-eco-development">Desarrollo de la ecología de herramientas de línea de comandos</a></li></ul> <h2 id="deployment"><a href="#deployment" class="header-anchor">#</a> Despliegue </h2> <ul><li><a href="#deploy-application-using-command-line-tools">Deployar aplicación usando herramientas de línea de comandos</a></li> <li><a href="#ecosystem-configuration-using-command-line-tool">Configuración ecológica usando herramientas de línea de comandos</a></li></ul> <h2 id="advanced-guide"><a href="#advanced-guide" class="header-anchor">#</a> Guía avanzada </h2> <ul><li><a href="#deploy-applications-using-application-packaging-tool">Deploying applications using application packaging tools</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> Para implementar el primer contrato inteligente a través de la herramienta de línea de comandos: </h2> <p>Vamos a desplegar un <a href="/es/concepts/thesaurus.html#smart-contract">contrato inteligente</a> en la cadena de bloques IBAX y aprender cómo llamar a un contrato inteligente utilizando la <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">herramienta de línea de comandos<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>. Como nuestro primer contrato inteligente, lo desplegaremos en una <a href="/es/concepts/blockchain-layers.html">red de prueba local</a>. Puedes consultar cómo desplegar una red local en <a href="/es/howtos/deployment.html">Despliegue de red</a>, por lo que no necesitas ningún gasto para desplegarlo y ejecutarlo.</p> <h3 id="create-application"><a href="#create-application" class="header-anchor">#</a> Crear una aplicación. </h3> <p>Invocar el contrato inteligente @1NewApplication para crear una aplicación. Este contrato inteligente tiene un parámetro de nombre de aplicación y un parámetro de modificación de permisos (../concepts/about-the-platform.md#access-rights-control-mechanism).</p> <div class="language-text extra-class"><pre class="language-text"><code>1 $ ibax-cli console 2 3 Welcome to the IBAX console! 4 To exit, press ctrl-d or type exit 5 >callContract @1NewApplication {"Name": "testapp", "Conditions": "ContractConditions(\"@1DeveloperCondition\")"} 6 7 { 8 "block_id": 1217, 9 "hash": "6327161d2202c33c06d34ab4ed9b509c05fc2cbb15cf260c6d3d404a6f640028", 10 "penalty": 0, 11 "err": "31" 12 } </code></pre></div><ul><li>En la primera línea, se inicia la terminal de línea de comandos.</li> <li>En la quinta línea, se llama al contrato inteligente @1NewApplication para crear una aplicación llamada <code>testapp</code>, con permisos de modificación de la aplicación para el desarrollador <code>@1DeveloperCondition</code>.</li> <li>En la octava línea, se muestra el ID del bloque generado por la transacción.</li> <li>En la novena línea, se muestra el hash del bloque generado por la transacción.</li> <li>En la décima línea, se muestra si la transacción falló (0: sin castigo, 1: castigo).</li> <li>En la undécima línea, si la transacción falló, se devuelve un mensaje de texto de error y si se devuelve el ID del bloque, el campo err es el ID de la aplicación.</li></ul> <p>Por supuesto, si desea ver qué campos y tipos de datos tiene este contrato inteligente, puede llamar al método <code>getContractInfo</code>, que devolverá información sobre el contrato inteligente de la siguiente manera:</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>El campo <code>fields</code> es el parámetro de este contrato inteligente, que incluye el nombre del parámetro <code>name</code>, el tipo <code>type</code>, la opción opcional <code>optional</code>, <code>Name</code> y <code>Conditions</code> son campos obligatorios, <code>VotingId</code> es opcional y se puede consultar en el método de API <a href="/es/reference/api2.html#contract-name">contract/name</a>.</p> <h3 id="writing-contracts"><a href="#writing-contracts" class="header-anchor">#</a> Escribir un contrato inteligente. </h3> <p>Usamos <a href="/es/topics/script.html#needle-contract-language">Needle</a> para escribir contratos inteligentes. Implementamos una operación de suma simple. El código fuente del contrato inteligente es el siguiente. Guardamos el contrato inteligente como <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><ul><li>En la primera línea, definimos un contrato inteligente llamado SumMath.</li> <li>En la segunda línea, se encuentra la sección de datos.</li> <li>En las líneas 3 y 4, definimos dos parámetros de entrada de tipo entero de 64 bits llamados <code>A</code> y <code>B</code>.</li> <li>En la línea 6, se encuentra la sección de condiciones.</li> <li>En la línea 9, se encuentra la sección de acciones. Definimos una variable llamada <code>sum</code> para recibir el resultado de la suma de <code>A</code> y <code>B</code>, y luego asignamos el valor de <code>sum</code> a <code>$result</code>, que es el resultado del contrato inteligente. Por supuesto, también podríamos asignar directamente el valor de <code>A+B</code> a <code>$result</code>, pero esto es solo un ejemplo.</li></ul> <h3 id="create-contract"><a href="#create-contract" class="header-anchor">#</a> Crear un contrato inteligente. </h3> <p>Hay dos formas de crear un contrato inteligente, el primer método:</p> <p>El primer paso es escribir un archivo de parámetros de contrato inteligente en formato 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>El <code>ApplicationId</code> es el ID de la aplicación, <code>Value</code> es el código fuente del contrato inteligente y debe escapar los caracteres especiales. <code>Conditions</code> son los permisos de modificación del contrato inteligente.</p> <p>Lo llamaremos <code>SumMathParams.json</code>.</p> <p>El segundo paso es llamar a la creación del contrato inteligente @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>Segunda opción:</p> <p>Enviar directamente el archivo de código fuente del contrato inteligente guardado como parámetro del contrato inteligente, el formato del parámetro es <code>nombre del parámetro</code> + <code>-</code> + "archivo", <code>nombreDelParametro-archivo</code> como se muestra a continuación:</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><ul><li>Línea 1: Se llama al contrato inteligente @1NewContract para crear un contrato inteligente, utilizando el parámetro del contrato inteligente importado desde un archivo con la opción -f.</li> <li>Línea 3: El ID del bloque generado por la transacción.</li> <li>Línea 4: El hash del bloque generado por la transacción.</li> <li>Línea 5: Si la transacción falla (0: sin castigo, 1: castigo).</li> <li>Línea 6: Si la transacción falla, se devuelve un mensaje de error de texto. Si se devuelve un ID de bloque, el campo err es el ID de este contrato inteligente.</li></ul> <p>Intentemos llamar al contrato inteligente que acabamos de implementar.</p> <div class="language- extra-class"><pre class="language-text"><code>1 >callContract @5SumMath {"A":1, "B":2} 2 3 { 4 "block_id": 1239, 5 "hash": "7fa09da0b9f65634119a910f9d91aaf4927208278efd62961499ef7e4f4c8c9c", 6 "penalty": 0, 7 "err": "3" 8 } </code></pre></div><p>La llamada se ha completado y el resultado es el esperado, a continuación se explica línea por línea:</p> <ul><li>En la primera línea se llama al contrato inteligente, aquí hemos desplegado el contrato inteligente en la ecología con el id 5, pero si estamos en la misma ecología con el id 5, también podemos llamarlo así: <code>callContract SumMath {"A":1, "B":2}</code>.</li> <li>En la tercera línea se muestra el id del bloque generado por la transacción.</li> <li>En la cuarta línea se muestra el hash del bloque generado por la transacción.</li> <li>En la quinta línea se muestra si la transacción falló (0: sin penalización, 1: con penalización).</li> <li>En la sexta línea, si la transacción falló, se devuelve un mensaje de error en forma de texto. Si se devuelve un id de bloque, el campo "err" será el resultado del contrato inteligente, es decir, el valor de <code>$result</code>.</li></ul> <h2 id="command-line-tool-eco-development"><a href="#command-line-tool-eco-development" class="header-anchor">#</a> Desarrollo de la ecología de herramientas de línea de comandos. </h2> <p>En este tutorial, aprenderás cómo:</p> <ol><li><a href="#step-1-create-ecosystem">Crear un ecosistema</a></li> <li><a href="#step-2-create-application">Crear una aplicación</a></li> <li><a href="#step-3-create-table">Crear una tabla de datos</a></li> <li><a href="#step-4-create-application-parameters">Crear parámetros de aplicación</a></li> <li><a href="#step-5-create-contract-deploy-contract">Crear y desplegar un contrato inteligente</a></li> <li><a href="#step-6-create-ecosystem-parameters">Crear parámetros ecosistema</a></li> <li><a href="#step-7-add-localization">Agregar localización</a></li> <li><a href="#step-8-modify-the-contract">Modificar el contrato inteligente</a></li> <li><a href="#step-9-modify-data-table-permissions">Modificar los permisos de la tabla de datos</a></li></ol> <p>Para comprender mejor cómo es el ecosistema y las aplicaciones de IBAX, y para qué se utilizan, primero debemos entender a qué parte pertenecen el ecosistema y las aplicaciones. Podemos comprenderlo mejor a través de un simple mapa mental: <img src="/ibax-eco.png" alt="image"></p> <p>Se puede ver que la red IBAX puede tener muchos <a href="/es/concepts/about-the-platform.html#ecolib">ecosistemas</a>, cada ecosistema puede tener múltiples <a href="/es/concepts/about-the-platform.html#applications">aplicaciones</a>, cada aplicación tiene <a href="/es/concepts/thesaurus.html#smart-contract">contratos inteligentes</a>, <a href="/es/concepts/about-the-platform.html#tables">tablas de datos</a>, el ecosistema tiene parámetros de ecosistema, las aplicaciones tienen parámetros de aplicación.</p> <h3 id="step-1-create-ecosystem"><a href="#step-1-create-ecosystem" class="header-anchor">#</a> Paso 1 - Crear un ecosistema </h3> <p>Primero usaremos la herramienta de línea de comandos (https://github.com/IBAX-io/ibax-cli) para crear un ecosistema y llamar al contrato inteligente @1NewEcosystem. Si desea modificar el nombre del ecosistema, puede llamar al contrato inteligente @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><ul><li>En la primera línea, se inicia el programa de consola de línea de comandos.</li> <li>En la quinta línea, se llama al contrato inteligente @1NewEcosystem para crear un ecosistema con el nombre <code>test ecosystem</code>.</li> <li>En la octava línea, se muestra el ID del bloque generado por la transacción.</li> <li>En la novena línea, se muestra el hash del bloque generado por la transacción.</li> <li>En la décima línea, se muestra si la transacción falló (0: sin castigo, 1: castigo).</li> <li>En la undécima línea, si la transacción falló, se devuelve un mensaje de error de texto y si se devuelve el ID del bloque, el campo err es el ID del ecosistema que es <code>18</code>.</li></ul> <p>Luego, configuramos la herramienta de comando <code>config.yml</code>, establecemos <code>ecosystem</code> como el ID del ecosistema creado <code>18</code> y reiniciamos el programa de consola de línea de comandos.</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> Paso 2 - Crear una aplicación </h3> <p>Para llamar al contrato inteligente <code>@1NewApplication</code> para crear una aplicación, el contrato inteligente tiene un parámetro para el nombre de la aplicación y un parámetro para modificar los derechos de acceso.</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 necesitas modificar los permisos de la aplicación, puedes llamar al contrato inteligente <code>EditApplication</code>.</p> <ul><li>En la primera línea, se llama al contrato inteligente @1NewApplication para crear una aplicación llamada <code>GradesRecorder</code>, con permisos de modificación para desarrolladores <code>@1DeveloperCondition</code>.</li> <li>En la cuarta línea, se muestra el ID del bloque generado por la transacción.</li> <li>En la quinta línea, se muestra el hash del bloque generado por la transacción.</li> <li>En la sexta línea, se indica si la transacción falló (0: sin castigo, 1: castigo).</li> <li>En la séptima línea, si la transacción falló, se devuelve un mensaje de error. Si se devuelve un ID de bloque, el campo "err" de la aplicación es <code>47</code>.</li></ul> <p>Vamos a escribir un ejemplo sencillo. Esta aplicación puede registrar las calificaciones de los estudiantes. Los campos de la tabla de datos incluyen información del estudiante, grado <code>grade</code>, clase <code>class</code>, calificaciones en matemáticas, física y literatura <code>mathematics, physics, literature</code>, puntaje general <code>overall_score</code>, calificación <code>score</code>, y una marca de tiempo de creación (en milisegundos) <code>created_at</code>.</p> <h3 id="step-3-create-table"><a href="#step-3-create-table" class="header-anchor">#</a> Paso 3 - Crear tabla de datos </h3> <p>"Primero, escribimos un archivo de parámetros de contrato inteligente en formato 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>El campo <code>ApplicationId</code> es el ID de la aplicación, <code>Name</code> es el nombre de la tabla de datos creada <code>test_table</code>, <code>ColumnsArr</code> es una matriz de campos de la tabla de datos, <code>TypesArr</code> es una matriz de tipos de campos de la tabla de datos, que incluye 9 tipos <a href="/es/concepts/about-the-platform.html#tables">tipos</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>, el nombre del campo y el tipo de campo son una correspondencia uno a uno, <code>InsertPerm</code> es el permiso para crear una entrada en la tabla de datos, <code>UpdatePerm</code> es el permiso para actualizar una entrada en la tabla de datos, <code>ReadPerm</code> es el permiso para leer datos de la tabla de datos, <code>NewColumnPerm</code> es el permiso para crear un nuevo campo en la tabla de datos. Consulte <a href="/es/concepts/about-the-platform.html#access-rights-control-mechanism">Gestión de permisos</a>, aquí <code>ContractConditions(\"MainCondition\")</code> está disponible para el creador del ecosistema actual.</p> <p>Lo llamamos createTable.json y luego llamamos al contrato inteligente para crear la tabla de datos <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> Modificar los permisos de los campos de la tabla de datos. </h4> <p>Podemos modificar los permisos de los campos de la tabla de datos. Los permisos de los campos de la tabla de datos incluyen permisos de lectura y permisos de actualización. Los permisos de lectura, cuando se utilizan <code>DBFind.Columns</code> en el contrato inteligente para filtrar campos o al consultar a través de la interfaz como <a href="https://docs.ibax.io/reference/api2.html#list-name-limit-offset-columns" target="_blank" rel="noopener noreferrer">list<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>, si no se tienen permisos, se producirá un error de permisos. Los permisos de actualización son los permisos para actualizar los campos de la tabla de datos. Establecemos los permisos de lectura y actualización del campo <code>student</code> en <code>false</code>, pero también se pueden establecer para que sean operables por algún contrato inteligente. Llamamos al contrato inteligente <code>@1EditColumn</code> para modificar los permisos de los campos de la tabla de datos.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditColumn <span class="token punctuation">{</span><span class="token string">"TableName"</span><span class="token builtin class-name">:</span> <span class="token string">"grade_info"</span>, <span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"student"</span>, <span class="token string">"UpdatePerm"</span><span class="token builtin class-name">:</span> <span class="token string">"false"</span>, <span class="token string">"ReadPerm"</span><span class="token builtin class-name">:</span> <span class="token string">"false"</span><span class="token punctuation">}</span> </code></pre></div><p>We can create several application parameters <code>grade_best_type</code>, <code>grade_type_a+</code>, <code>grade_type_a</code>, <code>grade_type_b+</code>, <code>grade_type_b</code>, <code>grade_type_c</code>, for grading types.</p> <p>Podemos crear varios parámetros de aplicación <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>, para tipos de calificación.</p> <h3 id="step-4-create-application-parameters"><a href="#step-4-create-application-parameters" class="header-anchor">#</a> Paso 4 - Crear parámetros de la aplicación </h3> <p>Utiliza el contrato inteligente <code>@1NewAppParam</code> para crear los parámetros de la aplicación. Si deseas modificar los parámetros de la aplicación, puedes utilizar el contrato inteligente <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>El parámetro <code>grade_best_type</code> es el tipo de calificación más alta. El parámetro <code>grade_type_a+</code> es la condición que desencadena la calificación <code>A+</code>. Cuando la puntuación es mayor o igual a 90 y menor que 101, se califica como <code>A+</code>. Los demás parámetros son similares.</p> <h3 id="step-5-create-contract-deploy-contract"><a href="#step-5-create-contract-deploy-contract" class="header-anchor">#</a> Paso 5 - Crear un contrato inteligente y desplegarlo </h3> <p>Vamos a crear un contrato inteligente para registrar la información de calificaciones y calificaciones finales de los estudiantes. Al ingresar la información, se ingresan las calificaciones de cada materia y la clase y el grado del estudiante. Se realiza un cálculo promedio de las calificaciones ingresadas para obtener la puntuación general <code>overallScore</code> y la calificación final <code>score</code>. Al llamar al contrato inteligente, se creará un registro en la tabla de datos <code>grade_info</code> que acabamos de crear.</p> <p>Primero, escribiremos un contrato inteligente y lo llamaremos <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><ul><li>En la línea 2, la sección de datos define los parámetros de entrada <code>Student</code> para el nombre del estudiante, <code>Grade</code> para el grado, <code>Class</code> para la clase, <code>Mathematics</code> para la puntuación de matemáticas, <code>Physics</code> para la puntuación de física y <code>Literature</code> para la puntuación de literatura.</li> <li>En la línea 10, la función getScore calcula la puntuación general y la calificación final en función de las puntuaciones de cada materia.</li> <li>En la línea 30, la función safeJsonDecode decodifica una cadena JSON y la convierte en un mapa.</li> <li>En la línea 38, se encuentra la sección de condiciones.</li> <li>En la línea 39, se encuentra la sección de acciones.</li></ul> <p>Puede ver que cuando se llama al contrato inteligente, primero se ejecuta la parte de la condición, verificando si los parámetros de entrada del contrato inteligente son válidos, como el nombre del estudiante <code>if Size($Student) == 0 {</code> si está vacío (línea 39), si está vacío, devuelve un mensaje de error. <code>"Student Can not be empty"</code> (línea 30), cuando se verifican todos los parámetros de entrada, en la línea 61, se utiliza <a href="/es/topics/script.html#dbfind">DBFind</a> para recuperar la información de la aplicación con el id de ecología <code>18</code>, el nombre de la aplicación <code>GradesRecorder</code> y que no ha sido eliminada <code>deleted=0</code> de la base de datos. En las líneas 69-74, se utiliza <a href="/es/topics/script.html#appparam">AppParam</a> para recuperar los parámetros de la aplicación, como <code>$gradeBestType = AppParam(app_id, "grade_best_type", $eId)</code> (línea 69), si los parámetros de la aplicación se almacenan en formato json, como <code>grade_type_a</code>, puede consultar <code>$gradeTypeABest = safeJsonDecode(AppParam(app_id, "grade_type_a+", $eId))</code>, y convertir los parámetros de la aplicación obtenidos en formato de mapa a través de la función safeJsonDecode.</p> <p>Luego, se ejecuta la parte de la operación, se llama a la función getScore para obtener la puntuación general y la calificación final (línea 10), se almacena en un mapa, en la línea 79, se define un mapa para guardar la información de calificaciones de los estudiantes, y se utiliza <a href="/es/topics/script.html#dbinsert">DBInsert</a> para insertar datos en la tabla de datos <code>@18grade_info</code>.</p> <p>Hay dos formas de crear un contrato inteligente, la primera forma:</p> <p>Primero, escribimos un archivo de parámetros de contrato inteligente, el formato del archivo es 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>El <code>ApplicationId</code> es el ID de la aplicación y se requiere procesar los caracteres especiales de escape. Las <code>Conditions</code> son los permisos de modificación del contrato inteligente y <code>Value</code> es el código fuente del contrato inteligente, que se guarda como <code>NewRecordParams.json</code>:</p> <p>Después de escribir el contrato inteligente, necesitamos implementarlo y llamar a la creación del contrato inteligente <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><ul><li>Línea 1: Se llama al contrato inteligente <code>@1NewContract</code> para crear un contrato inteligente, utilizando el parámetro del contrato inteligente importado del archivo <code>NewRecord.json</code> con la opción <code>-f</code>.</li> <li>Línea 3: El ID del bloque generado por la transacción.</li> <li>Línea 4: El hash del bloque generado por la transacción.</li> <li>Línea 5: Si la transacción falla (0: sin castigo, 1: castigo).</li> <li>Línea 6: Si la transacción falla, devuelve un mensaje de error de texto. Si se devuelve el ID del bloque, el campo <code>err</code> del ID del contrato inteligente es <code>348</code>.</li></ul> <p>Segunda opción:</p> <p>Se puede pasar directamente el código fuente del contrato inteligente guardado como parámetro del contrato inteligente, con el formato de parámetro <code>nombreDelParámetro</code> + <code>-</code> + "archivo", <code>nombreDelParámetro-archivo</code> como se muestra a continuación:</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 class="token entity" title="\"">\"</span>)"</span><span class="token punctuation">}</span> </code></pre></div><p>Ok, la traducción en español sería: "Vamos a intentar llamar al contrato inteligente que acabamos de crear.</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>La llamada se completa y luego verificamos si se guarda un registro en la tabla de datos.</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>Puedes ver que ya hay un registro en la tabla de datos, donde el <code>student</code> Tom tiene una puntuación integral de 56 y una calificación de C.</p> <p>El ejemplo anterior es solo para fines de aprendizaje e investigación. Debes modificar los parámetros relevantes de acuerdo con la situación real, como el permiso de escritura de la tabla de datos, el permiso de modificación del contrato inteligente, etc.</p> <p>Por ejemplo, si queremos especificar que solo una persona puede llamar a este contrato inteligente para crear un nuevo registro, y todas las demás personas no pueden llamarlo, podemos establecer un parámetro ecológico <code>new_record_account</code>.</p> <h3 id="step-6-create-ecosystem-parameters"><a href="#step-6-create-ecosystem-parameters" class="header-anchor">#</a> Paso 6 - Configuración de los parámetros ecosistema. </h3> <p>Invocar el contrato inteligente <code>@1NewParameter</code> creará el parámetro ecológico <code>new_record_account</code> en la tabla <code>@1parameters</code>. Si necesita modificar el parámetro ecológico, puede llamar a <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>Hemos creado un parámetro ecológico llamado <code>new_record_account</code>, con un valor de keyId <code>6667782293976713160</code>, y permisos de modificación establecidos en <code>ContractConditions("MainCondition")</code>, lo que significa que solo el creador actual del ecosistema puede modificarlo. Cuando se ejecuta la transacción con éxito, el campo "err" muestra que el id del parámetro ecológico es <code>273</code>.</p> <h3 id="step-7-add-localization"><a href="#step-7-add-localization" class="header-anchor">#</a> Paso 7 - Agregar idioma de localización </h3> <p>You can use the <code>@1NewLangJoint</code> smart contract to create a localized parameter called <code>account_not_access</code>, which will be created in the <code>@1languages</code> table. You can modify the localized parameter using <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> Paso 8 - Modificar el contrato inteligente </h3> <p>Entonces necesitamos modificar el código fuente del contrato en la sección de <code>condiciones</code>, agregando el siguiente código a <code>condiciones</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>Llamando a la modificación del contrato @1EditContract, donde <code>Id</code> es el ID del contrato y <code>Value</code> es el código fuente del contrato.</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> Paso 9 - Modificar los permisos de la tabla de datos </h4> <p>Aquí necesitamos cambiar los permisos de inserción de la tabla de datos. Originalmente, el permiso <code>ContractConditions("MainCondition")</code> era para el creador del ecosistema, pero la configuración del contrato <code>new_record_account</code> no es el creador del ecosistema. Por lo tanto, solo necesitamos cambiar <code>ContractConditions("MainCondition")</code> a <code>ContractAccess("@18NewRecord")</code>, que es el contrato especificado que puede operar. Luego, llamamos al contrato <code>@1EditTable</code> para cambiar los permisos de la tabla de datos.</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>Continúa llamando al contrato modificado recientemente y crea un nuevo registro.</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>Puedo ver que el parámetro de localización que acabamos de establecer, <code>account_not_access</code>, está funcionando.</p> <p>Hemos encontrado un error de permisos, el usuario actual no tiene permisos para operar, así que cambiamos a la cuenta con keyId <code>6667782293976713160</code>. Podemos obtener la información del usuario actual a través de la herramienta de línea de comandos <code>account info</code>. Configuramos el archivo <code>config.yml</code> de la herramienta de línea de comandos para cambiar a la cuenta con keyId <code>6667782293976713160</code>. Después de configurar esto, llamamos al contrato de nuevo.</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>La llamada ha sido completada. Al consultar la tabla de datos a través de <code>getList @18grade_info</code>, los resultados son los esperados.</p> <p>Espero que este artículo le ayude a comprender mejor cómo funciona la red IBAX y cómo escribir un código claro y seguro con <code>Needle</code>.</p> <h2 id="deploy-application-using-command-line-tools"><a href="#deploy-application-using-command-line-tools" class="header-anchor">#</a> Implementar aplicaciones usando herramientas de línea de comandos </h2> <p>En este tutorial, aprenderás cómo:</p> <ul><li><ol><li><a href="#export-application">Exportar una aplicación</a></li></ol></li> <li><ol start="2"><li><a href="#import-application">Importar una aplicación</a></li></ol></li></ul> <p>Antes de comenzar este tutorial, necesitas tener tu propia aplicación y conocer los conceptos de la ecología y la aplicación. Puedes consultar la <a href="#getting-started-guide">Guía de inicio</a> para obtener más información. Utilizaremos la <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">herramienta de línea de comandos<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> para importar y exportar aplicaciones en la cadena de bloques de IBAX.</p> <h3 id="export-application"><a href="#export-application" class="header-anchor">#</a> Aplicación de exportación </h3> <p>Al llamar a <code>account info</code>, se puede consultar la información de la cuenta actual. Aquí, el ID del ecosistema de inicio de sesión es <code>9</code>. Al llamar al comando <code>getList</code>, se puede consultar qué aplicaciones hay en el ecosistema actual.</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>Puedes ver que hay 6 aplicaciones en el ecosistema actual. Usamos el comando <code>export</code> para exportar la aplicación con <code>id</code> 36.</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>Aquí, el parámetro <code>-f</code> guardará la aplicación exportada en un archivo <code>data.json</code> en el directorio actual. Si no se utiliza el parámetro <code>-f</code>, los datos de la aplicación se mostrarán en la terminal de comandos.</p> <p>El comando <code>export</code> encapsula los pasos para exportar una aplicación. Puedes utilizar este comando para exportar una aplicación o seguir los siguientes pasos:</p> <ol><li>Llama al contrato <code>@1ExportNewApp</code> para exportar una nueva aplicación.</li> <li>Se generará un registro de la aplicación exportada en la tabla <code>1_buffer_data</code>.</li></ol> <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>Invocar el contrato <code>@1Export</code> para exportar la aplicación seleccionada, buscarla en la tabla <code>1_buffer_data</code> y exportar todos los recursos de la aplicación en una cadena JSON generada. La cadena JSON generada se escribirá en la tabla <code>1_binaries</code> del ecosistema actual.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1Export </code></pre></div><p><code>getList</code> comando para consultar los datos en la tabla <code>1_binaries</code>.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>getList @1binaries <span class="token parameter variable">-w</span><span class="token operator">=</span><span class="token punctuation">{</span><span class="token string">"name"</span><span class="token builtin class-name">:</span> <span class="token string">"export"</span>, <span class="token string">"account"</span><span class="token builtin class-name">:</span> <span class="token string">"0666-0819-...-7879-5186"</span>, <span class="token string">"ecosystem"</span><span class="token builtin class-name">:</span> <span class="token number">9</span>, <span class="token string">"app_id"</span><span class="token builtin class-name">:</span> <span class="token number">36</span><span class="token punctuation">}</span> <span class="token parameter variable">-l</span><span class="token operator">=</span><span class="token number">1</span> <span class="token parameter variable">-c</span><span class="token operator">=</span><span class="token string">"id,hash"</span> <span class="token punctuation">{</span> <span class="token string">"count"</span><span class="token builtin class-name">:</span> <span class="token number">1</span>, <span class="token string">"list"</span><span class="token builtin class-name">:</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> <span class="token string">"hash"</span><span class="token builtin class-name">:</span> <span class="token string">"8542cb57b77e0ae2c...92c3e05dbbe35ab646789be5b8ba8"</span>, <span class="token string">"id"</span><span class="token builtin class-name">:</span> <span class="token string">"14"</span> <span class="token punctuation">}</span> <span class="token punctuation">]</span> <span class="token punctuation">}</span> </code></pre></div><p>Obtener el ID y el hash del archivo binario. Llamar al comando <code>binaryVerify</code> para exportar el archivo binario.</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> Importar aplicación. </h3> <p>Para importar una aplicación usando el comando <code>import</code>, use el parámetro <code>-f</code> para especificar el archivo de la aplicación que desea importar.</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> ./data.json </code></pre></div><p>El comando <code>import</code> encapsula los pasos para importar una aplicación, y puedes usar el comando anterior para importar una aplicación.</p> <p>Alternativamente, para facilitar el aprendizaje e investigación, puedes seguir los siguientes pasos:</p> <ul><li>Paso 1: Llama al contrato <code>@1ImportUpload</code> para importar una nueva aplicación, lo que generará un registro de la aplicación exportada en la tabla <code>1_buffer_data</code>. El parámetro <code>Data</code> del contrato <code>@1ImportUpload</code> es de tipo <code>file</code>, que incluye las palabras clave <code>Name</code> para el nombre del archivo (cadena), <code>MimeType</code> para el tipo de archivo (cadena) y <code>Body</code> para el contenido del archivo ([]byte). Necesitas codificar los datos del archivo de la aplicación en base64 y pasarlos a <code>Body</code>. Puedes usar el comando <code>base64Encode</code> para codificar 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>Paso 2: Después de llamar a la función, utiliza el comando <code>getList</code> para consultar los datos en la tabla <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>Paso 3: Ensamble los datos de value.data->Data en un arreglo unidimensional, [a,b,c,d], luego cree un archivo de parámetros de contrato llamado <code>importParams.json</code>, con el siguiente contenido:</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>Paso 4: Llame al contrato <code>@1Import</code> para importar los datos de la aplicación.</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> Configurar el ecosistema usando herramientas de línea de comandos </h2> <p>En este tutorial, aprenderás cómo:</p> <ul><li><ol><li><a href="#apply-to-join-the-ecosystem">Solicitar unirse al ecosistema</a></li></ol></li> <li><ol start="2"><li><a href="#add-ecosystem-members">Agregar miembros al ecosistema</a></li></ol></li> <li><ol start="3"><li><a href="#freezing-of-accounts">Congelar cuenta</a></li></ol></li> <li><ol start="4"><li><a href="#role-management">Gestión de roles</a></li></ol></li> <li><ol start="5"><li><a href="#issuance-of-token">Emisión de tokens ecosistema</a></li></ol></li> <li><ol start="6"><li><a href="#eco-deduction">Deducción de tarifas ecosistema</a></li></ol></li> <li><ol start="7"><li><a href="#dao-governance-ecosystem">Gobernanza DAO del ecosistema</a></li></ol></li></ul> <p>Antes de comenzar este tutorial, necesitas tener tu propia aplicación y conocer los conceptos de la ecología y la aplicación. Puedes consultar la <a href="#getting-started-guide">Guía de inicio</a> para obtener más información. Utilizaremos la <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">herramienta de línea de comandos<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> para configurar la ecología en la cadena de bloques de IBAX.</p> <h3 id="apply-to-join-the-ecosystem"><a href="#apply-to-join-the-ecosystem" class="header-anchor">#</a> Solicitar unirse al ecosistema </h3> <p>Podemos llamar al contrato <code>@1MembershipRequest</code> para solicitar la membresía en el ecosistema. Por ejemplo:</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>Solicitud de unirse al ecosistema con ID <code>19</code>, el contrato <code>@1MembershipRequest</code> restringe las llamadas solo al ecosistema base. Una vez que se aprueba la solicitud, el administrador del ecosistema objetivo recibirá una notificación y solo se considerará que se ha unido al ecosistema objetivo después de que el administrador del ecosistema apruebe la solicitud. Si el ecosistema objetivo es público, puedes unirte directamente.</p> <h3 id="add-ecosystem-members"><a href="#add-ecosystem-members" class="header-anchor">#</a> Agregar miembros al ecosistema </h3> <p>Cuando se crea un ecosistema, solo el creador del ecosistema es miembro. Si deseas invitar a otros miembros a unirse, necesitas conocer la clave pública del miembro invitado y luego llamar al contrato <code>@1MembershipAdd</code> para agregar al miembro.</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 la ecología es pública y permite que cualquier persona se una, puedes establecer el parámetro de ecología "free_membership" en 1. Por defecto, la ecología no es pública, pero una vez que se establece este parámetro, cualquier persona puede unirse sin necesidad de aprobación.</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 no has establecido el parámetro <code>free_membership</code>, recibirás una notificación de solicitud cuando otros miembros soliciten unirse a tu ecosistema, que puedes ver en "Ver todas las notificaciones de roles".</p> <p>Llama al contrato <code>@1MembershipDecide</code> para aprobar la solicitud, con el parámetro del contrato <code>NotificId</code> como el ID de la notificación y <code>Accept</code> como la identificación de la decisión, donde <code>1</code> significa aprobado.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1MembershipDecide <span class="token punctuation">{</span><span class="token string">"NotificId"</span><span class="token builtin class-name">:</span> <span class="token number">6</span>, <span class="token string">"Accept"</span><span class="token builtin class-name">:</span> <span class="token number">1</span><span class="token punctuation">}</span> </code></pre></div><h3 id="freezing-of-accounts"><a href="#freezing-of-accounts" class="header-anchor">#</a> Congelar cuenta </h3> <p>Llame al contrato <code>@1DeleteMember</code> para congelar la cuenta. Tenga en cuenta que esta operación no se puede deshacer.</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> Gestión de roles </h3> <ul><li><a href="#new-role-creation">Nueva creación de rol</a></li> <li><a href="#adding-role-members">Agregar miembros al rol</a></li> <li><a href="#delete-role-members">Eliminar miembros del rol</a></li> <li><a href="#modify-role-manager">Modificar el administrador del rol</a></li> <li><a href="#delete-role">Eliminar el rol</a></li></ul> <h4 id="new-role-creation"><a href="#new-role-creation" class="header-anchor">#</a> Nueva creación de rol </h4> <p>Llame al contrato <code>@1RolesCreate</code> para crear un nuevo rol con el nombre <code>estudiante</code> y el tipo <code>2</code> (1-Asignable, 2-Elegido por votación, 3-Sistema).</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>El resultado contiene el ID de rol <code>21</code>.</p> <h4 id="adding-role-members"><a href="#adding-role-members" class="header-anchor">#</a> Agregar miembros al rol </h4> <p>Hay dos métodos, el primer método es que los miembros del ecosistema presenten una solicitud y llamen al contrato <code>@1RolesRequest</code> para solicitar ser agregados como miembros de ese rol, donde <code>Rid</code> es el ID del rol.</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>La segunda opción es que el administrador de roles asigne miembros a un rol. El administrador de roles llama al contrato "@1RolesAssign" para agregar miembros a ese rol.</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> Eliminar miembros del rol </h4> <p>Primero, vamos a ver qué miembros tiene un cierto personaje. Podemos hacerlo mediante la consulta getList, como se muestra a continuación:</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>En la cláusula <code>where</code>, <code>ecosystem</code> especifica el ecosistema, <code>role->id</code> especifica el ID del rol y <code>deleted: 0</code> especifica que no ha sido eliminado. Podemos ver que se han encontrado 3 registros. Si queremos eliminar los permisos del rol para el miembro <code>1273-2644-xxxx-5846-6598</code>, es decir, el rol con <code>id</code> 21, el administrador puede llamar al contrato <code>@1RolesUnassign</code> para eliminar al miembro del rol, como se muestra a continuación:</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> Modificar el administrador del rol </h4> <p>Vamos a echar un vistazo a los roles en el ecosistema actual.</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>En este caso, <code>roles_access</code> es el rol de gestión del rol actual y es una matriz que puede tener varios valores. Para agregar un rol de gestión al rol <code>teacher</code>, se llama al contrato <code>@1RolesAccessManager</code>, donde el parámetro <code>Action</code> es el operador de gestión (<code>clean</code> para limpiar, <code>remove</code> para eliminar, <code>add</code> para agregar), <code>Rid</code> es el ID del rol que se desea gestionar y <code>ManagerRid</code> es el ID del gestor de ese rol.</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> Eliminar el rol </h4> <p>Podemos llamar al contrato <code>@1RolesDelete</code> para eliminar un rol, donde el parámetro del contrato <code>Rid</code> es el ID del rol que se desea administrar, y <code>Ops</code> es el operador (<code>D</code> para eliminar, <code>R</code> para restaurar).</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> Emisión de tokens ecosistema </h3> <ul><li><a href="#create-ecosystem">Crear un ecosistema</a></li> <li><a href="#installing-basic-applications">Instalar aplicaciones básicas</a></li> <li><a href="#token-issuance">Emisión de tokens en el ecosistema</a></li></ul> <h4 id="create-ecosystem"><a href="#create-ecosystem" class="header-anchor">#</a> Crear un ecosistema </h4> <p>Crear un ecosistema, llamando al contrato <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>Entonces, vamos a modificar la configuración de la herramienta de línea de comandos para iniciar sesión en el nuevo ecosistema "21" que acabamos de crear.</p> <h4 id="installing-basic-applications"><a href="#installing-basic-applications" class="header-anchor">#</a> Instalar aplicaciones básicas </h4> <p>Invocar la instalación de una aplicación básica en un contrato inteligente, como se muestra a continuación:</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><ul><li>Primera línea, instalar la aplicación de plataforma.</li> <li>Segunda línea, instalar el rol predeterminado.</li> <li>Tercera y cuarta línea, instalar la configuración ecológica y la aplicación de emisión de tokens, donde la ID de la aplicación "5,6" se puede consultar a través de getList, como se muestra a continuación:</li></ul> <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> Emisión de tokens en el ecosistema </h4> <p>Debido a que es un ecosistema recién establecido, es necesario configurar la emisión de tokens. Llama al contrato <code>@1TeSettings</code> para especificar el rol que puede emitir tokens.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeSettings <span class="token punctuation">{</span><span class="token string">"RoleDeveloper"</span><span class="token builtin class-name">:</span> <span class="token number">30</span><span class="token punctuation">}</span> </code></pre></div><p><code>RoleDeveloper</code> es el ID del rol actual en el ecosistema, que se puede obtener a través de la tabla de datos "@1roles".</p> <p><strong>Emisión de tokens</strong></p> <p>Llame al contrato <code>@1NewToken</code> para emitir tokens.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1NewToken <span class="token punctuation">{</span><span class="token string">"Symbol"</span><span class="token builtin class-name">:</span> <span class="token string">"TEST"</span>, <span class="token string">"Name"</span><span class="token builtin class-name">:</span> <span class="token string">"TEST Coin"</span>, <span class="token string">"Amount"</span><span class="token builtin class-name">:</span> <span class="token string">"10000000000000000"</span> ,<span class="token string">"Digits"</span><span class="token builtin class-name">:</span> <span class="token string">"12"</span><span class="token punctuation">}</span> </code></pre></div><p>Los parámetros del contrato <code>Symbol</code> representan el símbolo del token, <code>Name</code> representa el nombre del token, <code>Amount</code> representa la cantidad total y <code>Digits</code> representa la precisión.</p> <p><strong>Incrementar la emisión de tokens</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>Destrucción de tokens</strong></p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1TeBurn <span class="token punctuation">{</span><span class="token string">"Amount"</span><span class="token builtin class-name">:</span> <span class="token number">1000000000000</span><span class="token punctuation">}</span> </code></pre></div><p>La emisión y la destrucción de tokens son permitidas por defecto, pero puedes desactivarlas a través de <code>@1TeChange</code>. <code>TypeChange</code> indica el tipo de cambio (<code>emission</code> para emisión y <code>withdraw</code> para destrucción) y <code>Value</code> indica el estado del cambio (<code>1</code> para activar y <code>2</code> para desactivar). Por ejemplo: <strong>Desactivar la emisión</strong>. Ten en cuenta que una vez desactivado, no se puede volver a activar.</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>Desactivar y destruir</strong></p> <p>Si desea volver a activar la función de destrucción, simplemente establezca el valor de "Value" en "1".</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> Deducción de tarifas ecosistema </h3> <p>Antes de configurar el ecosistema para la deducción de tarifas de gas por parte de los miembros, es necesario comprender el modelo de tarifas de IBAX, que se puede encontrar en el <a href="https://github.com/IBAX-io/whitepaper" target="_blank" rel="noopener noreferrer">libro blanco<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>Primero establecemos la dirección de la billetera del ecosistema, llamamos al contrato <code>@1EditParameter</code> y modificamos los parámetros del ecosistema:</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditParameter <span class="token punctuation">{</span><span class="token string">"Id"</span><span class="token builtin class-name">:</span> <span class="token number">334</span>, <span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token string">"1273-2644-xxxx-5846-6598"</span><span class="token punctuation">}</span> </code></pre></div><p><code>Id</code> se refiere al ID del parámetro <code>ecosystem_wallet</code> de la billetera ecológica. Puede consultarlo de la siguiente manera:</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>El valor <code>Value</code> es la dirección de la billetera ecológica que se va a vincular. La tarifa de gas generada por el contrato será pagada por esa dirección. Esta dirección debe tener suficientes tokens en la ecología actual y solo se modificará con el consentimiento de la dirección vinculada.</p> <p>Llamando al contrato <code>@1EcoFeeModeManage</code> para configurar la deducción de tarifas de múltiples ecosistemas, como sigue:</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>Los campos de parámetros del contrato se definen de la siguiente manera:</p> <ul><li><code>FollowFuel</code>: parámetro que multiplica la tasa de la tarifa ecológica 1.</li> <li><code>CombustionFlag</code>: si se habilita la quema de tarifas de gas en transacciones ecológicas, 1-no, 2-sí.</li> <li><code>CombustionPercent</code>: porcentaje de quema, solo efectivo cuando se habilita la quema de tarifas de gas, con valores del 1 al 100. Cuando no está habilitado, es 0.</li> <li><code>VmCostFlag</code>: identificador de costo de máquina virtual, establecido para pago directo o pago por proxy, 1-pago directo, 2-pago por proxy.</li> <li><code>StorageFlag</code>: identificador de costo de almacenamiento, establecido para pago directo o pago por proxy, 1-pago directo, 2-pago por proxy.</li> <li><code>ExpediteFlag</code>: identificador de costo acelerado, establecido para pago directo o pago por proxy, 1-pago directo, 2-pago por proxy.</li> <li><code>VmCostConversionRate</code>: tasa de conversión de costo de máquina virtual, con 2 decimales, solo efectiva para pago por proxy, mayor que cero.</li> <li><code>StorageConversionRate</code>: tasa de conversión de costo de almacenamiento, con 2 decimales, solo efectiva para pago por proxy, mayor que cero.</li></ul> <p>Si utiliza la configuración mencionada anteriormente, todas las tarifas de transacción generadas por los usuarios al llamar a contratos dentro de ese ecosistema serán pagadas por la billetera ecológica configurada actualmente. Todos los usuarios solo necesitan pagar las tarifas de gas generadas dentro de ese ecosistema. Por supuesto, puede ajustar los parámetros de tarifas correspondientes según sea necesario.</p> <h3 id="dao-governance-ecosystem"><a href="#dao-governance-ecosystem" class="header-anchor">#</a> Gobernanza DAO del ecosistema </h3> <p>Antes de cambiar a un ecosistema de gobernanza DAO, es necesario asegurarse de que el ecosistema actual ya haya emitido tokens. Después de cambiar a un ecosistema de gobernanza DAO, todas las propuestas en el ecosistema serán decididas por la votación de los miembros del comité de gobernanza, en lugar de ser administradas por separado por los desarrolladores del ecosistema. Los miembros del comité de gobernanza DAO son elegidos por los 50 principales poseedores de los tokens del ecosistema.</p> <p>Invoca el contrato <code>@1EditControlMode</code> para cambiar el modo de gobernanza ecológica al modo de gobernanza DAO.</p> <div class="language-shell extra-class"><pre class="language-shell"><code><span class="token operator">></span>callContract @1EditControlMode <span class="token punctuation">{</span><span class="token string">"Value"</span><span class="token builtin class-name">:</span> <span class="token number">2</span><span class="token punctuation">}</span> </code></pre></div><p>El parámetro <code>Value</code> con valor <code>1</code> representa el modelo de creador, mientras que <code>2</code> representa el modelo de gobernanza DAO.</p> <p>Podemos intentar crear una aplicación:</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>En este momento se generará una propuesta de gobernanza DAO, que solo se creará después de que sea aprobada por votación por el comité de gobernanza DAO. Se requiere una mayoría del 75% de los votos para que una propuesta sea válida, con una tasa de aprobación del 68%.</p> <p>El alcance de la gobernanza DAO incluye:</p> <ol><li>Agregar, eliminar y modificar aplicaciones, contratos, páginas, fragmentos de código, pestañas, menús, parámetros de aplicación, tablas de datos y campos.</li> <li>Modificar el multilingüismo.</li> <li>Interruptores de modelo DAO y creador.</li> <li>Editar parámetros ecosistema.</li> <li>Roles, asignación y eliminación de miembros de roles.</li> <li>Emitir y destruir monedas.</li> <li>Modificar parámetros de plataforma.</li> <li>Modificar información ecológica.</li> <li>Modificar contratos de retraso.</li> <li>Modificar plantillas de votación.</li></ol> <h2 id="deploy-applications-using-application-packaging-tool"><a href="#deploy-applications-using-application-packaging-tool" class="header-anchor">#</a> Deploying an application using an application packaging tool </h2> <p>Antes de comenzar este tutorial, necesitas descargar la <a href="https://github.com/IBAX-io/app-tool" target="_blank" rel="noopener noreferrer">herramienta de empaquetado de aplicaciones 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>. Necesitamos usar esta herramienta para empaquetar la aplicación IBAX.</p> <p>Necesitamos guardar los archivos de la aplicación en la siguiente estructura de directorios:</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>Como sigue:</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>El directorio <code>app_params</code> contiene archivos de parámetros de aplicación, con el nombre del parámetro seguido del formato de archivo <code>.csv</code>, y el contenido del archivo es el valor del parámetro. El directorio <code>contracts</code> contiene contratos en formato de archivo <code>.sim</code>, y el contenido del archivo es el código fuente del contrato. El directorio <code>tables</code> contiene la estructura de la tabla de datos de la aplicación en formato de archivo <code>json</code>, como se muestra a continuación:</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> es el nombre del campo de la tabla de datos, <code>conditions</code> son los permisos del campo de la tabla de datos, <code>type</code> es el tipo de campo.</p> <p>En el primer paso, generamos un archivo config.json y lo guardamos en el directorio airdrop. El contenido del archivo es el siguiente:</p> <div class="language-text extra-class"><pre class="language-text"><code>{ "name": "Airdrop", "conditions": "ContractConditions(\"@1MainCondition\")" } </code></pre></div><p>En primer lugar, <code>name</code> es el nombre de la aplicación y <code>conditions</code> son los permisos para modificar la aplicación. Luego, se guarda en el directorio <code>airdrop</code>.</p> <p>En el segundo paso, se empaqueta la aplicación y se genera el archivo <code>airdrop.json</code> en el directorio actual. Si se modifican los parámetros de la aplicación o el contrato, es necesario volver a empaquetar la aplicación.</p> <div class="language-shell extra-class"><pre class="language-shell"><code>$ ./app-tool airdrop/ </code></pre></div><p>Podemos importar una aplicación a través de la <a href="https://github.com/IBAX-io/ibax-cli" target="_blank" rel="noopener noreferrer">herramienta de línea de comandos<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>, como se muestra a continuación:</p> <p>Usando el comando <code>import</code>, importe la aplicación y el parámetro <code>-f</code> especifica el archivo de la aplicación a importar.</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>Por supuesto, si tienes una aplicación, también puedes generar la estructura completa del directorio con el siguiente comando.</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/es/tutorials/tutorial.md" target="_blank" rel="noopener noreferrer">Edita esta página en 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">Última actualización:</span> <span class="time">6/7/2023, 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev"> ← <a href="/es/tutorials/app_tutorial.html" class="prev"> Tutorial de desarrollo de aplicaciones {#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/48.f59df2d3.js" defer></script> </body> </html>