Metadados off-chain

O que são metadados off-chain?

Metadados off-chain são informações descritivas sobre um criptoativo, NFT, token, contrato inteligente, item de jogo, registro de identidade digital ou ativo do mundo real tokenizado que são armazenadas fora da blockchain, mas referenciadas por um registro on-chain.Em termos simples, a blockchain pode registrar quem é o proprietário do token, enquanto o arquivo de metadados que explica o que ele representa fica em outro lugar.No caso de um NFT, os metadados off-chain podem incluir nome, descrição, link da imagem, link da animação, atributos, características de raridade, URL externa, informações da coleção, texto da licença, propriedades do jogo ou dados do criador.Para um contrato de token, os metadados off-chain podem incluir logotipos, descrições do projeto, banners, links para redes sociais e documentação, além de informações de exibição usadas por carteiras e exploradores.Para um ativo do mundo real tokenizado, os metadados off-chain podem incluir documentos legais, relatórios de auditoria, referências a garantias, arquivos de avaliação ou informações com acesso restrito por identidade que não devem ser armazenadas publicamente on-chain.

O padrão ERC-721 define uma extensão opcional de metadados na qual tokenURI pode apontar para um arquivo JSON que descreve o NFT.

O padrão ERC-1155 também define o comportamento de URI de metadados para contratos de múltiplos tokens, incluindo a substituição da URI pelos IDs dos tokens.

Metadados off-chain são comuns porque armazenar arquivos grandes diretamente em uma blockchain pode ser caro e ineficiente.A desvantagem é que eles introduzem riscos de armazenamento, disponibilidade, mutabilidade e confiança que os usuários devem entender antes de confiar em um ativo.

Principais conclusões sobre metadados off-chain

• Metadados off-chain são informações sobre um ativo armazenadas fora da blockchain e referenciadas por uma URI, hash, ponteiro ou função de contrato on-chain.
• São amplamente usados para NFTs, ativos de jogos, logotipos de tokens, perfis de contratos, ativos do mundo real tokenizados, credenciais e metadados de colecionáveis.
• As opções comuns de armazenamento incluem servidores HTTPS, IPFS, Arweave, armazenamento apoiado pela Filecoin, serviços de nuvem e bancos de dados privados.
• Metadados off-chain reduzem os custos da blockchain porque arquivos JSON grandes, imagens, vídeos e documentos não precisam ser armazenados diretamente no contrato.
• Os principais riscos incluem links quebrados, encerramento de servidores, perda de domínios, alterações não autorizadas, pinning inadequado, censura, vazamentos de privacidade e metadados enganosos.
• O armazenamento endereçado por conteúdo, como o IPFS, pode melhorar a integridade porque o identificador do conteúdo muda quando o conteúdo é alterado.
• Persistência não é o mesmo que endereçamento por conteúdo: um arquivo ainda precisa continuar disponível por meio de pinning, hospedagem ou armazenamento permanente.
• Metadados dinâmicos podem ser úteis para jogos, NFTs em evolução, associações e ativos tokenizados, mas exigem controles sólidos para atualizações.
• Os metadados não comprovam automaticamente direitos autorais, propriedade legal, autenticidade ou valor do ativo.
• Os usuários devem sempre verificar onde os metadados estão armazenados, quem pode alterá-los e se a mídia ainda pode ser recuperada.

Como funcionam os metadados off-chain

Metadados off-chain geralmente começam com um contrato inteligente que armazena ou retorna uma URI.A URI pode apontar para um arquivo JSON em um site, um CID do IPFS, uma transação do Arweave, um objeto de armazenamento descentralizado ou outro local externo de dados.Uma carteira, explorador, marketplace, jogo ou ferramenta de análise lê a URI na blockchain.Em seguida, o aplicativo busca os metadados no local externo.O arquivo de metadados informa ao aplicativo como exibir o ativo.Por exemplo, tokenURI pode retornar um link para um arquivo JSON com o nome e a descrição do token, a URI da imagem, a URI da animação e os atributos.A carteira usa esse arquivo JSON para mostrar ao usuário a imagem e as características do NFT.A blockchain confirma a propriedade do ID do token.Os metadados off-chain explicam o que esse ID deveria representar.Essa separação é poderosa, mas também significa que o registro do token e o conteúdo descritivo podem ter pressupostos de segurança diferentes.

Metadados off-chain e metadados on-chain

Metadados off-chain são armazenados fora da blockchain.Metadados on-chain são armazenados ou gerados diretamente por um contrato inteligente ou uma transação da blockchain.Em geral, os metadados off-chain são mais baratos, mais fáceis de atualizar e mais adequados para arquivos grandes.Os metadados on-chain costumam ser mais duráveis, transparentes e menos dependentes de infraestrutura externa.Um NFT totalmente on-chain pode retornar todos os metadados principais diretamente do contrato.Um NFT off-chain típico pode armazenar apenas tokenURI on-chain e manter o arquivo JSON em outro lugar.Um NFT híbrido pode armazenar características importantes e imutáveis on-chain, mantendo a mídia ou os metadados complementares off-chain.O melhor modelo depende da finalidade do ativo.Arte generativa permanente pode se beneficiar de metadados on-chain.Um item de jogo que recebe atualizações frequentes pode se beneficiar de metadados off-chain controlados.Um token de ativo do mundo real pode precisar de documentos off-chain, pois arquivos legais privados não devem ficar expostos publicamente para sempre.

