> 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/almfahym-alasasyh/constraints.md).

# القيود

الحدود عند البناء على Rome EVM — حجم معاملة Solana، وميزانية \~1.4M CU، وحدود الحسابات، وتخطيط التخزين، وكيف يتجاوز Rome كل ذلك.

الحدود والقيود المهمة عند البناء على Rome EVM. يساعدك فهم هذه القيود على تصميم عقود تعمل بشكل موثوق.

## حدود معاملات سولانا

| القيد                       | القيمة                  | الأثر                                                                                       |
| --------------------------- | ----------------------- | ------------------------------------------------------------------------------------------- |
| حجم المعاملة                | 4 كيلوبايت (4,096 بايت) | يرسل Rome معاملات Solana v1؛ وتُرحَّل معاملات EVM الأكبر إلى حسابات حافظة (بشكل شفاف)       |
| وحدات الحوسبة لكل معاملة    | \~1.4 مليون وحدة حوسبة  | العمليات التي تتجاوز هذا تستخدم الوضع التكراري، وله حدود خاصة به (أدناه)                    |
| الحسابات لكل معاملة         | 64 عنوانًا              | حدّ معاملة v1؛ يُحتسب كل ما تلمسه معاملة EVM وCPIs الخاصة بها، بما في ذلك حسابات Rome نفسها |
| الحد الأقصى لحجم حساب الحفظ | 80 كيلوبايت             | الحد الأقصى لحجم RLP لمعاملة EVM واحدة                                                      |

## قيود تنفيذ EVM

