Zum Hauptinhalt springen

Metadaten & Speicherung

Während der Smart Contract Besitz und Echtheitsprüfung verwaltet, hängt die visuelle und beschreibende Darstellung des physischen Objekts von Metadaten ab.

Tokentagged nutzt den ERC-1155 Metadaten-Standard und priorisiert permanente, dezentrale Speicherung, damit der „Digitale Zwilling“ so lange lebt wie das physische Objekt.

Permanente Speicherung (Arweave)​

Im Gegensatz zu zentralen Servern oder temporären IPFS-Pinning-Diensten nutzen wir Arweave für die Metadaten-Speicherung.

  • Permaweb: Auf Arweave gespeicherte Daten sind durch einen nachhaltigen Endowment-Fonds abgesichert und bleiben für Hunderte Jahre verfügbar.
  • Unveränderlichkeit: Sobald die Metadaten-JSON hochgeladen und die URI auf der Blockchain geschrieben ist, kann der Inhalt nicht mehr geändert werden. Das garantiert, dass die Beschreibung eines physischen Kunstwerks oder Sammlerstücks für immer authentisch bleibt.
Unveränderlichkeit

Sobald ein Tokentag gemintet und die Metadaten eingefroren sind, ist es unmöglich, Bild, Beschreibung oder Attribute zu ändern. Das schützt Sammler:innen und stellt sicher, dass der digitale Asset stets dem physischen Zustand zum Zeitpunkt des Mintings entspricht.

Token-Metadaten (ERC-1155)​

Jeder Tokentag (NFT) verweist über seine tokenURI auf eine spezifische JSON-Datei. Diese Datei beschreibt das einzelne physische Objekt.

Beispielstruktur​

{
	"name": "Blockchain",
	"description": "Oil and egg tempera on canvas, 91 × 153,5 cm.",
	"external_url": "https://tokentagged.com/tag/eth/0x2fdfa8ab84bfbe658827a51af399531371cab86a/0x323951715310843b94e257b01b31c31db3ffbef4",
	"image": "https://arweave.net/0JuocasTJR-KUn5k5jDV6gLgY8I58GfnBuSirB9jc9E",
	"attributes": null,
	"animation_url": "https://arweave.net/RxwvIPXXaeF_D6KDnoijPdKMZpN9NwOL1Usgyepa-nk"
}

Eigenschaftsübersicht​

PropertyBeschreibung
nameDer Titel des Kunstwerks oder Objekts.
descriptionEine Textbeschreibung. Unterstützt Markdown. Sollte physische Details (Maße, Material) und Lieferhinweise enthalten.
imageURL zum primären statischen Bild (Arweave). Wird in Wallet-Previews und Marketplace-Grid verwendet.
external_urlEin Deep-Link zur Tokentagged-Verifizierungsseite für dieses spezifische Item. Alternativ können Creator eine eigene URL angeben (z. B. zur Homepage oder Projektseite).
animation_url(Optional) URL zu einer Multimediadatei (Video/MP4 oder 3D-Modell/GLB). Marktplätze rendern dies in der Detailansicht.
attributes(Optional) Array von Traits (z. B. „Material“: „Gold“, „Year“: „2023“) für Filter in Marktplätzen.

Contract-Metadaten (Collection-Ebene)​

Damit eine Collection auf Marktplätzen wie OpenSea korrekt erscheint (mit Logo, Banner und Beschreibung), besitzt der Smart Contract eine contractURI. Diese definiert das Branding für die gesamte Token-Gruppe.

Beispielstruktur​

{
		"name": "Akira's Friends",
		"symbol": "AKIRA",
		"description": "Deep in the hollow earth of your fantasy live Akira's friends. \nThey know neither one another nor themselves. \nAnd yet, they struggle bravely, building new hope for those who will come after us. \n~Akira",
		"image": "https://arweave.net/85FoUBhbGGFzD0ezlTCIPPcwS6M1QWsmWXNYzttwcfM",
		"banner_image": "https://arweave.net/5p2C9WHtbzoOS94iiGMuAh1jkCGLrjswbbdhznduh5o",
		"featured_image": "https://arweave.net/xGsbFjrljLxVTohB3sCTcm5oNcvQqIptZPW-rhyzR5M",
		"external_link": "https://akira.energy"
}

