URI de token

O que é uma URI de token?

Uma URI de token é um link ou identificador que aponta para os metadados de um token de criptomoeda.

Na maioria das conversas sobre cripto, URI de token é usada para NFTs, pois os NFTs frequentemente precisam de metadados como nome, descrição, imagem, animação, atributos, características e arquivos externos.

O padrão oficial RFC 3986 URI define uma URI como uma sequência compacta de caracteres que identifica um recurso abstrato ou físico.

Em contratos de NFT, uma URI de token geralmente identifica o recurso de metadados conectado a um ID de token específico.

O padrão oficial ERC-721 define uma função opcional de metadados chamada

, que pode retornar uma URI distinta para um token não fungível específico.

Uma URI de token pode apontar para metadados armazenados em IPFS, Arweave, um servidor web comum ou diretamente dentro do contrato inteligente por meio de uma URI de dados.

Uma URI de token normalmente não armazena a própria obra de arte na blockchain.

Em vez disso, ela geralmente informa a carteiras, marketplaces, exploradores e aplicativos descentralizados onde encontrar o arquivo de metadados que descreve o token.

Por isso, uma URI de token é um dos detalhes técnicos mais importantes por trás da exibição de NFTs.

Em um glossário cripto, URI de token deve ser entendida como o ponteiro de metadados que conecta um ID de token on-chain às informações off-chain ou on-chain que os usuários realmente veem.

Por que URIs de token são importantes no mercado cripto

URIs de token são importantes porque blockchains são otimizadas para propriedade, transferências e verificação, e não para armazenar arquivos de mídia grandes de forma econômica.

Um NFT pode representar arte digital, música, equipamento de jogo, um passe de associação, uma identidade semelhante a um domínio, um ingresso, uma credencial ou o registro de um ativo do mundo real.

A blockchain pode registrar quem possui o token, mas os usuários ainda precisam de uma forma de ver o que o token representa.

A URI de token fornece essa conexão.

Sem uma URI de token funcional, um NFT pode aparecer como um item em branco, uma imagem corrompida ou apenas um endereço de contrato e um ID de token.

Para colecionadores, a qualidade da URI de token pode afetar a confiança, o valor de revenda e a confiança de longo prazo.

Para desenvolvedores, o design da URI de token afeta a compatibilidade com carteiras, a exibição em marketplaces, as atualizações de metadados, as mecânicas de revelação e a experiência do usuário.

Para traders, a estrutura da URI de token pode revelar se os metadados são permanentes, mutáveis, centralizados ou controlados por um administrador.

Para projetos de jogos e ativos do mundo real, o design da URI de token pode determinar se os dados dinâmicos de itens ou referências de documentos permanecem precisos.

Portanto, uma URI de token não é apenas um link técnico, pois molda como os usuários entendem o token.

Como funciona uma URI de token

Uma URI de token geralmente funciona por meio de uma função de contrato inteligente que aceita um ID de token e retorna uma string URI.

Para um NFT ERC-721, uma carteira ou dApp pode chamar

para perguntar ao contrato onde os metadados estão localizados.

O contrato retorna uma string como

, ou .

A carteira ou dApp então busca ou decodifica os metadados.

Os metadados geralmente são um JSON que contém campos como

, , e .

Se os metadados incluírem um campo de imagem, a carteira busca essa imagem e a exibe ao usuário.

Se os metadados incluírem características, o marketplace ou aplicativo poderá mostrar detalhes de raridade, estatísticas do jogo ou filtros de categoria.

Esse processo pode ocorrer por meio de uma chamada direta ao contrato, um indexador, uma API, um cache ou um serviço de metadados de carteira.

O usuário normalmente vê apenas a imagem e os detalhes finais, não todo o processo de resolução.

No entanto, entender a URI de token ajuda os usuários a avaliar se os metadados do NFT são confiáveis.

URI de token no ERC-721

ERC-721 é o principal padrão de token para NFTs únicos em redes no estilo Ethereum.

A extensão de metadados ERC-721 inclui

, e .

A função

é opcional no padrão, mas é amplamente utilizada porque os usuários esperam que os NFTs exibam metadados.

Um projeto ERC-721 básico pode armazenar uma URI-base e combiná-la com um ID de token.

Por exemplo, o contrato pode combinar

com para formar .

A documentação oficial do OpenZeppelin ERC-721 explica que uma URI-base pode ser usada para calcular

