# Émission du DTT® Le **Digital Twin Token (DTT®)** est le mécanisme blockchain de Magma permettant d'ancrer le dossier numérique d'un bâtiment sur un registre public et immuable. Chaque DTT® représente l'état authentifié et horodaté de la documentation et du modèle 3D d'un bâtiment au moment du minting. C'est le compagnon numérique du bâtiment physique, qui évolue avec lui à chaque mise à jour. *** ## Qu'est-ce que le DTT® ? Le DTT® est implémenté sous forme de **contrat intelligent multi-token ERC-1155** (et non un NFT/ERC-721). Propriétés clés : * **Un contrat par bâtiment** — Chaque bâtiment dispose de son propre contrat intelligent dédié sur la blockchain. * **Plusieurs identifiants de token dans un seul contrat** — Chaque version de document et chaque version d'objet BIM reçoit son propre identifiant de token au sein du contrat du bâtiment. * **Historique des hachages préservé** — Chaque identifiant de token maintient un tableau de hachages cryptographiques en ajout uniquement via le contrat HashStorage. Lorsqu'un document est mis à jour, un nouveau hachage est ajouté au tableau du même identifiant de token — l'historique complet est préservé sur la chaîne. * **Blockchain :** VeChain (principale), avec le portefeuille du bâtiment géré via le fournisseur de portefeuille Venly. *** ## Contrats intelligents Trois contrats intelligents alimentent le système DTT® : | Contrat | Description | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **DTT Factory** | Déploie un nouveau contrat DTT pour chaque nouveau bâtiment. Une seule factory gère tous les bâtiments de la plateforme. | | **Contrat DTT (ERC-1155)** | Le propre contrat du bâtiment. Contient tous les identifiants de token pour les documents et objets BIM de ce bâtiment. | | **HashStorage** | Un contrat de stockage en ajout uniquement. Pour chaque identifiant de token, il stocke un tableau de hachages. Chaque mise à jour de document ajoute un nouveau hachage au tableau, préservant l'historique complet. | *** ## Rôles administrateurs Trois rôles administrateurs contrôlent différents aspects du contrat DTT® : | Rôle | Description | | ---------------------- | -------------------------------------------------------------------------------------------- | | **tokenAdministrator** | Peut minter de nouveaux identifiants de token et gérer les permissions au niveau des tokens. | | **levelAdministrator** | Contrôle les permissions pour un niveau de bâtiment spécifique (plage 0–255). | | **hashAdministrator** | Autorisé à ajouter de nouveaux hachages au contrat HashStorage. | *** ## Processus de minting Le minting est initié depuis l'onglet **DTT®** au sein du bâtiment. Il suit un processus séquentiel en 13 étapes : | Étape | Nom | Description | | ----- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | 1 | CREATE\_PROCESS | Initialise la session de minting et valide les prérequis. | | 2 | MINTING\_STARTED | Confirme que le processus a commencé et verrouille l'état des données du bâtiment. | | 3 | VALIDATE\_PAYMENTS | Vérifie que l'abonnement du bâtiment est actif et que les paiements sont à jour. | | 4 | REWARD\_TOKEN\_MINTING | Calcule et prépare les tokens de récompense MRT à distribuer aux intervenants. | | 5 | STAKEHOLDER\_PAYMENTS | Distribue les tokens de récompense MRT aux portefeuilles des intervenants éligibles. | | 6 | SYNC\_LEVEL | Synchronise les scores de niveau Magma Index à intégrer dans les métadonnées du token. | | 7 | MINTING\_ENDED | Marque la session de minting comme terminée côté plateforme. | | 8 | CREATE\_DTT\_BUILDING | Déploie le contrat DTT® du bâtiment (premier minting uniquement) ou référence le contrat existant. | | 9 | CREATE\_DTT\_DOCUMENT\_DTT\_CREATION | Crée les identifiants de token pour toutes les nouvelles versions de documents depuis le dernier minting. | | 10 | CREATE\_DTT\_MODEL\_DTT\_CREATION | Crée les identifiants de token pour les versions du modèle BIM. | | 11 | CREATE\_DTT\_MODEL\_OBJECT\_DTT\_CREATION | Crée les identifiants de token pour les versions d'objets BIM individuels. | | 12 | ADD\_HASHES\_DOCUMENT\_DTT\_CREATION | Ajoute les hachages cryptographiques de tous les documents à leurs identifiants de token respectifs dans HashStorage. | | 13 | ADD\_HASHES\_MODEL\_OBJECT\_DTT\_CREATION | Ajoute les hachages cryptographiques de tous les états d'objets BIM à leurs identifiants de token respectifs. | Un **indicateur de progression** dans l'onglet Minting affiche le statut en temps réel pour chaque étape. *** ## Interface de l'onglet DTT® ### Fiche DTT® L'élément visuel principal de l'onglet DTT® est la **fiche DTT®**, qui affiche : * **Image de couverture du bâtiment** — Rendue dans un style de fiche pivotée en 3D pour un impact visuel. * **Magma Index %** — Le score global de documentation actuel du bâtiment. * **Nom du bâtiment** — Le nom officiel du bâtiment. * **QR code** — Un QR code scannable qui renvoie à l'adresse du contrat blockchain du bâtiment, permettant à quiconque de vérifier le token sur la chaîne. ### Progression par niveau Sous la fiche DTT®, une décomposition affiche le statut de minting par niveau Magma (Genesis, Structure, Architecture, W1–W5, Filled) : * Combien de documents/objets à chaque niveau ont été mintés. * Combien sont en attente (validés mais pas encore mintés). ### Boutons d'action | Bouton | Description | | ----------------- | ----------------------------------------------------------------------------------------------------------------- | | **Minter** | Lance le premier minting pour ce bâtiment. Déploie le contrat intelligent et minte tout le contenu validé. | | **Mettre à jour** | Re-minte le bâtiment pour inclure les nouveaux documents validés et objets BIM ajoutés depuis le dernier minting. | | **Réessayer** | Si une session de minting a échoué, cliquez sur Réessayer pour reprendre depuis l'étape ayant échoué. | *** ## Premier minting vs. mises à jour ### Premier minting (Minter) * Déploie le contrat intelligent ERC-1155 unique du bâtiment via la DTT Factory. * Attribue au bâtiment une **adresse blockchain unique**. * Minte les identifiants de token pour tous les documents et objets BIM validés. * Ajoute leurs hachages cryptographiques au contrat HashStorage. * Déclenche la distribution des récompenses MRT à tous les intervenants éligibles. ### Mintings ultérieurs (Mettre à jour) * Ne redéploie pas le contrat — le contrat existant est mis à jour. * Crée de nouveaux identifiants de token uniquement pour les documents et objets BIM nouveaux ou mis à jour depuis le dernier minting. * Pour les documents mis à jour, un nouveau hachage est **ajouté** au tableau de hachages de l'identifiant de token existant (historique préservé). * Distribue les récompenses MRT pour le contenu nouvellement validé. *** ## Mécanisme de hachage Le mécanisme de hachage cryptographique garantit que chaque version de document et d'objet BIM est ancrée de manière permanente et vérifiable sur la blockchain : 1. Lorsqu'un document est téléversé, le contenu du fichier est haché (SHA-256 ou équivalent). 2. Lors du minting, ce hachage est ajouté au tableau de l'identifiant de token dans le contrat HashStorage. 3. Lorsque le document est mis à jour (remplacement), un nouveau hachage est calculé et ajouté au tableau du même identifiant de token. 4. Le tableau de hachages s'agrandit au fil du temps, fournissant un historique complet sur la chaîne de chaque version de chaque document. Toute personne ayant accès au fichier original peut recalculer son hachage et le comparer à l'enregistrement sur la chaîne pour vérifier son authenticité. *** ## Modal de succès Après la réussite des 13 étapes de minting, un modal de succès est affiché : > « Votre DTT® a été minté ! C'est le compagnon numérique de votre bâtiment qui évoluera avec lui. » Le modal affiche : * L'adresse blockchain unique du bâtiment. * Un lien vers la page DTT® publique de ce bâtiment. * Le QR code pour la vérification sur la chaîne. *** ## Page DTT® publique Chaque bâtiment minté dispose d'une page DTT® accessible publiquement à l'adresse : ``` /dtt/[blockchain-address] ``` Cette page est accessible à tous — aucun compte Magma requis. Elle affiche : ### Graphe de nœuds React Flow Un graphe interactif construit avec **React Flow** qui visualise l'ensemble de la hiérarchie DTT® : * Le **nœud bâtiment** en haut. * Les **nœuds de niveau** se ramifiant depuis le bâtiment (Genesis, Structure, Architecture, etc.). * Les **nœuds de document** et les **nœuds d'objet BIM** sous chaque niveau. * Chaque nœud est connecté par des arêtes montrant la relation. ### Éléments de stockage des hachages Pour chaque nœud (document ou objet), les éléments de stockage de hachages associés sont affichés : * Numéro de version. * Valeur du hachage. * Horodatage du minting. ### Liens vers l'explorateur blockchain Chaque nœud et élément de hachage comprend un bouton **« Voir sur la blockchain »** qui ouvre la transaction ou l'enregistrement du token dans l'explorateur blockchain VeChain, permettant une vérification indépendante sans aucune dépendance vis-à-vis de l'infrastructure de Magma. *** ## Statut des documents après le minting Les documents qui ont été mintés avec succès affichent un badge de statut **Minté** dans la Data Room. Il s'agit du statut final dans le cycle de vie du document : ``` Brouillon → En attente de validation → Validé → Minté ``` Les documents mintés restent dans la Data Room entièrement accessibles, consultables et téléchargeables. Leur hachage sur la chaîne constitue la preuve immuable d'authenticité. *** ## Prérequis pour le minting Avant de lancer un minting, assurez-vous que : * L'**abonnement du bâtiment est actif** et les **paiements sont à jour** (l'étape 3 du processus de minting valide ceci — les bâtiments en retard de paiement ne peuvent pas minter). * Tous les documents destinés au minting sont au statut **Validé**. * Le **portefeuille blockchain** du bâtiment est configuré (créé automatiquement lors de la création du bâtiment). * Tous les objets BIM destinés au minting ont leurs champs validés. *** ## Conseils et bonnes pratiques * **Mintez régulièrement** — Plus vous mintez fréquemment, plus l'historique sur la chaîne est granulaire. Envisagez de minter après chaque téléversement de document significatif ou mise à jour des données BIM. * **Validez avant de minter** — Seuls les documents et objets BIM validés sont inclus. Le contenu en attente ou rejeté est exclu du minting. * **Surveillez les 13 étapes** — Si une étape échoue, notez le nom de l'étape et consultez la page de statut de la plateforme ou contactez le support avant d'utiliser le bouton Réessayer. * **Partagez la page DTT® publique** avec les investisseurs, les prêteurs et les équipes de due diligence — elle fournit une preuve vérifiée par blockchain de l'état de la documentation du bâtiment sans nécessiter d'accès à la plateforme. * **Maintenez les paiements d'abonnement à jour** — Un seul paiement manqué peut bloquer le minting (au stade OVERDUE\_3\_DAYS) et retarder vos mises à jour d'enregistrement blockchain. --- # 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/fonctionnalites/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.