Por que projetos cripto usam metadados off-chain

Projetos cripto usam metadados off-chain porque as blockchains não foram projetadas para armazenar todos os arquivos grandes a baixo custo.Imagens, vídeos, arquivos de áudio, modelos 3D, documentos legais e dados de jogos podem ser muito maiores do que os dados de uma transação comum.Armazenar esses dados diretamente on-chain pode encarecer a emissão e as atualizações.O armazenamento off-chain permite que os projetos mantenham as transações na blockchain menores.Também permite que os aplicativos carreguem mídia rica sem obrigar cada nó da blockchain a armazenar arquivos grandes dos ativos.Os metadados off-chain também podem viabilizar experiências dinâmicas.Um jogo pode atualizar o nível de um personagem.Um NFT de associação pode mudar de status.Um ativo tokenizado pode receber um documento de avaliação atualizado.Uma credencial pode apontar para registros privados sem expor informações confidenciais em um registro público.A vantagem é a flexibilidade, mas o custo é uma confiança adicional no sistema de armazenamento e atualização.

Campos comuns de metadados off-chain

O campo mais comum dos metadados é o nome do ativo.O campo de descrição explica o que o ativo representa.O campo de imagem aponta para um arquivo visual exibido pelo aplicativo.O campo animation_url pode apontar para vídeo, áudio, HTML ou mídia interativa, quando compatível com os aplicativos.O campo de atributos ou propriedades descreve características, raridade, níveis, estatísticas, categorias ou valores do jogo.O campo external_url pode apontar para a página de um projeto ou ativo.Os metadados no nível do contrato podem incluir o nome, símbolo, descrição, imagem de perfil e banner da coleção, imagem em destaque, link externo e colaboradores.

O rascunho do padrão ERC-7572 contractURI propõe metadados no nível do contrato por meio de uma função contractURI.

Campos de metadados bem definidos devem ser claros, consistentes e fáceis de interpretar por carteiras e indexadores.Metadados mal estruturados podem dificultar a exibição, verificação ou comparação de ativos.

Metadados off-chain e tokenURI

tokenURI é uma das funções mais importantes para os metadados de NFTs.No ERC-721, tokenURI retorna uma URI diferente para um ID específico de token.Essa URI pode apontar para um arquivo JSON que descreve o NFT.Em muitas coleções, tokenURI aponta para um arquivo off-chain em vez de retornar os metadados diretamente do contrato.Esse projeto reduz o custo de emissão e oferece mais flexibilidade para armazenar mídia.Também cria uma dependência do local em que o arquivo JSON está armazenado.Se o servidor desaparecer, o token ainda poderá existir on-chain, mas a imagem e a descrição talvez não carreguem mais.Se o arquivo JSON mudar, a exibição do NFT poderá mudar mesmo que o ID do token permaneça igual.Ao avaliar a qualidade de um NFT no longo prazo, os usuários devem inspecionar tokenURI.A URI pode revelar se o projeto usa um servidor comum, IPFS, Arweave ou outro método de armazenamento.

Metadados off-chain e substituição de URI no ERC-1155

O ERC-1155 é um padrão de múltiplos tokens que pode gerenciar vários tipos de tokens em um único contrato.O padrão de URI de metadados do ERC-1155 pode incluir a string {id} como marcador de posição.O software cliente substitui esse marcador pelo ID real do token em um formato hexadecimal padronizado.Isso permite que um único modelo de URI atenda a muitos IDs de tokens.Por exemplo, um caminho-base pode apontar para diversos arquivos JSON de metadados.Isso é útil para jogos, edições, sistemas de recompensas e coleções com muitos tipos de itens.Também significa que os desenvolvedores precisam estruturar corretamente os arquivos off-chain.Se o padrão de nomenclatura dos arquivos estiver errado, as carteiras talvez não encontrem os metadados corretos.Se a pasta off-chain for movida ou alterada, muitos tokens podem parar de funcionar ao mesmo tempo.Os metadados ERC-1155 são eficientes, mas exigem gerenciamento cuidadoso do armazenamento.

Metadados off-chain e IPFS

O IPFS é uma das opções de armazenamento mais comuns para metadados e mídia off-chain de NFTs.

As orientações do IPFS para dados de NFTs recomendam usar URIs do IPFS para vincular contratos inteligentes a dados externos armazenados no IPFS.

O IPFS usa identificadores de conteúdo, também chamados de CIDs, para identificar arquivos pelo conteúdo.Se o conteúdo mudar, o CID também muda.Isso torna o IPFS mais confiável do que uma URL comum para detectar adulterações.Uma URI do IPFS deixa claro que o arquivo é endereçado pelo conteúdo, e não vinculado a um único servidor.No entanto, o IPFS não garante automaticamente que o conteúdo continuará disponível para sempre.Os dados ainda precisam ser fixados, hospedados ou preservados por nós que mantenham uma cópia.As orientações do IPFS explicam que as cópias recuperadas podem ser temporárias e eventualmente excluídas, a menos que sejam fixadas.Por isso, o IPFS melhora a integridade, mas a persistência ainda precisa ser planejada.

