tokenURI

TokenURI, in der Erweiterung ERC721Metadata als tokenURI(uint256 _tokenId) returns (string) definiert, gibt eine URI zurück, die auf eine JSON-Datei mit den Metadaten des NFT verweist. Dieses JSON muss dem ERC721 Metadata JSON Schema entsprechen, mit Standardfeldern wie name, description, image und üblicherweise attributes. Das gängige Implementierungsmuster verwendet eine baseURI des Contracts, die automatisch mit der Token-ID verkettet wird. Die URI kann auf HTTP, IPFS oder Arweave verweisen oder eine Data-URI on-chain sein. In ERC-1155 unterstützt die Funktion uri den Platzhalter {id}, den der Client durch die Token-ID als 64-stelligen Hexadezimalwert ersetzt, sodass eine einzige URI-Vorlage für viele Token genügt.

Sie ist die Brücke zwischen dem Token on-chain und seinen Metadaten, die häufig off-chain liegen. Es ist das Feld, das Marktplätze, Wallets und Explorer auslesen, um Bild und Eigenschaften des NFT anzuzeigen, und der genaue Begriff, nach dem Entwickler suchen, wenn sie die Darstellung eines Vermögenswerts integrieren oder debuggen. Die Beständigkeit dessen, worauf die URI verweist, ist ein kritischer Punkt, daher gibt es ergänzende Standards für Metadatenintegrität wie ERC-2477.

Die Contracts von OpenZeppelin implementieren sie über ERC721URIStorage und _baseURI(). Bekannte Kollektionen liefern ihre Metadaten über IPFS aus, andere rendern sie on-chain. MetaMask und die Explorer lesen tokenURI oder uri, um den Vermögenswert anzuzeigen. tokenURI gehört zu ERC-721 und ERC-1155 und ist zugleich das Identitätselement, das Erweiterungen wie ERC-6551 erben, bei denen ein Token-gebundenes Konto an einem NFT verankert ist, dessen Identität diese Funktion definiert.