tokenURI

TokenURI, definida como tokenURI(uint256 _tokenId) returns (string) na extensão ERC721Metadata, retorna uma URI que aponta para um arquivo JSON com os metadados do NFT. Esse JSON deve estar em conformidade com o ERC721 Metadata JSON Schema, com campos padrão como name, description, image e, habitualmente, attributes. O padrão habitual de implementação usa um baseURI do contrato, que é concatenado automaticamente com o identificador do token. A URI pode apontar para HTTP, IPFS, Arweave ou ser um data URI on-chain. No ERC-1155, a função uri admite o curinga {id}, que o cliente substitui pelo identificador do token em hexadecimal de 64 caracteres, permitindo uma única URI modelo para muitos tokens.

É a ponte entre o token on-chain e seus metadados, que muitas vezes vivem off-chain. É o campo que marketplaces, wallets e exploradores leem para exibir a imagem e as propriedades do NFT, e o termo exato que os desenvolvedores buscam quando integram ou depuram a visualização de um ativo. A persistência do que a URI aponta é um ponto crítico, daí padrões complementares de integridade de metadados como o ERC-2477.

Os contratos da OpenZeppelin o implementam via ERC721URIStorage e _baseURI(). Coleções conhecidas servem seus metadados por IPFS e outras os renderizam on-chain. MetaMask e os exploradores consomem tokenURI ou uri para exibir o ativo. tokenURI pertence ao ERC-721 e ao ERC-1155 e é também a peça de identidade herdada por extensões como o ERC-6551, em que uma conta vinculada a token se ancora a um NFT cuja identidade é definida por essa função.