# Belohnungen

Das Magma-Rewards-System bietet Beteiligten Anreize, hochwertige, verifizierte Gebäudedokumentation beizutragen, indem **MRT (Magma Reward Token)** Kryptowährungs-Rewards für qualifizierende Aktionen verteilt werden. Rewards werden auf der Grundlage der Qualität und Glaubwürdigkeit jedes Beitrags berechnet, nicht nur der Menge.

***

## Überblick

Rewards werden von Beteiligten verdient, die spezifische Aktionen im Zusammenhang mit der Gebäudedokumentation durchführen:

* Hochladen von Dokumenten (wenn das Dokument anschließend validiert wird).
* Validierung von Dokumenten, die von anderen hochgeladen wurden.
* Eingabe von Daten in BIM-Objektfelder (wenn der Eintrag anschließend genehmigt wird).
* Validierung von BIM-Feldeinträgen, die von anderen eingereicht wurden.

Rewards werden in **MRT** verteilt, einem ERC-20-Token auf der VeChain-Blockchain (auch auf ETH, BNB und Polygon verfügbar). MRT wird in der persönlichen **Stakeholder-Wallet** des Beteiligten empfangen (getrennt von der Building-Wallet).

***

## Qualifizierende Reward-Aktionen

| Aktion                             | Beschreibung                                                               | Auslöser                                                                                  |
| ---------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Dokument-Upload**                | Ein Beteiligter lädt ein Dokument in den Data Room hoch.                   | Reward wird ausgestellt, wenn das Dokument den Status **Validated** erreicht.             |
| **Dokumentvalidierung (Primär)**   | Ein Beteiligter validiert ein Dokument als primärer (erster) Validator.    | Reward wird nach Abschluss der Validierung ausgestellt.                                   |
| **Dokumentvalidierung (Sekundär)** | Ein Beteiligter validiert ein Dokument als zweiter Validator.              | Reward wird nach Abschluss der Validierung ausgestellt.                                   |
| **Dokumentvalidierung (Tertiär)**  | Ein Beteiligter validiert ein Dokument als dritter Validator.              | Reward wird nach Abschluss der Validierung ausgestellt.                                   |
| **BIM-Feldeingabe**                | Ein Beteiligter gibt Daten in ein BIM-Objektfeld über den 3D Viewer ein.   | Reward wird ausgestellt, wenn die Feldänderung von allen Validatoren **genehmigt** wurde. |
| **BIM-Feldvalidierung**            | Ein Beteiligter stimmt für die Genehmigung einer BIM-Feldänderungsanfrage. | Reward wird nach erfolgreicher Genehmigung ausgestellt.                                   |

***

## Reward-Berechnungsformel

Der MRT-Reward-Betrag für jede Aktion wird durch die Multiplikation mehrerer Faktoren bestimmt:

```
Reward = Intrinsischer Dokumentwert × Akteurkategorie × Uploader/Validator-Kombination × Validator-Vollständigkeit × Beteiligten-Reputation × Datenablauf-Faktor
```

### Faktor 1 — Intrinsischer Dokumentwert

Der Basiswert, der einem bestimmten Dokumenttyp zugewiesen wird, angepasst nach:

* Dem **Dokumenttyp** (z. B. hat eine Eigentumsurkunde einen höheren intrinsischen Wert als ein Budgetdokument).
* Dem **Gebäudetyp** (z. B. wird eine Sicherheitsvereinbarung für ein Hotel stärker gewichtet als für ein Lagergebäude).
* Der **Magma-Ebene** (z. B. haben Genesis-Dokumente andere Basiswerte als Wired-Dokumente).

### Faktor 2 — Akteurkategorie

| Kategorie                    | Multiplikator             |
| ---------------------------- | ------------------------- |
| Professionell (lizenziert)   | Höherer Multiplikator     |
| Laienhaft (nicht lizenziert) | Niedrigerer Multiplikator |

### Faktor 3 — Relevanz der Uploader/Validator-Kombination

