Padrões de metadados

O que são padrões de metadados?

Padrões de metadados são regras compartilhadas que definem como as informações sobre uma criptomoeda, token, conta blockchain, item colecionável digital, transação ou identidade descentralizada devem ser nomeadas, formatadas, armazenadas, recuperadas e interpretadas.

Metadados são dados que descrevem outro ativo ou objeto de dados.

No universo cripto, os metadados podem descrever o nome, símbolo, precisão decimal, imagem, atributos, criador, recurso externo, tipo de mídia, termos de emissão ou ativo subjacente de um token.

Os padrões de metadados permitem que carteiras, aplicativos blockchain, exploradores, indexadores, sistemas de análise e contratos inteligentes interpretem as mesmas informações de maneira consistente.

Sem um padrão compartilhado, um aplicativo pode usar o campo

, outro pode usar e um terceiro pode não entender a referência à mídia.

Um padrão de metadados pode definir funções de contrato, campos de dados, estruturas JSON, identificadores, eventos de atualização, regras de validação, métodos de armazenamento e requisitos de segurança.

Alguns metadados são armazenados diretamente em uma blockchain, enquanto outros ficam armazenados em sites, redes de armazenamento distribuído ou bancos de dados privados.

Os padrões de metadados melhoram a interoperabilidade, mas não garantem que as informações sejam verdadeiras, permanentes, legais ou seguras.

Por que os padrões de metadados são importantes em cripto?

Os registros de blockchain frequentemente contêm identificadores técnicos difíceis de entender para usuários comuns.

O endereço de um contrato de token identifica um ativo específico, mas o endereço, por si só, não fornece um nome legível, logotipo, descrição ou precisão de exibição.

Os metadados convertem informações técnicas da blockchain em dados estruturados que o software pode exibir e os usuários podem interpretar.

Uma carteira pode usar metadados padronizados para exibir o nome e o saldo corretos de um token.

Um aplicativo de NFT pode usar metadados para exibir uma imagem, animação, descrição e características.

Um aplicativo de identidade descentralizada pode usar metadados para identificar chaves de verificação, endpoints de serviço, emissores, titulares de credenciais e tipos de credenciais.

Os padrões reduzem a necessidade de cada aplicativo criar uma integração personalizada para cada ativo cripto.

Também facilitam a validação de dados, a detecção de campos ausentes, a comparação de implementações e a transferência de informações entre sistemas.

Padrões de metadados vs. metadados

Metadados são as informações descritivas efetivamente vinculadas ou associadas a um ativo.

Um padrão de metadados é o conjunto de regras que explica como essas informações devem ser estruturadas e interpretadas.

O texto “Digital Access Pass” pode ser o nome de um token armazenado nos metadados.

Um padrão pode especificar que o nome do token deve aparecer em um campo chamado

e ser representado como uma string.

Os metadados podem estar em conformidade com um padrão, atender a apenas parte dele ou usar um formato totalmente personalizado.

Padrão de metadados vs. esquema de metadados

Um padrão de metadados descreve as regras mais amplas para criar e trocar metadados.

Um esquema de metadados define a estrutura permitida, os campos, os tipos de dados e os requisitos de validação de um documento de metadados.

Um padrão pode incluir um ou mais esquemas, além de interfaces de contrato inteligente, eventos de atualização, regras de URI e instruções de processamento.

Um esquema pode exigir que

seja uma string, que seja um array e que contenha uma URI.

Um documento pode ser um JSON válido e ainda assim não atender ao esquema de metadados exigido.

Padrões de metadados vs. padrões de token

Um padrão de token define o comportamento de um token e a forma como outros aplicativos interagem com seu contrato inteligente.

Um padrão de metadados define como as informações descritivas sobre esse token são representadas.

Um único padrão de token pode incluir tanto funções comportamentais quanto funções opcionais de metadados.

Por exemplo, um padrão de token fungível pode definir transferências, saldos, aprovações, oferta total, nome, símbolo e precisão decimal.

Um padrão de NFT pode definir funções de propriedade e transferência e usar uma URI de metadados para localizar informações descritivas.

Elementos essenciais dos padrões de metadados cripto

Identificadores

Um identificador distingue uma blockchain, contrato, tipo de token, instância de token, conta, credencial ou documento de metadados de outro.

Exemplos incluem identificadores de cadeia, endereços de contrato, IDs de token, identificadores descentralizados, URLs, URIs e identificadores de conteúdo.

Nomes de campos

Nomes de campos padronizados permitem que o software localize informações sem precisar adivinhar como cada emissor as identificou.

Os campos comuns incluem

, , , , , e .

Tipos de dados

Um tipo de dado define se um valor deve ser uma string, número, inteiro, valor booleano, objeto, array ou valor nulo.

O uso de tipos de dados consistentes impede que um aplicativo receba um número quando esperava texto.

Campos obrigatórios e opcionais

Um padrão pode exigir informações que toda implementação compatível deve fornecer e permitir campos opcionais para recursos adicionais.

O software não deve presumir que um campo opcional estará sempre presente.

Regras de URI

Um padrão de metadados pode definir como um contrato retorna a URI usada para localizar um documento de metadados ou arquivo de mídia.

Uma URI identifica um recurso, mas o esquema da URI determina como o aplicativo deve recuperá-lo ou interpretá-lo.

Regras de atualização

As regras de atualização explicam se os metadados podem mudar, quem pode alterá-los e como os aplicativos ficam sabendo da atualização.

Regras de integridade

