Extensão de metadados

O que é uma extensão de metadados?

Uma extensão de metadados é um recurso opcional ou adicional de um contrato inteligente que permite que um token cripto disponibilize informações descritivas sobre si mesmo.

No universo cripto, o termo é usado com mais frequência para padrões de NFT, como o ERC-721, em que a extensão de metadados permite que carteiras, marketplaces, jogos e aplicativos encontrem o nome, o símbolo e o URI de metadados de um token.

O padrão ERC-721 define uma extensão opcional de metadados que inclui as funções name, symbol e tokenURI.

Isso é importante porque o ID de um token na blockchain, por si só, não explica a aparência do ativo, suas características nem o que ele representa.

Uma extensão de metadados ajuda os aplicativos a conectar o token on-chain aos metadados on-chain ou off-chain.

Esses metadados podem incluir o nome, a descrição, a imagem, a animação, os atributos, as características de raridade, as estatísticas de um jogo, os dados de terrenos virtuais ou arquivos 3D do ativo.

Em termos simples, uma extensão de metadados é a parte de um padrão de token que ajuda os aplicativos a responder à pergunta: “O que é este token?”

Como funciona uma extensão de metadados

Uma extensão de metadados geralmente funciona adicionando funções ou eventos padronizados a um contrato de token.

Para NFTs ERC-721, a função de metadados mais importante é tokenURI.

A função tokenURI retorna um URI que aponta para o arquivo de metadados de um ID de token específico.

Quando uma carteira ou marketplace quer exibir um NFT, ela chama tokenURI, busca o arquivo de metadados e lê campos como nome, descrição, imagem e atributos.

Assim, vários aplicativos podem exibir o mesmo NFT sem precisar de instruções personalizadas da equipe do projeto.

Para ativos ERC-1155, os metadados funcionam por meio de um sistema de URI que pode oferecer suporte a vários tipos de tokens em um único contrato.

O padrão ERC-1155 define um esquema JSON de URI de metadados e permite substituir o ID para obter metadados específicos de cada token.

O objetivo é a padronização.

Quando os projetos seguem extensões de metadados comuns, carteiras e aplicativos conseguem oferecer suporte a mais ativos com menos código personalizado.

Por que as extensões de metadados são importantes no universo cripto

As extensões de metadados são importantes porque os ativos digitais precisam de contexto legível.

Um token pode existir on-chain, mas os usuários precisam saber o que ele representa antes de poder avaliá-lo, usá-lo, negociá-lo ou exibi-lo.

No caso dos NFTs, os metadados podem definir o ativo visível.

Em jogos blockchain, os metadados podem definir o tipo, a raridade, o nível, o poder ou o status de aprimoramento de um item.

Para ativos do metaverso, os metadados podem definir coordenadas de terrenos, compatibilidade com avatares, arquivos de itens vestíveis, acesso a eventos ou dados de objetos virtuais.

Sem extensões de metadados, cada carteira ou marketplace precisaria de uma forma diferente de interpretar cada projeto.

Isso tornaria muito mais difícil encontrar NFTs, negociá-los, aplicar filtros, usar ferramentas de raridade, criar listagens em marketplaces e integrar jogos.

Por isso, as extensões de metadados são essenciais para a interoperabilidade de NFTs e para a experiência do usuário.

Extensão de metadados ERC-721

A extensão de metadados ERC-721 é o exemplo mais conhecido de extensão de metadados no universo cripto.

ERC-721 é um padrão para tokens não fungíveis, o que significa que cada token pode ser único.

A extensão de metadados adiciona três funções comuns: name, symbol e tokenURI.

A função name retorna o nome da coleção ou do contrato do token.

A função symbol retorna um símbolo curto para a coleção.

A função tokenURI retorna o URI de metadados de um ID de token específico.

Essa estrutura permite que os aplicativos busquem os metadados corretos de cada NFT.

Por exemplo, os IDs de token 10 e 11 podem pertencer à mesma coleção, mas ter imagens e características diferentes.

A função tokenURI ajuda os aplicativos a encontrar o arquivo de metadados correto para cada um.

Extensão de metadados ERC-1155

ERC-1155 é um padrão mult token que pode oferecer suporte a tokens fungíveis, semifungíveis e NFTs em um único contrato.

Isso o torna útil para jogos blockchain, ativos do metaverso, distintivos, ingressos e sistemas com muitos itens.

Seu sistema de metadados é diferente do ERC-721 porque um contrato pode gerenciar muitos tipos de ativos.

O ERC-1155 pode usar um URI com um marcador que os aplicativos substituem pelo ID real do token.

Isso facilita o gerenciamento de muitos itens, como espadas, escudos, poções, skins, distintivos e passes para eventos.

A extensão de metadados ERC-1155 é especialmente útil quando um projeto precisa de várias classes de tokens, em vez de um token único para cada estrutura de contrato.

