Estructuras de datos

Resumen

Manipular grandes cantidades de datos en un contrato inteligente puede volverse un problema si debemos realizar operaciones complejas con los mismos. Tanto los Array como los Mapping de Solidity nos serán muy útiles, pero sus funcionalidades pueden quedar algo limitadas en casos de uso complejos.

Extención de Arrays y Mappings

OpenZeppelin nos ofrece dos utilidades para extender el funcionamiento de los Array y de los Mappings.

Se trata de dos contratos inteligentes que nos permitirán recorrer estas estructuras de datos con más rapidez, localizar datos de forma más eficiente, borrarlos o incluso obtener la cantidad de los mismos.

Estos son EnumerableSet.sol y EnumerableMap.sol, tanto para Arrays como para Mappings respectivamente.

Ambos se declaran de forma muy sencilla haciendo la importación correspondiente de la librería.

 contract ExampleEnumerableSet {
     // Importamos la librería
     using EnumerableSet for EnumerableSet.AddressSet;
     
     // Declaramos un Set de datos
     EnumerableSet.AddressSet private mySet;
 }

 contract ExampleEnumerableMap {
     // Importamos la librería
     using EnumerableMap for EnumerableMap.UintToAddressMap;
     
     // Declaramos un Map de datos
     EnumerableMap.UintToAddressMap private myMap;
 }

Al implementar estas librerías, ya no necesitaremos utilizar Array y Mapping. En su lugar, implementaremos estas estructuras de datos que nos aportan grandes funcionalidades adicionales para resolver casos de uso complejos.

Tal vez no sea recomendable utilizar este tipo de librerías si tenemos que resolver casos de uso sencillos como llevar el balance de una cuenta en un Mapping o guardar datos de los usuarios del contrato.

Si al momento de estar desarrollando el contrato detectas que necesitarás realizar operaciones complejas con este tipo de estructuras de datos, es momento de que entre en juego estas utilidades para simplificar nuestro trabajo.

Contribución creada por: Kevin Fiorentino (Platzi contributor).

Dany R

student•

EnumerableSet crea un tipo de “Array dinamico” al que se le llama Set, a este tipo de “Array” se le ha agregado las siguientes propiedades:

Los inputs se pueden agregar (al final de la cadena), eliminar (no importa la posición del elemento) o verificar (si existen) a traves de funciones de la librería EnumerableSet.
A los elementos que ingresan (inputs) se les asigna una nueva numeración (aparte de la numeración que tiene por ser un tipo de Array).

💡 IMPORTANTE!!! Al remover un elemento, el último valor del Set pasa a ocupar la posición del elemento eliminado P.E.

values()  
//Retorna el Set (array) almacenado [10,20,30,40,50]
at(50)
//Retorna 4, ya que es la posicion de 50

remove(20)
//Elimino el elemento 20

values()
//Retorna un nuevo Set (array) [10,50,30,40]
at(50)  
//Retorna 2, la posicion de 50 cambio

EnumerableSet esta definida para trabajar con 3 tipos de variables:

bytes32 → bytes32Set
uint → uintSet
address → addressSet

Las funciones que agrega EnumerableSet son:

add (set, value) → bool // añade el elemento value al array
remove (set, value) → bool // remueve el elemento value del array
contains (set, value) → bool // devuelve v o f si contiene el input
length (set) → uint // devuelve el tamaño del array
at (set, index) → bytes32 , uint, address // devuelve un valor correspondiente al indice, el indice empieza desde cero (0)
values (set) → bytes32[ ] , uint [ ], address[ ] // devuelve el array completo

Para usar EnumerableSet con using_for_ a parte de importar la librería, se debe declarar la un tipo de variable Set de la siguiente forma:

contract Example {
    // Add the library methods
    using EnumerableSet for EnumerableSet.AddressSet;

    // Declare a set state variable
    EnumerableSet.AddressSet private mySet;
}

Ejemplos basicos para usar EnumerableSet y EnumerableMAp AQUI

Bienvenida

Qué es OpenZeppelin

Control de acceso

Propiedad con Ownable

Control de acceso basado en roles

Gestión de demoras con TimelockController

Reto: control de acceso

Tokens

Estándar de tokens ERC20

Estándar de tokens ERC721

Estándar multitoken ERC1155

Extensión de la funcionalidad de los tokens

Reto: tokens

Utilidades

Operaciones matemáticas

Criptografía

Caso de uso: Escrow

Introspección de contratos inteligentes

Estructuras de datos

Reto: utilidades

Conceptos avanzados

Gobernanza y descentralización

Contratos actualizables

Despedida

Continúa aprendiendo

Estructuras de datos