As regras de integridade permitem que um aplicativo verifique se os metadados recuperados correspondem a um hash criptográfico ou identificador de conteúdo esperado.

Regras de validação

As regras de validação identificam metadados malformados, ausentes, conflitantes ou incompatíveis antes que cheguem aos usuários.

Metadados on-chain

Metadados on-chain são armazenados diretamente no estado da blockchain, no armazenamento do contrato, em dados de transação ou em outro recurso protegido pela blockchain.

Os aplicativos podem ler os metadados de um nó sem depender de um servidor web comum.

O armazenamento on-chain pode oferecer alta disponibilidade e integridade quando a blockchain subjacente continua acessível.

Também pode ser caro, pois cada byte armazenado pode aumentar os custos de transação e os requisitos de armazenamento da rede a longo prazo.

Mídias totalmente on-chain podem usar texto compacto, gráficos vetoriais codificados, geração procedural ou URIs de dados.

On-chain não significa automaticamente imutável, pois um contrato atualizável ou controlado por um administrador pode alterar as informações retornadas.

Metadados off-chain

Metadados off-chain são armazenados fora da blockchain, enquanto a blockchain registra uma referência a eles.

A referência pode apontar para um recurso HTTPS, objeto de armazenamento distribuído, servidor privado, interface de programação de aplicativos ou arquivo endereçado por conteúdo.

O armazenamento off-chain pode comportar imagens maiores, vídeos, documentos e conjuntos detalhados de atributos com um custo menor na blockchain.

Ele introduz riscos adicionais relacionados à disponibilidade, hospedagem, domínio, segurança e alterações de conteúdo.

Se um servidor comum desaparecer, o token poderá continuar na blockchain enquanto seus metadados ficam indisponíveis.

Metadados híbridos

Metadados híbridos combinam informações on-chain com arquivos off-chain.

Um contrato inteligente pode armazenar on-chain o ID do token, a propriedade, a URI de metadados e o hash do conteúdo, enquanto o documento JSON completo e a mídia ficam armazenados em outro local.

Essa abordagem pode reduzir os custos de armazenamento e, ao mesmo tempo, permitir que os aplicativos verifiquem o conteúdo recuperado.

A segurança do resultado depende de quais campos são protegidos on-chain e quais ainda podem mudar.

Padrões de metadados para tokens fungíveis

Os metadados de tokens fungíveis ajudam carteiras e aplicativos a exibir corretamente ativos cripto intercambiáveis.

O padrão final de token ERC-20 define funções opcionais para o nome, o símbolo e a precisão decimal de um token.

O campo

fornece um nome legível para o ativo.

O campo

fornece uma representação mais curta, semelhante a um ticker.

O valor

informa às interfaces como converter a menor unidade on-chain em uma quantidade legível para o usuário.

Um token com 18 casas decimais representa um token exibido como 10¹⁸ unidades mínimas.

O nome e o símbolo não identificam um token de forma exclusiva, pois vários contratos sem relação entre si podem usar valores idênticos.

Um aplicativo confiável deve identificar o ativo por meio da blockchain e do endereço do contrato, e não apenas pelo símbolo.

Metadados decimais

Os metadados decimais alteram a forma de exibir um saldo inteiro de tokens, mas não dividem automaticamente as unidades subjacentes na blockchain.

Saldo de tokens exibido = saldo bruto de tokens / 10^decimais

Um saldo bruto de 250.000.000 com seis casas decimais é exibido como 250 tokens.

Metadados decimais incorretos podem fazer um saldo parecer muito maior ou menor do que realmente é.

Os cálculos financeiros devem usar aritmética inteira precisa, e não aproximações de ponto flutuante.

Padrão de metadados ERC-721

ERC-721 é um padrão final para tokens não fungíveis, no qual cada token tem um identificador distinto.

A interface opcional de metadados do padrão ERC-721 define as funções

, e .

A função

retorna uma URI associada a um ID de token específico.

Os metadados localizados geralmente contêm um nome, uma descrição e uma URI de imagem.

Os aplicativos podem aceitar campos adicionais, mas não há garantia de que os campos personalizados apareçam de maneira consistente em todas as interfaces.

O ERC-721 padroniza o acesso aos metadados sem exigir que cada byte de metadados seja armazenado diretamente no contrato.

Campos comuns de metadados ERC-721

Nome

O campo

fornece um nome legível para o token individual ou ativo representado.

Descrição

O campo

explica o token, a mídia, a utilidade, o histórico ou o item representado.

Imagem

O campo

contém uma URI que aponta para uma imagem associada ao token.

URL de animação

Um campo

pode apontar para vídeo, áudio, mídia interativa, conteúdo tridimensional ou outro recurso avançado.

URL externa

Um campo

pode direcionar os usuários para uma página oficial de informações ou de um aplicativo.

Atributos

Um array

pode descrever características como categoria, nível, edição, cor, status ou outra propriedade específica do token.

Os formatos das características devem ser consistentes em toda a coleção para que os aplicativos possam organizá-las e compará-las corretamente.

Padrão de metadados ERC-1155

O ERC-1155 permite vários tipos de tokens fungíveis, não fungíveis e semifungíveis em um único contrato inteligente.

O padrão final ERC-1155 de múltiplos tokens define uma interface opcional de URI de metadados e um esquema JSON associado.

A função

retorna uma URI de metadados para um tipo de token.

O padrão permite que o espaço reservado

apareça nos valores dos metadados.

