> 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/akadymyh-rwma/04-how-rome-runs-your-code.md).

# 4. كيف تُشغّل Rome شيفرتك

كيف تصبح معاملة روم معاملات سولانا، ولماذا تعمل معظم الاستدعاءات بشكل ذري، وما الذي يتغير عندما يكون الاستدعاء كبيرًا جدًا.

يعمل Solidity الخاص بك دون تغيير. ما يتغير هو مكان تشغيله: داخل برنامج Solana، ضمن حدود Solana. يمنحك هذا الدرس الصورة التي تحتاجها لتتوقع تكلفة أي استدعاء ومتى سيفشل.

## ما ستتعلمه

* المسار الذي تسلكه المعاملة من محفظتك إلى أحد مدققي Solana ثم العودة إلى إيصال EVM.
* الفرق بين التنفيذ الذري والتنفيذ التكراري، ولماذا تريد التنفيذ الذري.
* الحدود في Solana التي تؤثر على Solidity لديك: الحوسبة، الحجم، عدد الحسابات، الأقفال.
* كيف تقيس التكلفة الحقيقية لأي استدعاء.

## قبل أن تبدأ

* أنهِ [3. أول عقد لك على Hadrian](https://docs.rome.builders/ar/akadymyh-rwma/03-first-contract-on-hadrian.md). تحتاج إلى عقد منشور ومعاملة واحدة أرسلتها إليه.
* احتفظ بتجزئة تلك المعاملة في متناول يدك. ستفتحها في المستكشف في نهاية هذا الدرس.

## مسار معاملة واحدة

توقّع معاملة EVM عادية وترسلها إلى وكيل Rome مع `eth_sendRawTransaction`. لا يمررها الوكيل بعد. أولًا، يشغّل الاستدعاء خارج السلسلة في محاكي ينفذ منطق EVM نفسه الذي ينفذه البرنامج على السلسلة. ويخبره المحاكاة بثلاثة أشياء: مقدار الغاز الذي يحتاجه الاستدعاء، وحسابات Solana التي يلمسها الاستدعاء، وما إذا كان الاستدعاء يناسب معاملة Solana واحدة.

ثم يغلّف الوكيل استدعاءك كتوجيهات Solana ويرسلها. برنامج Rome EVM، وهو برنامج Solana عادي، يفسر الشيفرة الثنائية الخاصة بك. وتستقر تغييرات الحالة في حسابات Solana. ويقرأ المفهرس النتيجة وينتج كتلة EVM والإيصال اللذين تتوقعهما أدواتك.

كل عنوان EVM يُطابَق مع حساب Solana مملوك لبرنامج Rome. رصيد عقدك، والعداد غير المستخدم (nonce)، والشيفرة، والتخزين، كلها حسابات Solana. لهذا يجب أن يعرف الوكيل قائمة الحسابات قبل الإرسال: إذ تتطلب Solana تسمية كل حساب مسبقًا.

اقرأ دورة الحياة الكاملة في [نموذج التنفيذ](https://docs.rome.builders/ar/almfahym-alasasyh/execution-model.md).

## الذري أولًا

تعمل معظم الاستدعاءات داخل معاملة Solana واحدة. ويسمي Rome هذا التنفيذَ الذري (VmAt). إنه كلٌّ أو لا شيء: إذا فشلت أي خطوة، يُلغى الاستدعاء كله. التحويل، والمبادلة، ومعظم استدعاءات DeFi تناسب ذلك. وبعضها لا يناسبه: كان استدعاء اقتراض من Aave على Hadrian يحتاج إلى أكثر من معاملة Solana واحدة.

الاستدعاء الذري الواحد لديه ميزانية تقارب 1.4 مليون وحدة حوسبة. وتشكل هذه الحدود كل استدعاء:

| الحد      | ماذا يعني ذلك لك                                                                                                                 |
| --------- | -------------------------------------------------------------------------------------------------------------------------------- |
| الحوسبة   | حوالي 1.4 مليون CU مشتركة بين عمل EVM وكل برنامج تستدعيه                                                                         |
| الحسابات  | 64 عنوانًا، بما في ذلك حسابات Rome نفسها وكل ما تلمسه استدعاءات CPIs الخاصة بك                                                   |
| الحجم     | 4 كيلوبايت لكل معاملة Solana؛ أما حمولات EVM الأكبر، مثل عمليات النشر الكبيرة، فتُمرَّر عبر حساب حاضن ويتكفل SDK بذلك نيابةً عنك |
| حجم العقد | 24 كيلوبايت، كما في Ethereum                                                                                                     |

القائمة الكاملة، مع القيم، موجودة في [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md).

## تكراري عندما يكون الاستدعاء كبيرًا جدًا

إذا اكتشف المحاكي أن الاستدعاء لا يناسب، يشغّل Rome التنفيذ تكراريًا (VmIt). ويُقسَّم الاستدعاء إلى مراحل. كل مرحلة هي معاملة Solana مستقلة وتنفذ أكبر عدد من التعليمات البرمجية يسمح به رصيدها من الحوسبة. وبين المراحل تُحفَظ حالة VM في حساب حاضن وتلتقطها المرحلة التالية.

يعمل التنفيذ التكراري، لكنه يأتي بتكلفة:

* تنتهي الجلسة بعد 160 مرحلة. وبعد ذلك، تطلق أقفالها ولا تلتزم بأي شيء.
* تقوم الجلسة بقفل حسابات الرصيد والتخزين لبضع ثوانٍ، وتُجدَّد في كل مرحلة. ويُرفض أي كتابة ذرية إلى حساب مقفل مع `AccountLocked`، ثم يعيد العميل الإرسال.
* الاستدعاءات التي تُجري CPIs في Solana على المسار القديم (استدعاءات `CpiProgram` و `HelperProgram` في الدرس 5) لا يمكنها العمل تكراريًا إطلاقًا. يجب أن تناسب التنفيذ الذري.
* على مسار Solana، تستدعي المحفظة التي توقّع مراحلها بنفسها المستخدم مرة واحدة لكل مرحلة.

وتنطلق من ذلك قاعدة التصميم: شكّل كل إجراء للمستخدم بحيث يناسب معاملة ذرية واحدة. إذا كانت السلسلة أكبر من ذلك، فقسّمها إلى إجراءين للمستخدم بدل الاعتماد على النمط التكراري. سيعود الدرس 5 إلى هذا عندما تستدعي برامج Solana.

## ما الذي تدفعه

يحسب Rome تكلفة الاستدعاء بلامبورتات Solana: رسوم التوقيع، وعبور ثابت، وإيجار أي حساب ينشئه الاستدعاء. تمثل وحدة غاز واحدة لامبورتًا واحدًا من التكلفة. ويحوّل سعر الغاز ذلك إلى رمز الغاز الخاص بالسلسلة، وهو USDC على Hadrian وRubicon.

الإيجار هو الجزء الذي يفاجئ الناس. فالنقل الأول إلى عنوان لم يُستخدم من قبل ينشئ حسابات، ولذلك يكلف أكثر بكثير من النقل المتكرر. توقّع غازًا مرتفعًا عند أول لمس، وغازًا عاديًا بعد ذلك. الأرقام العملية موجودة في [كيف يلتقي Solana وEVM على Rome](https://docs.rome.builders/ar/almfahym-alasasyh/how-solana-and-evm-meet.md#gas-and-rent).

## قِس، ولا تخمّن

EVM `gasUsed` ليس بديلًا دقيقًا لحوسبة Solana. على Rome، تمثل وحدة غاز واحدة لامبورتًا واحدًا من التكلفة، لذا `eth_estimateGas` تحدد حد الغاز لديك، لكنها لا تخبرك بشيء عن وحدات الحوسبة. اقرأ الحوسبة من جانب Solana. يرتبط Via بالمعاملة من صف «تمت التسوية في»، ويعرض مستكشف Solana وحدات الحوسبة الخاصة بها. في الشيفرة، احصل على توقيعات Solana وراء تجزئة EVM باستخدام `rome_solanaTxForEvmTx`، ثم اجلب كل واحدة باستخدام `getTransaction` و `maxSupportedTransactionVersion: 1`، واقرأ `computeUnitsConsumed`. الاستدعاء التكراري له معاملة واحدة لكل مرحلة. [ميزانية الحوسبة](https://docs.rome.builders/ar/almfahym-alasasyh/compute-budget.md) لها تكاليف نموذجية لكل عملية وعادات رخيصة تقللها: ثوابت لمعرفات البرامج، واشتقاقات PDA مخبأة، وعدد أقل من الحسابات.

هناك سلوكان يختلفان عن Ethereum ويستحقان معرفتهما الآن:

* لا تمتلك Rome عداد غاز لكل تعليمة. الغاز الذي تمرره إلى `CALL` لا يُفرض، ولا توجد حصة 2300 غاز. تحصّن ضد إعادة الدخول صراحةً.
* `block.number` هو slot الخاص بـ Solana و `block.timestamp` هو ساعة Solana.

## اختبر نفسك

افتح معاملتك من الدرس 3 على مستكشف Hadrian. اعثر على رابط الشبكة في [هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md) وملاحظات المستكشف في [عبر المستكشف](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md).

لاحظ شيئين:

1. معاملة Solana التي سوّت استدعاءك، من صف «تمت التسوية في».
2. وحدات الحوسبة التي استهلكتها، على مستكشف Solana.

قارن هذا الرقم بميزانية 1.4 مليون. الاستدعاء البسيط يستخدم جزءًا صغيرًا منها.

ثم أجب:

<details>

<summary>1. لماذا يحاكي الوكيل الاستدعاء قبل إرساله؟</summary>

تحتاج Solana إلى تسمية كل حساب مسبقًا، ويجب أن يعرف الوكيل ما إذا كان الاستدعاء يناسب معاملة واحدة. تكشف المحاكاة الحسابات الملموسة، وتقدّر الغاز، وتقرر: ذري أم تكراري.

</details>

<details>

<summary>2. استدعاء يجري CPI على المسار القديم (استدعاءات `CpiProgram` و`HelperProgram` في الدرس 5) ويحتاج إلى أكثر من 1.4 مليون CU. ماذا يحدث؟</summary>

لا يمكنه العمل. تُرفض CPIs الخاصة بالمسار القديم داخل معاملة تكرارية، لذا يجب أن يناسب الاستدعاء معاملة ذرية واحدة. قسّم العمل إلى إجراءات مستخدم أصغر.

</details>

<details>

<summary>3. لماذا يكون أول تحويل إلى عنوان جديد مكلفًا؟</summary>

لأن Rome ينشئ له حسابات Solana، وتُحاسَب رسوم إيجار تلك الحسابات على المُرسِل على أنها غاز.

</details>

## التالي

[5. استدعِ سولانا من Solidity](https://docs.rome.builders/ar/akadymyh-rwma/05-call-solana-from-solidity.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/akadymyh-rwma/04-how-rome-runs-your-code.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.