e que a URI resultante pode ser a URI-base mais o ID do token.

Outros projetos podem armazenar uma URI diferente para cada ID de token.

Alguns projetos podem gerar todos os metadados diretamente on-chain.

Alguns projetos podem apontar para um servidor que cria metadados dinâmicos sob demanda.

Como os projetos ERC-721 podem implementar metadados de maneiras diferentes, os usuários devem verificar como uma coleção específica trata sua URI de token.

URI de token no ERC-1155

ERC-1155 é um padrão multitoque que pode lidar com tokens fungíveis, tokens semifungíveis e NFTs em um único contrato.

O padrão oficial ERC-1155 define um padrão de URI de metadados no qual uma string URI pode incluir o marcador

.

Os clientes substituem

pelo ID de token real no formato hexadecimal exigido.

Isso significa que um modelo de URI pode oferecer suporte a muitos IDs de token.

Por exemplo, um contrato ERC-1155 pode retornar

.

A carteira ou dApp deve substituir

pelo ID de token correto antes de buscar os metadados.

Essa abordagem pode ser eficiente para ativos de jogos, edições, ingressos, associações e coleções com muitos tipos de token.

Ela também cria uma fonte comum de erros de exibição quando um cliente trata incorretamente a substituição do ID do token.

A documentação oficial do OpenZeppelin ERC-1155 Metadata URI explica que a extensão de URI de metadados pode apontar cada token para um arquivo JSON que segue o esquema de metadados ERC-1155.

Um usuário que vê metadados ERC-1155 corrompidos deve considerar se o problema vem do contrato, da camada de armazenamento, do cliente ou do processo de substituição.

URI de token vs. metadados

Uma URI de token não é a mesma coisa que metadados.

A URI de token é o ponteiro.

Os metadados são as informações encontradas nesse ponteiro.

Por exemplo,

é uma URI de token.

O arquivo JSON encontrado nessa URI são os metadados.

Os metadados podem incluir o nome do token, a descrição, o link da imagem, o link da animação, atributos, cor de fundo, página externa, informações de licença ou outros campos.

Se a URI de token mudar, o local dos metadados poderá mudar.

Se o arquivo de metadados mudar, o token poderá exibir conteúdo diferente mesmo que a URI de token permaneça a mesma.

Essa diferença é importante porque alguns projetos afirmam que os metadados são fixos quando apenas o formato da URI de token é fixo.

Os usuários devem verificar tanto a URI de token quanto o conteúdo que ela retorna.

URI de token vs. URI de imagem

Uma URI de token também não é a mesma coisa que uma URI de imagem.

A URI de token geralmente aponta para um arquivo JSON de metadados.

O arquivo JSON de metadados pode então incluir um campo

que aponta para a obra de arte ou arquivo de mídia real.

Por exemplo,

pode retornar .

Dentro de

, o campo pode apontar para .

Isso cria duas camadas de confiabilidade.

O arquivo de metadados deve permanecer disponível.

A imagem ou o arquivo de mídia referenciado dentro dos metadados também deve permanecer disponível.

Um token pode carregar seus metadados corretamente, mas ainda mostrar uma imagem corrompida se a URI da imagem falhar.

Uma boa due diligence de NFT verifica ambas as camadas.

Formatos comuns de URI de token

Os formatos mais comuns de URI de token são

, , e .

Uma URI de token

aponta para conteúdo endereçado por IPFS.

Uma URI de token

aponta para um servidor web comum ou endpoint de API.

Uma URI de token

pode apontar para dados hospedados no Arweave.

Uma URI de token

contém os metadados diretamente dentro da URI.

Cada formato apresenta diferentes compromissos em relação à permanência, custo, conveniência, mutabilidade e compatibilidade.

Os metadados HTTP são fáceis de criar e atualizar, mas podem ser centralizados e frágeis.

Os metadados IPFS podem melhorar a integridade do conteúdo, mas o conteúdo ainda precisa estar fixado e ser recuperável.

URIs de dados podem oferecer suporte a metadados totalmente on-chain, mas podem ser maiores e mais difíceis de implementar.

O formato da URI de token diz muito aos usuários sobre como o projeto considera a durabilidade e o controle.

URI de token e IPFS

IPFS é uma das opções de armazenamento mais comuns para metadados de NFT.

