> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ar/albda-1/key-concepts.md).

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

المصطلحات الأساسية في Solana وRome EVM للمطوّرين — البرامج، والحسابات، وPDAs، وCPI، وSPL tokens، والتنفيذ الذرّي مقابل التكراري.

المصطلحات والمفاهيم الأساسية للبناء على بروتوكول Rome.

## مفاهيم سولانا

**برنامج** — المعادل في سولانا للعقد الذكي. البرامج هي ملفات تنفيذية عديمة الحالة منشورة على السلسلة. إن Rome EVM نفسه برنامج سولانا.

**حساب** — كل الحالة في سولانا تعيش في الحسابات. لكل حساب مالك (برنامج)، ورصيد (لامبورتس)، وبيانات. وعلى عكس إيثريوم، يُخزَّن الكود والحالة في حسابات منفصلة.

**PDA (العنوان المشتق من البرنامج)** — عنوان حتمي مشتق من بذور ومعرّف برنامج. تتيح PDAs للبرامج "امتلاك" الحسابات من دون مفتاح خاص. يستخدم Rome PDAs لربط عناوين إيثريوم بحسابات سولانا.

**CPI (الاستدعاء عبر البرامج)** — برنامج سولانا يستدعي برنامجًا آخر ضمن المعاملة نفسها. بهذه الطريقة تتفاعل عقود Rome EVM مع Jupiter وKamino وSPL Token وبرامج سولانا الأخرى.

**SPL Token** — برنامج الرموز القياسي في سولانا. يعادل ERC-20 في إيثريوم. جميع الرموز القابلة للاستبدال على سولانا (USDC وSOL وغيرها) هي رموز SPL.

**Token-2022** — برنامج الرموز SPL من الجيل التالي مع امتدادات مثل خطافات النقل، والتحويلات السرية، والمفوّضين الدائمين.

**خطاف النقل** — امتداد في Token-2022 يستدعي برنامجًا في كل `transfer_checked` استدعاء.

**ATA (حساب الرمز المميز المرتبط)** — حساب رمزي حتمي لزوج محدد من المحفظة + الإصدار. لكل مستخدم ATA واحد لكل رمز يحتفظ به.

**لامبورتس** — أصغر وحدة من SOL. 1 SOL = 1,000,000,000 لامبورتس (10^9).

**وحدات الحوسبة (CU)** — المعادل في سولانا لغاز إيثريوم. لكل معاملة ميزانية حوسبة (الافتراضي نحو 200 ألف CU، والحد الأقصى نحو 1.4 مليون CU). تستهلك العمليات وحدات CU.

## مفاهيم Rome

**برنامج Rome EVM** — برنامج سولانا الذي يحتوي على مفسّر بايتكود EVM. يُنشر بمعرّف برنامج محدد لكل بيئة.

**معرّف السلسلة** — تحصل كل تطبيقات Rome على معرّف سلسلة EVM خاص بها. وهذا ينشئ بيئات EVM معزولة تشترك في حالة سولانا الأساسية نفسها.

**التنفيذ الذري (VmAt)** — معاملة EVM تُنفَّذ بالكامل داخل معاملة سولانا واحدة. تُستخدم لمعظم العمليات.

**التنفيذ التكراري (VmIt)** — معاملة EVM مُقسّمة عبر عدة معاملات سولانا، حيث تُكدَّس في كل خطوة أكبر عدد ممكن من أوامر التشغيل التي تتسع لها ميزانية الحوسبة في معاملة سولانا واحدة (تكيفية، وليست عددًا ثابتًا). تُستخدم للعمليات كثيفة الحوسبة مثل اقتران BN254.

**حساب الحفظ** — مخزن مؤقت على السلسلة يخزن معاملات EVM الكبيرة (حتى 80 كيلوبايت) التي تتجاوز حد حجم معاملة سولانا (v1) البالغ 4 كيلوبايت. تتم إدارته بشفافية بواسطة SDK.

**StateHolder** — حساب على السلسلة يخزن حالة الآلة الافتراضية المُسلسلة بين خطوات التنفيذ التكرارية.

**Rome Proxy** — خادم JSON-RPC (المنفذ 9090) الذي يترجم استدعاءات واجهة برمجة تطبيقات إيثريوم إلى معاملات سولانا. يتصل هنا كلٌّ من MetaMask وHardhat.

