# مسرد Blockchain وDTT®

تشرح هذه الصفحة مفاهيم البلوكتشين المستخدمة في Magma. لست بحاجة إلى فهم تقنية البلوكتشين لاستخدام Magma — لكن هذا المسرد يساعدك إن أردت فهم ما يحدث خلف الكواليس عند سَكّ البيانات.

***

## المفاهيم الأساسية

### Digital Twin Token (DTT®)

DTT® هو سجل قائم على البلوكتشين يمثل مبنى. تقنيًا، هو **عقد ذكي ERC-1155** منشور على بلوكتشين VeChain — عقد واحد لكل مبنى. داخل هذا العقد، تُنشَأ **معرّفات رموز (token IDs)** متعددة — واحد لكل إصدار مستند تم التحقق منه وواحد لكل إصدار جسم BIM تم التحقق منه.

فكّر في DTT® بوصفه جواز السفر الرقمي الدائم للمبنى: فهو يعرّف المبنى على البلوكتشين ويوفر مرساةً قابلة للتحقق لجميع البيانات المُسهَم بها فيه.

### ERC-1155

معيار رموز متعددة للعقود الذكية على البلوكتشين. بخلاف ERC-721 (الذي ينشئ رمزًا واحدًا لكل عنصر)، يتيح ERC-1155 لعقد واحد إدارة العديد من الرموز — مما يجعله فعالًا لتمثيل مئات المستندات وأجسام النماذج داخل عقد DTT® لمبنى واحد.

تستخدم Magma معيار ERC-1155 تحديدًا لأن:

* عقد واحد لكل مبنى (وليس واحدًا لكل مستند)
* يحصل كل إصدار مستند وكل حقل BIM على معرّف رمز خاص به داخل ذلك العقد
* المعيار مدعوم جيدًا عبر المحافظ والمستكشفات والأسواق

### Token ID

داخل عقد DTT® لمبنى، يحصل كل أصل تم التحقق منه على **معرّف رمز** فريد:

* إصدار ملف مستند ← معرّف رمز واحد
* إصدار جسم نموذج BIM ← معرّف رمز واحد

معرّفات الرموز هي الرابط بين بيانات Magma الداخلية والسجل على السلسلة. وهي تستمر بشكل دائم بمجرد إنشائها.

### عقد HashStorage

عقد ذكي مرافق يُنشَر إلى جانب كل عقد DTT®. يخزّن **مصفوفة قابلة للإضافة فقط من البصمات التشفيرية** لكل معرّف رمز.

```
HashStorage[tokenId] = [hash_v1, hash_v2, hash_v3, ...]
```

عند سَكّ مستند لأول مرة، تُخزَّن بصمته عند الفهرس 0. وعند رفع نسخة جديدة والتحقق منها، تُضاف البصمة الجديدة عند الفهرس 1 — وهكذا. لا تُستبدَل البصمة الأصلية **أبدًا**. يُحفَظ كامل تاريخ جميع الإصدارات بشكل دائم وقابل للاستعلام.

### DTT Factory

عقد ذكي مشترك واحد على VeChain ينشر عقود DTT® جديدة. عند إنشاء مبنى على Magma وإكمال الدفع، يُستدعى DTT Factory لنشر عقد DTT® جديد (وعقد HashStorage المقترن به) لمبناك. يتتبع المصنع جميع العقود المنشورة عبر مصفوفة على السلسلة.

***

## أدوار المسؤول الإداري

لكل عقد DTT® ثلاثة عناوين مسؤول إداري منفصلة:

| الدور                  | ما يمكنه فعله                         |
| ---------------------- | ------------------------------------- |
| **tokenAdministrator** | سَكّ معرّفات رموز جديدة داخل عقد DTT® |
| **levelAdministrator** | تعيين المستوى الهرمي لـ DTT® (0–255)  |
| **hashAdministrator**  | إضافة البصمات إلى عقد HashStorage     |

تُحتَفظ هذه الأدوار من قبل البنية التحتية لـ Magma، وليس من قبل مستخدمين أفراد. وهي تضمن ألا تتمكن سوى المنصة من الكتابة على السلسلة — مع كون جميع البيانات شفافة وقابلة للتحقق علنًا.

***

## البلوكتشين والمحافظ

### VeChain

شبكة البلوكتشين الأساسية المستخدمة من قبل Magma. VeChain هو بلوكتشين عام مصمم للتطبيقات المؤسسية، برسوم معاملات منخفضة وإنتاجية عالية. محافظ المباني ومحافظ الأطراف المعنية على Magma هي عناوين VeChain.