Clientes compatíveis substituem esse espaço reservado pelo ID do token representado como uma string hexadecimal minúscula, preenchida com zeros à esquerda até 64 caracteres, sem o prefixo

.

Essa substituição permite que um único padrão de URI atenda muitos IDs de token de forma eficiente.

O esquema ERC-1155 inclui campos como name, description, image, decimals e properties.

Metadados ERC-721 vs. ERC-1155

O ERC-721 normalmente retorna uma URI específica do token por meio de

.

O ERC-1155 pode retornar um modelo de URI que os aplicativos personalizam por meio da substituição do ID do token.

O ERC-721 foi projetado para tokens individualmente distintos, enquanto o ERC-1155 pode representar várias categorias de tokens em um único contrato.

Ambos os padrões geralmente resolvem os metadados como JSON e podem apontar para mídia externa.

Um aplicativo deve detectar e processar a interface correta, em vez de presumir que todo NFT segue o mesmo padrão de metadados.

Padrões de atualização de metadados

Metadados mutáveis de NFT criam um desafio porque os aplicativos podem armazenar em cache uma versão anterior e nunca saber que ela mudou.

A extensão ERC-4906 de atualização de metadados define eventos padronizados para notificar os aplicativos sobre alterações nos metadados ERC-721.

O evento

identifica um token cujos metadados foram alterados.

O evento

identifica um intervalo consecutivo de IDs de token afetados.

Os aplicativos podem monitorar esses eventos e recuperar os metadados atualizados por meio da URI do token.

O evento sinaliza que os metadados mudaram, mas não inclui o documento atualizado completo.

Padrões emergentes de metadados on-chain

Novas propostas de metadados continuam em desenvolvimento à medida que os aplicativos blockchain precisam de informações on-chain mais estruturadas.

O ERC-8048 foi apresentado em setembro de 2025 como uma proposta em rascunho para metadados de chave-valor armazenados diretamente em registros de múltiplos tokens e NFTs.

O rascunho atual do ERC-8048 propõe uma função que retorna bytes de metadados para um ID de token e uma chave de string.

Também propõe um evento que os aplicativos podem monitorar quando um valor de metadados é definido.

Como o ERC-8048 continua sendo um rascunho, os desenvolvedores não devem descrevê-lo como padrão finalizado ou adotado universalmente.

Propostas em rascunho podem mudar, ficar estagnadas ou não receber amplo suporte de implementação.

JSON como formato de metadados

JSON é um formato de texto leve, comumente usado para trocar metadados cripto entre contratos, servidores, carteiras e aplicativos.

O padrão JSON da IETF define objetos, arrays, strings, números, valores booleanos e valores nulos.

Um objeto JSON contém nomes de campos e os valores correspondentes.

O JSON é popular por ser legível, amplamente compatível e fácil de processar em aplicativos web.

Um JSON válido não comprova que o documento siga um esquema de metadados de token.

Os aplicativos devem rejeitar valores duplicados ou inesperados de acordo com suas políticas de segurança e interoperabilidade.

Exemplo de estrutura de metadados de NFT

Este exemplo usa campos comuns, mas não representa um esquema universal completo para todos os aplicativos de NFT.

A URI, a estrutura dos atributos e os campos opcionais devem ser avaliados de acordo com o padrão e o aplicativo que os utilizarão.

JSON Schema

JSON Schema fornece regras legíveis por máquinas para validar a estrutura e os valores de um documento JSON.

Um esquema pode definir propriedades obrigatórias, tipos de dados esperados, valores mínimos, padrões de string, valores permitidos e regras para objetos aninhados.

O JSON Schema Draft 2020-12 continua sendo a versão lançada mais recente da especificação geral em 2026.

Um projeto cripto pode usar JSON Schema para verificar os metadados antes da mintagem ou publicação dos tokens.

Carteiras e indexadores também podem usar esquemas para identificar dados inválidos ou incompatíveis.

A validação do esquema confirma a estrutura, mas não comprova que uma descrição, imagem, declaração de propriedade ou afirmação do emissor seja verdadeira.

Metadados JSON-LD

JSON-LD amplia o JSON com semântica de dados vinculados, permitindo que campos e tipos se conectem a conceitos definidos globalmente.

A Recomendação JSON-LD 1.1 define um formato baseado em JSON para dados vinculados interoperáveis.

A propriedade

associa nomes de campos curtos a identificadores e vocabulários mais precisos.

A propriedade

pode identificar um sujeito ou recurso.

A propriedade

identifica o tipo de entidade descrita.

O JSON-LD pode ajudar ativos tokenizados, credenciais, registros de identidade e sistemas de ativos do mundo real a trocar metadados com significados consistentes.

Contextos remotos criam riscos de dependência e segurança quando seu conteúdo pode mudar ou ficar indisponível.

Padrões de URI em metadados cripto

Um identificador uniforme de recurso (URI) identifica um recurso digital ou físico por meio de um formato de caracteres padronizado.

O padrão de sintaxe genérica de URI define a estrutura comum usada pelos esquemas de URI.

Os esquemas comuns de metadados cripto incluem

, e .

Uma URI HTTPS identifica uma localização controlada por meio de um domínio web e de um servidor.

Uma URI IPFS identifica conteúdo por meio de um identificador de conteúdo.

Uma URI de dados incorpora o conteúdo diretamente na URI.

Os aplicativos devem verificar quais esquemas são compatíveis e evitar tratar uma URI não reconhecida como um link web seguro.

Endereçamento por localização vs. endereçamento por conteúdo

O endereçamento por localização informa ao aplicativo onde solicitar um recurso.