A documentação oficial sobre endereçamento de conteúdo do IPFS explica que o IPFS usa Content Identifiers, ou CIDs, para lidar com dados endereçados por conteúdo.

O endereçamento de conteúdo significa que o identificador está vinculado ao próprio conteúdo, e não apenas à localização de um servidor.

Isso ajuda os usuários a verificar que os metadados ou a mídia não foram alterados silenciosamente sob o mesmo identificador.

Uma URI de token como

aponta para o conteúdo por meio de um CID.

Carteiras e dApps frequentemente convertem links

em URLs de gateway para que navegadores possam carregar o conteúdo.

Essa conversão é apenas um método de recuperação e não altera o identificador de conteúdo IPFS subjacente.

O conteúdo IPFS ainda precisa estar disponível em nós, serviços de pinning, gateways ou outra infraestrutura de armazenamento.

Se ninguém armazenar ou disponibilizar o conteúdo, o CID poderá continuar válido enquanto os metadados se tornam difíceis de recuperar.

Por esse motivo, o IPFS melhora a integridade, mas não garante automaticamente a disponibilidade para sempre.

URI de token e links HTTP

Muitos projetos de NFT usam URIs de token

porque são simples e familiares.

Um servidor pode gerar metadados rapidamente, atualizar arquivos, controlar o momento da revelação e oferecer suporte a conteúdo dinâmico.

Isso é útil para jogos, passes de associação, ingressos para eventos ao vivo e projetos que precisam alterar metadados.

A fragilidade é que links web comuns dependem de servidores, domínios, contas de hospedagem e operações do projeto.

Se o servidor ficar offline, o NFT poderá deixar de ser exibido corretamente.

Se o domínio expirar, outra pessoa poderá controlar o endpoint de metadados posteriormente.

Se o projeto alterar o JSON, os usuários poderão ver imagens ou características diferentes.

Isso não significa que todas as URIs de token HTTP são ruins.

Significa que os usuários devem saber se os metadados são controlados por um servidor centralizado e se o projeto possui um plano de preservação de longo prazo.

Para NFTs de alto valor, a dependência do servidor deve fazer parte da análise de risco.

URI de token e URIs de dados

Uma URI de dados pode armazenar os metadados diretamente dentro da string retornada.

Muitos NFTs totalmente on-chain usam uma URI de token

.

Isso significa que o contrato retorna JSON codificado, em vez de um link para um arquivo externo.

O JSON pode incluir uma imagem SVG incorporada ou outra referência de mídia on-chain.

Essa abordagem pode reduzir a dependência de armazenamento externo.

Ela também pode tornar o contrato mais caro e complexo.

Carteiras e dApps devem decodificar corretamente a URI de dados para exibir o token.

Uma URI de dados pode ser poderosa para arte generativa, tokens de identidade, badges e mídias simples que podem ser criadas por código.

Ela pode ser menos prática para vídeos grandes, imagens de alta resolução ou arquivos complexos de jogos.

URIs de dados mostram que uma URI de token nem sempre significa um link web comum.

URI de token e URI-base

Uma URI-base é um caminho inicial compartilhado usado para criar links de metadados específicos de cada token.

Por exemplo, um contrato pode armazenar

como sua URI-base.

Quando alguém chama

, o contrato pode retornar .

Esse padrão economiza armazenamento porque o contrato não precisa armazenar uma URI completa para cada token.

A lógica de URI-base é comum em coleções ERC-721.

Ela também é comum em projetos baseados em revelação, nos quais a URI-base pode mudar de um local de preenchimento para um local final de metadados.

O risco é que um administrador possa alterar a URI-base após o mint.

Se a URI-base puder ser alterada, os usuários devem saber quem controla essa permissão e se ela pode ser bloqueada ou renunciada.

Uma URI-base fixa pode favorecer a confiança, enquanto uma URI-base sem restrições pode criar risco de alteração de metadados.

Portanto, o design da URI-base é uma parte importante da segurança dos metadados de NFT.

URI de token e revelações de NFT

As mecânicas de revelação de NFT frequentemente dependem de mudanças na URI de token.

Antes da revelação, todos os tokens podem apontar para os mesmos metadados de preenchimento.

Após a revelação, o contrato pode atualizar a URI-base para que cada token aponte para seu arquivo final de metadados.

Isso cria uma experiência comum na qual os compradores veem uma imagem misteriosa antes que a obra de arte final apareça.