| القيد                                | القيمة                                                | ملاحظات                                                                                                                                                                                                           |
| ------------------------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| خانات تخزين العقد                    | 256 لكل حساب تخزين                                    | يمكن إنشاء عدة حسابات تخزين لكل عقد                                                                                                                                                                               |
| العمليات البرمجية لكل تكرار          | متكيف                                                 | تُحزم ضمن ميزانية وحدات الحوسبة لكل معاملة Solana (VmIt)                                                                                                                                                          |
| مدة بقاء قفل الحساب                  | 3 ثوانٍ (4 ثوانٍ عندما تلمس الجلسة أكثر من 28 حسابًا) | أثناء التنفيذ التكراري؛ يُجدَّد في كل خطوة                                                                                                                                                                        |
| طول الجلسة التكرارية                 | 160 خطوة                                              | بعد تجاوز الحد، تُحرر الخطوة التالية أقفال الجلسة وتنهيها دون اعتماد أي شيء                                                                                                                                       |
| الخطوات المخططة بواسطة Rust Rome SDK | 128                                                   | السقف الأعلى للمؤلف التكراري؛ وتتم التسويات الفعلية في عدد أقل بكثير                                                                                                                                              |
| المعاملات لكل خطة موقعة من المحفظة   | 64                                                    | الحد الأقصى `rome_submitSignedV1Plan` يقبل في استدعاء واحد؛ راجع [الاستدعاءات المُرحَّلة والاستدعاءات الطويلة](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md#relayed-calls-and-long-calls) |
| محافظ الخزانة                        | 64                                                    | محافظ مجمع الرسوم                                                                                                                                                                                                 |
| حد حجم العقد                         | 24 كيلوبايت                                           | مثل Ethereum (EIP-170، 24,576 بايت)                                                                                                                                                                               |

## قيود CPI

| القيد                         | القيمة                                                                 | ملاحظات                                                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| عمق CPI                       | 4 مستويات كحد أقصى                                                     | حد عمق CPI في سولانا                                                                                                     |
| الحسابات لكل استدعاء CPI      | ضمن حد المعاملة البالغ 64 عنوانًا                                      | مشترك مع كل حساب آخر تلمسه المعاملة                                                                                      |
| عمق CPI + خطاف النقل          | يستخدم مستويات CPI                                                     | قد تتجاوز خطافات النقل من داخل CPI العمق                                                                                 |
| مسار واحد لكل عقد             | Legacy (`0xff…07/08/09`, `0x42…16`) **أو** cached (`0xff…04/05/06/0b`) | يُرفض خلط الاستدعاءات المُعدِّلة من كليهما في معاملة واحدة                                                               |
| CPI القديمة في الوضع التكراري | غير مسموح                                                              | يفشل CPI من المسار القديم في معاملة تكرارية مع `CpiProhibitedInIterativeTx`؛ أما تأثيرات المسار المخزن مؤقتًا فمسموح بها |

**عمق CPI هو القيد الأهم.** يستهلك Rome EVM مستوىً واحدًا من CPI عندما تستدعي سولانا برنامج Rome. إذا استدعى عقد Solidity لديك بعد ذلك برنامج سولانا آخر عبر CPI، فهذا هو المستوى 2. وإذا استدعى ذلك البرنامج برنامجًا آخر، فهذا هو المستوى 3. لديك 4 مستويات فقط إجمالًا.

```
المستوى 0: Solana Runtime → برنامج Rome EVM
المستوى 1: برنامج Rome EVM → هدف CPI الخاص بك (مثل Jupiter)
المستوى 2: Jupiter → برنامج آخر (مثل Raydium)
المستوى 3: Raydium → SPL Token (العمق الأقصى)
```

## قيود خطاف النقل في Token-2022

| القيد                          | الأثر                                                                       |
| ------------------------------ | --------------------------------------------------------------------------- |
| خطاف واحد لكل mint             | يحتوي mint في Token-2022 على خانة واحدة لخطاف النقل                         |
| `transfer_checked` فقط         | لا تعمل الخطافات على `transfer`. وتستخدم عمليات جسر Rome `transfer_checked` |
| السك/الحرق غير مرتبطين بالخطاف | تُتحكم عبر سلطة السك، لا عبر الخطافات                                       |

## قيود الغاز والتسعير

| القيد                  | ملاحظات                                          |
| ---------------------- | ------------------------------------------------ |
| مصدر تسعير الغاز       | مجمع Meteora DAMM، v1 أو v2 (رمز الغاز SPL)      |
| مضاعف سعر الغاز        | قابل للتهيئة لكل وكيل (`gas_price_mul`)          |
| الحد الأدنى لسعر الغاز | يُحدَّد بواسطة إعدادات الوكيل                    |
| تقدير الغاز            | يُجرى خارج السلسلة عبر محاكي Mollusk قبل الإرسال |

## قيود خاصة بالشبكة

| البيئة                    | معرّف السلسلة | معرّف برنامج rome-evm                         |
| ------------------------- | ------------- | --------------------------------------------- |
| Hadrian (شبكة الاختبار)   | 200010        | `RPTWwELXAY4KC9ZPHhaxp7Sq1hHtU3HNEgLbSegCcWf` |
| Rubicon (الشبكة الرئيسية) | 7531          | `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX` |

## قيود Precompile

| Precompile                 | القيد                                                                                                                             |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Modexp (0x05)              | **معطّل** — يفشل الاستدعاء مع `استدعاء big_mod_exp معطّل` حتى تُفعِّل سولانا `big_mod_exp` استدعاء النظام                         |
| BN254 ecPairing (0x08)     | حوالي 22 ألف وحدة حوسبة بالإضافة إلى 12.8 ألف لكل زوج وفق تسعير البرنامج؛ يمكن لفحص من أربعة أزواج أن يندرج ضمن معاملة ذرية واحدة |
| CPI precompile (0xFF...08) | يجب التصريح بالحسابات مسبقًا في معاملة سولانا                                                                                     |

## التحقق من المعاملة

| القاعدة                         | الأثر                                                                                                                                                      |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| قابلية التلاعب بالتوقيع (EIP-2) | معاملة موقعة يكون `s` قيمتها أكبر من نصف رتبة المنحنى تُرفض                                                                                                |
| بنية RLP                        | تُرفض المعاملة التي تحتوي قائمة RLP الخاصة بها على بايتات زائدة بعد آخر عنصر                                                                               |
| تعليمة غير مُنفَّذة             | يُجهض المعاملة بأكملها (`IncompatibleVersionEVM(opcode)`)؛ لا يُعتمد أي شيء ولا يمكن للعقد المستدعي ابتلاعه                                                |
| قياس الغاز                      | لا يملك Rome جدول غاز لكل تعليمة: الغاز الممرَّر إلى `CALL`/`CREATE` لا يُفرض، ولا توجد منحة 2300 غاز — لا تعتمد على حماية إعادة الدخول القائمة على المنحة |

## قيود الأوراكل

| القيد                               | القيمة                                                   |
| ----------------------------------- | -------------------------------------------------------- |
| الحد الأقصى الافتراضي لقدم البيانات | 60 ثانية                                                 |
| بيانات الجولات التاريخية            | غير مدعوم — `getRoundData(roundId)` يتراجع               |
| متوسط Switchboard الأسي             | غير مدعوم — `latestEMAData()` يتراجع على SwitchboardV3   |
| إزاحات المحلل                       | مُتحقَّق منه تجريبيًا — يجب إعادة التحقق قبل إعادة النشر |

## توصيات التصميم

1. **اجعل عمق CPI سطحيًا.** صمّم العقود لتقليل التعشيش. إذا كنت تستدعي Jupiter الذي يستدعي Raydium الذي يستدعي SPL Token، فأنت عند 3 مستويات — وهذا قريب جدًا من الحد.
2. **فضّل الوضع الذري.** صمّم العمليات لتناسب حوالي 1.4 مليون وحدة حوسبة. يضيف الوضع التكراري زمن استجابة (أقفال لمدة 3-4 ثوانٍ)، وحدًا أقصى قدره 160 تكرارًا لكل جلسة، وطلبًا من المحفظة لكل خطوة على مسار Solana عندما توقّع المحفظة الخطوات بنفسها. الاستدعاء الذي ينشئ CPIs من المسار القديم لا يمكن تشغيله تكراريًا إطلاقًا.
3. **صرّح بالحسابات مسبقًا.** يجب أن تكون جميع حسابات سولانا التي يلمسها CPI معروفة وقت إنشاء المعاملة (ويكتشفها محاكاة الوكيل). لا يمكن الاكتشاف الديناميكي للحسابات داخل استدعاء CPI، ويجب أن يندرج المجموع ضمن حد 64 عنوانًا.
4. **اختر مسار Precompile واحدًا لكل عقد.** استدعاء برنامج سولانا مخصص (`invoke_signed`) يكون من المسار القديم ومتاحًا في الوضع الذري فقط؛ راجع [دمج برنامج سولانا](https://docs.rome.builders/ar/adlh-almtw-ryn/integrate-solana-program.md).
5. **استخدم `transfer_checked`.** إذا كنت تبني أي شيء يلامس رموز Token-2022، فاستخدم دائمًا `transfer_checked` لضمان تفعيل الخطافات.
6. **اختبر استهلاك وحدات الحوسبة.** قِس وحدات حوسبة سولانا الفعلية من إيصال المعاملة (`computeUnitsConsumed`) — EVM `gasUsed` ليس بديلًا دقيقًا لوحدات حوسبة سولانا. حسّن المسارات الساخنة باستخدام Yul.

## ما التالي

* [ميزانية الحوسبة](https://docs.rome.builders/ar/almfahym-alasasyh/compute-budget.md) — تكاليف CU التفصيلية لكل عملية
* [التوافق البيني للرموز](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md) — نموذج الجسر بين ERC-20 ↔ SPL
* [مرجع Precompile](https://docs.rome.builders/ar/almrja/precompiles.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/almfahym-alasasyh/constraints.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.