O endereçamento por conteúdo identifica um recurso de acordo com informações derivadas do próprio conteúdo.

Uma URL HTTPS pode continuar apontando para a mesma localização mesmo depois que o servidor altera o arquivo.

Um identificador de conteúdo muda quando o conteúdo referenciado muda, de acordo com as mesmas regras de codificação e hashing.

Por isso, o endereçamento por conteúdo melhora a verificação de integridade, mas não garante que o conteúdo continue hospedado e acessível.

Metadados IPFS

O IPFS é comumente usado para armazenar metadados e mídia de NFTs por meio de identificadores endereçados por conteúdo.

A documentação oficial do IPFS sobre endereçamento de conteúdo explica que um identificador de conteúdo, ou CID, contém informações derivadas do hash criptográfico e da codificação do conteúdo.

Quando as mesmas configurações de endereçamento de conteúdo são usadas, a alteração do conteúdo produz um CID diferente.

Uma URI de token pode usar o formato

para identificar um documento de metadados ou arquivo.

Um gateway público pode converter essa URI em uma solicitação HTTPS para acesso pelo navegador.

O gateway é um caminho de recuperação, não a identidade subjacente do conteúdo.

Um CID não garante armazenamento permanente, pois pelo menos um provedor acessível precisa continuar disponibilizando os dados.

Integridade dos metadados

Integridade dos metadados significa que os dados recuperados não foram alterados inesperadamente desde a criação da referência confiável.

É possível calcular um hash criptográfico do documento de metadados e compará-lo com um hash esperado.

A integridade dos metadados é válida quando o hash calculado = hash esperado confiável

Um hash correspondente fornece evidências de que os bytes são iguais, mas não comprova que o conteúdo original era preciso ou autorizado.

Os metadados endereçados por conteúdo podem incluir integridade no próprio identificador.

Os metadados endereçados por localização podem usar um hash armazenado separadamente, uma assinatura digital ou um registro de integridade.

Autenticidade dos metadados

A autenticidade diz respeito a quem criou, aprovou ou controlou os metadados.

Uma assinatura digital pode vincular um documento de metadados a uma chave criptográfica.

O verificador ainda precisa determinar se essa chave pertence ao criador, emissor, autoridade do contrato ou organização esperados.

Uma assinatura válida de uma chave comprometida pode autenticar um documento não autorizado.

A rotação e revogação de chaves, o controle de acesso e os procedimentos para incidentes continuam sendo necessários.

Metadados imutáveis

Metadados imutáveis são projetados para que seu conteúdo ou referência confiável não possa ser alterado após um momento definido.

A imutabilidade pode ser obtida armazenando todos os dados on-chain, usando um identificador de conteúdo imutável ou desativando permanentemente as permissões de atualização.

O projeto deve explicar exatamente quais partes são imutáveis.

Um documento JSON imutável ainda pode apontar para uma imagem externa que muda.

Um contrato inteligente imutável também pode fazer referência a uma localização em servidor mutável.

A verdadeira imutabilidade deve ser avaliada em toda a cadeia de referências.

Metadados mutáveis

Metadados mutáveis podem mudar após a criação de um token.

Eles podem permitir a evolução de itens de jogos, NFTs em evolução, memberships, ativos resgatáveis, status de identidade, registros de manutenção e atualizações de ativos do mundo real.

Também permitem que uma parte autorizada ou um administrador comprometido substitua imagens, descrições, características ou links externos.

Um padrão de metadados deve definir a autoridade de atualização, o processo, o evento, o histórico e as condições para bloquear futuras alterações.

Os aplicativos não devem descrever metadados mutáveis como permanentes.

Metadados congelados

Metadados congelados são metadados que antes podiam ser editados, mas foram colocados em um estado no qual novas alterações não são esperadas nem permitidas.

O processo de congelamento deve ser aplicado pelo código do contrato ou por outro controle que possa ser verificado de forma independente.

Uma declaração em um site afirmando que os metadados estão congelados é menos confiável do que uma restrição técnica que remove a autoridade de atualização.

Os usuários devem verificar se atualizações de proxy, ações de governança ou chaves de administrador podem restabelecer as permissões de alteração.

Versionamento de metadados

O versionamento de metadados registra como um documento ou esquema de metadados muda ao longo do tempo.

Um identificador de versão ajuda os aplicativos a determinar quais regras devem aplicar.

Uma versão semântica pode usar números principais, secundários e de correção para distinguir alterações incompatíveis de acréscimos e correções compatíveis.

Versões históricas podem ajudar em auditorias, disputas, migrações e na exibição precisa de estados anteriores do token.

Uma URI mutável que substitui o documento anterior sem manter o histórico dificulta a reconstrução do que os usuários receberam originalmente.

Padrões de metadados cross-chain

Aplicativos cross-chain precisam de identificadores que distingam ativos com nomes e endereços semelhantes em diferentes blockchains.

Um símbolo de ticker não é suficiente, pois ativos sem relação entre si podem compartilhar o mesmo símbolo.

O padrão de identificadores de ativos CAIP-19 define um formato independente de blockchain para identificar tipos e instâncias individuais de ativos.

Um identificador completo pode combinar um namespace de blockchain, uma referência à blockchain, um namespace de ativo, uma referência ao contrato ou ativo e um ID de token opcional.

Os identificadores cross-chain reduzem ambiguidades quando carteiras, sistemas de pagamento, bridges e ferramentas de portfólio trocam metadados de ativos.