Os sistemas de revelação podem ser legítimos quando são transparentes e justos.

Eles também podem gerar questões de confiança se a equipe do projeto puder manipular metadados após ver os resultados do mint.

Os usuários devem perguntar se os metadados foram preparados antes do mint e se o processo de revelação é verificável.

Os desenvolvedores devem usar eventos claros e documentação pública ao atualizar metadados.

Uma revelação não deve ser uma oportunidade oculta para pessoas internas atribuírem características raras de forma injusta.

O comportamento da URI de token é central para que uma revelação de NFT pareça confiável.

URI de token e atualizações de metadados

Alguns NFTs são projetados para mudar com o tempo.

Um item de jogo pode subir de nível.

Um passe de associação pode ser renovado ou expirar.

Um token de ativo do mundo real pode atualizar referências de documentos.

Um token de arte dinâmica pode mudar com base em dados on-chain ou off-chain.

A extensão oficial de atualização de metadados ERC-4906 define eventos de atualização de metadados que ajudam plataformas de terceiros a saber quando os metadados de um token foram alterados.

Isso é importante porque carteiras e marketplaces frequentemente armazenam metadados em cache para melhorar a velocidade.

Se os metadados mudarem sem um sinal claro de atualização, os usuários poderão continuar vendo informações desatualizadas.

As atualizações de metadados são úteis quando esperadas e documentadas.

As atualizações de metadados são arriscadas quando dão a um emissor controle ilimitado sobre o que os usuários compraram.

URI de token e metadados no nível do contrato

A URI de token geralmente descreve um ID de token específico.

Os metadados no nível do contrato descrevem toda a coleção ou contrato.

O padrão oficial de metadados no nível do contrato ERC-7572 padroniza

para informações no nível da coleção, como nome, descrição e imagem.

Essa distinção é importante porque uma coleção precisa de metadados no nível do token e no nível da coleção.

A URI de token responde o que um token representa.

A URI de contrato responde o que toda a coleção ou contrato representa.

Uma carteira pode usar a URI de token para exibir a imagem específica do NFT.

Um marketplace pode usar metadados no nível do contrato para exibir o logotipo, o banner e a descrição de uma coleção.

Ambas as camadas de metadados devem ser precisas, duráveis e transparentes.

Um design completo de metadados de NFT não deve se concentrar apenas no arquivo individual do token.

URI de token e ERC-1046

Em todas as discussões sobre padrões, URI de token não se limita a NFTs.

A proposta oficial de interoperabilidade ERC-1046 tokenURI adiciona uma função

ao ERC-20 e estende a interoperabilidade de metadados entre os tipos de token ERC-20, ERC-721 e ERC-1155.

Isso é importante porque tokens fungíveis também podem se beneficiar de metadados mais completos.

Um token fungível pode precisar de logotipo, descrição, site do projeto, informações do emissor, documentação do ativo ou detalhes de conformidade.

Na prática, o suporte ao ERC-1046 pode variar entre carteiras e aplicativos.

Ainda assim, a proposta demonstra que os metadados de tokens são um tema de design mais amplo do que apenas obras de arte de NFT.

À medida que o mercado cripto se torna mais orientado a aplicativos, metadados padronizados podem se tornar mais importantes em muitos tipos de token.

Os usuários ainda devem verificar contratos de token e fontes oficiais, em vez de confiar apenas em campos de metadados.

Os metadados podem ajudar a exibir informações, mas não comprovam legitimidade por si só.

Uma URI de token só é útil quando as informações retornadas são precisas e confiáveis.

URI de token e cache

Cache significa salvar metadados temporariamente para que os aplicativos possam carregar tokens mais rapidamente.

Carteiras, exploradores, marketplaces e indexadores frequentemente armazenam resultados de URI de token e arquivos de metadados em cache.

Isso melhora o desempenho porque buscar milhares de arquivos de metadados repetidamente seria lento.

A desvantagem é que os metadados armazenados em cache podem ficar desatualizados.

Um token pode revelar uma nova obra de arte, mas a carteira pode continuar mostrando a antiga imagem de preenchimento.

Um NFT dinâmico pode atualizar suas características, mas o marketplace pode continuar mostrando a versão anterior.

Eventos de atualização de metadados e botões de atualização podem ajudar a resolver esse problema.

Os usuários devem se lembrar de que um problema de exibição pode vir do cache, e não do próprio contrato de NFT.

