Estructuras de datos en Solidity: Mappings y enums

Clase 6 de 21 • Curso de Introducción a Solidity

Ernesto García

teacher•

Mapas

Los mapas son estructuras de datos de tipo llave-valor, que permiten apuntar un tipo de dato a otro en forma de diccionario.

El tipo de la llave puede ser cualquier tipo de dato elemental, (por ejemplo, uint), y el tipo de dato del valor puede ser cualquier dato elemental o complejo, (se pueden inclusive hacer estructuras multidimensionales)

mapping(<key type> => <value type>) <visibility> <name>;

Enum

Representa una lista de valores posibles creados por el usuario, una variable del tipo de enum declarado sólo puede tomar los valores enumerados.

enum { <value1>, ..., <valueN> }

Adolfo Sebastián Jara Gavilanes

student•

Excelente aporte!! Muchas gracias

Carlos Rodríguez

student•

Grandioso sus aportes profe, como siempre.

Gustavo Aceredo

student•

Seria bueno generarle la cultura a los nuevos programadores para que las clases, variables, enum, contratos no solo sean formato camelcase sino que tambien se escriban en ingles. Por lo demas todo viene excelente

Luis Dotto

student•

Veo que en el video figura la opcion de call, en mi caso no me figura, pero se soluciona haciendo click en el nombre del parametro. Entiendo que se habra actualizado el Remix.

Luis Reynaldo Marino

student•

estoy atrapado en este loop, lo mas parecido a una solucion ha sido esta publicación pero quedo igual porque no comprendo bien a que se refiere con darle click en el nombre del parametro..ayudaa

Luis Alejandro Vera Hernandez

student•

Mapping

Permite almacenar datos asociando una llave:valor mapping (string -> string) countries;


countries['Felipe'] = 'Colombia';
countries['Laura']= 'Ecuador';

countries['Felipe'] // 'Colombia';
countries['Laura'] // 'Ecuador';

Enum types

Las enumeraciones son la forma de crear tipos de datos definidos por el usuario, generalmente se usa para proporcionar nombres para constantes integrales, lo que hace que el contrato sea mejor para el mantenimiento y la lectura. Las enumeraciones restringen la variable con uno de los pocos valores predefinidos

enum <enumerator_name> { 
				element 1, elemenent 2,....,element n
	}

Marcos Kinam Diaz Rodriguez

student•

pragma solidity >=0.7.0 <0.9.0;

contract Saldo {
    
    mapping(address => uint) public balance;
    
    enum Estado { Iniciado, Finalizado }
    
    Estado public estadoDelContrato;
    
    constructor() {
        estadoDelContrato = Estado.Iniciado;
        
        balance[msg.sender] = 1000;
        
        estadoDelContrato = Estado.Finalizado;
    }
    
    
}

Abidan Triguero Calle

student•

RESUMEN CLASE 6: MAPPINGS Y ENUMS

I.- MAPPINGS

Es un tipo de almacenamiento de un valor identificado por una clave la cual puede ser de un tipo de dato diferente. Permite acceder al valor directamente desde su clave sin necesidad de iterar todos los valores almacenados.

II.- ENUM

Representa una serie de valores creados por el usuario, los cuales van a ser representados externamente por un nombre, pero internamente por un valor entero. Son utilizados principalmente para manejar estados dentro de los contratos.

REMIX:

Mappings.sol

// SPDX-License-Identifier: GLP-3.0

pragma solidity >=0.7.0 <0.9.0;

contract Saldo {

    mapping(address => uint) public balance;

    enum Estado { Iniciado, Finalizado }

    Estado public estadoDelContrato;

    constructor() {
        estadoDelContrato = Estado.Iniciado;

        balance[msg.sender] = 1000;

        estadoDelContrato = Estado.Finalizado;
    }

}

Carlos Rodríguez

student•

Gran resumen mi amigo.

Jorge Arribas Castañeyra

student•

array --> lista sin indice mapping --> lista con indice

Rodrigo Ramos Xochiteotzin

student•