Metadados off-chain e Arweave

O Arweave é outra rede de armazenamento usada para metadados e mídia cripto.

A documentação do Arweave descreve a rede como um sistema de armazenamento permanente de informações e uma web descentralizada dentro de um registro aberto.

Alguns projetos usam o Arweave quando querem armazenar metadados ou mídia com um modelo de permanência mais robusto.Isso pode ser útil para arte, arquivos, registros públicos, ativos históricos e coleções que prometem disponibilidade de longo prazo.Do ponto de vista de outra blockchain, o Arweave ainda é uma camada de armazenamento externa.Se um contrato de NFT em uma rede apontar para dados no Arweave, a propriedade estará registrada em uma blockchain, enquanto a mídia ou os metadados estarão armazenados no Arweave.Em relação à blockchain principal do NFT, isso continua sendo um caso de metadados off-chain.Esse modelo pode ser robusto quando o link é estável e os dados são preservados.Mesmo assim, os usuários devem verificar o que está armazenado, como é referenciado e se os metadados, a mídia ou ambos estão lá.Afirmações sobre armazenamento permanente devem ser verificadas com cuidado, pois a linguagem de marketing pode ser mais abrangente do que a configuração técnica real.

Metadados off-chain e armazenamento apoiado pela Filecoin

O armazenamento apoiado pela Filecoin pode ajudar a manter a disponibilidade de metadados e mídia off-chain.IPFS e Filecoin são frequentemente mencionados juntos porque o IPFS pode endereçar o conteúdo, enquanto a Filecoin pode oferecer contratos de armazenamento e incentivos econômicos para mantê-lo disponível.Um projeto pode usar CIDs do IPFS para endereçar o conteúdo e o armazenamento da Filecoin para preservá-lo por mais tempo.Isso pode ajudar a resolver a diferença entre integridade e disponibilidade.Integridade significa que o arquivo pode ser verificado com base no seu identificador de conteúdo.Disponibilidade significa que o arquivo pode ser recuperado quando os usuários precisarem dele.Ambas são importantes para metadados off-chain.Um CID perfeito não serve de nada se ninguém armazenar o arquivo.Um servidor muito disponível não basta se o arquivo puder ser alterado sem aviso.Um bom projeto de metadados busca oferecer tanto conteúdo verificável quanto recuperação confiável.

Metadados HTTPS

Metadados HTTPS usam uma URL comum da web como local dos metadados.Essa opção é simples para os desenvolvedores e fácil de acessar para os aplicativos.Também funciona bem com navegadores e infraestrutura web tradicionais.O problema é que os metadados HTTPS geralmente dependem de um domínio, servidor, conta de nuvem, política de acesso e operador do projeto.Se o domínio expirar, os metadados podem desaparecer.Se o servidor for invadido, os metadados podem ser substituídos.Se o projeto encerrar a API, as carteiras podem exibir ativos com erros.Se o operador alterar o arquivo JSON, a exibição do NFT pode mudar sem uma atualização on-chain.O armazenamento HTTPS pode ser aceitável para ativos temporários ou dinâmicos, mas é menos confiável para ativos que prometem permanência.Os usuários devem ter cautela quando NFTs valiosos ou ativos tokenizados dependem apenas de URLs comuns da web.

Metadados off-chain e risco de centralização

O risco de centralização é uma das principais fragilidades dos metadados off-chain.Pesquisas sobre a centralização de metadados de NFTs constataram que muitos sistemas dependem de armazenamento centralizado, o que pode criar riscos de censura, violações de dados, alterações administrativas e perda de controle.Um servidor centralizado pode ser rápido e prático, mas também pode se tornar um ponto único de falha.Se uma empresa controla o servidor de metadados, ela talvez consiga alterar a forma como os ativos são exibidos.Se um serviço de nuvem suspender uma conta, os metadados podem parar de carregar.Se um invasor comprometer o servidor, os usuários podem ver links maliciosos ou imagens falsas.Se o projeto desaparecer, os arquivos podem desaparecer com ele.Isso não significa que todos os metadados off-chain sejam ruins.Significa que a arquitetura de armazenamento deve estar de acordo com as garantias de confiança do ativo.Um projeto que afirma oferecer permanência não deve depender apenas de uma hospedagem centralizada e frágil.

Metadados off-chain e NFTs dinâmicos

NFTs dinâmicos frequentemente dependem de metadados off-chain porque sua aparência ou seus atributos podem mudar com o tempo.Um personagem de jogo pode subir de nível.Um colecionável esportivo pode atualizar suas estatísticas.Um token de associação pode mudar de categoria.Um token de ativo do mundo real pode receber uma atualização do status de um documento.Uma obra de arte generativa pode revelar novos estados quando determinadas condições forem atendidas.Os metadados off-chain facilitam essas atualizações porque o arquivo JSON ou a API pode mudar sem a implantação de um novo contrato.O risco é que o poder de atualização se torne amplo demais.Se o emissor puder mudar qualquer característica a qualquer momento, o comprador talvez não saiba de fato o que possui.Os metadados dinâmicos devem ter regras claras, eventos de atualização, controles de acesso e documentação pública.Flexibilidade não deve se transformar em controle oculto.