Eigenschaftsübersicht​

PropertyBeschreibungMarketplace-Nutzung
nameName der Collection.Headline der Collection-Seite.
symbolCollection-Symbol / Ticker.Wird als Kurzkennung auf Marktplätzen angezeigt.
descriptionBeschreibung der Marke/des Creators.Erscheint unterhalb des Headers.
imageCollection-Logo / Avatar.Rundes Icon (z. B. 350x350px).
banner_imageGroßes Header-Banner.Seitenkopf (z. B. 1400x350px).
featured_imagePromotional Tile.Wird auf der Marketplace-Startseite/Empfehlungen verwendet (z. B. 600x400px).
external_linkWebsite-URL.Button zur Creator-Website.

Medien-Empfehlungen​

Damit physische Assets auf allen Plattformen (OpenSea, Rarible, MetaMask, Tokentagged App) professionell wirken, empfehlen wir folgende Spezifikationen für Medien, die auf Arweave hochgeladen werden.

1. Token-Bild (image)​

Die image-Eigenschaft repräsentiert das statische Cover-Bild des Tokens. Es wird in Wallet-Previews und Marketplace-Grids angezeigt.

Input-Empfehlung:

  • Auflösung: Wir empfehlen hochauflösende Fotos (mind. 1000px an der kürzesten Seite).
  • Format: JPG oder PNG.
  • Seitenverhältnis: Rechteckige Bilder werden vollständig unterstützt.

Plattform-Processing (interaktives Zuschneiden): Während des Setup-Prozesses bietet die Tokentagged App ein interaktives Zuschneide-Tool. Du musst kein quadratisches Bild vorbereiten; stattdessen kannst du den 1:1-Auswahlrahmen manuell positionieren und skalieren, um den perfekten Ausschnitt festzulegen.

Output-Standard: Das finale Bild wird als normierte 960 x 960 px Datei gespeichert, um Konsistenz im gesamten Ökosystem zu gewährleisten.

Interaktive Assets (animation_url)​

Aktuell normalisiert Tokentagged alle interaktiven Inhalte in ein standardisiertes MP4-Videoformat. Das garantiert maximale Kompatibilität über Wallets und Marktplätze hinweg.

Die Plattform erzeugt dieses Asset automatisch auf Basis deines Ausgangsmaterials:

  1. Aus 3D-Scans: Wenn du ein 3D-Modell mit den Tokentagged-Tools erstellst, rendert die Plattform automatisch einen 6-sekündigen „Turntable“-Trailer (Objekt rotiert) als MP4.
  2. Aus Video-Uploads:
    • Kurze Videos (≤ 10s): Das Video wird optimiert und direkt verwendet.
    • Lange Videos (> 10s): Die Plattform generiert automatisch einen 6-Sekunden-Trailer/Teaser aus dem Footage.
Zukunfts-Roadmap

Native Unterstützung für interaktive GLB-Dateien (3D-Modelle) und Full-Length-Video-Streaming via animation_url ist für zukünftige Protokoll-Updates geplant. Aktuell werden diese Assets strikt als MP4-Trailer formatiert.

Output-Standards:

  • Format: MP4
  • Codec: H.264 / AAC Audio
  • Dauer: Max. 10 Sekunden (standardisiert auf ~6s bei generierten Trailern)

Collection-Branding​

  • Logo (image): OpenSea empfiehlt mindestens 350 x 350 px. Best Practice: 600 x 600 px oder 1000 x 1000 px. Format: PNG, JPG, GIF. Wird meist kreisrund dargestellt, daher wichtige Details nicht in die Ecken legen.
  • Featured Image (featured_image): OpenSea nutzt 600 x 400 px. Wird verwendet, wenn die Collection auf der Startseite oder in Kategorien gefeatured wird. Fehlt dieses Bild, nutzt OpenSea oft ein zufälliges NFT, was inkonsistent wirken kann.
  • Banner (banner_image): OpenSea nutzt 1400 x 350 px. Format: PNG, JPG, GIF. Logos/Texte im mittleren Safe-Zone-Bereich platzieren, um Cropping auf mobilen Geräten zu vermeiden.