Esto es un error. En realidad el array sí es una lista con índices, aquí y en China (en Solidity, como en C, como en Python o JS). El número que pones entre corchetes cuando llamas a un elemento del array corresponde a la posición o al índice que ocupa ese elemento respecto de esa lista. . Por otro lado, el mapping como tal no es una lista. Es más preciso decir que su estructura de datos es un hash map. Éstos no tienen un índice (como sí lo tienen los arrays) para identificar a sus elementos, más bien sus elementos se identifican por una llave que cuyo valor pones entre corchetes cuando lo llamas y te retorna el valor.

Carlos Rodríguez

student•

Los enums tienen una importancia significativa, debido a que nos permiten visualizar el estado del contrato, esto a nivel de desarrollo en blockchain es súper fundamental ya que nos permite saber si el código que escribimos estando ya en la red, funciona como lo planificamos.

Gustavo Carballo Reyes

student•

Hola 😃 Tengo una duda, realmente no entiendo muy bien que es lo que hace el constructor, alguien tendra alguna definicion mas basica o sencilla??

Santiago Leonel Fiebke

student•

Básicamente, inicializa tus variables con el valor que necesites.

Omar Francisco Herrera Ortiz

student•

Es una función en la que se ejecuta código en el momento en el que se "crea" (se hace deploy) el contrato

Normalmente se usa para darle valor a variables que serán utilizadas más adelante, por eso hay muchos de ejemplos donde se declara la variable owner y dentro del constructor se le da el valor

HECTOR BECERRIL MEDINA

student•

Alan Viñals

student•

Los elementos que no le demos valor, solidity le da un valor por defecto.
Cualquier elemento entero que no le hayamos definido un valor, tendrá de valor 0.

Carlos Rodríguez

student•

Excelente esos apuntes, es bueno tenerlo presente.

Jorge Fidel Zubieta Choque

student•

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.7.0 <0.9.0;

contract Saldo {

mapping(address => uint) public balance;
// mapedo donde address es
// unit para valor positivo que represent su balance
// => para separar entre la clave (direccion) y valor ayuda memoria 

enum Estado { Iniciado, Finalizado }
// el enum es el estado de la transccion con 2 estados

Estado public estadoDelContrato;
// para poder simbolizar el estado debemos declarar una variable del tipo estado
// donde almacenaremos el estado actual del contrato de forma TEMPORAL en el momento en que estamos trabajando

constructor() {
    // logica para inicializar  balance y estado

    estadoDelContrato = Estado.Iniciado;
    
        balance[msg.sender] = 1000;
        // declaro un valor inicial para el balance.
        // este actua por mdio de una cuenta debemos enviar el mensaje.
        // sender crea el contrato para setearle un balance inicial en este caso de 1000

    estadoDelContrato = Estado.Finalizado;
}

}

Carlos Rodríguez

student•

Buena.

HECTOR BECERRIL MEDINA

student•

mapping: Es un tipo especial de arreglo llamados arreglos asociativos.

enum: Coleccion ordenada de valores, el primer elemento corresponde con el elemento 0 (cero).

Francisco Javier Candia Mardones

student•

entonces, un mapa es ¿similar a los diccionarios de Python?

VICTOR AHUMADA MATOS

student•

no me esta compilando, no se que error tengo que aun estoy peliando con el codigo para que funcione

Sebastian Perez

teacher•

Hola Victor, fijate que "estado" lo definiste con minúscula, pero "Estado" lo citaste con mayúsculas, por eso el error

Fidel Parabacuto

student•

Hay que practicar y practicar para agarrarle la mano. Les dejo este código comentado de cómo lo entendí yo.

Nota: probablemente me gaste todo el gas si fuera algo real y la lógica no sería la mejor pero tenía que entender cómo funciona todo

// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;

contract TestMappingEnums{
		// Mapping que relaciona direcciones con saldos
    mapping(address => uint) public balance;

		// Enum que define posibles estados del contrato
    enum Estado {Iniciado, Finalizado}

		// Variable que almacena el estado actual del contrato
    Estado public estadoDelContrato;

		
    constructor(){
		// Se establece el estado inicial como "Iniciado"
        estadoDelContrato = Estado.Iniciado;

		// Se asigna un saldo inicial de 0 al remitente (msg.sender)
        balance[msg.sender] = 0;
    }

		// Función para sumar 1000 al saldo del remitente cada vez que se ejecuta
    function sumBlance() public{
        balance[msg.sender] += 1000;        
    }

		// Función para cambiar el estado del contrato a "Finalizado"
    function closeBalance() public{
        estadoDelContrato = Estado.Finalizado;
    }

		// Función para obtener el saldo del remitente
    function getBalance() public view returns(uint){
        return balance[msg.sender];
    }
}

