Metadados de NFT

Um NFT on-chain é essencialmente um registro de propriedade. No padrão ERC-721, é um tokenId único dentro de um contrato, associado a um endereço proprietário. O token quase nunca contém a imagem nem os atributos, apenas um ponteiro. A função tokenURI(tokenId) no ERC-721, ou uri(id) no ERC-1155, retorna uma URI que o cliente (um marketplace ou uma wallet) resolve para obter o JSON. O ERC-721 Metadata JSON Schema padroniza os campos básicos, nome, descrição e imagem, e a extensão attributes, popularizada pela OpenSea, acrescenta os traços do ativo.

Isso esclarece um mal-entendido frequente. Comprar um NFT não é comprar o arquivo, é possuir um token que aponta para determinados metadados. A durabilidade e a veracidade desses metadados determinam o que de fato se possui. A URI pode apontar para HTTP, para o IPFS, para o Arweave ou codificar o JSON diretamente como data URI. Se apontar para um servidor centralizado e ele deixar de responder, o conteúdo pode ficar indisponível, ainda que o token persista on-chain.

A documentação de metadados da OpenSea é o padrão de fato seguido pela maioria dos projetos, com campos como image, attributes e animation_url. O Bored Ape Yacht Club, da Yuga Labs, hospeda seus metadados e imagens no IPFS, com as características no campo attributes. O Art Blocks produz a obra de forma generativa e serve metadados que referenciam o script que a gera, de modo que o JSON descreve uma peça criada por código.