### Venly

مزود المحافظ المدمج في Magma. Venly هو خدمة **محفظة بحفظ الطرف الثالث (custodial)** — فهو يدير مفاتيحك الخاصة نيابةً عنك، مما يجعله متاحًا للمستخدمين الجدد على Web3. تصادق مع Venly باستخدام بيانات اعتماد قياسية (دون الحاجة إلى عبارة استرداد). عند توصيل محفظتك في Magma، فإنك توصل محفظة VeChain يديرها Venly.

### محفظة الطرف المعني

محفظتك الشخصية على البلوكتشين، المرتبطة بملف مستخدم Magma الخاص بك. تتلقى **مكافآت رمز MRT** بعد السَكّ. محفظة واحدة لكل شخص، متصلة عبر Venly.

### محفظة المبنى

محفظة بلوكتشين منفصلة تُنشَأ لكل مبنى أثناء معالج الإنشاء. تمتلك العقد الذكي DTT® وهي مطلوبة قبل أن يبدأ السَكّ. محفظة واحدة لكل مبنى.

***

## الرموز والمكافآت

### رمز MRT (Magma Reward Token)

رمز **ERC-20** منشور عبر بلوكتشينات متعددة:

* VeChain (الأساسي)
* Ethereum
* BNB Smart Chain (Binance)
* Polygon

يُوزَّع MRT كمكافأة للأطراف المعنية الذين يتم التحقق من مساهماتهم في البيانات وسَكّها. يعتمد المقدار على القيمة الجوهرية للمستند، وسمعة الطرف المعني، ودوره (رافع مقابل مستوى مدقق).

يستخدم MRT نمط **MiniMeToken**، الذي يدعم استعلامات الأرصدة التاريخية القائمة على اللقطات — مما يتيح ميزات الحوكمة مستقبلًا.

### السَكّ (Minting)

عملية تسجيل بيانات المبنى التي تم التحقق منها بشكل دائم على البلوكتشين. ينشئ السَكّ معرّفات رموز داخل عقد DTT® ويضيف البصمات إلى عقد HashStorage. كما يوزّع مكافآت MRT على المساهمين.

يبدأ السَكّ من قبل المالك أو مدير الأصول (أو طرف معني لديه حقوق سَكّ مفوَّضة) ويتكون من 13 خطوة تُنفَّذ بالتتابع.

***

## المفاهيم التشفيرية

### البصمة التشفيرية (Hash)

سلسلة نصية ثابتة الطول تعرّف محتوى ملف بشكل فريد. إذا تغير الملف حتى بحرف واحد، فإن البصمة تتغير تمامًا. وهذا يجعل البصمات مثالية للتحقق من أن مستندًا لم يُعبَث به.

في Magma، تكون بصمة كل إصدار مستند:

1. مرئية للمستخدمين في لوحة معلومات المستند
2. مخزَّنة على السلسلة في HashStorage بعد السَكّ
3. محفوظة بشكل دائم (لا تُستبدَل أبدًا)

يمكن لأي شخص التحقق من صحة مستند بحساب بصمته ومقارنتها بالسجل على السلسلة.

### السجل على السلسلة

بيانات مخزَّنة على البلوكتشين. بمجرد التسجيل، تكون البيانات على السلسلة غير قابلة للتغيير — لا يمكن تغييرها أو حذفها أو العبث بها. في Magma، تشمل السجلات على السلسلة لمبنى جميع بصمات المستندات المسكوكة وإصدارات أجسام BIM.

***

## صفحة DTT® العامة

يمكن الوصول علنًا إلى DTT® لكل مبنى على:

```
https://app.mymagma.com/dtt/[blockchain-address]
```

تعرض هذه الصفحة:

* رسمًا بيانيًا هرميًا للعقد (تصور React Flow) لبنية رموز المبنى
* العقد الأساسية PRIMARY (عقد DTT® الرئيسي)، والعقد الثانوية SECONDARY (الرموز الفرعية)، وعقد STORAGE\_AGGREGATOR (HashStorage)
* لكل عقدة: عنوان البلوكتشين ورابط "See on blockchain" إلى مستكشف VeChain
* نافذة Hash Storage تعرض جميع المستندات وأجسام BIM المسكوكة مع بصماتها

لا يلزم وجود حساب Magma لعرض هذه الصفحة. يمكن لأي شخص لديه عنوان البلوكتشين الخاص بالمبنى التحقق من تاريخ توأمه الرقمي.


---

# 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/ar/almrja/blockchain-glossary.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.