Eles não comprovam que um token conectado por bridge seja totalmente lastreado pelo ativo original.

Metadados de ativos wrapped e conectados por bridge

Um token wrapped ou conectado por bridge representa um ativo por meio de outra blockchain ou sistema técnico.

Seus metadados devem identificar a blockchain atual, o contrato do token, o ativo representado, o emissor ou mecanismo da bridge e as condições relevantes de resgate.

Copiar o nome e o logotipo do ativo original sem distinguir a representação wrapped pode induzir os usuários ao erro.

Os aplicativos não devem presumir que símbolos idênticos indicam os mesmos direitos de resgate ou o mesmo nível de segurança.

Os metadados devem esclarecer se o ativo é nativo, wrapped, conectado por bridge, sintético ou representado de outra forma.

Metadados de identificadores descentralizados

Identificadores descentralizados podem conectar entidades relacionadas a blockchains a métodos de verificação e informações de serviço.

Documentos DID podem conter controladores, métodos de verificação criptográfica, relações de autenticação e endpoints de serviço.

A W3C publicou o DID Core versão 1.1 como Candidate Recommendation Snapshot em 5 de março de 2026.

Como a versão 1.1 continua na trilha de Recommendation, os implementadores devem diferenciá-la da Recomendação final DID Core 1.0.

Os metadados DID podem ser usados por emissores de tokens, organizações, credenciais, carteiras e agentes automatizados.

Um DID comprova controle de acordo com seu método, mas não prova automaticamente que todas as afirmações de seu controlador sejam precisas.

Metadados de credenciais verificáveis

Credenciais verificáveis usam metadados estruturados para expressar declarações de um emissor sobre um titular.

O Verifiable Credentials Data Model 2.0 da W3C tornou-se uma Recomendação W3C em 15 de maio de 2025.

O modelo define informações sobre emissores, titulares de credenciais, tipos, períodos de validade, status de credenciais, esquemas de dados e mecanismos de proteção.

Aplicativos cripto podem usar credenciais verificáveis para identidade, memberships, conformidade, educação, qualificações profissionais e direitos de acesso tokenizados.

Uma prova válida de credencial mostra que os dados protegidos não foram alterados segundo o método criptográfico aplicável.

O verificador deve decidir separadamente se o emissor é confiável e se a credencial é adequada à finalidade pretendida.

Metadados para ativos do mundo real tokenizados

Os metadados de um ativo do mundo real tokenizado podem descrever imóveis, valores mobiliários, commodities, faturas, declarações ambientais, memberships ou direitos legais.

O contrato do token, por si só, pode não conter todos os documentos necessários para entender a propriedade ou o resgate.

Os metadados podem identificar contratos legais, emissores, custodiantes, datas de avaliação, jurisdições, identificadores de ativos, auditorias, restrições e informações de status.

Um link para metadados não torna automaticamente vinculante um documento legal externo.

Os usuários devem determinar se o token concede uma reivindicação executável contra a entidade ou o ativo relevante.

Informações pessoais e comerciais confidenciais não devem ser armazenadas permanentemente em uma blockchain pública.

Localização de metadados

A localização permite que nomes, descrições e outros metadados legíveis sejam exibidos em vários idiomas.

Um padrão deve identificar o idioma associado a cada valor de texto.

Os aplicativos devem definir o comportamento alternativo quando o idioma solicitado não estiver disponível.

As traduções devem preservar informações relevantes sobre riscos, aspectos legais e resgate, em vez de simplificar apenas o conteúdo promocional.

A codificação de caracteres deve ser consistente para que os nomes não sejam corrompidos entre sistemas.

Acessibilidade dos metadados

Metadados acessíveis ajudam usuários que dependem de leitores de tela, alternativas textuais, navegação por teclado ou outras tecnologias assistivas.

As imagens devem ter descrições textuais significativas quando o aplicativo ou esquema oferecer suporte a elas.

Informações essenciais não devem aparecer apenas dentro de uma imagem ou animação.

Cor, movimento e som não devem ser os únicos meios de comunicar um status importante de um token.

A acessibilidade melhora a usabilidade e torna os metadados compreensíveis para um público mais amplo.

Tipos de mídia em metadados cripto

Um tipo de mídia descreve o formato de um arquivo vinculado, como JSON, PNG, SVG, MP4 ou outro tipo registrado.

Os aplicativos podem usar informações sobre o tipo de mídia para decidir como processar um recurso.

Uma extensão de arquivo, por si só, não é confiável, pois um servidor pode retornar conteúdo inesperado com um nome de arquivo familiar.

Os aplicativos devem inspecionar o tipo de resposta, validar a estrutura do arquivo e aplicar regras de renderização seguras.

Formatos ativos, como HTML e SVG, exigem controles mais rigorosos do que imagens estáticas comuns, pois podem conter scripts, referências externas ou comportamentos interativos.

Cache de metadados

Carteiras, indexadores e aplicativos costumam armazenar metadados em cache para melhorar o desempenho e reduzir solicitações repetidas à rede.

O cache pode fazer com que nomes, imagens e atributos desatualizados continuem visíveis após uma atualização autorizada.

Eventos de atualização, políticas de expiração, identificadores de versão e ferramentas de atualização manual podem reduzir problemas com dados desatualizados.

Uma cópia em cache não deve ser considerada o estado atual oficial sem verificar sua fonte e data/hora.

Metadados endereçados por conteúdo podem ser armazenados em cache com segurança quanto à integridade, pois o identificador muda quando o conteúdo muda.

