GameItems.sol

Comenzamos con el identificador de licencia SPDX y la declaración de la versión de Solidity. Estos son requerimientos indispensables en todo contrato Solidity. Usamos MIT como licencia de código abierto y la versión ^0.8.29 del compilador.

Importamos la implementación estándar de ERC1155 desde OpenZeppelin y declaramos nuestro contrato GameItems que hereda de ella. El estándar ERC-1155 nos permite manejar múltiples tipos de tokens (fungibles y no fungibles) en un solo contrato, lo que lo hace mucho más gas-eficiente que desplegar contratos separados para cada tipo de token.

Añadimos un constructor que recibe la dirección del propietario inicial y configura la URI base para los metadatos de los tokens. En ERC-1155, la URI funciona como plantilla: el placeholder {id} es reemplazado por el identificador del token cuando se consulta uri(tokenId). También heredamos de Ownable pasando la dirección del propietario inicial, que en OpenZeppelin v5 es un parámetro obligatorio del constructor.

Definimos constantes para cada tipo de token que nuestro contrato gestionará. En este ejemplo, GOLD y SILVER son tokens fungibles (se pueden fraccionar), mientras que THORS_HAMMER es un token no fungible (solo existe una unidad). SWORD y SHIELD son tokens fungibles con cantidades mayores. Las constantes nos permiten referenciar cada tipo de token por un nombre legible en lugar de un número.

Realizamos la asignación inicial de tokens al desplegador del contrato utilizando la función _mint de ERC-1155. Cada llamada a _mint recibe la dirección de destino, el ID del token, la cantidad y datos adicionales. _mintBatch permite crear múltiples tokens en una sola transacción, lo cual es más gas-eficiente que múltiples llamadas a _mint.

Añadimos una función pública mint que permite al propietario crear nuevos tokens de cualquier tipo. La función _mint de ERC-1155 recibe cuatro parámetros: la dirección de destino, el ID del token, la cantidad a crear, y datos adicionales (vacíos en este caso). Restringimos esta función con el modificador onlyOwner para que solo el propietario pueda crear nuevos tokens, evitando la inflación descontrolada.

Añadimos la función mintBatch que permite al propietario crear múltiples tipos de tokens en una sola transacción. Esto es una de las grandes ventajas de ERC-1155 sobre ERC-20 y ERC-721: la posibilidad de realizar operaciones por lote, lo que ahorra significantes costos de gas cuando se necesitan crear varios tokens a la vez.

Añadimos una función setURI que permite al propietario actualizar la URI base de los metadatos. Esto es útil cuando necesitamos cambiar la ubicación de los metadatos, por ejemplo al migrar de un servidor a IPFS o al actualizar la estructura de URLs. La función interna _setURI de ERC-1155 permite modificar la URI sin necesidad de redirigir.

Añadimos la capacidad de pausar el contrato en situaciones críticas, utilizando la extensión Pausable de OpenZeppelin. Esto nos permite detener las transferencias de tokens en caso de emergencia. En OpenZeppelin v5, importamos Pausable desde utils/Pausable.sol. Creamos las funciones pause y unpause restringidas al propietario.

En OpenZeppelin v5, el hook para controlar transferencias, mints y burns en ERC-1155 es _update. Sobrescribimos esta función interna con el modificador whenNotPaused, lo que garantiza que ninguna transferencia, mint ni burn pueda ocurrir mientras el contrato esté pausado. La función _update en ERC-1155 recibe arrays de IDs y valores, ya que maneja operaciones por lote. Llamamos a super._update para mantener el comportamiento original.