Extensão de atualização de metadados ERC-4906

ERC-4906 é uma extensão de atualização de metadados que ajuda os aplicativos a saber quando os metadados de um NFT foram alterados.

O padrão ERC-4906 define os eventos MetadataUpdate e BatchMetadataUpdate para alterações nos metadados de NFTs.

Isso é útil porque alguns NFTs têm metadados dinâmicos.

Por exemplo, um personagem de um jogo blockchain pode subir de nível, um distintivo pode mudar depois que um usuário participa de um evento ou um ativo do metaverso pode ser atualizado após a construção de um edifício.

Sem um sinal padronizado de atualização, marketplaces e carteiras talvez não saibam quando atualizar a exibição do NFT.

O ERC-4906 ajuda a resolver esse problema, oferecendo aos contratos uma forma padronizada de avisar que os metadados devem ser atualizados.

Isso não torna os metadados seguros ou corretos por si só.

Apenas melhora a comunicação entre contratos inteligentes e aplicativos off-chain.

Extensões de metadados no nível do contrato

Os metadados nem sempre descrevem apenas um token.

Às vezes, os aplicativos precisam de metadados sobre todo o contrato ou a coleção.

O ERC-7572 padroniza a função contractURI para metadados no nível do contrato.

O padrão ERC-7572 explica que contractURI pode retornar metadados sobre um contrato, como nome, descrição e imagem.

Isso é útil para marketplaces, carteiras, exploradores e indexadores que querem exibir informações sobre a coleção como um todo.

Os metadados no nível do token informam aos usuários o que é um NFT específico.

Os metadados no nível do contrato informam aos usuários o que é a coleção ou o contrato como um todo.

Ambos os tipos de metadados podem facilitar a descoberta de ativos e aumentar a confiança dos usuários.

Extensão de metadados vs. URI de metadados

Uma extensão de metadados e um URI de metadados estão relacionados, mas não são a mesma coisa.

Uma extensão de metadados é o recurso ou a interface do contrato que permite acessar os metadados.

Um URI de metadados é o link ou caminho retornado por esse recurso.

Por exemplo, a extensão de metadados do ERC-721 inclui a função tokenURI.

A função tokenURI pode retornar um link HTTPS, um link IPFS, um link Arweave ou um URI de dados on-chain.

A extensão de metadados é a porta de entrada.

O URI de metadados é o endereço que fica atrás dessa porta.

Entender essa diferença ajuda usuários e desenvolvedores a avaliar como os metadados de NFTs estão estruturados.

Extensão de metadados vs. padrão de token

Um padrão de token define as regras principais de funcionamento de um token.

Uma extensão de metadados adiciona funções ou eventos extras relacionados a informações descritivas.

No ERC-721, o padrão principal define as regras de propriedade e transferência.

A extensão de metadados adiciona name, symbol e tokenURI.

Essa separação é importante porque algumas extensões são opcionais.

Um token pode seguir o padrão principal e, ainda assim, oferecer diferentes níveis de suporte a metadados.

A maioria dos projetos de NFT inclui suporte a metadados porque os usuários esperam que carteiras e marketplaces exibam imagens, nomes e características.

No entanto, os desenvolvedores ainda devem verificar quais interfaces um contrato realmente oferece.

O que os metadados podem incluir

Os metadados podem incluir o nome, a descrição, a imagem, a animação, um URL externo e os atributos do token.

Em coleções de NFT, os atributos podem incluir características como plano de fundo, vestuário, classe, raridade, nível ou recursos especiais.

Em jogos blockchain, os metadados podem incluir estatísticas de itens, durabilidade, poder, tipo de elemento, classe de personagem ou estágio de aprimoramento.

Para ativos do metaverso, os metadados podem incluir coordenadas de terrenos, tamanho de parcelas, links para arquivos de avatares, compatibilidade com itens vestíveis ou direitos de acesso.

Para NFTs de eventos, os metadados podem incluir nome e data do evento, categoria do ingresso, status de comprovação de participação ou benefícios.

As extensões de metadados facilitam o acesso dos aplicativos a essas informações e sua exibição.

Elas não garantem que as informações sejam precisas, permanentes ou juridicamente válidas.

Armazenamento de metadados e extensões de metadados

Uma extensão de metadados geralmente informa aos aplicativos onde encontrar os metadados, mas nem sempre define onde eles devem ser armazenados.

Os metadados podem ser armazenados em um servidor HTTPS centralizado, no IPFS, no Arweave ou diretamente on-chain.

O armazenamento HTTPS é simples, mas depende de um servidor ou API continuar online.

O IPFS usa endereçamento baseado em conteúdo, o que pode ajudar a verificar se o conteúdo corresponde ao seu identificador de conteúdo.