Os desenvolvedores devem usar estruturas de metadados previsíveis e eventos de atualização padrão para facilitar o cache.

Um bom design de URI de token reduz confusões desnecessárias sobre metadados.

URI de token e mutabilidade

Mutabilidade significa que a URI de token ou os metadados para os quais ela aponta podem mudar.

Alguma mutabilidade é útil para NFTs dinâmicos, jogos, ingressos, credenciais e associações em evolução.

Outra mutabilidade cria risco porque o emissor pode conseguir alterar a obra de arte ou as características depois que os usuários compram o token.

Uma URI de token pode ser imutável enquanto o servidor de metadados é mutável.

Uma URI de token também pode ser mutável se o proprietário do contrato inteligente puder alterar a URI-base.

Um projeto pode congelar os metadados bloqueando a URI-base, fazendo pinning do conteúdo IPFS final ou removendo poderes de atualização do administrador.

Os usuários devem perguntar se os metadados são congelados, dinâmicos, controlados por administrador ou totalmente on-chain.

Os desenvolvedores devem explicar claramente a mutabilidade antes do mint.

A mutabilidade oculta pode prejudicar a confiança e reduzir a confiança do mercado.

A mutabilidade esperada pode criar experiências de token úteis e envolventes.

URI de token e riscos de segurança

URIs de token podem criar riscos de segurança porque carteiras e dApps buscam e exibem conteúdo externo.

Metadados maliciosos podem incluir links de phishing, mensagens falsas de recompensa, imagens enganosas ou URLs externas inseguras.

Um NFT de spam pode aparecer em uma carteira e usar seus metadados para informar ao usuário que visite uma página falsa de resgate.

Uma coleção falsa pode copiar nomes e imagens de uma coleção real.

Um servidor comprometido pode alterar os metadados para direcionar os usuários a um site malicioso.

Carteiras e dApps devem tratar metadados como entrada não confiável.

Os usuários não devem clicar em links presentes em metadados de NFTs desconhecidos.

Os usuários nunca devem inserir frases de recuperação, chaves privadas ou backups de carteira porque uma imagem ou descrição de NFT instrui que façam isso.

Uma URI de token ajuda a exibir dados, mas também pode exibir dados controlados por invasores.

O comportamento cripto seguro exige ceticismo diante de tokens não solicitados e metadados suspeitos.

URI de token e permanência de NFTs

A permanência de NFTs depende, em parte, do design da URI de token.

Um token pode permanecer on-chain enquanto seus metadados desaparecem.

Se uma URI de token apontar para um servidor inativo, o NFT poderá não ser mais exibido corretamente.

Se uma URI de token apontar para conteúdo IPFS que não está fixado, os metadados poderão se tornar difíceis de recuperar.

Se uma URI de token apontar para dados on-chain, a permanência poderá ser maior, mas o custo e a flexibilidade poderão ser limitados.

Os colecionadores devem entender isso antes de comprar NFTs de alto valor.

Os desenvolvedores devem projetar o armazenamento de metadados para a vida útil esperada do ativo.

Os projetos devem explicar se os metadados são permanentes, mutáveis, descentralizados, centralizados ou dependentes de um servidor da empresa.

Um NFT não é automaticamente permanente apenas porque a propriedade está registrada em uma blockchain.

A URI de token e o plano de armazenamento determinam se o token continua visual e informacionalmente útil.

URI de token e tokens de ativos do mundo real

Tokens de ativos do mundo real podem usar URIs de token para fazer referência a documentos, certificados, imagens, auditorias, avaliações, termos legais ou registros de verificação.

Isso pode tornar o design de URI de token mais sensível do que metadados de colecionáveis comuns.

Uma URI de token de ativo do mundo real pode exigir controle de versão, restrições de acesso, hashes de documentos, detalhes do emissor e contexto legal claro.

Uma URI de token corrompida ou desatualizada pode induzir os usuários ao erro sobre o ativo representado.

Uma URI de token, por si só, não comprova a propriedade legal de um ativo físico.

O acordo legal, o emissor, o custodiante, a jurisdição, o processo de resgate e a documentação continuam sendo importantes.

Os usuários devem ler os documentos oficiais do ativo e não confiar apenas nos metadados exibidos em uma carteira.

Os desenvolvedores devem evitar misturar imagens de marketing com registros legalmente importantes de forma confusa.