Eventos de atualização de metadados

Os eventos de atualização de metadados ajudam os aplicativos a saber quando devem atualizar os metadados armazenados em cache.

A extensão ERC-4906 para atualização de metadados adiciona os eventos MetadataUpdate e BatchMetadataUpdate para tokens ERC-721.

Isso é útil porque carteiras e indexadores costumam armazenar metadados em cache em vez de buscá-los a cada acesso.Se os metadados mudarem sem um sinal de atualização, os usuários podem ver imagens ou atributos antigos.O ERC-4906 também alerta que os controles de permissão são importantes quando há modificações em metadados off-chain.Isso importa porque uma função de atualização de metadados pode se tornar um poder administrativo sensível.Se a conta errada puder acionar ou controlar atualizações, a confiança dos usuários pode ser prejudicada.Projetos com metadados off-chain dinâmicos devem tornar previsível o comportamento das atualizações.Também devem informar quem pode atualizar os metadados e por que isso acontece.Os usuários devem verificar se os metadados podem mudar após a emissão ou compra.

Metadados off-chain no nível do contrato

Metadados no nível do contrato descrevem o contrato ou a coleção, e não um único ID de token.Podem incluir o nome e a descrição da coleção, imagem de perfil, banner, imagem em destaque, link externo e colaboradores.O ERC-7572 propõe contractURI como uma forma de os contratos retornarem metadados no nível do contrato.A string contractURI retornada pode apontar para um recurso off-chain ou retornar dados JSON on-chain.Isso importa porque carteiras e exploradores frequentemente precisam de informações detalhadas sobre um contrato antes de exibi-lo aos usuários.Metadados no nível do contrato podem melhorar a usabilidade, mas também podem induzir os usuários ao erro se forem alterados de forma maliciosa.Um arquivo de metadados de contrato falso ou comprometido pode exibir um nome ou logotipo familiar.Os usuários não devem confiar apenas nos metadados do contrato.O endereço do contrato, o código-fonte, o histórico do emissor e os canais oficiais de comunicação continuam importantes.Os dados de exibição devem ajudar na verificação, não substituí-la.

Metadados off-chain e novos padrões de metadados on-chain

Os padrões mais recentes mostram que os desenvolvedores tentam reduzir alguns riscos do armazenamento off-chain.

A proposta de rascunho ERC-8049 define um padrão para armazenar metadados no nível do contrato on-chain.

A proposta explica que os metadados de contratos frequentemente dependem de URLs off-chain ou do IPFS, o que pode criar riscos de confiança e disponibilidade.O ERC-8049 não é uma substituição universal para todos os metadados off-chain.Ele indica que o ecossistema está avançando em direção a uma identidade de contrato mais clara e a dados de exibição mais confiáveis para carteiras.Alguns projetos continuarão usando metadados off-chain porque arquivos grandes e documentos privados não são práticos para armazenar on-chain.Outros poderão migrar os dados principais de identidade para a blockchain e manter apenas a mídia mais pesada off-chain.O futuro provavelmente será híbrido.Campos essenciais de identidade poderão se tornar mais verificáveis on-chain.Mídias grandes, documentos privados e dados que mudam com frequência poderão continuar off-chain, com provas de integridade mais robustas.

Metadados off-chain e mecanismos de revelação

Muitas coleções de NFTs usam mecanismos de revelação.Antes da revelação, todos os tokens podem apontar para os mesmos metadados de espaço reservado.Após a revelação, cada token recebe metadados exclusivos.Essa abordagem pode gerar expectativa e reduzir a busca antecipada por características raras.Ela também exige confiança quando o processo de revelação não é transparente.Uma equipe desonesta poderia atribuir características raras de forma injusta se a aleatoriedade e a atribuição dos metadados não fossem tratadas com cuidado.Os projetos podem reduzir esse risco publicando compromissos dos metadados, usando aleatoriedade verificável, bloqueando hashes dos metadados ou explicando claramente o processo de revelação.Os metadados off-chain facilitam os mecanismos de revelação porque os arquivos podem ser substituídos ou atualizados.Essa mesma flexibilidade pode gerar desconfiança se os usuários não puderem verificar o processo.Uma revelação justa deve ser compreensível antes da emissão dos tokens.

Metadados off-chain e congelamento de metadados

Congelar metadados significa impedir mudanças futuras após determinado momento.Um projeto pode congelar os metadados depois da revelação para que os usuários saibam que o ativo não mudará inesperadamente.O congelamento pode ocorrer por meio da lógica do contrato, configurações de URI imutável, links endereçados por conteúdo, compromissos de armazenamento ou uploads para armazenamento permanente.O congelamento pode aumentar a confiança dos colecionadores porque torna mais estável a exibição do ativo.Também pode tornar os erros permanentes.Se os metadados tiverem um link quebrado, erro de ortografia, característica incorreta ou licença errada antes do congelamento, talvez seja difícil corrigir o problema.Os projetos devem auditar cuidadosamente os metadados antes de congelá-los.Os usuários devem confirmar se os metadados estão realmente congelados ou se apenas são descritos como finais em materiais de marketing.Uma declaração pública é menos sólida do que um controle técnico aplicável.O contrato e a configuração de armazenamento devem corresponder ao que o projeto promete.

