# Glossaire Blockchain & DTT® Cette page explique les concepts blockchain utilisés dans Magma. Vous n'avez pas besoin de comprendre la technologie blockchain pour utiliser Magma — mais ce glossaire vous aide si vous souhaitez comprendre ce qui se passe en coulisses lors de l'émission de données. *** ## Concepts fondamentaux ### Digital Twin Token (DTT®) Le DTT® est un enregistrement basé sur la blockchain qui représente un bâtiment. Techniquement, il s'agit d'un **contrat intelligent ERC-1155** déployé sur la blockchain VeChain — un contrat par bâtiment. À l'intérieur de ce contrat, plusieurs **identifiants de token** sont créés — un pour chaque version de document validée et un pour chaque version d'objet BIM validée. Pensez au DTT® comme au passeport numérique permanent du bâtiment : il identifie le bâtiment sur la blockchain et fournit une ancre vérifiable pour toutes les données qui y sont contribuées. ### ERC-1155 Un standard de multi-tokens pour les contrats intelligents blockchain. Contrairement à l'ERC-721 (qui crée un token par élément), l'ERC-1155 permet à un seul contrat de gérer plusieurs tokens — ce qui le rend efficace pour représenter des centaines de documents et d'objets de modèle au sein du contrat DTT® d'un seul bâtiment. Magma utilise ERC-1155 spécifiquement parce que : * Un contrat par bâtiment (pas un par document) * Chaque version de document et chaque champ BIM obtient son propre identifiant de token dans ce contrat * Le standard est bien supporté par les portefeuilles, les explorateurs et les places de marché ### Identifiant de token Dans le contrat DTT® d'un bâtiment, chaque actif validé obtient un **identifiant de token** unique : * Version d'un fichier de document → 1 identifiant de token * Version d'un objet de modèle BIM → 1 identifiant de token Les identifiants de token sont le lien entre les données internes de Magma et l'enregistrement sur la blockchain. Ils sont conservés définitivement une fois créés. ### Contrat HashStorage Un contrat intelligent complémentaire déployé aux côtés de chaque contrat DTT®. Il stocke un **tableau append-only de hashes cryptographiques** pour chaque identifiant de token. ``` HashStorage[tokenId] = [hash_v1, hash_v2, hash_v3, ...] ``` Lorsqu'un document est émis pour la première fois, son hash est stocké à l'index 0. Lorsqu'une nouvelle version est importée et validée, le nouveau hash est ajouté à l'index 1 — et ainsi de suite. Le hash original n'est **jamais écrasé**. L'historique complet de toutes les versions est définitivement préservé et interrogeable. ### DTT Factory Un contrat intelligent partagé unique sur VeChain qui déploie de nouveaux contrats DTT®. Lorsque vous créez un bâtiment sur Magma et complétez le paiement, la DTT Factory est appelée pour déployer un nouveau contrat DTT® (et son contrat HashStorage associé) pour votre bâtiment. La factory suit tous les contrats déployés via un tableau sur la blockchain. *** ## Rôles d'administrateur Chaque contrat DTT® possède trois adresses d'administrateur distinctes : | Rôle | Ce qu'ils peuvent faire | | ---------------------- | -------------------------------------------------------------- | | **tokenAdministrator** | Émettre de nouveaux identifiants de token dans le contrat DTT® | | **levelAdministrator** | Définir le niveau hiérarchique du DTT® (0–255) | | **hashAdministrator** | Ajouter des hashes au contrat HashStorage | Ces rôles sont détenus par l'infrastructure de Magma, et non par des utilisateurs individuels. Ils garantissent que seule la plateforme peut écrire sur la blockchain — tandis que toutes les données sont transparentes et publiquement vérifiables. *** ## Blockchain et portefeuilles ### VeChain Le réseau blockchain principal utilisé par Magma. VeChain est une blockchain publique conçue pour les applications d'entreprise, avec des frais de transaction faibles et un débit élevé. Les portefeuilles de bâtiment et les portefeuilles de parties prenantes sur Magma sont des adresses VeChain. ### Venly Le fournisseur de portefeuille intégré à Magma. Venly est un service de **portefeuille custodial** — il gère vos clés privées pour vous, le rendant accessible aux utilisateurs novices en Web3. Vous vous authentifiez auprès de Venly avec des identifiants standard (pas de phrase mnémotechnique requise). Lorsque vous connectez votre portefeuille dans Magma, vous connectez un portefeuille VeChain géré par Venly. ### Portefeuille de partie prenante Votre portefeuille blockchain personnel, lié à votre profil utilisateur Magma. Il reçoit les **récompenses en tokens MRT** après émission. Un portefeuille par personne, connecté via Venly. ### Portefeuille du bâtiment Un portefeuille blockchain distinct créé pour chaque bâtiment lors de l'assistant de création. Il détient le contrat intelligent DTT® et est requis avant que l'émission puisse commencer. Un portefeuille par bâtiment. *** ## Tokens et récompenses ### Token MRT (Magma Reward Token) Un token **ERC-20** déployé sur plusieurs blockchains : * VeChain (principal) * Ethereum * BNB Smart Chain (Binance) * Polygon Le MRT est distribué comme récompense aux parties prenantes dont les contributions de données sont validées et émises. Le montant dépend de la valeur intrinsèque du document, de la réputation de la partie prenante et de son rôle (importateur vs. niveau de validateur). Le MRT utilise le pattern **MiniMeToken**, qui supporte les requêtes historiques de solde basées sur des snapshots — permettant des fonctionnalités de gouvernance à l'avenir. ### Émission Le processus d'enregistrement permanent des données de bâtiment validées sur la blockchain. L'émission crée des identifiants de token dans le contrat DTT® et ajoute des hashes au contrat HashStorage. Elle distribue également des récompenses MRT aux contributeurs. L'émission est initiée par le Propriétaire ou l'Asset Manager (ou une partie prenante avec des droits d'émission délégués) et consiste en 13 étapes exécutées séquentiellement. *** ## Concepts cryptographiques ### Hash (cryptographique) Une chaîne de longueur fixe qui identifie de manière unique le contenu d'un fichier. Si le fichier change, même d'un seul caractère, le hash change complètement. Cela rend les hashes idéaux pour vérifier qu'un document n'a pas été altéré. Dans Magma, le hash de chaque version de document est : 1. Visible pour les utilisateurs dans le panneau d'informations du document 2. Stocké sur la blockchain dans HashStorage après émission 3. Définitivement préservé (jamais écrasé) N'importe qui peut vérifier l'authenticité d'un document en calculant son hash et en le comparant à l'enregistrement sur la blockchain. ### Enregistrement sur la blockchain Données stockées sur la blockchain. Une fois enregistrées, les données sur la blockchain sont immuables — elles ne peuvent être modifiées, supprimées ou altérées. Dans Magma, les enregistrements sur la blockchain pour un bâtiment comprennent tous les hashes de documents émis et les versions d'objets BIM. *** ## La page publique du DTT® Le DTT® de chaque bâtiment est publiquement accessible à : ``` https://app.mymagma.com/dtt/[blockchain-address] ``` Cette page affiche : * Un graphe de nœuds hiérarchique (visualisation React Flow) de la structure des tokens du bâtiment * Des nœuds PRIMARY (le contrat DTT® principal), des nœuds SECONDARY (tokens enfants), et des nœuds STORAGE\_AGGREGATOR (HashStorage) * Pour chaque nœud : l'adresse blockchain et un lien « Voir sur la blockchain » vers l'explorateur VeChain * Une fenêtre modale Hash Storage montrant tous les documents et objets BIM émis avec leurs hashes Aucun compte Magma n'est requis pour consulter cette page. Quiconque disposant de l'adresse blockchain du bâtiment peut vérifier l'historique de son jumeau numérique. --- # 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/fr/reference/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.