09.12.2024

Lição 273: Metadados e Armazenamento de NFT

Nesta lição, vamos explorar como gerenciar e armazenar metadados para Tokens Não Fungíveis (NFTs) na blockchain Ethereum usando Solidity. Os NFTs possuem metadados únicos associados a eles, que podem incluir informações como nome, descrição, URL da imagem e propriedades específicas do NFT.

Compreendendo os Metadados de NFT

Os metadados de NFT são um objeto JSON que fornece informações detalhadas sobre um NFT. Esses metadados são frequentemente armazenados fora da blockchain, mas também veremos como interagir com armazenamento na blockchain. Os padrões mais comuns para metadados de NFT são os padrões ERC721 e ERC1155.

Aqui está um exemplo de como os metadados de um NFT podem ser estruturados:

{
  "name": "Meu NFT",
  "description": "Este é meu primeiro NFT!",
  "image": "https://exemplo.com/minha-imagem-nft.png",
  "attributes": [
    {
      "trait_type": "Cor",
      "value": "Vermelho"
    },
    {
      "trait_type": "Tamanho",
      "value": "Grande"
    }
  ]
}

Armazenados fora da blockchain, esses metadados podem ser recuperados e exibidos por diversas plataformas e aplicativos.

Armazenamento de Metadados na Blockchain

Embora seja comum armazenar metadados fora da blockchain para reduzir custos de gás, você pode querer armazenar alguns metadados essenciais na blockchain por razões de funcionalidade ou responsabilidade.

Exemplo: Armazenando Metadados de NFT em Solidity

Vamos criar um contrato inteligente ERC721 simples que permite aos usuários mintar NFTs e armazenar seus metadados na blockchain.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

contract MeuNFT is ERC721, Ownable {
    uint256 private _contadorIdToken;

    // Estrutura para armazenar os metadados
    struct MetadadosNFT {
        string nome;
        string descricao;
        string imagem;
    }

    // Mapeamento de ID do token para seus metadados
    mapping(uint256 => MetadadosNFT) private _metadadosToken;

    constructor() ERC721("MeuNFT", "MNFT") {
        _contadorIdToken = 0;
    }

    function mintNFT(
        address para,
        string memory nome,
        string memory descricao,
        string memory imagem
    ) public onlyOwner {
        uint256 idToken = _contadorIdToken;
        _safeMint(para, idToken);

        // Armazenar os metadados
        _metadadosToken[idToken] = MetadadosNFT(nome, descricao, imagem);
        _contadorIdToken++;
    }

    function getMetadadosNFT(uint256 idToken) public view returns (MetadadosNFT memory) {
        require(_exists(idToken), "Consulta para um token inexistente");
        return _metadadosToken[idToken];
    }
}

Explicação

1. Importando Bibliotecas: Importamos o contrato ERC721 e o Ownable da biblioteca OpenZeppelin para herdar as funcionalidades essenciais.

2. Definição de Estrutura: Definimos uma estrutura MetadadosNFT para armazenar os campos de metadados.

3. Mapeamento: Um mapeamento de IDs de tokens para seus metadados correspondentes permite que recuperemos facilmente as informações do NFT.

4. Função de Mintagem: A função mintNFT permite ao proprietário do contrato mintar um novo NFT, armazenando seus metadados associados ao ID do token.

5. Recuperando Metadados: A função getMetadadosNFT retorna os metadados para um determinado ID de token, garantindo que o token exista.

Implantando o Contrato

Você pode implantar este contrato usando ferramentas como Remix ou Truffle. Certifique-se de interagir com o contrato após a implantação para mintar NFTs e recuperar seus metadados.

Considerações para Metadados Fora da Blockchain

Se você optar por armazenar metadados fora da blockchain, considere usar ferramentas como IPFS (InterPlanetary File System) para armazenamento descentralizado. Armazene apenas o hash ou a URL do IPFS em seu contrato inteligente, economizando significativamente em custos de gás, enquanto mantém os dados acessíveis.

Conclusão

Nesta lição, abordamos como gerenciar metadados de NFT e armazená-los tanto na blockchain quanto fora dela. Compreender esses princípios é crucial para desenvolver projetos eficazes de NFT e garantir que seus NFTs tenham metadados envolventes e úteis associados a eles.

Experimente o código fornecido para aprofundar sua compreensão e considere expandir a funcionalidade para incluir recursos como atualizações de metadados de transferência de tokens, eventos e muito mais! Bom codificação!

Video

Navigation