Metadados off-chain e ativos do mundo real tokenizados

Ativos do mundo real tokenizados frequentemente precisam de metadados off-chain porque registros legais e financeiros podem ser grandes, privados ou regulamentados.Um token pode representar exposição a um fundo, fatura, imóvel, commodity, título, crédito de carbono ou outra reivindicação sobre um ativo do mundo real.Os metadados podem fazer referência a documentos que explicam direitos, obrigações, auditorias, garantias, datas de vencimento ou regras de resgate.Algumas dessas informações podem ser públicas.Outras podem exigir acesso restrito.Colocar documentos legais privados diretamente em uma blockchain pública pode gerar problemas de privacidade e conformidade.Uma abordagem comum é armazenar um hash do documento on-chain e manter o documento off-chain.O hash pode ajudar a verificar se o documento não foi alterado.O arquivo propriamente dito pode permanecer em armazenamento controlado por motivos legais, de privacidade ou licenciamento.No caso de ativos do mundo real, os metadados devem conectar os registros da blockchain a documentos legais aplicáveis, e não substituí-los.

Metadados off-chain e jogos

Jogos em blockchain frequentemente usam metadados off-chain porque os ativos de jogo podem mudar com frequência.Uma espada pode ganhar poder.Um personagem pode subir de nível.Um terreno pode mudar após a construção de uma estrutura por um jogador.Uma skin pode desbloquear novos estados visuais.Atualizações on-chain frequentes podem ser caras e lentas, então os estúdios podem armazenar metadados variáveis off-chain.Isso pode tornar a experiência de jogo mais fluida.Também significa que os jogadores precisam confiar nas regras de atualização do jogo.Se o jogo puder mudar os atributos dos itens a qualquer momento, o valor econômico desses itens também poderá mudar.Metadados bem projetados para jogos devem separar a propriedade permanente do estado mutável da partida.Os jogadores devem saber quais características são fixas e quais podem evoluir.

Metadados off-chain e identidade digital

Sistemas de identidade digital podem usar metadados off-chain para proteger a privacidade.Uma credencial pode precisar comprovar que um usuário tem determinado status, associação, licença ou conquista.Os dados pessoais brutos por trás dessa credencial muitas vezes devem permanecer off-chain.Uma blockchain pública geralmente não é um local seguro para números de passaporte, endereços residenciais, dados de saúde, arquivos de emprego ou registros legais privados.Em vez disso, um sistema de identidade pode armazenar on-chain um hash, compromisso, referência ao emissor ou ponteiro de verificação.Os metadados detalhados da credencial podem permanecer off-chain e ser compartilhados seletivamente.Esse modelo pode permitir tanto verificação quanto privacidade.Também pode criar dependência de emissores de credenciais, provedores de armazenamento e sistemas de acesso.Os metadados de identidade devem seguir o princípio da minimização de dados.Somente informações que realmente precisam de verificação pública devem ser colocadas on-chain.

Metadados off-chain e privacidade

Metadados off-chain podem melhorar a privacidade quando arquivos confidenciais são mantidos fora de registros públicos.No entanto, estar off-chain não significa automaticamente que algo é privado.Um arquivo de metadados HTTPS ainda pode ser público.Um arquivo do IPFS pode ser recuperado por qualquer pessoa que conheça o CID, se o conteúdo estiver disponível.Um arquivo de metadados pode revelar nomes, locais, associações, participação em eventos, vínculos com carteiras ou imagens privadas.Um projeto nunca deve colocar informações confidenciais de usuários em metadados públicos sem que eles entendam claramente o risco.Sistemas sensíveis à privacidade devem considerar criptografia, controles de acesso, divulgação seletiva, hashes e permissões off-chain.Os usuários devem presumir que metadados públicos podem ser copiados e arquivados.Excluir o arquivo do servidor original talvez não remova todas as cópias.A privacidade dos metadados exige planejamento antes da publicação, não uma tentativa de corrigir o problema após a exposição.

Metadados off-chain e direitos autorais

Metadados off-chain não comprovam automaticamente a titularidade de direitos autorais.Um arquivo de metadados pode afirmar que um NFT representa uma imagem, música, item de jogo ou objeto do mundo real famoso.Essa afirmação pode ser falsa.A blockchain pode comprovar que uma carteira possui um token, mas não comprova automaticamente que o emissor tinha direitos legais sobre a mídia.O campo de imagem dos metadados pode apontar para uma obra copiada.O campo de descrição pode conter informações enganosas sobre a licença.Um site de projeto pode desaparecer depois que os compradores confiarem nele.Antes de presumir que têm direitos de propriedade intelectual, os usuários devem verificar a identidade do criador, os termos da licença, o endereço do contrato, o histórico de emissão, a documentação oficial e os direitos legais.Para ativos valiosos, os contratos legais podem ser mais importantes do que o arquivo de metadados.Os metadados registram afirmações, mas não tornam todas elas verdadeiras.

Metadados off-chain e segurança