Carlos Villamil

student•

Algo que ayuda mucho y te va ahorrando tiempo es guardar con el control+s que te compila automáticamente :D

pragma solidity >=0.7.0 <0.9.0;

contract Saldo {
    
    mapping(address => uint) public balance;
    
    enum Estado { Iniciado, Finalizado }
    
    Estado public estadoDelContrato;
    
    constructor() {
        estadoDelContrato = Estado.Iniciado;
        
        balance[msg.sender] = 1000;
        
        estadoDelContrato = Estado.Finalizado;
    }
    
}

// SPDX-License-Identifier: GLP-3.0

pragma solidity >=0.7.0 <0.9.0;

contract Saldo {

    mapping(address => uint) public balance;

    enum Estado { Iniciado, Finalizado }

    Estado public estadoDelContrato;

    constructor() {
        estadoDelContrato = Estado.Iniciado;

        balance[msg.sender] = 1000;

        estadoDelContrato = Estado.Finalizado;
    }

}

mapping(address => uint) public balance;
// mapedo donde address es
// unit para valor positivo que represent su balance
// => para separar entre la clave (direccion) y valor ayuda memoria 

enum Estado { Iniciado, Finalizado }
// el enum es el estado de la transccion con 2 estados

Estado public estadoDelContrato;
// para poder simbolizar el estado debemos declarar una variable del tipo estado
// donde almacenaremos el estado actual del contrato de forma TEMPORAL en el momento en que estamos trabajando

constructor() {
    // logica para inicializar  balance y estado

    estadoDelContrato = Estado.Iniciado;
    
        balance[msg.sender] = 1000;
        // declaro un valor inicial para el balance.
        // este actua por mdio de una cuenta debemos enviar el mensaje.
        // sender crea el contrato para setearle un balance inicial en este caso de 1000

    estadoDelContrato = Estado.Finalizado;
} 

// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;

contract TestMappingEnums{
		// Mapping que relaciona direcciones con saldos
    mapping(address => uint) public balance;

		// Enum que define posibles estados del contrato
    enum Estado {Iniciado, Finalizado}

		// Variable que almacena el estado actual del contrato
    Estado public estadoDelContrato;

		
    constructor(){
		// Se establece el estado inicial como "Iniciado"
        estadoDelContrato = Estado.Iniciado;

		// Se asigna un saldo inicial de 0 al remitente (msg.sender)
        balance[msg.sender] = 0;
    }

		// Función para sumar 1000 al saldo del remitente cada vez que se ejecuta
    function sumBlance() public{
        balance[msg.sender] += 1000;        
    }

		// Función para cambiar el estado del contrato a "Finalizado"
    function closeBalance() public{
        estadoDelContrato = Estado.Finalizado;
    }

		// Función para obtener el saldo del remitente
    function getBalance() public view returns(uint){
        return balance[msg.sender];
    }
}

Estructuras de datos en Solidity: Mappings y enums

Por qué debes aprender Solidity

Curso de Solidity: Fundamentos y Desarrollo en Blockchain

Programación en Solidity para Contratos Inteligentes en Blockchain

Introducción a la programación con Solidity

Estructura Básica de Contratos en Solidity

Tipos de datos y variables en Solidity: enteros, booleanos y direcciones

Estructuras y Arrays en Contratos Inteligentes

Estructuras de datos en Solidity: Mappings y enums

Estructuras de control en Solidity

Manejo de Eventos con Solidity

Programación de Funciones en Solidity

Cómo implementar funciones en Solidity

Uso de Modificadores en Solidity

Manejo de errores

Gestionando costos de gas y comisiones

Tipos de almacenamiento

Manejo del gas y comisiones

Transferencias de ether desde un contrato

Recibir ether desde un contrato

Conceptos avanzados de Solidity

Manejo de dependencias y librerías

Uso de la herencia en Solidity

Polimorfismo en contratos inteligentes

Tokens

Application Binary Interface (ABI)

Cómo continuar mi camino desarrollando en Blockchain

Cómo continuar mi camino con Solidity