Indexação de metadados

Um indexador de metadados coleta referências da blockchain, recupera documentos, valida campos e prepara dados para pesquisa e exibição rápidas.

O indexador pode normalizar diferentes padrões em um formato interno.

A normalização pode melhorar a usabilidade, mas também pode remover campos incompatíveis ou ocultar diferenças entre os esquemas originais.

Os indexadores devem preservar a fonte original, o horário de recuperação, o identificador da blockchain, o endereço do contrato e o ID do token.

Um aplicativo voltado ao usuário deve diferenciar metadados obtidos diretamente de um contrato das informações adicionadas por um banco de dados externo.

Validação de metadados

A validação de metadados verifica se os dados seguem a sintaxe, o esquema, os identificadores, os tipos de campo e as regras de segurança exigidos.

A validação de sintaxe confirma se um documento está em JSON bem formado ou em outro formato esperado.

A validação do esquema verifica campos, valores e estruturas obrigatórios.

A validação de URI verifica se as referências a recursos usam esquemas permitidos e formatos válidos.

A validação de integridade compara hashes ou identificadores de conteúdo.

A validação semântica verifica se as informações fazem sentido no contexto relevante da blockchain e do ativo.

Nenhuma camada de validação, isoladamente, pode comprovar todas as afirmações contidas nos metadados.

Riscos de segurança dos metadados cripto

Links maliciosos

Um documento de metadados pode direcionar os usuários a um site de phishing por meio de uma URL externa.

Mídia maliciosa

Um campo de imagem ou animação pode referenciar conteúdo ativo criado para explorar softwares de renderização inseguros ou rastrear usuários.

Arquivos grandes demais

Um invasor pode fornecer arquivos de metadados ou mídia extremamente grandes para consumir memória, largura de banda, armazenamento ou capacidade de processamento.

Referências recursivas

Os metadados podem apontar para recursos adicionais que referenciam uns aos outros repetidamente e geram solicitações excessivas.

Falsificação com caracteres Unicode

Nomes e símbolos de tokens podem usar caracteres Unicode visualmente semelhantes para imitar um ativo confiável.

Substituição de metadados

Um administrador ou servidor comprometido pode substituir metadados mutáveis depois que os usuários adquirem um token.

Manipulação de esquemas

Um esquema remoto ou contexto JSON-LD pode mudar e alterar a forma como um documento é interpretado.

Rastreamento de privacidade

Uma URL de mídia exclusiva pode revelar quando uma carteira ou usuário específico visualiza metadados de um token.

Afirmações falsas

Os metadados podem fazer afirmações falsas sobre propriedade, raridade, autenticidade, direitos legais, reservas ou aprovação do criador.

Metadados e phishing em carteiras

Uma carteira pode detectar um token desconhecido cujos metadados exibem uma mensagem prometendo uma recompensa ou alertando sobre um problema na conta.

Os metadados podem direcionar o usuário a um site malicioso.

Receber um token não comprova que seu nome, imagem, site ou emissor sejam confiáveis.

Os usuários devem verificar independentemente a blockchain, o endereço do contrato, a fonte oficial e a ação solicitada à carteira.

Nenhum documento de metadados precisa da chave privada ou da frase de recuperação do usuário.

Riscos de privacidade dos metadados

Metadados públicos podem expor nomes pessoais, localizações, credenciais, memberships, informações de saúde ou relações financeiras.

Dados armazenados diretamente em uma blockchain pública podem ser difíceis ou impossíveis de remover.

Criptografar metadados confidenciais pode reduzir sua visibilidade pública, mas cria desafios de gestão de chaves e confidencialidade a longo prazo.

Um hash público também pode revelar informações quando é fácil adivinhar os valores subjacentes possíveis.

Os projetos devem minimizar os dados pessoais e armazenar apenas o que for necessário para a finalidade pretendida do ativo cripto.

Como projetar um padrão de metadados cripto

Defina o caso de uso

O responsável pelo design deve identificar qual ativo, identidade, credencial ou aplicativo será descrito pelos metadados.

Defina identificadores exclusivos

Os identificadores devem distinguir a blockchain, o contrato, o tipo de ativo e o token individual sem depender de nomes ou símbolos.

Selecione um formato de dados

O formato deve ter ampla compatibilidade, ser determinístico quando necessário e adequado ao tamanho de dados esperado.

Defina os campos obrigatórios

Somente os campos necessários para uma interoperabilidade confiável devem ser obrigatórios.

Defina os tipos de dados

Cada campo deve ter um tipo, intervalo permitido, codificação e política de erro claramente definidos.

Defina o comportamento das URIs

O padrão deve identificar os esquemas de URI compatíveis, as regras para referências relativas, as expectativas de recuperação e as restrições de segurança.

Defina a mutabilidade

O padrão deve explicar quem pode atualizar os metadados e se as atualizações podem ser desativadas futuramente.

Defina a proteção de integridade

Documentos externos importantes devem usar hashes, identificadores de conteúdo, assinaturas ou outro método de integridade verificável.

Defina o versionamento

Os aplicativos precisam de uma forma confiável de identificar versões incompatíveis do esquema e extensões futuras.

Defina o comportamento em caso de falha

O padrão deve explicar como o software lida com metadados ausentes, malformados, indisponíveis, grandes demais ou incompatíveis.

Documente as considerações de segurança

A especificação deve abordar entradas maliciosas, referências remotas, privacidade, controles de acesso, autoridade de atualização e riscos de negação de serviço.