Metadados off-chain podem se tornar um risco de segurança quando os usuários confiam demais nas informações exibidas.Um arquivo de metadados malicioso pode conter links de phishing.Um servidor comprometido pode substituir uma imagem segura por uma chamada à ação maliciosa.Uma coleção falsa pode copiar o nome, a imagem e a descrição de um ativo legítimo.Uma carteira pode mostrar uma marca conhecida mesmo que o endereço do contrato esteja errado.Uma atualização de metadados pode mudar a identidade aparente de um ativo depois que o usuário o compra.Os aplicativos devem tratar metadados como dados não confiáveis.Devem validar campos, alertar sobre links suspeitos e evitar executar código inseguro proveniente dos metadados.Os usuários devem verificar os endereços dos contratos e ter cautela antes de clicar em links nas descrições dos ativos.A segurança não se limita ao contrato inteligente quando a exibição do ativo depende de arquivos externos.

Metadados off-chain e indexadores

Indexadores leem dados da blockchain e os organizam para carteiras, exploradores, jogos, dashboards e aplicativos.Quando os metadados estão off-chain, os indexadores geralmente buscam tokenURI ou contractURI e armazenam o JSON retornado em cache.Isso melhora a velocidade, pois os aplicativos não precisam buscar todos os arquivos de metadados a cada acesso.Também pode gerar dados desatualizados se os metadados mudarem e o indexador não atualizar o cache.Eventos de atualização como o ERC-4906 podem ajudar os indexadores a saber quando devem buscar novamente os metadados.Sem esses eventos, os aplicativos podem exibir imagens ou características antigas.Os indexadores também podem divergir se um gateway falhar e outro funcionar.Os desenvolvedores devem usar esquemas padronizados e sinais de atualização claros.Os usuários devem lembrar que a exibição em uma carteira é uma interpretação dos metadados, não a própria blockchain.Quando algo parecer errado, consultar a URI de origem pode ajudar.

Metadados off-chain e exibição em carteiras

As carteiras dependem muito dos metadados para tornar os tokens compreensíveis.Uma carteira pode exibir o nome, a imagem, o símbolo, a coleção, as características e a descrição do token com base nos metadados off-chain.Se os metadados estiverem ausentes, a carteira pode exibir uma imagem em branco ou um ativo desconhecido.Se os metadados carregarem lentamente, o ativo pode aparecer com atraso.Se os metadados forem alterados, a carteira pode exibir uma nova imagem ou novas características.Se forem maliciosos, a carteira pode exibir informações enganosas.Isso torna os metadados parte da experiência e da segurança do usuário.A forma como um token é exibido pode influenciar se o usuário assina uma transação, aceita uma oferta ou confia em uma coleção.Quando possível, as carteiras devem exibir endereços de contratos e indicadores de alerta.Os usuários não devem confiar apenas na imagem que aparece na carteira.

Metadados off-chain e DAOs

DAOs podem usar metadados off-chain para propostas, registros de governança, distintivos de associação, ativos do tesouro e credenciais da comunidade.Um token de governança ou NFT pode apontar para metadados que descrevem direitos de voto, funções dos membros ou histórico de participação.Uma proposta pode referenciar arquivos off-chain, como orçamentos, pareceres jurídicos, solicitações de subsídio ou planos de projeto.Armazenar todos os documentos de governança on-chain pode ser caro e expor informações privadas.Os metadados off-chain podem tornar a governança de uma DAO mais prática.O risco é que os arquivos da proposta sejam alterados depois de os participantes analisá-los.As DAOs podem reduzir esse risco armazenando hashes dos documentos, usando links endereçados por conteúdo e arquivando os materiais finais das propostas.Os votantes devem saber se o documento que leram é o mesmo que foi aprovado.A governança depende de registros claros.A praticidade do armazenamento off-chain não deve enfraquecer a prestação de contas.

Metadados off-chain e ativos gerados por IA

Ativos gerados por IA podem usar metadados off-chain para descrever prompts, versões de modelos, datas de geração, carteiras dos criadores, licenças e notas de procedência.Essas informações podem ser grandes demais ou sensíveis demais para serem armazenadas integralmente on-chain.Os metadados off-chain podem manter um registro mais completo da geração.Também podem ser editados ou removidos se o modelo de armazenamento for frágil.Um arquivo de metadados pode afirmar que uma imagem foi gerada por determinado modelo ou criador.Essa afirmação ainda precisa ser verificada.Para NFTs gerados por IA, os metadados devem distinguir dados factuais, afirmações dos criadores e direitos legais.Um hash da mídia original ou do pacote de prompts pode ajudar a comprovar que um arquivo não foi alterado.No entanto, um hash não comprova que o conteúdo é legal, original ou não viola direitos.Os metadados de ativos de IA devem ser transparentes sem exagerar o que podem comprovar.

Vantagens dos metadados off-chain

A primeira vantagem é o custo menor.Os projetos podem armazenar arquivos grandes sem pagar taxas de armazenamento da blockchain por cada byte.A segunda vantagem é a flexibilidade.Os metadados podem dar suporte a ativos dinâmicos, atualizações de jogos, revelações, correções e registros em evolução.A terceira vantagem é o suporte a mídia rica.Vídeos, arquivos de áudio, modelos 3D e imagens de alta resolução são mais fáceis de armazenar off-chain.A quarta vantagem é o controle de privacidade.Documentos confidenciais podem permanecer em armazenamento controlado em vez de serem colocados em um registro público.A quinta vantagem é o melhor desempenho.Os aplicativos podem usar sistemas de distribuição de conteúdo, gateways ou redes de armazenamento para carregar arquivos com eficiência.A sexta vantagem é a integração mais fácil.Metadados JSON e URIs padronizadas são amplamente compreendidos por carteiras, exploradores, jogos e indexadores.