Para ativos do mundo real, a qualidade da URI de token faz parte da qualidade das divulgações.

Os metadados devem apoiar a verificação, e não substituir a due diligence legal.

URI de token e ativos de jogos

Os ativos de jogos frequentemente usam URIs de token para descrever itens, personagens, skins, terrenos, armas, badges e conquistas.

Um NFT de jogo pode precisar de metadados dinâmicos porque as estatísticas de itens podem mudar durante a jogabilidade.

Uma espada pode subir de nível.

Um personagem pode adquirir novas características.

Um terreno pode exibir construções aprimoradas.

Uma URI de token pode retornar metadados que refletem essas mudanças.

Isso torna os ativos de jogos blockchain mais interativos.

Também significa que o servidor do jogo ou o mecanismo de metadados podem se tornar importantes para a utilidade do ativo.

Se o jogo for encerrado, alguns metadados dinâmicos poderão deixar de ser atualizados.

Os usuários devem entender quais partes de um ativo de jogo estão realmente on-chain e quais partes dependem do operador do jogo.

Como verificar uma URI de token

Os usuários podem verificar uma URI de token visualizando o contrato do token em um explorador de blockchain e lendo a função

, quando disponível.

Eles também podem usar ferramentas de desenvolvedor, visualizações de metadados de carteiras, ferramentas de análise de NFT ou chamadas diretas ao contrato.

Para tokens ERC-1155, os usuários devem se lembrar de que a URI pode incluir um marcador

.

Após encontrar a URI, os usuários podem verificar se ela usa IPFS, HTTP, Arweave ou uma URI de dados.

Se a URI apontar para JSON, os usuários poderão abrir ou buscar o JSON por meio de um visualizador seguro.

Eles devem verificar se os campos de imagem e atributos apontam para locais confiáveis.

Eles devem comparar o endereço do contrato com o endereço oficial do projeto.

Eles devem ter cuidado para não interagir com links suspeitos encontrados nos metadados.

Verificar uma URI de token é útil para due diligence, mas os usuários devem evitar sites inseguros e ferramentas não confiáveis.

Em caso de dúvida, use ferramentas somente de leitura e nunca assine transações apenas para visualizar metadados.

Problemas comuns de URI de token

O primeiro problema comum é uma URI de token ausente ou vazia.

O segundo problema comum são metadados JSON inválidos.

O terceiro problema comum é um link de imagem corrompido dentro dos metadados.

O quarto problema comum é um CID IPFS que não está disponível em nenhum gateway.

O quinto problema comum é um servidor centralizado que fica offline.

O sexto problema comum são metadados armazenados em cache e desatualizados após uma revelação.

O sétimo problema comum é um marcador

ERC-1155 tratado incorretamente.

O oitavo problema comum são metadados que mudam sem aviso.

O nono problema comum é uma URI de token controlada por uma chave de administrador sem limites claros.

O décimo problema comum são metadados maliciosos projetados para enganar os usuários e levá-los a sites de phishing.

Práticas recomendadas para desenvolvedores

Use funções de metadados padrão ao criar tokens ERC-721 ou ERC-1155.

Retorne strings URI válidas que carteiras e aplicativos possam resolver de forma confiável.

Use metadados JSON claros que atendam às expectativas comuns de marketplaces e carteiras.

Prefira armazenamento durável para ativos de longo prazo.

Use armazenamento endereçado por conteúdo quando a integridade dos metadados for importante.

Faça pinning dos metadados e da mídia IPFS, em vez de presumir que o conteúdo permanecerá disponível automaticamente.

Documente se os metadados são mutáveis, congelados, dinâmicos ou controlados por administrador.

Emita eventos padrão de atualização de metadados quando os metadados mudarem.

Teste o comportamento da URI de token em várias carteiras, exploradores e dApps antes do mint público.

Não dependa de controles de metadados ocultos que os usuários não possam entender ou auditar.

Práticas recomendadas para usuários

Verifique a URI de token antes de comprar NFTs caros.

Verifique se os metadados são armazenados em IPFS, Arweave, HTTP ou dados on-chain.

Analise se o projeto pode alterar a URI-base ou os metadados após o mint.

Tenha cautela com NFTs que dependem apenas de um servidor centralizado.

Não clique em links suspeitos dentro dos metadados de NFT.

Não assine transações apenas porque uma página de metadados informa que há uma recompensa disponível.