Boas práticas de metadados para projetos cripto

Use a blockchain e o endereço do contrato como identidade principal do ativo, em vez do símbolo do ticker.

Siga um padrão finalizado quando ele já atender ao caso de uso necessário.

Identifique claramente as extensões de metadados em rascunho ou experimentais.

Use nomes de campos e tipos de dados estáveis em toda a coleção de tokens.

Valide cada documento de metadados antes da publicação.

Use endereçamento por conteúdo ou hashes criptográficos para recursos que devam permanecer inalterados.

Divulgue a autoridade de atualização e as regras de congelamento antes que os usuários adquiram o token.

Emita eventos padronizados de atualização quando houver suporte.

Preserve versões históricas dos metadados para auditorias e disputas.

Evite armazenar dados pessoais ou confidenciais permanentemente em uma blockchain pública.

Limite mídias ativas e higienize o conteúdo externo antes de renderizá-lo.

Forneça descrições textuais significativas e informações de idioma.

Mantenha armazenamento redundante para arquivos off-chain essenciais.

Não afirme que algo é imutável quando qualquer referência importante ainda puder ser alterada.

Como avaliar metadados de tokens

Confirme a blockchain correta e o endereço do contrato do token.

Identifique quais padrões de token e de metadados o contrato afirma implementar.

Quando for tecnicamente viável, leia a URI diretamente do contrato.

Verifique se os metadados estão armazenados on-chain, por HTTPS, via IPFS ou em outro sistema.

Verifique os identificadores de conteúdo ou hashes, quando disponíveis.

Analise quem pode alterar o contrato, a URI, os metadados, o esquema ou a referência de armazenamento.

Confira se são emitidos eventos de atualização de metadados.

Inspecione com cautela as mídias vinculadas e as URLs externas.

Compare declarações legais e de lastro do ativo com documentação independente.

Não confie em um logotipo, nome ou símbolo de ticker como prova de autenticidade.

Erros comuns em padrões de metadados

Um erro comum é tratar um JSON válido como prova de que os metadados estão em conformidade com um padrão de token.

Outro erro é usar o símbolo do token como identificador de ativo globalmente exclusivo.

Alguns projetos armazenam os metadados em um servidor comum enquanto anunciam o ativo como totalmente imutável.

Outros inserem um CID do IPFS em um documento, mas permitem que o contrato substitua a URI desse documento.

Um documento de metadados pode usar nomes e valores de atributos inconsistentes dentro da mesma coleção.

Os aplicativos podem renderizar mídias ativas sem sanitização ou limites de conteúdo.

Os desenvolvedores podem presumir que toda carteira é compatível com campos de metadados personalizados.

Outro erro é não emitir um evento de atualização depois de alterar metadados mutáveis.

Os projetos podem usar uma proposta em rascunho sem informar que seus campos e comportamentos ainda podem mudar.

Armazenar informações pessoais confidenciais permanentemente on-chain pode criar problemas graves de privacidade e conformidade.

Perguntas frequentes

Qual é a definição mais simples de padrões de metadados?

Padrões de metadados são regras compartilhadas para estruturar, armazenar, recuperar e interpretar informações descritivas sobre ativos cripto e registros de blockchain.

O que são metadados cripto?

Metadados cripto são informações que descrevem um token, NFT, conta blockchain, credencial, transação ou ativo representado.

Por que os ativos cripto precisam de metadados?

Os metadados ajudam o software a exibir nomes, símbolos, imagens, casas decimais, atributos, identidades e recursos externos legíveis.

Os metadados ficam armazenados na blockchain?

Podem ficar armazenados on-chain, off-chain ou em um design híbrido que combina referências da blockchain com arquivos externos.

O que são metadados on-chain?

Metadados on-chain são dados descritivos armazenados diretamente no estado da blockchain, no armazenamento de contratos inteligentes ou em dados de transação.

O que são metadados off-chain?

Metadados off-chain são armazenados fora da blockchain, enquanto a blockchain registra uma URI ou outra referência a eles.

Metadados off-chain são inseguros?

Podem ser usados com segurança, mas introduzem riscos de hospedagem, integridade, disponibilidade, domínio e atualização que precisam ser gerenciados.

Quais metadados o ERC-20 define?

O ERC-20 define funções opcionais para o nome do token, o símbolo e a precisão decimal.

Os nomes e símbolos dos tokens são exclusivos?

Não. Contratos sem relação entre si podem usar o mesmo nome e símbolo de token.

Como um token fungível deve ser identificado?

Ele deve ser identificado por meio da blockchain e do endereço do contrato, e não apenas pelo símbolo.

O que são metadados ERC-721?

Os metadados ERC-721 usam uma URI específica do token para fornecer informações sobre um token não fungível individual.

O que são metadados ERC-1155?

Os metadados ERC-1155 usam uma interface de URI e um esquema JSON que podem oferecer suporte a vários tipos de tokens em um único contrato.

O que significa o espaço reservado

{id}

do ERC-1155?

Aplicativos compatíveis o substituem pelo ID do token formatado como um valor hexadecimal minúsculo de 64 caracteres, sem o prefixo

.

O que é ERC-4906?

ERC-4906 é uma extensão final que define eventos para notificar os aplicativos sobre atualizações de metadados ERC-721.

O que é ERC-8048?

ERC-8048 é uma proposta em rascunho apresentada em 2025 para metadados de chave-valor armazenados diretamente em registros de múltiplos tokens e NFTs.

O ERC-8048 é um padrão finalizado?