Riscos e limitações dos metadados off-chain

O primeiro risco são links quebrados.Se a URL dos metadados parar de funcionar, o ativo pode não ser exibido corretamente.O segundo risco são alterações não autorizadas.Se o arquivo puder ser editado, o ativo poderá mudar depois da compra.O terceiro risco é a centralização.Um único servidor ou conta de nuvem pode se tornar um ponto de falha.O quarto risco é a baixa disponibilidade.O conteúdo do IPFS pode não ser recuperável se ninguém o fixar ou hospedar.O quinto risco é o vazamento de privacidade.Os metadados podem expor informações que não deveriam ser públicas.O sexto risco são afirmações enganosas.Os metadados podem alegar direitos, raridade, autenticidade ou garantias inexistentes.O sétimo risco é a inconsistência dos caches.Carteiras e indexadores diferentes podem exibir versões diferentes do mesmo ativo.

Erros comuns relacionados aos metadados off-chain

Um erro comum é presumir que a propriedade de um NFT significa que a mídia está armazenada on-chain.Muitos NFTs registram a propriedade on-chain e mantêm os metadados off-chain.Outro erro é usar uma URL HTTPS comum para uma coleção que promete permanência.Um terceiro erro é usar o IPFS sem fixar os dados de forma confiável.Um quarto erro é alterar os metadados sem emitir eventos de atualização.Um quinto erro é dar a uma única carteira de administrador controle ilimitado sobre os metadados sem informar os usuários.Um sexto erro é armazenar informações privadas de usuários em metadados públicos.Um sétimo erro é tratar metadados como prova legal de direitos autorais.Um oitavo erro é não fazer cópias de segurança dos arquivos de mídia antes da emissão.Um nono erro é usar campos fora do padrão que as carteiras não conseguem ler.Um décimo erro é não verificar como os metadados são exibidos em diferentes carteiras e exploradores.

Boas práticas para desenvolvedores

Escolha o modelo de armazenamento dos metadados antes de implantar o contrato.Use armazenamento endereçado por conteúdo quando a integridade de longo prazo for importante.Use URIs do IPFS em vez de URLs específicas de gateways ao vincular conteúdo do IPFS.Fixe os metadados e a mídia no IPFS usando uma infraestrutura confiável.Use opções de armazenamento permanente quando o ativo prometer disponibilidade de longo prazo.Armazene hashes ou compromissos on-chain quando documentos off-chain importantes precisarem ser verificados.Emita eventos de atualização de metadados quando eles mudarem.Documente se os metadados são mutáveis, congelados, dinâmicos ou sujeitos a revelação.Proteja as funções de atualização de metadados com controles de acesso robustos.Evite inserir dados pessoais confidenciais em arquivos públicos de metadados.

Boas práticas para usuários

Antes de comprar um ativo valioso, verifique tokenURI ou o local dos metadados.Confira se os metadados usam HTTPS, IPFS, Arweave ou outro método de armazenamento.Verifique se o conteúdo do IPFS está fixado ou preservado de outra forma.Procure a documentação do projeto sobre congelamento dos metadados e controles de atualização.Verifique o endereço do contrato em vez de confiar na imagem ou no nome exibido.Tenha cautela com links externos nas descrições dos metadados.Não presuma que a imagem de um token comprova direitos autorais.Quando possível, use exploradores de blockchain para inspecionar as funções de metadados.Para ativos de alto valor, verifique se a mídia e os metadados ainda podem ser recuperados por caminhos independentes.Trate os metadados como parte da diligência prévia, não como uma prova completa de valor.

Quando os metadados off-chain são úteis

Metadados off-chain são úteis quando os arquivos são grandes demais para serem armazenados com eficiência on-chain.São úteis quando os ativos precisam de imagens, vídeos, áudio, modelos 3D ou conteúdo interativo rico.São úteis quando os metadados precisam mudar de acordo com o estado de um jogo, uma situação de associação ou eventos do mundo real.São úteis quando documentos legais ou privados não devem ficar permanentemente públicos.São úteis quando um projeto precisa de carregamento rápido e ampla compatibilidade com aplicativos.São úteis quando armazenamento endereçado por conteúdo ou permanente pode oferecer integridade e disponibilidade robustas.São úteis para NFTs, itens de jogos, ativos tokenizados, credenciais de identidade, registros de DAOs e dados de exibição de contratos.São menos úteis quando um projeto promete máxima permanência, mas depende apenas de um servidor frágil.São menos úteis quando os controles de atualização não estão claros ou são poderosos demais.São perigosos quando informações confidenciais são expostas por meio de arquivos públicos de metadados.

Metadados off-chain em uma frase

Metadados off-chain são informações sobre criptoativos armazenadas fora da blockchain e referenciadas por registros on-chain, tornando dados de NFTs, tokens, jogos, identidade e ativos do mundo real mais baratos e flexíveis, mas acrescentando riscos de armazenamento, confiança, disponibilidade e atualização.

