# Portefeuille

La section Portefeuille gère vos connexions de portefeuilles blockchain sur la plateforme Magma. Les portefeuilles vous permettent de recevoir des tokens de récompense MRT pour vos contributions et de participer à l'écosystème DTT® (Digital Twin Token). Magma utilise la blockchain **VeChain** avec **Venly** comme fournisseur de portefeuille exclusif.

***

## Deux types de portefeuilles

Magma opère deux types de portefeuilles distincts, chacun ayant une fonction différente :

| Type de portefeuille                   | Propriétaire                             | Objectif                                                                                                                       |
| -------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Portefeuille de la partie prenante** | Partie prenante individuelle (personnel) | Reçoit les tokens de récompense MRT pour les téléversements de documents, les validations et les contributions aux champs BIM. |
| **Portefeuille du bâtiment**           | Le bâtiment lui-même                     | Détient le contrat intelligent DTT® ERC-1155 pour le bâtiment. Créé automatiquement lors de la création du bâtiment.           |

Ces deux portefeuilles sont indépendants. Votre Portefeuille de partie prenante personnel reçoit vos récompenses MRT gagnées. Le Portefeuille du bâtiment est géré au niveau du bâtiment par le Propriétaire et les Gestionnaires de compte.

***

## Token MRT

Le **MRT (Magma Reward Token)** est la cryptomonnaie de récompense distribuée aux parties prenantes pour les contributions éligibles :

| Propriété                | Valeur                                         |
| ------------------------ | ---------------------------------------------- |
| Standard du token        | ERC-20                                         |
| Blockchain principale    | VeChain                                        |
| Également disponible sur | ETH, BNB, Polygon                              |
| Reçu dans                | Portefeuille de la partie prenante (personnel) |
| Fournisseur              | Venly                                          |

***

## Fournisseur de portefeuille : Venly

Magma prend exclusivement en charge **Venly** comme fournisseur de portefeuille. Venly est une plateforme de portefeuille blockchain en tant que service qui simplifie l'expérience utilisateur pour les utilisateurs non techniques en abstrayant la gestion des clés privées.

> **Remarque :** Seuls les portefeuilles Venly sont supportés. Les autres fournisseurs de portefeuilles (MetaMask, Ledger, WalletConnect, etc.) ne sont pas compatibles avec la plateforme Magma.

***

## État sans portefeuille connecté

Si vous n'avez pas encore connecté de portefeuille, la section Portefeuille affiche un écran d'information avec :

### Cartes d'avantages

Deux cartes mettant en évidence les raisons de connecter un portefeuille :

| Avantage                        | Description                                                                                                                                     |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gérer les récompenses**       | Connectez un portefeuille pour recevoir vos tokens MRT gagnés lorsque les documents sont mintés.                                                |
| **Réputation + Droits de vote** | Votre portefeuille est lié à votre score de réputation et vous accorde des droits de vote dans les approbations de modifications de champs BIM. |

### Bouton de connexion

Un bouton **Connecter le portefeuille** bien visible pour démarrer le processus de connexion.

### Boîte d'avertissement

Une boîte d'avertissement informative expliquant que sans portefeuille connecté, toutes les récompenses MRT gagnées pour les contributions validées resteront à l'état **En attente** et ne seront pas distribuées tant qu'un portefeuille n'est pas connecté.

***

## Connexion de votre portefeuille