Ob Uploader und Validator(en) die optimalen Rollen für den spezifischen Dokumenttyp sind. Relevante Rollenkombinationen erhalten einen höheren Multiplikator. Nicht übereinstimmende Rollen (z. B. ein Mieter, der ein Tragwerksdokument validiert) erhalten einen niedrigeren Multiplikator.

### Faktor 4 — Validator-Vollständigkeit

| Zugewiesene Validatoren | Stufe   | Auswirkung auf Reward   |
| ----------------------- | ------- | ----------------------- |
| 0                       | Keine   | Kein Validierungsbonus  |
| 1                       | Stufe 1 | Moderater Multiplikator |
| 2                       | Stufe 2 | Höherer Multiplikator   |
| 3                       | Stufe 3 | Maximaler Multiplikator |

### Faktor 5 — Beteiligten-Reputation

Jeder Beteiligte hat einen **Reputationswert** (ganzzahlig 1–5, Standard: 3):

* Höhere Reputation = höherer Reward-Multiplikator.
* **Erhöhungen:** +1 für jeweils 5 gemintete Validierungen (max. 5).
* **Verringerungen:** Durch den Cron-Job der Plattform für sanktionierungswürdiges Verhalten angewendet (z. B. abgelehnte Validierungen, ungenaue Dateneingaben).

Reputation ist ein **globaler Wert** — er gilt für alle Gebäude, an denen der Beteiligte teilnimmt. Der Aufbau einer starken Reputation in einem Gebäude kommt den Rewards des Beteiligten im gesamten Portfolio zugute.

### Faktor 6 — Datenablauf

Dokumente mit aktiven, nicht abgelaufenen Gültigkeitsdaten erhalten den vollen Reward. Dokumente mit einem Ablaufdatum, das zum Zeitpunkt des Mintings bereits vergangen ist, erhalten aufgrund der Datenablaufstrafe einen **reduzierten Reward**.

***

## Reward-Zustände

Jeder Reward durchläuft drei Zustände:

| Zustand        | Beschreibung                                                                                                                                                      |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ausstehend** | Die qualifizierende Aktion hat stattgefunden, aber das Minting wurde noch nicht abgeschlossen. Der Reward ist berechnet und reserviert, aber noch nicht verteilt. |
| **Finanziert** | Der Minting-Prozess wurde durchgeführt und der Reward wurde on-chain zugeteilt.                                                                                   |
| **Bezahlt**    | Die MRT-Token wurden in die Stakeholder-Wallet des Beteiligten übertragen.                                                                                        |

***

## MRT-Token

| Eigenschaft           | Wert                                        |
| --------------------- | ------------------------------------------- |
| Token-Typ             | ERC-20                                      |
| Primäre Blockchain    | VeChain                                     |
| Auch verfügbar auf    | ETH, BNB, Polygon                           |
| Wallet (empfangen in) | Stakeholder-Wallet (persönlich), über Venly |

MRT-Rewards sind von der Building-Wallet getrennt, die den DTT-Vertrag hält. Jede persönliche Wallet eines Beteiligten empfängt MRT unabhängig.

***

## Beteiligten-Reputation

Reputation ist ein wichtiger Multiplikator sowohl für Rewards als auch für die Magma Index-Bewertung.

### Wie Reputation funktioniert

| Ereignis                        | Reputationsänderung       |
| ------------------------------- | ------------------------- |
| Standard (neuer Beteiligter)    | 3                         |
| Alle 5 geminteten Validierungen | +1 (max. 5)               |
| Sanktionierung durch Cron-Job   | -1 (abhängig vom Verstoß) |

### Reputation und Stimmrechte

Reputation verleiht auch **Stimmrechte** bei Feldänderungsanfragen. Validatoren mit höherer Reputation haben mehr Gewicht im Genehmigungsprozess. Dies spiegelt sich in den Vorteilen wider, die auf dem Wallet-Verbindungsbildschirm angezeigt werden.

***

## Rewards-Registerkarte

