tokenURI

TokenURI, definida como tokenURI(uint256 _tokenId) returns (string) en la extensión ERC721Metadata, devuelve una URI que apunta a un fichero JSON con los metadatos del NFT. Ese JSON debe conformar al ERC721 Metadata JSON Schema, con campos estándar como name, description, image y, habitualmente, attributes. El patrón habitual de implementación usa un baseURI del contrato que se concatena automáticamente con el identificador del token. La URI puede apuntar a HTTP, IPFS, Arweave o ser un data URI on-chain. En ERC-1155 la función uri admite el comodín {id}, que el cliente sustituye por el identificador del token en hexadecimal de 64 caracteres, permitiendo una sola URI plantilla para muchos tokens.

Es el puente entre el token on-chain y sus metadatos, que a menudo viven off-chain. Es el campo que leen marketplaces, wallets y exploradores para mostrar la imagen y las propiedades del NFT, y el término exacto que buscan los desarrolladores cuando integran o depuran la visualización de un activo. La persistencia de lo que apunta la URI es un punto crítico, de ahí estándares complementarios de integridad de metadatos como ERC-2477.

Los contratos de OpenZeppelin lo implementan vía ERC721URIStorage y _baseURI(). Colecciones conocidas sirven sus metadatos por IPFS y otras los renderizan on-chain. MetaMask y los exploradores consumen tokenURI o uri para mostrar el activo. tokenURI pertenece a ERC-721 y ERC-1155 y es también la pieza de identidad que heredan extensiones como ERC-6551, donde una cuenta vinculada a token se ancla a un NFT cuya identidad define esta función.