A documentação do IPFS explica que os Identificadores de Conteúdo identificam os dados com base no próprio conteúdo.

O Arweave foi projetado para o armazenamento de dados a longo prazo.

O site do Arweave descreve a rede como um sistema de armazenamento permanente de informações.

Os metadados on-chain podem ser muito duráveis, mas seu armazenamento pode ser caro para imagens, vídeos ou arquivos 3D grandes.

Extensões de metadados e marketplaces de NFT

Os marketplaces de NFT dependem muito das extensões de metadados para exibir os ativos corretamente.

Um marketplace pode chamar tokenURI, buscar o arquivo JSON de metadados e exibir a imagem, as características, o nome e a descrição do NFT.

A documentação dos padrões de metadados da OpenSea informa que a plataforma oferece suporte a metadados estruturados de acordo com os padrões ERC-721 e ERC-1155.

Isso mostra por que é importante estruturar os metadados de forma padronizada.

Se um projeto usar campos de metadados incomuns ou links quebrados, os marketplaces poderão exibir o NFT incorretamente.

Uma boa estrutura de metadados pode melhorar a pesquisa, a filtragem, a classificação por raridade, a exibição de características e a confiança dos usuários.

Uma estrutura de metadados ruim pode fazer os ativos parecerem quebrados ou pouco confiáveis, mesmo que o contrato do token funcione.

Extensões de metadados e NFTs dinâmicos

NFTs dinâmicos são NFTs cujos metadados podem mudar com o tempo.

Isso pode ser útil em jogos, programas de fidelidade, aplicativos do metaverso e sistemas de identidade.

Um NFT dinâmico pode subir de nível, mudar de aparência, desbloquear novas características ou exibir um status atualizado.

As extensões de metadados tornam isso possível ao permitir que os aplicativos leiam os metadados atuais.

Extensões de atualização de metadados, como o ERC-4906, podem ajudar os aplicativos a saber quando atualizar esses metadados.

Os metadados dinâmicos devem ser transparentes.

Os usuários devem entender o que pode mudar, quem pode fazer alterações e se elas são controladas por contratos inteligentes ou servidores centralizados.

Extensões de metadados e imutabilidade

As extensões de metadados não tornam os metadados imutáveis automaticamente.

Um contrato de token pode oferecer suporte a tokenURI e, ainda assim, permitir que o proprietário do projeto altere o URI base posteriormente.

Isso significa que os metadados visíveis do NFT podem mudar, embora o token continue existindo on-chain.

A imutabilidade dos metadados depende do design do contrato, da opção de armazenamento e das permissões de administrador.

Se um projeto quiser garantir maior imutabilidade, poderá bloquear o URI base, usar armazenamento com endereçamento por conteúdo, armazenar os metadados on-chain ou remover as permissões de administrador para atualizações.

Os usuários não devem presumir que uma extensão de metadados significa que eles são permanentes.

É preciso verificar se o URI de metadados pode ser alterado e se os arquivos estão armazenados de forma durável.

Benefícios das extensões de metadados

O primeiro benefício é uma melhor experiência do usuário.

Carteiras e marketplaces podem exibir nomes, imagens, descrições e características automaticamente.

O segundo benefício é a interoperabilidade.

Diferentes aplicativos podem ler informações sobre tokens usando interfaces compartilhadas.

O terceiro benefício é o suporte a marketplaces.

Metadados padronizados facilitam a listagem, a pesquisa, a filtragem e a negociação de NFTs.

O quarto benefício é a eficiência para desenvolvedores.

Os desenvolvedores podem criar soluções usando interfaces conhecidas, em vez de sistemas de metadados personalizados.

O quinto benefício é a criação de ativos mais completos.

Jogos, aplicativos do metaverso e projetos de criadores podem associar informações detalhadas a ativos tokenizados.

Riscos das extensões de metadados

O primeiro risco são os links de metadados quebrados.

Se um tokenURI apontar para um arquivo inexistente, o NFT poderá não ser exibido corretamente.

O segundo risco são os metadados editáveis.

Se o proprietário do contrato puder alterar o URI, o ativo poderá exibir conteúdo diferente posteriormente.

O terceiro risco são os metadados falsos.

Golpistas podem copiar imagens, características e descrições de coleções legítimas.

O quarto risco são os links externos maliciosos.

Os metadados podem incluir URLs que direcionam os usuários para sites não seguros.

O quinto risco é o suporte inconsistente entre aplicativos.

Diferentes carteiras e marketplaces podem interpretar os campos de metadados de maneiras distintas.

O sexto risco são as suposições incorretas.

Os usuários podem pensar que o suporte a metadados significa que o NFT é autêntico, permanente ou valioso, mas as extensões de metadados não garantem nenhuma dessas coisas.

Como avaliar uma extensão de metadados

Comece verificando qual padrão de token o contrato utiliza.