Perguntas frequentes

O que significa metadados off-chain?

Metadados off-chain são informações descritivas sobre um ativo, armazenadas fora da blockchain, mas referenciadas por um token, contrato, URI, hash ou ponteiro da blockchain.

Metadados off-chain são ruins?

Não. Eles não são automaticamente ruins, pois podem reduzir custos e oferecer suporte a mídia rica, mas precisam ser armazenados e protegidos com cuidado.

Por que os NFTs usam metadados off-chain?

Os NFTs usam metadados off-chain porque imagens, vídeos, arquivos JSON e atributos podem ser grandes ou caros demais para armazenamento direto on-chain.

O que é tokenURI?

tokenURI é uma função comum de NFT que retorna a URI onde os metadados de um ID específico de token podem ser encontrados.

Qual é o risco dos metadados HTTPS?

Os metadados HTTPS podem parar de funcionar ou mudar se o servidor, domínio, conta de nuvem ou operador do projeto falhar ou for comprometido.

Metadados do IPFS são off-chain?

Sim. Em relação à blockchain do token, os metadados do IPFS são off-chain, mas o endereçamento por conteúdo pode ajudar a verificar a integridade do arquivo.

O IPFS garante disponibilidade permanente?

Não. O IPFS identifica o conteúdo pelo CID, mas ele ainda precisa ser fixado, hospedado ou preservado para que os usuários possam recuperá-lo no futuro.

Os metadados off-chain podem ser alterados?

Sim. Eles podem ser alterados se o projeto ou servidor controlar o arquivo, a menos que o modelo use links imutáveis, metadados congelados ou compromissos robustos.

O que são metadados dinâmicos?

São metadados que mudam com o tempo com base em atualizações, estado do jogo, conquistas, dados de oráculos, situação de associação ou regras do emissor.

Os metadados comprovam a titularidade de direitos autorais?

Não. Os metadados podem descrever um ativo ou reivindicar direitos, mas os direitos autorais e a propriedade legal dependem de licenças, contratos, autoridade do emissor e legislação aplicável.

Como os usuários podem verificar metadados off-chain?

Os usuários podem inspecionar tokenURI, verificar o método de armazenamento, conferir hashes de conteúdo ou CIDs, analisar permissões de atualização e testar se os metadados e a mídia podem ser recuperados.

Qual é o modelo mais seguro para metadados off-chain?

Um modelo mais seguro usa esquemas padronizados, armazenamento endereçado por conteúdo, persistência confiável, hashes ou compromissos on-chain, controles de atualização claros e informações honestas sobre o que pode mudar.

Conclusão

Metadados off-chain são uma das escolhas de projeto mais comuns em criptoativos porque permitem conectar a propriedade registrada na blockchain a informações detalhadas e legíveis.Sem metadados, um token pode consistir apenas em um endereço, um ID de token e um saldo.Com metadados, os usuários podem ver um nome, imagem, descrição, características, documentos, mídia e contexto.A popularidade dos metadados off-chain tem um motivo prático.Armazenar arquivos grandes em blockchains é caro.Sistemas off-chain podem armazenar arquivos JSON, imagens, vídeos, dados de jogos, documentos legais e registros de identidade com mais economia e flexibilidade.Isso facilita a criação e a exibição de NFTs, ativos tokenizados, jogos, credenciais e perfis de contratos.No entanto, os metadados off-chain mudam o modelo de confiança.A blockchain pode proteger a propriedade, mas o significado do ativo pode depender de um arquivo externo.Se esse arquivo desaparecer, mudar ou ficar indisponível, a experiência do usuário e o valor do ativo podem ser prejudicados.Servidores web comuns são fáceis de usar, mas frágeis para ativos cripto de longo prazo.O IPFS melhora a integridade por meio do endereçamento por conteúdo, mas os arquivos ainda precisam ser fixados e ter sua disponibilidade planejada.O Arweave e outros sistemas de armazenamento persistente podem melhorar o acesso de longo prazo, mas os usuários ainda devem verificar o que está realmente armazenado e referenciado.Metadados dinâmicos podem tornar os ativos mais úteis, mas também podem criar controle oculto se as atualizações não forem claramente governadas.Para desenvolvedores, a abordagem mais segura é projetar os metadados com transparência desde o início.Use padrões compatíveis com carteiras e indexadores.Use armazenamento endereçado por conteúdo quando a integridade for importante.Armazene hashes ou compromissos quando documentos off-chain precisarem ser verificados.Emita eventos de atualização quando os metadados mudarem.Proteja as permissões de atualização.Evite colocar dados pessoais confidenciais em arquivos públicos.Para os usuários, a abordagem mais segura é inspecionar o método de armazenamento antes de confiar no ativo.Uma imagem bonita na carteira não basta.As perguntas importantes são onde os metadados ficam, se podem mudar, quem os controla, se podem ser recuperados e se as afirmações legais são reais.Metadados off-chain não são uma fragilidade por si só.São uma escolha com vantagens e desvantagens.Usados com cuidado, tornam os criptoativos mais expressivos, acessíveis e úteis.Usados sem cuidado, podem transformar um ativo da blockchain em um link quebrado, uma imagem enganosa ou uma promessa impossível de verificar.