Verifique se o endereço do contrato do token corresponde às fontes oficiais do projeto.

Use pequenas transações de teste ao interagir com contratos ou ferramentas de NFT desconhecidos.

Entenda que a imagem de um token em uma carteira não comprova que a coleção é oficial.

Trate a análise da URI de token como parte da due diligence de NFTs.

Perguntas frequentes

O que significa URI de token?

URI de token significa a URI que aponta para os metadados de um token de criptomoeda, especialmente um NFT.

O que tokenURI faz?

A função

geralmente retorna a URI de metadados para um ID de token ERC-721 específico.

URI de token é o mesmo que metadados de NFT?

Não. A URI de token é o ponteiro, enquanto os metadados são as informações encontradas nesse ponteiro.

URI de token é o mesmo que a imagem de NFT?

Não. A URI de token geralmente aponta para um arquivo JSON de metadados, e esse arquivo JSON pode conter uma URI de imagem separada.

O que é uma URI de token ERC-721?

Uma URI de token ERC-721 é uma URI retornada por

para um NFT único.

O que é uma URI de token ERC-1155?

Uma URI de token ERC-1155 é uma URI de metadados que pode usar um marcador

para diferentes IDs de token.

O que significa uma URI de token IPFS?

Uma URI de token IPFS significa que os metadados são referenciados por meio de um identificador de conteúdo IPFS.

Uma URI de token pode mudar?

Sim. Uma URI de token pode mudar se o contrato permitir atualizações de metadados, alterações de URI-base, metadados dinâmicos ou respostas controladas pelo servidor.

Os metadados de NFT podem mudar sem que a URI de token mude?

Sim. Os metadados podem mudar se a URI de token apontar para um servidor mutável ou um arquivo que possa ser substituído no mesmo local web.

Uma URI de token on-chain é mais segura?

Uma URI de token on-chain pode reduzir a dependência de armazenamento externo, mas pode ser mais cara e ainda exige um design cuidadoso do contrato.

Por que os metadados do meu NFT não aparecem?

Os metadados podem não aparecer porque a URI de token está ausente, o JSON é inválido, o armazenamento está indisponível, o link da imagem está corrompido ou o cache do aplicativo está desatualizado.

O que é uma URI-base?

Uma URI-base é um prefixo compartilhado que um contrato de token pode combinar com IDs de token para criar URIs de token completas.

O que é uma revelação no design de URI de token?

Uma revelação é uma atualização de metadados em que URIs de token de preenchimento são substituídas ou redirecionadas para os metadados finais do token.

Os metadados de URI de token podem ser maliciosos?

Sim. Os metadados podem incluir links de phishing, descrições enganosas, mensagens falsas de recompensa ou referências externas inseguras.

O que os usuários devem verificar antes de confiar em uma URI de token?

Os usuários devem verificar o tipo de armazenamento, permissões do contrato, endereço oficial do contrato, disponibilidade dos metadados, link da imagem, regras de mutabilidade e links externos suspeitos.

Conclusão

Uma URI de token é o ponteiro de metadados que conecta um token de blockchain às informações que os usuários veem em carteiras, exploradores, marketplaces e dApps.

Para NFTs ERC-721, ela é comumente retornada por

.

Para tokens ERC-1155, ela pode ser retornada por meio de um modelo de URI que usa o marcador

.

Uma URI de token pode apontar para IPFS, Arweave, servidores HTTPS ou dados armazenados diretamente dentro do contrato inteligente.

Cada formato tem diferentes compromissos em relação à permanência, flexibilidade, custo, compatibilidade e confiança.

O design da URI de token afeta se os NFTs são exibidos corretamente, se os metadados podem mudar, se as imagens permanecem disponíveis e se os usuários podem verificar o que possuem.

Os desenvolvedores devem usar funções padrão, metadados válidos, armazenamento durável, eventos claros de atualização e regras transparentes de mutabilidade.

Os usuários devem verificar a estrutura da URI de token antes de confiar em NFTs caros, ativos dinâmicos, itens de jogos ou tokens de ativos do mundo real.

Eles também devem evitar links de metadados suspeitos e lembrar que a exibição em uma carteira não comprova autenticidade.

URI de token é uma das bases técnicas ocultas do valor e da utilidade dos NFTs.

Em um glossário cripto, URI de token deve ser entendida como a URI retornada ou usada por um contrato de token para identificar o recurso de metadados que descreve um token específico.