Confira se o contrato oferece suporte a metadados ERC-721, metadados ERC-1155, eventos de atualização ERC-4906 ou metadados no nível do contrato, como o ERC-7572.

Verifique se tokenURI ou uri retorna um link de metadados funcional.

Confira se os metadados usam campos comuns, como name, description, image e attributes.

Verifique se os arquivos de mídia estão armazenados via HTTPS, IPFS, Arweave ou dados on-chain.

Procure funções de administrador que possam alterar o URI base ou o URI do token.

Verifique se os metadados são congelados, dinâmicos ou atualizáveis.

Confirme o endereço oficial do contrato antes de confiar nos metadados exibidos.

Para NFTs valiosos, o design dos metadados deve fazer parte da due diligence antes da compra.

Equívocos comuns sobre extensões de metadados

Um equívoco comum é pensar que uma extensão de metadados armazena todas as imagens de NFTs on-chain.

Em muitos casos, a extensão apenas retorna um URI que aponta para metadados armazenados em outro lugar.

Outro equívoco é pensar que o suporte a metadados comprova a autenticidade.

Um NFT falso também pode ter metadados, por isso os usuários precisam verificar o endereço oficial do contrato.

Um terceiro equívoco é pensar que tokenURI significa que os metadados não podem mudar.

Os metadados ainda podem mudar se o contrato ou a estrutura de armazenamento permitir atualizações.

Um quarto equívoco é pensar que todos os aplicativos exibem os metadados da mesma forma.

Diferentes carteiras, marketplaces e jogos podem oferecer suporte a diferentes campos de metadados.

Um quinto equívoco é pensar que metadados dinâmicos são sempre perigosos.

Metadados dinâmicos podem ser úteis quando as regras de atualização são transparentes e condizem com a finalidade do ativo.

Perguntas frequentes

O que é uma extensão de metadados no universo cripto?

Uma extensão de metadados é um recurso de um contrato de token que permite que os aplicativos acessem informações descritivas sobre um ativo cripto.

O que é a extensão de metadados ERC-721?

A extensão de metadados ERC-721 é uma interface opcional que adiciona as funções name, symbol e tokenURI aos NFTs ERC-721.

O que tokenURI faz?

tokenURI retorna o URI de metadados de um ID de NFT específico para que os aplicativos possam buscar os metadados do token.

Uma extensão de metadados é igual a um URI de metadados?

Não. A extensão de metadados é a interface ou o recurso do contrato, enquanto o URI de metadados é o link retornado por esse recurso.

O ERC-1155 oferece suporte a metadados?

Sim. O ERC-1155 inclui um sistema de URI de metadados e um esquema JSON para ativos mult token.

O que é ERC-4906?

ERC-4906 é uma extensão de atualização de metadados que define eventos padronizados para avisar os aplicativos quando os metadados de um NFT mudam.

Uma extensão de metadados torna os metadados imutáveis?

Não. A imutabilidade depende do design de armazenamento, das permissões do contrato inteligente e da possibilidade de alterar o URI de metadados.

Uma extensão de metadados pode ser usada para ativos do metaverso?

Sim. As extensões de metadados podem ajudar a descrever terrenos virtuais, itens vestíveis, avatares, passes para eventos, itens de jogos e outros ativos do metaverso.

Por que os marketplaces precisam de extensões de metadados?

Os marketplaces usam extensões de metadados para exibir nomes, imagens, características e descrições de NFTs, além de informações sobre as coleções.

O que os usuários devem verificar antes de confiar nos metadados de um NFT?

Os usuários devem verificar o endereço do contrato, o URI de metadados, o método de armazenamento, as permissões de atualização, o status de congelamento e a autenticidade do projeto.

Conclusão

Uma extensão de metadados é um conceito importante no universo cripto porque conecta tokens de blockchain aos dados descritivos de que usuários e aplicativos precisam.

Para NFTs, a extensão de metadados ERC-721 permite disponibilizar nomes de coleções, símbolos e URIs de metadados específicos de cada token.

Em sistemas mult token, o suporte a metadados ERC-1155 ajuda jogos, plataformas do metaverso e aplicativos a gerenciar vários tipos de ativos com eficiência.

Extensões de atualização de metadados, como o ERC-4906, ajudam NFTs dinâmicos a comunicar alterações a carteiras e marketplaces.

Padrões de metadados no nível do contrato, como o ERC-7572, ajudam os aplicativos a exibir informações mais abrangentes sobre coleções ou contratos.

As extensões de metadados melhoram a usabilidade, a interoperabilidade, a exibição em marketplaces e a descoberta de ativos.

No entanto, elas não garantem automaticamente autenticidade, permanência, segurança ou valor.

Os usuários devem entender onde os metadados estão armazenados, se podem ser alterados e se o contrato é oficial antes de confiar em um ativo cripto ou comprá-lo.