# Blockchain & DTT®-woordenlijst Deze pagina legt de blockchain-concepten uit die worden gebruikt in Magma. U hoeft blockchain-technologie niet te begrijpen om Magma te gebruiken — maar dit glossarium helpt als u wilt begrijpen wat er achter de schermen gebeurt wanneer gegevens worden gemint. *** ## Kernconcepten ### Digital Twin Token (DTT®) De DTT® is een blockchain-gebaseerde registratie die een gebouw vertegenwoordigt. Technisch gezien is het een **ERC-1155-smart contract** ingezet op de VeChain-blockchain — één contract per gebouw. Binnen dit contract worden meerdere **token-ID's** aangemaakt — één voor elke gevalideerde documentversie en één voor elke gevalideerde BIM-objectversie. Beschouw de DTT® als het permanente digitale paspoort van het gebouw: het identificeert het gebouw op de blockchain en biedt een verifieerbaar ankerpunt voor alle bijgedragen data. ### ERC-1155 Een multi-token-standaard voor blockchain-smart contracts. In tegenstelling tot ERC-721 (dat één token per item aanmaakt) stelt ERC-1155 één contract in staat veel tokens te beheren — waardoor het efficiënt is om honderden documenten en modelobjecten te vertegenwoordigen binnen één DTT®-contract van een gebouw. Magma gebruikt ERC-1155 specifiek omdat: * Één contract per gebouw (niet één per document) * Elke documentversie en elk BIM-veld zijn eigen token-ID krijgt binnen dat contract * De standaard goed wordt ondersteund door wallets, explorers en marktplaatsen ### Token-ID Binnen het DTT®-contract van een gebouw krijgt elk gevalideerd asset een unieke **token-ID**: * Documentbestandsversie → 1 token-ID * BIM-modelobjectversie → 1 token-ID Token-ID's zijn de verbinding tussen Magma's interne gegevens en de on-chain registratie. Ze blijven permanent bestaan zodra ze zijn aangemaakt. ### HashStorage-contract Een begeleidend smart contract dat naast elk DTT®-contract wordt ingezet. Het slaat een **alleen-toevoegen-array van cryptografische hashes** op voor elke token-ID. ``` HashStorage[tokenId] = [hash_v1, hash_v2, hash_v3, ...] ``` Wanneer een document voor het eerst wordt gemint, wordt de hash opgeslagen op index 0. Wanneer een nieuwe versie wordt geüpload en gevalideerd, wordt de nieuwe hash toegevoegd op index 1 — enzovoort. De oorspronkelijke hash wordt **nooit overschreven**. De volledige geschiedenis van alle versies is permanent bewaard en opvraagbaar. ### DTT Factory Een enkel gedeeld smart contract op VeChain dat nieuwe DTT®-contracten inzet. Wanneer u een gebouw aanmaakt op Magma en de betaling voltooit, wordt de DTT Factory aangeroepen om een nieuw DTT®-contract (en het bijbehorende HashStorage-contract) in te zetten voor uw gebouw. De factory houdt alle ingezette contracten bij via een on-chain array. *** ## Beheerdersrollen Elk DTT®-contract heeft drie afzonderlijke beheerdersadressen: | Rol | Wat ze kunnen doen | | ---------------------- | ------------------------------------------------------ | | **tokenAdministrator** | Nieuwe token-ID's minten binnen het DTT®-contract | | **levelAdministrator** | Het hiërarchische niveau van de DTT® instellen (0–255) | | **hashAdministrator** | Hashes toevoegen aan het HashStorage-contract | Deze rollen worden gehouden door Magma's infrastructuur, niet door individuele gebruikers. Ze zorgen ervoor dat alleen het platform naar de chain kan schrijven — terwijl alle gegevens transparant en openbaar verifieerbaar zijn. *** ## Blockchain en wallets ### VeChain Het primaire blockchain-netwerk dat door Magma wordt gebruikt. VeChain is een openbare blockchain ontworpen voor zakelijke toepassingen, met lage transactiekosten en hoge doorvoer. Gebouwwallets en stakeholderwallets op Magma zijn VeChain-adressen. ### Venly De walletprovider geïntegreerd in Magma. Venly is een **beheerde wallet**-dienst — het beheert uw privésleutels voor u, waardoor het toegankelijk is voor gebruikers die nieuw zijn met Web3. U authenticeer u bij Venly met standaardgegevens (geen seed-phrase vereist). Wanneer u uw wallet verbindt in Magma, verbindt u een door Venly beheerde VeChain-wallet. ### Stakeholderwallet Uw persoonlijke blockchain-wallet, gekoppeld aan uw Magma-gebruikersprofiel. Het ontvangt **MRT-tokenbeloningen** na minting. Één wallet per persoon, verbonden via Venly. ### Gebouwwallet Een aparte blockchain-wallet aangemaakt voor elk gebouw tijdens de aanmaakaanwijzer. Het bezit het DTT®-smart contract en is vereist voordat minting kan beginnen. Één wallet per gebouw. *** ## Tokens en beloningen ### MRT-token (Magma Reward Token) Een **ERC-20**-token ingezet op meerdere blockchains: * VeChain (primair) * Ethereum * BNB Smart Chain (Binance) * Polygon MRT wordt gedistribueerd als beloning aan stakeholders wiens gegevensbijdragen zijn gevalideerd en gemint. Het bedrag hangt af van de intrinsieke documentwaarde, de stakeholderreputatie en hun rol (uploader versus validatorniveau). MRT gebruikt het **MiniMeToken**-patroon, dat op snapshots gebaseerde historische saldoquery's ondersteunt — waardoor bestuursfuncties in de toekomst mogelijk zijn. ### Minting Het proces van het permanent vastleggen van gevalideerde gebouwgegevens op de blockchain. Minting maakt token-ID's aan binnen het DTT®-contract en voegt hashes toe aan het HashStorage-contract. Het distribueert ook MRT-beloningen aan bijdragers. Minting wordt geïnitieerd door de Owner of Asset Manager (of een stakeholder met gedelegeerde mintingrechten) en bestaat uit 13 stappen die sequentieel worden uitgevoerd. *** ## Cryptografische concepten ### Hash (cryptografisch) Een tekenreeks met vaste lengte die de inhoud van een bestand uniek identificeert. Als het bestand ook maar met één teken verandert, verandert de hash volledig. Dit maakt hashes ideaal voor het verifiëren dat een document niet is gemanipuleerd. In Magma is de hash van elke documentversie: 1. Zichtbaar voor gebruikers in het documentinformatievenster 2. Na minting on-chain opgeslagen in HashStorage 3. Permanent bewaard (nooit overschreven) Iedereen kan de authenticiteit van een document verifiëren door de hash te berekenen en te vergelijken met de on-chain registratie. ### On-chain registratie Gegevens opgeslagen op de blockchain. Eenmaal geregistreerd, zijn on-chain gegevens onveranderlijk — ze kunnen niet worden gewijzigd, verwijderd of gemanipuleerd. In Magma omvatten de on-chain registraties voor een gebouw alle geminte documenthashes en BIM-objectversies. *** ## De openbare DTT®-pagina De DTT® van elk gebouw is openbaar toegankelijk op: ``` https://app.mymagma.com/dtt/[blockchain-adres] ``` Deze pagina toont: * Een hiërarchische knoopgrafiek (React Flow-visualisatie) van de tokenstructuur van het gebouw * PRIMARY-knooppunten (het hoofd-DTT®-contract), SECONDARY-knooppunten (onderliggende tokens) en STORAGE\_AGGREGATOR-knooppunten (HashStorage) * Voor elk knooppunt: het blockchain-adres en een "Bekijk op blockchain"-link naar de VeChain-explorer * Een Hash Storage-modal met alle geminte documenten en BIM-objecten met hun hashes Er is geen Magma-account vereist om deze pagina te bekijken. Iedereen met het blockchain-adres van het gebouw kan de digitale tweelinggeschiedenis verifiëren. --- # 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/nl/referentie/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.