Não. Continua sendo um rascunho e pode mudar antes de ser finalizado.

Por que o JSON é usado para metadados cripto?

O JSON é legível, leve, amplamente compatível e adequado para a troca de dados estruturados.

Um JSON válido significa que os metadados do token são válidos?

Não. O documento também precisa atender ao esquema de metadados relevante e aos requisitos do aplicativo.

O que é JSON Schema?

JSON Schema define regras de validação legíveis por máquinas para documentos JSON.

O que é JSON-LD?

JSON-LD acrescenta significado de dados vinculados e identificadores definidos globalmente às estruturas JSON.

O que é uma URI de metadados?

Uma URI de metadados identifica o recurso que contém ou representa os metadados de um token.

O que é um CID do IPFS?

Um CID do IPFS é um identificador de conteúdo derivado, em parte, do hash criptográfico e da codificação do conteúdo.

Um CID do IPFS garante armazenamento permanente?

Não. Ele verifica a identidade do conteúdo, mas não garante que um provedor acessível continuará armazenando os dados.

O que são metadados endereçados por conteúdo?

Metadados endereçados por conteúdo são identificados por informações derivadas do próprio conteúdo, e não apenas da localização em um servidor.

O que é integridade dos metadados?

Integridade dos metadados significa que os bytes recuperados correspondem a um hash confiável, identificador de conteúdo, assinatura ou outra referência de integridade.

Um hash correspondente prova que os metadados são verdadeiros?

Não. Ele prova que os bytes correspondem ao conteúdo esperado, mas não que as afirmações contidas nele sejam precisas.

Os metadados de NFT podem mudar?

Sim. Os metadados podem mudar quando o contrato ou o sistema de armazenamento permite atualizações autorizadas.

O que são metadados congelados?

Metadados congelados são informações colocadas em um estado no qual futuras alterações são tecnicamente restritas ou desativadas.

Os metadados on-chain permanecem sempre inalterados?

Não. Contratos atualizáveis e armazenamento controlado por administradores podem permitir alterações nos metadados on-chain.

O que é versionamento de metadados?

O versionamento de metadados identifica e preserva as alterações feitas em esquemas ou documentos ao longo do tempo.

O que é CAIP-19?

CAIP-19 é um padrão independente de blockchain para identificar tipos e instâncias individuais de ativos cripto.

Por que os identificadores cross-chain são importantes?

Eles impedem que ativos em diferentes blockchains sejam confundidos por causa de nomes, símbolos ou formatos de contrato semelhantes.

O que são metadados DID?

Metadados DID descrevem identificadores descentralizados, controladores, métodos de verificação e endpoints de serviço.

O que são metadados de credenciais verificáveis?

Eles descrevem um emissor, o titular da credencial, as declarações, o período de validade, o status, o esquema e o método de proteção.

Os metadados podem conter malware?

Os metadados podem referenciar links maliciosos, scripts, mídias ativas, arquivos grandes demais e outros conteúdos inseguros.

Receber um NFT pode expor uma carteira a phishing?

Sim. Metadados de tokens não solicitados podem exibir links maliciosos ou mensagens falsas de recompensa para enganar o usuário.

Os metadados devem solicitar uma frase de recuperação?

Não. Nenhum documento legítimo de metadados, emissor de token ou processo de suporte precisa da frase de recuperação de uma carteira.

Os metadados podem revelar informações pessoais?

Sim. Metadados públicos podem expor identidade, memberships, localizações, credenciais ou relações financeiras.

Como validar metadados cripto?

É possível verificá-los por meio da validação de sintaxe, validação de esquema, regras de URI, hashes criptográficos, assinaturas e análise semântica.

Qual é a maior limitação dos padrões de metadados?

Um padrão pode tornar os dados interoperáveis, mas não pode garantir que o ativo, emissor ou declaração descritos sejam legítimos.

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

Os usuários devem verificar a blockchain, o endereço do contrato, o padrão de metadados, o método de armazenamento, a autoridade de atualização, a referência de integridade e as afirmações externas.

Conclusão

Os padrões de metadados definem como as informações descritivas sobre ativos cripto, NFTs, identidades, credenciais e recursos de blockchain são estruturadas e trocadas.

Eles permitem que carteiras, contratos inteligentes, indexadores e aplicativos interpretem nomes, símbolos, casas decimais, imagens, características, identificadores e recursos externos de maneira consistente.

Entre os principais sistemas de metadados cripto estão os campos de tokens fungíveis, as URIs de tokens ERC-721, os esquemas de metadados ERC-1155, os eventos de atualização ERC-4906, JSON, JSON Schema, JSON-LD, identificadores de conteúdo e identificadores de ativos independentes de blockchain.

Os metadados podem ser armazenados diretamente on-chain, hospedados off-chain ou protegidos por um modelo híbrido que usa referências da blockchain e verificações criptográficas de integridade.

O armazenamento on-chain não garante imutabilidade, enquanto o endereçamento por conteúdo não garante disponibilidade permanente.

Os aplicativos precisam validar esquemas, higienizar conteúdo externo, verificar a autoridade de atualização, preservar o histórico de versões e evitar confiar em nomes ou símbolos como identificadores exclusivos.

Os usuários devem tratar os metadados como informações descritivas, e não como prova de que um token é autêntico, valioso, lastreado ou juridicamente executável.

Padrões de metadados bem projetados melhoram a interoperabilidade cripto somente quando acompanhados de armazenamento seguro, afirmações precisas, governança clara, proteção de privacidade e validação confiável.