NFT.sol

Antes de comenzar con el contrato, es buena práctica agregar un comentario con el identificador de licencia SPDX, lo cual es obligatorio en Solidity para especificar la licencia del código fuente. Usamos MIT como licencia de código abierto.

Para que el compilador sepa qué versión de Solidity utilizar, debemos especificar la versión del compilador con la declaración pragma solidity. Esto asegura que el contrato se compile correctamente solo con versiones compatibles del compilador.

Declaramos nuestro contrato utilizando la palabra reservada contract. Este es el bloque base de cualquier contrato en Solidity. En este caso, el contrato implementará el estándar ERC721 para tokens no fungibles (NFTs).

Importamos la implementación estándar de ERC721 desde OpenZeppelin. Esto nos permite utilizar todas las funciones que conforman el estándar ERC721 en nuestro contrato, como transferFrom, ownerOf, balanceOf, etc. Hacemos que nuestro contrato herede de ERC721.

Añadimos un constructor, que es una función especial que se ejecuta solo una vez cuando se despliega el contrato. Aquí, inicializamos el nombre y el símbolo del NFT utilizando el constructor de ERC721.

Para evitar que cualquier usuario pueda crear tokens arbitrariamente, restringimos la función de minting al propietario del contrato. Utilizamos la biblioteca Ownable de OpenZeppelin para gestionar esta propiedad. En OpenZeppelin v5, Ownable requiere una dirección initialOwner en su constructor, haciendo que la propiedad sea explícita.

Añadimos la capacidad de definir y asignar metadatos a cada token NFT utilizando la extensión ERC721URIStorage de OpenZeppelin. Los metadatos son típicamente una URL que apunta a un archivo JSON que describe el NFT, incluyendo su nombre, descripción y otros atributos. Esta extensión proporciona la función interna _setTokenURI para almacenar el URI de cada token, y automáticamente maneja la concatenación con un _baseURI si está configurado.

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, Pausable se importa desde utils/Pausable.sol.

En OpenZeppelin v5, el hook correcto para controlar transferencias, mints y burns en ERC721 es _update, que reemplaza al antiguo _beforeTokenTransfer. 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 ERC721 recibe los parámetros (address to, uint256 tokenId, address auth) y devuelve la dirección del propietario anterior.