1. Cliquez sur **Connecter le portefeuille**.
2. Vous êtes redirigé vers le flux d'authentification et de sélection de portefeuille **Venly**.
3. Connectez-vous à votre compte Venly (ou créez-en un si vous n'en avez pas).
4. Sélectionnez ou créez un portefeuille VeChain dans Venly.
5. Autorisez Magma à se connecter à votre portefeuille.
6. Vous êtes redirigé vers la section Portefeuille de Magma avec votre portefeuille maintenant connecté.

***

## État avec portefeuille connecté

Une fois un portefeuille connecté, la section Portefeuille affiche :

### Carte de portefeuille

La carte de portefeuille principale affiche :

| Élément                     | Description                                                                                         |
| --------------------------- | --------------------------------------------------------------------------------------------------- |
| **Adresse du portefeuille** | Votre adresse de portefeuille VeChain (clé publique).                                               |
| **Nom du portefeuille**     | Le nom d'affichage du portefeuille tel que configuré dans Venly.                                    |
| **Solde MRT**               | Votre solde actuel en tokens MRT.                                                                   |
| **Équivalent EUR**          | La valeur marchande actuelle de votre solde MRT en EUR (basée sur le taux de change en temps réel). |

### Bouton Explorer

Ouvre l'**explorateur de blockchain VeChain** pour votre adresse de portefeuille, vous permettant de vérifier indépendamment l'historique des transactions, les soldes de tokens et les avoirs DTT® de votre portefeuille.

### Bouton Déconnecter

Déconnecte votre portefeuille Venly de la plateforme Magma. La déconnexion n'affecte pas votre portefeuille lui-même ni votre solde de tokens — elle supprime uniquement le lien entre Magma et votre portefeuille. Vos tokens MRT gagnés restent dans le portefeuille.

> **Remarque :** Si vous déconnectez votre portefeuille, les distributions de récompenses seront mises en pause (les récompenses s'accumuleront à l'état En attente) jusqu'à ce que vous vous reconnectiez.

***

## Section Digital Twin Tokens

Sous la carte de portefeuille, une section **Digital Twin Tokens** affiche tous les bâtiments dans lesquels vous avez une participation et leur statut DTT® associé :

### Carrousel de bâtiments

Un carrousel horizontal de bâtiments, affichant :

* **Image du bâtiment** — La photo de couverture du bâtiment.
* **Nom du bâtiment** — Le nom officiel du bâtiment.
* **Magma Index %** — Le score actuel de complétude de la documentation du bâtiment.
* **Statut DTT®** — Si le bâtiment a été minté et si le DTT® est actif.

Cliquer sur une carte de bâtiment dans ce carrousel navigue vers l'onglet DTT® de ce bâtiment.

***

## Portefeuille du bâtiment

Le **Portefeuille du bâtiment** est automatiquement créé lors du processus de [Création du bâtiment](/magma-documentation/fr/fonctionnalites/building-creation.md) (Étape 5). Ce n'est pas un portefeuille personnel — il appartient au bâtiment et est utilisé par la plateforme pour :

* Déployer le contrat intelligent DTT® ERC-1155 pour le bâtiment.
* Détenir la propriété du contrat DTT® on-chain.
* Signer les transactions de minting au nom du bâtiment.

Les Propriétaires et les Gestionnaires de compte peuvent consulter l'adresse du Portefeuille du bâtiment dans les paramètres du bâtiment. Cette adresse est également liée sur la page publique DTT® (`/dtt/[address]`) et est intégrée dans le QR code sur la carte DTT®.

***

## Distribution des récompenses vers votre portefeuille

Lorsqu'un minting DTT® est complété, la plateforme :

1. Calcule la récompense MRT pour chaque partie prenante éligible (en fonction des facteurs de récompense).
2. Met les récompenses de l'état **En attente** à l'état **Financée**.
3. Transfère les tokens MRT vers le Portefeuille de partie prenante connecté de chaque partie prenante.
4. Met les récompenses à l'état **Payée**.

Si votre portefeuille n'est pas connecté au moment du minting, vos récompenses restent à l'état **En attente**. Elles sont distribuées dès que vous connectez un portefeuille et que le prochain minting a lieu.

***

## Conseils pour gérer votre portefeuille

* **Connectez votre portefeuille tôt** — Les récompenses gagnées avant la connexion d'un portefeuille sont maintenues à l'état En attente et ne sont distribuées qu'au prochain minting après la connexion. Ne tardez pas à vous connecter.
* **Sécurisez votre compte Venly** — Vos tokens MRT sont détenus dans votre portefeuille Venly. Activez l'authentification à deux facteurs sur votre compte Venly.
* **Surveillez votre solde MRT** — Vérifiez régulièrement l'équivalent en EUR. La valeur marchande du MRT peut fluctuer.
* **Utilisez le bouton Explorer** pour vérifier indépendamment vos reçus de tokens après chaque minting — cela confirme que la plateforme a correctement transféré vos récompenses on-chain.
* **Ne déconnectez pas votre portefeuille** entre les périodes de minting actives — la déconnexion met en pause la distribution des récompenses.


---

# 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/wallet.md?ask=<question>
```

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.
