# Blockchain & DTT®-Glossar Diese Seite erklärt die in Magma verwendeten Blockchain-Konzepte. Sie müssen die Blockchain-Technologie nicht verstehen, um Magma zu nutzen – aber dieses Glossar hilft, wenn Sie verstehen möchten, was unter der Haube passiert, wenn Daten geminted werden. *** ## Grundkonzepte ### Digital Twin Token (DTT®) Der DTT® ist ein blockchain-basierter Eintrag, der ein Gebäude repräsentiert. Technisch gesehen ist er ein **ERC-1155-Smart-Contract**, der auf der VeChain-Blockchain eingesetzt wird – ein Vertrag pro Gebäude. Innerhalb dieses Vertrags werden mehrere **Token-IDs** erstellt – eine für jede validierte Dokumentversion und eine für jede validierte BIM-Objektversion. Stellen Sie sich den DTT® als den permanenten digitalen Reisepass des Gebäudes vor: Er identifiziert das Gebäude auf der Blockchain und bietet einen überprüfbaren Anker für alle dazu beigetragenen Daten. ### ERC-1155 Ein Multi-Token-Standard für Blockchain-Smart-Contracts. Im Gegensatz zu ERC-721 (das ein Token pro Element erstellt) ermöglicht ERC-1155 einem einzelnen Vertrag, viele Tokens zu verwalten – was es effizient macht, Hunderte von Dokumenten und Modellobjekten innerhalb des DTT®-Vertrags eines einzelnen Gebäudes darzustellen. Magma verwendet ERC-1155 speziell, weil: * Ein Vertrag pro Gebäude (nicht einer pro Dokument) * Jede Dokumentversion und jedes BIM-Feld eine eigene Token-ID innerhalb dieses Vertrags erhält * Der Standard von Wallets, Explorern und Marktplätzen gut unterstützt wird ### Token-ID Innerhalb des DTT®-Vertrags eines Gebäudes erhält jedes validierte Asset eine eindeutige **Token-ID**: * Dokumentdateiversion → 1 Token-ID * BIM-Modellobjektversion → 1 Token-ID Token-IDs sind die Verbindung zwischen Magmas internen Daten und dem On-Chain-Eintrag. Sie bleiben nach ihrer Erstellung dauerhaft bestehen. ### HashStorage-Contract Ein Begleit-Smart-Contract, der neben jedem DTT®-Vertrag eingesetzt wird. Er speichert ein **nur-anhängendes Array kryptographischer Hashes** für jede Token-ID. ``` HashStorage[tokenId] = [hash_v1, hash_v2, hash_v3, ...] ``` Wenn ein Dokument zum ersten Mal geminted wird, wird sein Hash bei Index 0 gespeichert. Wenn eine neue Version hochgeladen und validiert wird, wird der neue Hash bei Index 1 angehängt – und so weiter. Der ursprüngliche Hash wird **nie überschrieben**. Die gesamte Geschichte aller Versionen ist dauerhaft erhalten und abfragbar. ### DTT Factory Ein einzelner gemeinsamer Smart-Contract auf VeChain, der neue DTT®-Verträge einsetzt. Wenn Sie ein Gebäude auf Magma erstellen und die Zahlung abschließen, wird die DTT Factory aufgerufen, um einen neuen DTT®-Vertrag (und seinen gepaarten HashStorage-Vertrag) für Ihr Gebäude einzusetzen. Die Factory verfolgt alle eingesetzten Verträge über ein On-Chain-Array. *** ## Administrator-Rollen Jeder DTT®-Vertrag hat drei separate Administrator-Adressen: | Rolle | Was sie tun können | | ---------------------- | -------------------------------------------------- | | **tokenAdministrator** | Neue Token-IDs innerhalb des DTT®-Vertrags minten | | **levelAdministrator** | Die hierarchische Ebene des DTT® (0–255) festlegen | | **hashAdministrator** | Hashes an den HashStorage-Vertrag anhängen | Diese Rollen werden von Magmas Infrastruktur gehalten, nicht von einzelnen Nutzern. Sie stellen sicher, dass nur die Plattform auf die Chain schreiben kann – während alle Daten transparent und öffentlich überprüfbar sind. *** ## Blockchain und Wallets ### VeChain Das primäre Blockchain-Netzwerk, das von Magma verwendet wird. VeChain ist eine öffentliche Blockchain, die für Unternehmensanwendungen konzipiert ist, mit niedrigen Transaktionsgebühren und hohem Durchsatz. Gebäude-Wallets und Stakeholder-Wallets auf Magma sind VeChain-Adressen. ### Venly Der in Magma integrierte Wallet-Anbieter. Venly ist ein **verwahrter Wallet**-Dienst – er verwaltet Ihre privaten Schlüssel für Sie, was ihn für neue Web3-Nutzer zugänglich macht. Sie authentifizieren sich bei Venly mit Standardanmeldedaten (keine Seed-Phrase erforderlich). Wenn Sie Ihre Wallet in Magma verbinden, verbinden Sie eine von Venly verwaltete VeChain-Wallet. ### Stakeholder-Wallet Ihre persönliche Blockchain-Wallet, die mit Ihrem Magma-Benutzerprofil verknüpft ist. Sie empfängt **MRT-Token-Belohnungen** nach dem Minting. Eine Wallet pro Person, verbunden über Venly. ### Gebäude-Wallet Eine separate Blockchain-Wallet, die für jedes Gebäude während des Erstellungsassistenten erstellt wird. Sie besitzt den DTT®-Smart-Contract und ist erforderlich, bevor das Minting beginnen kann. Eine Wallet pro Gebäude. *** ## Tokens und Belohnungen ### MRT-Token (Magma Reward Token) Ein **ERC-20**-Token, der auf mehreren Blockchains eingesetzt ist: * VeChain (primär) * Ethereum * BNB Smart Chain (Binance) * Polygon MRT wird als Belohnung an Stakeholder verteilt, deren Datenbeiträge validiert und geminted wurden. Der Betrag hängt vom intrinsischen Dokumentwert, der Stakeholder-Reputation und ihrer Rolle (Uploader vs. Validator-Stufe) ab. MRT verwendet das **MiniMeToken**-Muster, das snapshot-basierte historische Saldoabfragen unterstützt – was in Zukunft Governance-Funktionen ermöglicht. ### Minting Der Prozess der dauerhaften Aufzeichnung validierter Gebäudedaten auf der Blockchain. Minting erstellt Token-IDs innerhalb des DTT®-Vertrags und hängt Hashes an den HashStorage-Vertrag an. Es verteilt auch MRT-Belohnungen an Beitragende. Minting wird vom Owner oder Asset Manager (oder einem Stakeholder mit delegierten Minting-Rechten) initiiert und besteht aus 13 sequenziell ausgeführten Schritten. *** ## Kryptographische Konzepte ### Hash (kryptographisch) Ein Zeichenfolge fester Länge, die den Inhalt einer Datei eindeutig identifiziert. Wenn sich die Datei auch nur um ein Zeichen ändert, ändert sich der Hash vollständig. Dies macht Hashes ideal für die Überprüfung, ob ein Dokument nicht manipuliert wurde. In Magma ist der Hash jeder Dokumentversion: 1. Für Nutzer im Dokumentinformationsfeld sichtbar 2. Nach dem Minting in HashStorage on-chain gespeichert 3. Dauerhaft erhalten (nie überschrieben) Jeder kann die Authentizität eines Dokuments verifizieren, indem er seinen Hash berechnet und ihn mit dem On-Chain-Eintrag vergleicht. ### On-Chain-Eintrag Auf der Blockchain gespeicherte Daten. Einmal aufgezeichnet, sind On-Chain-Daten unveränderlich – sie können nicht geändert, gelöscht oder manipuliert werden. In Magma umfassen die On-Chain-Einträge für ein Gebäude alle geminteten Dokument-Hashes und BIM-Objektversionen. *** ## Die öffentliche DTT®-Seite Der DTT® jedes Gebäudes ist öffentlich zugänglich unter: ``` https://app.mymagma.com/dtt/[blockchain-adresse] ``` Diese Seite zeigt: * Ein hierarchisches Knotengraph (React Flow-Visualisierung) der Token-Struktur des Gebäudes * PRIMARY-Knoten (der Haupt-DTT®-Vertrag), SECONDARY-Knoten (untergeordnete Tokens) und STORAGE\_AGGREGATOR-Knoten (HashStorage) * Für jeden Knoten: die Blockchain-Adresse und einen „Auf Blockchain ansehen"-Link zum VeChain-Explorer * Ein Hash Storage-Modal, das alle geminteten Dokumente und BIM-Objekte mit ihren Hashes anzeigt Es ist kein Magma-Konto erforderlich, um diese Seite zu besuchen. Jeder mit der Blockchain-Adresse des Gebäudes kann seine digitale Zwillingsgeschichte verifizieren. --- # 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/referenz/blockchain-glossary.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.