# DTT®-Minting Der **Digital Twin Token (DTT)** ist Magmas Blockchain-Mechanismus zur Verankerung des digitalen Datensatzes eines Gebäudes in einem öffentlichen, unveränderlichen Ledger. Jeder DTT repräsentiert den authentifizierten, zeitgestempelten Zustand der Dokumentation und des 3D-Modells eines Gebäudes zum Zeitpunkt des Mintings. Er ist der digitale Begleiter des physischen Gebäudes und entwickelt sich mit jeder Aktualisierung weiter. *** ## Was ist der DTT? Der DTT ist als **ERC-1155-Multi-Token-Smart-Contract** implementiert (kein NFT/ERC-721). Wichtige Eigenschaften: * **Ein Vertrag pro Gebäude** — Jedes Gebäude hat seinen eigenen dedizierten Smart Contract auf der Blockchain. * **Mehrere Token-IDs innerhalb eines Vertrags** — Jede Dokumentenversion und jede BIM-Objektversion erhält ihre eigene Token-ID innerhalb des Gebäudevertrags. * **Hash-Historie erhalten** — Jede Token-ID pflegt ein nur erweitertes Array kryptografischer Hashes über den HashStorage-Vertrag. Wenn ein Dokument aktualisiert wird, wird ein neuer Hash an das Array derselben Token-ID angehängt — die vollständige Geschichte ist on-chain gespeichert. * **Blockchain:** VeChain (primär), mit der Gebäudebrieftasche, die über den Venly-Wallet-Anbieter verwaltet wird. *** ## Smart Contracts Drei Smart Contracts betreiben das DTT-System: | Vertrag | Beschreibung | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **DTT Factory** | Stellt für jedes neue Gebäude einen neuen DTT-Vertrag bereit. Eine Factory verwaltet alle Gebäude auf der Plattform. | | **DTT-Vertrag (ERC-1155)** | Der eigene Vertrag des Gebäudes. Enthält alle Token-IDs für die Dokumente und BIM-Objekte dieses Gebäudes. | | **HashStorage** | Ein nur erweiterbarer Speichervertrag. Für jede Token-ID speichert er ein Array von Hashes. Jede Dokumentenaktualisierung fügt dem Array einen neuen Hash hinzu und bewahrt die vollständige Geschichte. | *** ## Administratorrollen Drei Administratorrollen kontrollieren verschiedene Aspekte des DTT-Vertrags: | Rolle | Beschreibung | | ---------------------- | ---------------------------------------------------------------------------- | | **tokenAdministrator** | Kann neue Token-IDs minten und Token-Level-Berechtigungen verwalten. | | **levelAdministrator** | Kontrolliert Berechtigungen für eine bestimmte Gebäudeebene (Bereich 0–255). | | **hashAdministrator** | Berechtigt, neue Hashes an den HashStorage-Vertrag anzuhängen. | *** ## Minting-Prozess Das Minting wird über die Registerkarte **DTT** innerhalb des Gebäudes eingeleitet. Es folgt einem sequenziellen 13-Schritte-Prozess: | Schritt | Name | Beschreibung | | ------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | 1 | CREATE\_PROCESS | Initialisiert die Minting-Sitzung und überprüft Voraussetzungen. | | 2 | MINTING\_STARTED | Bestätigt den Prozessbeginn und sperrt den Datenzustand des Gebäudes. | | 3 | VALIDATE\_PAYMENTS | Überprüft, ob das Abonnement des Gebäudes aktiv und Zahlungen aktuell sind. | | 4 | REWARD\_TOKEN\_MINTING | Berechnet und bereitet die MRT-Reward-Token für die Verteilung an Beteiligte vor. | | 5 | STAKEHOLDER\_PAYMENTS | Verteilt MRT-Reward-Token an die Wallets berechtigter Beteiligter. | | 6 | SYNC\_LEVEL | Synchronisiert die Magma Index-Ebenenwerte, die in die Token-Metadaten eingebettet werden. | | 7 | MINTING\_ENDED | Markiert die Minting-Sitzung als auf Plattformseite abgeschlossen. | | 8 | CREATE\_DTT\_BUILDING | Stellt den DTT-Vertrag des Gebäudes bereit (nur beim ersten Minting) oder verweist auf den bestehenden Vertrag. | | 9 | CREATE\_DTT\_DOCUMENT\_DTT\_CREATION | Erstellt Token-IDs für alle neuen Dokumentenversionen seit dem letzten Minting. | | 10 | CREATE\_DTT\_MODEL\_DTT\_CREATION | Erstellt Token-IDs für BIM-Modellversionen. | | 11 | CREATE\_DTT\_MODEL\_OBJECT\_DTT\_CREATION | Erstellt Token-IDs für individuelle BIM-Objektversionen. | | 12 | ADD\_HASHES\_DOCUMENT\_DTT\_CREATION | Hängt die kryptografischen Hashes aller Dokumente an ihre jeweiligen Token-IDs in HashStorage an. | | 13 | ADD\_HASHES\_MODEL\_OBJECT\_DTT\_CREATION | Hängt die kryptografischen Hashes aller BIM-Objektzustände an ihre jeweiligen Token-IDs an. | Ein **Fortschrittsanzeiger** in der Minting-Registerkarte zeigt den Echtzeit-Status für jeden Schritt. *** ## DTT-Registerkarten-Oberfläche ### DTT-Karte Das visuelle Hauptelement der DTT-Registerkarte ist die **DTT-Karte**, die folgendes anzeigt: * **Gebäude-Titelbild** — Im 3D-rotierten Kartenstil für visuelle Wirkung gerendert. * **Magma Index %** — Der aktuelle Gesamtdokumentationswert des Gebäudes. * **Gebäudename** — Der offizielle Gebäudename. * **QR-Code** — Ein scannbarer QR-Code, der zur Blockchain-Vertragsadresse des Gebäudes verlinkt und es jedem ermöglicht, den Token on-chain zu überprüfen. ### Fortschritt pro Ebene Unterhalb der DTT-Karte zeigt eine Aufschlüsselung den Minting-Status pro Magma-Ebene (Genesis, Structure, Architecture, W1–W5, Filled): * Wie viele Dokumente/Objekte auf jeder Ebene bereits gemintet wurden. * Wie viele ausstehend sind (validiert, aber noch nicht gemintet). ### Aktionsschaltflächen | Schaltfläche | Beschreibung | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | **Mint** | Das erste Minting für dieses Gebäude einleiten. Stellt den Smart Contract bereit und mintet alle validierten Inhalte. | | **Aktualisieren** | Das Gebäude neu minten, um neue validierte Dokumente und BIM-Objekte einzuschließen, die seit dem letzten Minting hinzugefügt wurden. | | **Erneut versuchen** | Wenn eine Minting-Sitzung fehlgeschlagen ist, klicken Sie auf Erneut versuchen, um vom fehlgeschlagenen Schritt an fortzufahren. | *** ## Erstes Minting vs. Aktualisierungen ### Erstes Minting (Mint) * Stellt den einzigartigen ERC-1155-Smart-Contract des Gebäudes über die DTT Factory bereit. * Weist dem Gebäude eine **einzigartige Blockchain-Adresse** zu. * Mintet Token-IDs für alle validierten Dokumente und BIM-Objekte. * Hängt ihre kryptografischen Hashes an den HashStorage-Vertrag an. * Löst die MRT-Reward-Verteilung an alle berechtigten Beteiligten aus. ### Nachfolgendes Minting (Aktualisieren) * Stellt den Vertrag nicht erneut bereit — der bestehende Vertrag wird aktualisiert. * Erstellt neue Token-IDs nur für Dokumente und BIM-Objekte, die seit dem letzten Minting neu oder aktualisiert wurden. * Für aktualisierte Dokumente wird ein neuer Hash an das Hash-Array der bestehenden Token-ID **angehängt** (Historie bewahrt). * Verteilt MRT-Rewards für neu validierte Inhalte. *** ## Hash-Mechanismus Der kryptografische Hash-Mechanismus stellt sicher, dass jede Dokumenten- und BIM-Objektversion dauerhaft und nachprüfbar auf der Blockchain verankert ist: 1. Wenn ein Dokument hochgeladen wird, werden seine Dateiinhalte gehasht (SHA-256 oder äquivalent). 2. Beim Minting wird dieser Hash an das Array der Token-ID im HashStorage-Vertrag angehängt. 3. Wenn das Dokument aktualisiert wird (Ersatz), wird ein neuer Hash berechnet und an das Array derselben Token-ID angehängt. 4. Das Hash-Array wächst im Laufe der Zeit und liefert eine vollständige On-Chain-Geschichte jeder Version jedes Dokuments. Jeder, der Zugang zur Originaldatei hat, kann ihren Hash neu berechnen und ihn mit dem On-Chain-Datensatz vergleichen, um die Authentizität zu überprüfen. *** ## Erfolgsmodal Nach erfolgreichem Abschluss aller 13 Minting-Schritte wird ein Erfolgsmodal angezeigt: > „Ihr DTT® wurde gemintet! Er ist der digitale Begleiter Ihres Gebäudes, der sich mit ihm weiterentwickeln wird." Das Modal zeigt: * Die einzigartige Blockchain-Adresse des Gebäudes. * Einen Link zur öffentlichen DTT-Seite für dieses Gebäude. * Den QR-Code für die On-Chain-Überprüfung. *** ## Öffentliche DTT-Seite Jedes gemintete Gebäude hat eine öffentlich zugängliche DTT-Seite unter: ``` /dtt/[blockchain-address] ``` Diese Seite ist für jedermann zugänglich — kein Magma-Konto erforderlich. Sie zeigt: ### React Flow-Knotengraph Ein interaktiver Graph, der mit **React Flow** erstellt wurde und die vollständige DTT-Hierarchie visualisiert: * Der **Gebäudeknoten** oben. * **Ebenenknoten**, die vom Gebäude abzweigen (Genesis, Structure, Architecture usw.). * **Dokumentknoten** und **BIM-Objektknoten** unter jeder Ebene. * Jeder Knoten ist durch Kanten verbunden, die die Beziehung zeigen. ### Hash Storage-Elemente Für jeden Knoten (Dokument oder Objekt) werden die zugehörigen Hash-Storage-Elemente angezeigt: * Versionsnummer. * Hash-Wert. * Minting-Zeitstempel. ### Blockchain-Explorer-Links Jeder Knoten und jedes Hash-Element enthält eine **„In Blockchain anzeigen"**-Schaltfläche, die die Transaktion oder den Token-Datensatz im VeChain-Blockchain-Explorer öffnet, was eine unabhängige Überprüfung ohne jegliche Abhängigkeit von Magmas Infrastruktur ermöglicht. *** ## Dokumentenstatus nach dem Minting Dokumente, die erfolgreich gemintet wurden, zeigen ein **Minted**-Status-Badge im Data Room. Dies ist der endgültige Status im Dokumentlebenszyklus: ``` Draft → Pending Validation → Validated → Minted ``` Gemintete Dokumente verbleiben im Data Room als vollständig zugänglich, einsehbar und herunterladbar. Ihr On-Chain-Hash dient als unveränderlicher Authentizitätsbeweis. *** ## Voraussetzungen für das Minting Stellen Sie vor der Einleitung eines Mintings sicher, dass: * Das **Abonnement des Gebäudes aktiv** ist und **Zahlungen aktuell** sind (Schritt 3 des Minting-Prozesses überprüft dies — überfällige Gebäude können nicht minten). * Alle für das Minting vorgesehenen Dokumente den Status **Validated** haben. * Die **Blockchain-Wallet des Gebäudes** eingerichtet ist (wird automatisch bei der Gebäudeerstellung erstellt). * Alle für das Minting vorgesehenen BIM-Objekte ihre Felder validiert haben. *** ## Tipps und Best Practices * **Minten Sie regelmäßig** — Je häufiger Sie minten, desto granularer ist die On-Chain-Historie. Erwägen Sie das Minting nach jedem bedeutenden Dokument-Upload oder BIM-Datenaktualisierung. * **Validieren Sie vor dem Minting** — Nur validierte Dokumente und BIM-Objekte werden einbezogen. Ausstehende oder abgelehnte Inhalte werden vom Minting ausgeschlossen. * **Überwachen Sie die 13 Schritte** — Wenn ein Schritt fehlschlägt, notieren Sie den Schrittnamen und prüfen Sie die Plattform-Statusseite oder kontaktieren Sie den Support, bevor Sie die Schaltfläche Erneut versuchen verwenden. * **Teilen Sie die öffentliche DTT-Seite** mit Investoren, Kreditgebern und Due-Diligence-Teams — sie liefert einen unabhängigen, blockchain-verifizierten Nachweis des Dokumentationszustands des Gebäudes, ohne Plattformzugang zu erfordern. * **Halten Sie Abonnementzahlungen aktuell** — Eine einzige versäumte Zahlung kann das Minting (ab der OVERDUE\_3\_DAYS-Stufe) blockieren und Ihre Blockchain-Datensatzaktualisierungen verzögern. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mymagma.com/magma-documentation/de/funktionen/dtt-minting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.