Die Rewards-Registerkarte ist nur für Gebäude-**Eigentümer** und **Kontoverwalter** zugänglich. Sie bietet Einblick in alle Reward-Aktivitäten für das Gebäude.

### Unterregisterkarten

Die Rewards-Registerkarte ist in zwei Unterregisterkarten unterteilt:

#### Unterregisterkarte Dokumente

Eine Tabelle mit allen dokumentenbezogenen Rewards:

| Spalte        | Beschreibung                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------ |
| Akteur        | Der Beteiligte, der die Aktion durchgeführt hat (Name + Avatar).                                 |
| Aktionstyp    | Die qualifizierende Aktion (Upload, Primärvalidierung, Sekundärvalidierung, Tertiärvalidierung). |
| Reward-Betrag | Der berechnete MRT-Reward-Betrag.                                                                |
| Status        | Ausstehend / Finanziert / Bezahlt.                                                               |

#### Unterregisterkarte 3D-Modell

Eine Tabelle mit allen BIM-bezogenen Rewards:

| Spalte        | Beschreibung                                     |
| ------------- | ------------------------------------------------ |
| Akteur        | Der Beteiligte, der die Aktion durchgeführt hat. |
| Aktionstyp    | BIM-Feldeingabe oder BIM-Feldvalidierung.        |
| Reward-Betrag | Der berechnete MRT-Reward-Betrag.                |
| Status        | Ausstehend / Finanziert / Bezahlt.               |

### Rewards pro Beteiligten umschalten

Eigentümer und Kontoverwalter können Rewards für einzelne Beteiligte **aktivieren oder deaktivieren**. Dies wird über einen Umschalter neben jedem Beteiligten in der Rewards-Registerkarte verwaltet. Das Deaktivieren von Rewards für einen Beteiligten bedeutet, dass ihre qualifizierenden Aktionen keine MRT-Rewards generieren.

***

## Reward-Simulator

Vor dem Hochladen eines Dokuments können Beteiligte den **Simulator** verwenden, um die genaue MRT-Reward-Verteilung zu sehen, die aus dem Upload resultieren würde.

Der Simulator zeigt eine Vorschau von:

* Wie viel MRT der Uploader erhalten wird.
* Wie viel jeder Validator erhalten wird (pro Validator-Slot: primär, sekundär, tertiär).
* Den gesamten Reward-Pool für das Dokument.

Weitere Details zur Verwendung finden Sie im [Simulator](/magma-documentation/de/funktionen/simulator.md)-Leitfaden.

***

## Tipps zur Maximierung von Rewards

* **Bauen Sie Ihre Reputation auf** — Jede gemintete Validierung erhöht Ihren Reputationswert (bis zu 5). Höhere Reputation bedeutet höhere Rewards bei jeder nachfolgenden Aktion.
* **Validieren Sie so oft wie möglich** — Jede Validierung (primär, sekundär oder tertiär) generiert einen Reward. Als Validator zugewiesen zu sein ist eine der ertragreichsten Aktionen auf der Plattform.
* **Laden Sie als Profi hoch** — Beteiligte mit professionellen Rollen erhalten einen höheren Akteurkategorie-Multiplikator. Stellen Sie sicher, dass Ihre Rolle auf der Plattform Ihren professionellen Status genau widerspiegelt.
* **Füllen Sie die Validator-Slots** — Dokumente mit 3 Validatoren generieren den maximalen Reward für alle Parteien. Uploader sollten immer versuchen, alle 3 Validator-Slots zu besetzen.
* **Halten Sie Dokumente aktuell** — Dokumente, die vor dem Minting ablaufen, erhalten einen reduzierten Reward. Aktualisieren Sie zeitkritische Dokumente proaktiv, um die Ablaufstrafe zu vermeiden.
* **Verwenden Sie den Simulator** — Sehen Sie sich Ihren Reward vor dem Hochladen an, um sicherzustellen, dass die Verteilung Ihren Erwartungen entspricht, und wählen Sie die optimale Validator-Kombination.


---

# 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/funktionen/rewards.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.