**Hercules** — مفهرس الكتل الذي يراقب أحداث Rome EVM على سولانا ويُنتج بيانات كتل متوافقة مع إيثريوم.

**المُسدِّد** — زوج مفاتيح سولانا يوقّع ويدفع مقابل معاملات سولانا نيابةً عن مستخدمي EVM. يديره Proxy عبر مجمعات الدافعين.

## مفاهيم الرموز

**SPL\_ERC20 / SPL\_ERC20\_cached** — عقود غلاف ERC-20 تمثل رمز SPL داخل Rome EVM. بالنسبة للمحفظة، يقرأ الغلاف الرصيد مباشرةً من حساب رمز SPL الأساسي. الرموز التي يحتفظ بها عقد تستقر في حساب الضمان الرمزي الخاص بالغلاف وتُتتبَّع في تخزين الغلاف (انظر [دمج برنامج سولانا](https://docs.rome.builders/ar/adlh-almtw-ryn/integrate-solana-program.md)). ينشر المصنع النسخة المخبأة اليوم.

**ERC20SPLFactory** — عقد مصنع ينشر أغلفة لأي رمز SPL.

**السجل** — تُدار الأغلفة القياسية، ورموز الغاز، وتوصيلات الجسر خارج السلسلة في [rome-protocol/registry](https://github.com/rome-protocol/rome-registry); لا يوجد عقد سجل رموز على السلسلة. وهذا يُبقي كل أصل مُعيَّنًا إلى سكّ SPL قياسي وحيد.

## الاستدعاءات المسبقة

**الاستدعاءات المسبقة القياسية في إيثريوم** — ecrecover (0x01)، SHA-256 (0x02)، RIPEMD-160 (0x03)، identity (0x04)، modexp (0x05)، BN254 ecAdd/ecMul/ecPairing (0x06-0x08)، Blake2f (0x09).

**العنصر المسبق للنظام** (`0xFF...07`) — اشتقاق PDA وتحويل base58 من Solidity.

**العنصر المسبق CpiProgram** (`0xFF...08`) — استدعاء عبر البرامج (`invoke` / `invoke_signed`) بالإضافة إلى اختصارات القراءة عبر الحالة.

**العنصر المسبق HelperProgram** (`0xFF...09`) — إنشاء ATA/PDA، وتحويلات SPL، وتحويل الغاز↔اللامبورتس؛ الواجهة الأساسية لعمليات SPL الموقعة بواسطة PDA الخاص بالمستخدم.

**العنصر المسبق للسحب** (`0x42...16`) — سحب SOL أو رموز SPL من EVM إلى سولانا.

عائلة ذات مسار مخبأ (`0xff…04/05/06/0b`) تعكس هذه الأنواع لعمليات القراءة الموفرة لوحدات الحوسبة؛ ويستخدم العقد مسارًا واحدًا باستمرار.

## أنواع المعاملات

يبني Rust SDK ثلاثة أنواع من المعاملات. يقوم Rome بتسوية كل منها على سولانا.

**معاملة EVM واحدة (`RheaTx`)** — معاملة EVM واحدة على سلسلة Rome واحدة. وهو النوع الأكثر شيوعًا.

**عدة معاملات EVM (`RemusTx`)** — معاملات EVM على سلاسل Rome مختلفة، تُنفَّذ معًا في معاملة سولانا واحدة. إذا فشلت إحداها، فالجميع يتراجع.

**معاملات EVM بالإضافة إلى تعليمات سولانا (`RomulusTx`)** — معاملات EVM وتعليمات سولانا الأصلية في معاملة سولانا ذرية واحدة، بحيث تعمل Solidity وبرامج سولانا معًا أو لا تعمل إطلاقًا.

## ما التالي

* [نموذج التنفيذ](https://docs.rome.builders/ar/almfahym-alasasyh/execution-model.md) — نظرة معمقة على كيفية تنفيذ معاملات EVM على سولانا
* [التوافق البيني للرموز](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md) — كيف تتفاعل رموز ERC-20 ورموز SPL
* [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md) — الحدود والقيود المهمة


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ar/albda-1/key-concepts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
