O que é o padrão de metadados de NFT?
O padrão de metadados de NFT é o conjunto de interfaces de contratos inteligentes, formatos JSON, regras de URI e práticas de armazenamento que ajudam aplicativos cripto a entender o que um token não fungível representa.Um NFT pode comprovar a propriedade on-chain, mas os metadados explicam o ativo que os usuários realmente veem, como nome, imagem, descrição, características, animação, estatísticas de jogo ou conteúdo externo.Na maioria dos ecossistemas cripto, o registro do token e o registro da mídia são camadas separadas.O registro do token fica em uma blockchain por meio de um contrato inteligente.Os metadados geralmente ficam em um arquivo JSON, em uma resposta de API, em armazenamento descentralizado ou em dados codificados on-chain.O padrão de metadados de NFT facilita para carteiras, marketplaces, jogos, indexadores, ferramentas de portfólio e plataformas de análise ler essas informações de maneira consistente.Sem padrões de metadados, cada projeto de NFT poderia descrever os tokens de uma maneira completamente diferente, dificultando muito a descoberta, a exibição, a negociação e a verificação de NFTs.Não existe um único padrão universal de metadados de NFT que abranja todas as redes, todos os tipos de mídia e todos os aplicativos.Em vez disso, os padrões de metadados mais importantes vêm de padrões de token amplamente utilizados, como ERC-721, ERC-1155 e extensões relacionadas, como ERC-4906.
Por que os padrões de metadados de NFT são importantes no mercado cripto
Os padrões de metadados de NFT são importantes porque os NFTs foram projetados para circular por diversos aplicativos cripto.Um usuário pode emitir um NFT por meio de um aplicativo, visualizá-lo em uma carteira, listá-lo em uma interface de negociação, usá-lo em um jogo, verificá-lo em um sistema de associação e acompanhá-lo em uma ferramenta de análise.Cada um desses sistemas precisa de uma maneira confiável de saber o que é o NFT.Os padrões de metadados fornecem campos e funções previsíveis que esses sistemas podem ler.Isso melhora a interoperabilidade, pois os desenvolvedores não precisam criar uma integração personalizada para cada coleção de NFTs.Também melhora a experiência do usuário, pois os NFTs podem ser exibidos com nome, imagem, descrição e atributos claros, em vez de aparecerem como tokens desconhecidos ou com erros.Os padrões de metadados também ajudam os compradores de NFTs a tomar decisões mais bem informadas.Quando os metadados são estruturados de forma clara, os usuários podem analisar características, propriedades relacionadas à raridade, links de mídia e detalhes da coleção antes de comprar ou transferir um NFT.Isso é importante porque o valor de um NFT costuma estar ligado a características visíveis, qualidade da mídia, utilidade, autenticidade e disponibilidade dos dados no longo prazo.Principais componentes de um padrão de metadados de NFT
Um sistema de metadados de NFT costuma ter quatro componentes principais.O primeiro é a interface do contrato inteligente que disponibiliza uma URI de metadados.O segundo é o arquivo ou a resposta JSON de metadados que descreve o NFT.O terceiro é a mídia referenciada pelos metadados, como uma imagem, vídeo, arquivo de áudio, modelo 3D ou animação.O quarto é o método de armazenamento que mantém os metadados e a mídia disponíveis ao longo do tempo.Para NFTs ERC-721, a função principal geralmente é
Para NFTs ERC-1155, a função principal geralmente é
Padrão de metadados ERC-721
ERC-721 é o padrão de token mais conhecido para NFTs únicos em redes compatíveis com Ethereum.O padrão oficial ERC-721 define uma extensão opcional de metadados com funções como
A função
A função
A função
O padrão ERC-721 também inclui um esquema JSON de metadados ERC-721 com campos como
O campo
O campo
O campo
Muitos projetos de NFT também incluem campos extras, como
Exemplo de metadados JSON ERC-721
Um arquivo básico de metadados ERC-721 geralmente se parece com um objeto JSON simples."name": "Example NFT #1",
"description": "A sample NFT used to explain metadata structure.",
"image": "ipfs://bafyexamplecid/image.png",
"attributes": [
{
"trait_type": "Background",
"value": "Blue"
},
{
"trait_type": "Level",
"value": 5
}
]
}
O array
Padrão de metadados ERC-1155
ERC-1155 é um padrão de múltiplos tokens que pode representar tokens fungíveis, tokens semifungíveis e NFTs em um único contrato inteligente.Isso torna o ERC-1155 útil para jogos blockchain, itens digitais, edições, distintivos, ingressos, associações e coleções com muitos tipos de token.O padrão oficial ERC-1155 inclui um sistema de URI de metadados baseado na função
O ERC-1155 também oferece suporte a um padrão especial de substituição
Quando a string
A documentação de URI de metadados ERC-1155 da OpenZeppelin explica como URIs específicas de tokens podem apontar para arquivos JSON que seguem o esquema JSON de URI de metadados ERC-1155.
Exemplo de metadados JSON ERC-1155
Um arquivo de metadados ERC-1155 pode incluir campos semelhantes aos dos metadados ERC-721, mas também pode conter propriedades que atendem a vários tipos de token dentro de um único contrato."name": "Crystal Sword",
"description": "A rare game item that can be used inside a blockchain game.",
"image": "ipfs://bafyexamplecid/{id}.png",
"properties": {
"class": "Weapon",
"rarity": "Rare",
"durability": 100
}
}
O padrão
URI de token e URI de metadados
Uma URI de token é um ponteiro que informa aos aplicativos onde encontrar os metadados de NFT.No ERC-721, a URI geralmente vem de
No ERC-1155, a URI geralmente vem de
Campos comuns de metadados de NFT
O campo
O campo
O campo
O campo
O campo
O campo
O campo
Atributos e características
Os atributos são uma das partes mais importantes dos metadados de NFT porque descrevem o que torna um token único ou útil.Em uma coleção de imagens de perfil, os atributos podem incluir plano de fundo, roupas, olhos, boca, acessório e efeitos especiais.Em um jogo blockchain, os atributos podem incluir classe, nível, força, durabilidade, tempo de recarga, raridade ou tipo de habilidade.Em um NFT de associação, os atributos podem incluir categoria, status, região, acesso a eventos ou nível de fidelidade.Na arte digital, os atributos podem incluir edição, paleta de cores, método de geração, série do artista ou estilo de material.Uma formatação clara dos atributos ajuda carteiras, exploradores e ferramentas de análise a exibir corretamente os dados das características.Também ajuda os compradores a comparar NFTs da mesma coleção.Atributos mal formatados podem gerar confusão, rankings de raridade incorretos e exibições inconsistentes entre aplicativos.Metadados de imagem e mídia
O campo
Metadados on-chain
Os metadados on-chain são armazenados ou gerados diretamente por um contrato inteligente.Isso pode tornar os metadados mais transparentes, pois os usuários podem inspecionar a lógica do contrato e os dados na blockchain.Os metadados on-chain também podem reduzir a dependência de servidores externos.No entanto, o armazenamento on-chain pode ser caro, especialmente para imagens grandes, vídeos e arquivos JSON detalhados.Por isso, NFTs on-chain costumam usar imagens SVG compactas, lógica de arte generativa, JSON codificado em Base64 ou metadados algorítmicos.Os metadados on-chain podem ser uma boa opção quando permanência e transparência são mais importantes do que o tamanho da mídia ou a flexibilidade para atualizações.Podem ser uma opção menos adequada quando o NFT precisa de arquivos de mídia grandes, atualizações frequentes ou dados off-chain complexos.Metadados off-chain
Os metadados off-chain são armazenados fora da blockchain e referenciados por uma URI.Esse é o modelo mais comum porque imagens, vídeos, arquivos de áudio e ativos 3D podem ser grandes demais para armazenamento diretamente on-chain.Os metadados off-chain podem ser armazenados em um servidor centralizado, uma rede de armazenamento descentralizada, um sistema de arquivos distribuído ou um protocolo de armazenamento permanente.O principal benefício dos metadados off-chain é a flexibilidade.O principal risco é a dependência do provedor de armazenamento, servidor, gateway ou equipe do projeto.Se os metadados estiverem hospedados em um servidor que fique offline, o NFT ainda poderá existir on-chain, mas aparecer com erro nas interfaces dos usuários.Se os metadados estiverem hospedados por meio de uma API mutável, o projeto poderá conseguir alterar o que os usuários veem sem modificar o registro na blockchain.Os compradores devem entender se os metadados são centralizados, descentralizados, imutáveis ou controlados por uma autoridade de atualização.IPFS e metadados de NFT
O IPFS é amplamente usado para metadados de NFT porque utiliza endereçamento por conteúdo, em vez de endereçamento baseado em localização.As boas práticas oficiais do IPFS para dados de NFT explicam como os criadores podem armazenar dados de NFT de uma maneira que melhore a persistência e a experiência do usuário.
No IPFS, um identificador de conteúdo aponta para um conteúdo específico.Se o conteúdo mudar, o identificador de conteúdo também muda.Isso ajuda os usuários a verificar se um arquivo de metadados ou mídia não foi alterado silenciosamente sob o mesmo endereço de conteúdo.No entanto, o conteúdo do IPFS ainda precisa permanecer disponível por meio de pinning, serviços de armazenamento, nós ou outros planos de persistência.Um link IPFS não é útil se nenhum nó estiver disponibilizando o conteúdo.Projetos de NFT bem estruturados devem planejar como manter metadados e mídia disponíveis após a emissão, após a revelação e depois que o entusiasmo inicial com o projeto diminuir.Metadados centralizados
Os metadados centralizados são armazenados em um servidor, bucket na nuvem ou API controlada pelo projeto.Esse modelo pode ser fácil de implementar e atualizar.Pode oferecer suporte a NFTs dinâmicos, dados de jogos, sistemas de revelação e alterações frequentes nos metadados.Também pode gerar riscos de confiança, pois o projeto ou operador do servidor pode alterar, remover ou redirecionar os metadados.Um servidor centralizado também pode falhar, expirar, ser invadido ou se tornar caro demais para manter.Metadados centralizados não são necessariamente ruins, mas isso deve ser informado com clareza.Os usuários devem saber se um NFT depende de um servidor operado pelo projeto para ser exibido corretamente.Projetos que usam metadados centralizados devem proteger a infraestrutura, monitorar o tempo de atividade e, quando possível, oferecer um plano de migração de longo prazo.Metadados imutáveis
Metadados imutáveis são aqueles que não podem ser alterados depois de finalizados.Isso pode aumentar a confiança dos colecionadores, pois a arte, as características e a descrição não poderão ser modificadas posteriormente pelo proprietário do projeto ou por uma carteira administrativa.Metadados imutáveis são especialmente úteis para obras de arte únicas, colecionáveis fixos, registros históricos, certificados e ativos cuja representação deve permanecer estável.No entanto, a imutabilidade também pode tornar erros permanentes.Se um projeto bloquear metadados com um erro de digitação, um link de mídia quebrado ou uma característica incorreta, corrigi-los pode ser impossível ou muito difícil.Os projetos devem revisar e testar cuidadosamente os metadados antes de bloqueá-los.Os compradores devem verificar se a coleção já bloqueou os metadados ou se o projeto ainda pode atualizá-los.Metadados mutáveis
Metadados mutáveis podem ser alterados depois da emissão.Isso é útil para revelações de NFTs, progressão em jogos, obras de arte evolutivas, status de associação, níveis de fidelidade e sistemas dinâmicos de identidade.Uma espada em formato de NFT pode ganhar novas estatísticas após ser usada em um jogo.Um NFT de associação pode passar de prata para ouro quando o usuário alcança um nível superior.Um NFT de obra de arte pode evoluir com base no tempo, nas ações do usuário ou em eventos on-chain.Metadados mutáveis podem proporcionar experiências avançadas, mas também exigem confiança.Os usuários devem saber quem pode alterar os metadados, o que pode ser alterado, se há um limite para o escopo das alterações e se as atualizações seguem regras transparentes.Metadados mutáveis pouco claros podem reduzir a confiança, pois os compradores podem recear que as características, imagens ou utilidade sejam alteradas de maneira injusta.Sinalização de atualizações de metadados com ERC-4906
ERC-4906 é uma extensão de atualização de metadados do ERC-721 que ajuda os aplicativos a identificar quando os metadados foram alterados.Ela define o evento
Também define o evento
Várias URIs de metadados com ERC-7160
Alguns NFTs precisam de mais de uma URI de metadados para o mesmo token.A extensão ERC-7160 de vários metadados propõe uma maneira de permitir que tokens ERC-721 tenham várias URIs de metadados por token.
Isso pode ser útil quando um NFT tem diferentes estados, modos de exibição, versões, camadas de mídia ou registros de metadados.Por exemplo, um NFT pode ter uma URI de metadados para uma imagem pública, outra para um estado de jogo e outra para uma versão histórica.Um design com vários metadados pode aumentar a flexibilidade, mas também exige suporte claro na interface do usuário.Se os usuários não entenderem qual URI está ativa ou fixada, várias fontes de metadados poderão gerar confusão.Os projetos devem documentar por que existem várias URIs de metadados e como os aplicativos devem interpretá-las.Armazenamento em cache de metadados
O armazenamento em cache de metadados ocorre quando um aplicativo guarda uma cópia dos metadados de NFT, em vez de buscá-los todas as vezes.O cache melhora a velocidade e reduz a carga nos sistemas de armazenamento.Também pode causar atrasos quando os metadados mudam.Uma carteira pode exibir metadados novos enquanto outro aplicativo ainda mostra os antigos.Um indexador pode precisar de tempo para detectar um evento de atualização, buscar o novo JSON, processar a mídia e atualizar o banco de dados.Por isso, uma atualização de metadados pode estar correta no nível do contrato inteligente, mas ainda levar algum tempo para aparecer em todos os lugares.Eventos padrão como o ERC-4906 podem reduzir esse problema, mas os aplicativos ainda precisam monitorar os eventos e atualizar seus caches.Metadados de NFT e raridade
Os metadados afetam a raridade porque as características geralmente são armazenadas neles.Se um projeto usa atributos para descrever plano de fundo, roupas, tipo de item, edição, nível ou outras características, ferramentas de raridade podem usar esses campos para classificar os NFTs.Metadados claros facilitam a análise de raridade.Metadados inconsistentes podem prejudicar os cálculos de raridade.Por exemplo, um token pode usar o valor
Metadados de NFT e utilidade
Os metadados de NFT podem descrever uma utilidade, mas não a proporcionam automaticamente.Um arquivo de metadados pode dizer que um NFT concede acesso, status de nível, poder em um jogo, entrada em eventos ou benefícios de associação.A utilidade real pode depender de um contrato inteligente, site, servidor de jogo, aplicativo com acesso restrito a tokens ou acordo off-chain.Isso significa que os metadados devem ser precisos e não induzir a erro.Se um projeto declara uma utilidade nos metadados, os usuários devem conseguir entender como ela é verificada e utilizada.NFTs com utilidade dinâmica devem deixar claro se as atualizações de metadados são controladas por regras on-chain, servidores do projeto ou ações administrativas manuais.Bons metadados devem ajudar os usuários a entender o papel do NFT sem criar promessas exageradas sobre seu valor futuro.Metadados de NFT e propriedade intelectual
Os metadados de NFT muitas vezes apontam para conteúdo criativo, mas não definem automaticamente a titularidade dos direitos autorais.Comprar um NFT geralmente significa comprar um token, não adquirir automaticamente os direitos autorais da obra de arte, música, vídeo ou ativo de marca vinculado a ele.O estudo do Escritório de Direitos Autorais dos EUA sobre NFTs explica que a propriedade de NFTs e os direitos de propriedade intelectual podem ser questões distintas.
Essa distinção é importante porque os metadados podem exibir uma imagem ou descrever um ativo de mídia, mas os direitos legais geralmente dependem dos termos da licença, dos termos do projeto ou de acordos separados.Os projetos devem evitar incluir nos metadados declarações vagas ou enganosas sobre direitos.Os usuários devem ler a licença do NFT antes de usar comercialmente a mídia associada.Os metadados podem ajudar na descoberta e na exibição, mas não devem ser tratados como um contrato jurídico completo, a menos que o projeto tenha sido claramente concebido para isso.Riscos de segurança nos metadados de NFT
Os metadados de NFT podem gerar riscos de segurança quando apontam para arquivos inseguros, sites maliciosos ou servidores comprometidos.Um campo de metadados pode incluir uma URL externa que direciona os usuários a uma página de phishing.Um arquivo de mídia pode ser substituído se o armazenamento centralizado for comprometido.Um endpoint de metadados dinâmicos pode retornar conteúdos diferentes para usuários diferentes.Uma carteira administrativa do projeto pode usar indevidamente o poder de atualização para alterar características, imagens ou links depois que os compradores adquirirem o NFT.Os aplicativos devem sanitizar os metadados, evitar comportamentos de renderização inseguros e proteger os usuários contra links suspeitos.Os projetos devem proteger permissões de atualização, contas de armazenamento, chaves de implantação e infraestrutura de API.Os usuários devem evitar assinar mensagens da carteira ou conectar carteiras por meio de links encontrados em metadados de NFT desconhecidos.Boas práticas para padrões de metadados de NFT
Ao criar NFTs em redes compatíveis com Ethereum, os projetos devem usar padrões amplamente reconhecidos, como os metadados ERC-721 ou ERC-1155.Os projetos devem manter o JSON válido, simples e consistente.Devem usar nomes de campo claros e evitar campos personalizados desnecessários, a menos que estejam documentados.Devem usar links de mídia estáveis e planejar o armazenamento de longo prazo antes da emissão.Devem testar os metadados em várias carteiras e aplicativos de NFT antes do lançamento.Devem informar se os metadados são mutáveis ou imutáveis.Devem proteger qualquer carteira, função de contrato ou servidor que possa atualizar metadados.Devem usar eventos ERC-4906 quando for necessário que os aplicativos detectem alterações nos metadados ERC-721.Devem manter um histórico público de alterações quando as atualizações de metadados afetarem aparência, características, utilidade, raridade ou expectativas dos detentores.Devem evitar usar metadados para fazer promessas financeiras ou declarações enganosas sobre o valor futuro.Boas práticas para compradores de NFT
Sempre que possível, os compradores de NFT devem inspecionar os metadados antes de comprar.Devem verificar se a URI do token aponta para IPFS, HTTPS, dados on-chain ou outro sistema de armazenamento.Devem entender se os arquivos de imagem e JSON são permanentes, mutáveis ou dependem de um servidor do projeto.Devem verificar se as características estão estruturadas com clareza e consistência.Não devem presumir que um NFT concede direitos comerciais apenas porque os metadados exibem uma obra de arte.Devem ter cuidado quando os metadados incluem links externos que solicitam conexão com uma carteira.Devem lembrar que uma imagem exibida não equivale a valor garantido, propriedade legal ou utilidade futura.Devem considerar a qualidade dos metadados como um dos fatores entre segurança, liquidez, reputação do criador, força da comunidade e execução do projeto.Lista de verificação para desenvolvedores de metadados de NFT
Os desenvolvedores devem decidir se o NFT usará ERC-721, ERC-1155 ou outro padrão de token.Devem implementar a função de metadados correta para o padrão escolhido.Devem validar cada arquivo JSON antes da publicação.Devem usar nomes de características e tipos de dados consistentes.Devem armazenar a mídia de acordo com os objetivos de permanência do projeto.Devem decidir se os metadados serão bloqueados, atualizáveis, dinâmicos ou totalmente on-chain.Devem proteger as funções de atualização com um controle de acesso robusto.Devem emitir eventos padrão de atualização de metadados quando apropriado.Devem testar a exibição do NFT em carteiras, exploradores de blockchain e ferramentas de indexação.Devem documentar todo o comportamento dos metadados para evitar surpresas futuras para os usuários.Equívocos comuns sobre padrões de metadados de NFT
Um equívoco comum é pensar que os metadados de NFT são sempre armazenados on-chain.Na realidade, muitos NFTs armazenam apenas uma URI on-chain, enquanto o JSON e a mídia ficam off-chain.Outro equívoco é pensar que todos os campos de metadados são oficialmente obrigatórios.Na realidade, os padrões definem alguns campos e interfaces principais, enquanto muitos campos populares são convenções comuns, e não requisitos rigorosos.Um terceiro equívoco é pensar que os metadados IPFS são automaticamente permanentes.O IPFS usa endereçamento por conteúdo, mas o conteúdo ainda precisa estar disponível por meio de nós, pinning ou serviços de armazenamento.Um quarto equívoco é pensar que atualizações de metadados sempre indicam algo suspeito.Algumas atualizações são normais, como revelações, progressão em jogos, migrações de armazenamento ou correções de erros.Um quinto equívoco é pensar que os metadados definem a titularidade dos direitos autorais.Os metadados podem descrever um ativo, mas os direitos legais dependem de licenças, termos e leis aplicáveis.Perguntas frequentes
O que é o padrão de metadados de NFT?
O padrão de metadados de NFT é um conjunto de interfaces de contratos inteligentes e formatos de metadados que ajuda os aplicativos a ler e exibir informações de NFT, como nome, imagem, descrição e características.O ERC-721 é o principal padrão de metadados de NFT?
O ERC-721 é um dos principais padrões de NFT, e sua extensão opcional de metadados é amplamente usada para NFTs únicos.Qual é a diferença entre os metadados ERC-721 e ERC-1155?
O ERC-721 geralmente retorna metadados de um token único por meio de
Quais campos costumam estar incluídos nos metadados de NFT?
Os metadados de NFT geralmente incluem campos como
Os metadados de NFT precisam ser armazenados on-chain?
Não. Os metadados de NFT podem ser armazenados on-chain ou off-chain, e muitos NFTs usam arquivos JSON off-chain referenciados por uma URI on-chain.Por que muitos NFTs usam IPFS para os metadados?
Muitos NFTs usam IPFS porque o endereçamento por conteúdo ajuda a vincular metadados e mídia a um identificador de conteúdo específico, em vez de depender apenas da localização de um servidor.Os metadados de NFT podem ser alterados depois da emissão?
Sim. Os metadados de NFT podem ser alterados depois da emissão se o contrato, a URI, o sistema de armazenamento ou o endpoint de metadados tiver sido projetado para permitir atualizações.O que é ERC-4906?
ERC-4906 é uma extensão do ERC-721 que fornece eventos padrão para sinalizar alterações nos metadados de NFT.Os metadados comprovam a titularidade dos direitos autorais?
Não. Os metadados podem descrever a mídia ou a utilidade de um NFT, mas a titularidade dos direitos autorais depende dos direitos legais, das licenças e dos termos do projeto.O que torna os metadados de NFT de alta qualidade?
Metadados de NFT de alta qualidade são válidos, consistentes, transparentes, seguros, fáceis de indexar, vinculados a um armazenamento confiável e claros quanto à possibilidade de atualização.Conclusão
O padrão de metadados de NFT é essencial porque conecta a propriedade registrada na blockchain às informações visuais, descritivas e funcionais que os usuários esperam dos NFTs.ERC-721 e ERC-1155 fornecem as principais bases de metadados para contratos de NFT compatíveis com Ethereum.ERC-4906 ajuda os aplicativos a detectar alterações nos metadados, enquanto extensões mais recentes, como ERC-7160, permitem designs de metadados mais flexíveis.Bons metadados de NFT devem ser estruturados com clareza, armazenados de forma confiável e documentados com honestidade.Devem ajudar carteiras, jogos, ferramentas de negociação e usuários a entender o que um token representa, sem depender de suposições.Para criadores e desenvolvedores, os padrões de metadados melhoram a interoperabilidade e reduzem problemas de integração.Para compradores e colecionadores, a qualidade dos metadados ajuda a avaliar se um NFT é compreensível, durável, seguro e compatível com a utilidade que afirma ter.À medida que os NFTs se expandem por arte, jogos, identidade, associações, ingressos e mídia tokenizada, os padrões de metadados continuarão sendo um dos componentes mais importantes do ecossistema de NFTs cripto.Você também pode gostar
HOT
Criptomoedas que estão em alta atualmente e ganhando atenção significativa do mercado
TOP volume
As criptomoedas com o maior volume de negociação
Recém-adicionados
Criptomoedas listadas recentemente que estão disponíveis para negociação

