> 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/architecture.md).

# المعمارية

كيف تتكامل مكوّنات Rome معًا — تنفيذ EVM داخل برنامج Solana.

تضمّ Rome مترجمًا فوريًا لبايت كود EVM داخل برنامج على السلسلة في Solana. في مسار مفتاح EVM، يرسل المستخدمون معاملات EVM موقعة إلى Rome Proxy عبر واجهة Ethereum JSON-RPC القياسية. يقوم الوكيل بإرسالها إلى برنامج Rome EVM على Solana. قد تتطلب معاملة EVM واحدة عدة معاملات Solana لكتابة الأجزاء في حسابات الحافظات أو تشغيل التنفيذ التكراري. في مسار مفتاح Solana v1، يقوم الوكيل بتأليف المعاملة. وتوقّعها محفظة Solana وترسلها مباشرة إلى Solana RPC. لا توجد طبقة تنفيذ منفصلة يجب إبقاؤها متزامنة — حالة EVM *هو* حالة Solana.

## نظرة عامة على النظام

<figure><img src="https://1717205515-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-4d7d386c95b500079204f3dea2103d9759c5de8f%2Farchitecture.svg?alt=media" alt="EVM wallet and Solana wallet connected to Rome Proxy with its emulator. The Solana cluster holds the Rome EVM program, per-chain state, external-authority PDA, token accounts, Solana programs and holder accounts. Hercules feeds blocks, receipts and logs back to the proxy."><figcaption></figcaption></figure>

## المكوّنات

### برنامج Rome EVM (على السلسلة)

لبّ Rome — برنامج Solana BPF يحتوي على مترجم فوري كامل لبايت كود EVM (شوكة من SputnikVM). وهو:

* يستقبل معاملات EVM الموقعة وهيئات EIP-1559 غير الموقعة كتعليمات Solana. يصرّح مفتاح Solana بهيئة غير موقعة عبر توقيع دافع رسوم Solana أو عبر تعليمة مُتحقّق Ed25519
* ينفّذ بايت كود Solidity داخل بيئة تنفيذ Solana
* يربط كل عنوان Ethereum ‏(H160) بحساب PDA للرصد لكل سلسلة يحتوي على الـ nonce والرصيد الأصلي والكود. توجد حسابات تخزين PDA منفصلة مرتبطة بحساب الرصيد. كما يملك كل عنوان أيضًا عنوانًا مشتقًا برمجيًا للسلطة على استدعاءات Solana، يُسمى **PDA بسلطة خارجية**. هذا الـ PDA مشترك بين كل سلسلة على البرنامج. وهو يملك حسابات رموز SPL الخاصة بالعنوان ويوقّع عمليات الاستدعاء بين البرامج (CPIs) الخاصة به
* يعرّض precompiles للاستدعاء إلى Solana (CPI وSystem وHelper وWithdraw) إلى جانب precompiles الخاصة بـEthereum. وتضيف عائلة cached كلًا من SystemCached (`0xff…04`), SplCached (`0xff…05`), ASplCached (`0xff…06`) وWithdrawCached (`0xff…0b`). ويقوم المصنع بنشر أغلفة على هذا المسار المخبأ
* يخزّن حالة EVM (الأرصدة، nonce، الكود، التخزين) كبيانات حساب Solana
* يمكن لبرنامج Rome EVM واحد أن يستضيف العديد من معرّفات السلاسل. معرّف السلسلة جزء من عناوين PDA الخاصة بالرصيد والتخزين، وليس من PDA الخاص بالسلطة الخارجية

### Rome Proxy (خادم JSON-RPC)

Rome Proxy هو خادم Ethereum JSON-RPC قياسي. يتصل المستخدمون بـ `https://hadrian.testnet.romeprotocol.xyz/` لـ Hadrian (شبكة الاختبار) و `https://rubicon.mainnet.romeprotocol.xyz/` لـ Rubicon (الشبكة الرئيسية). وهو يترجم استدعاءات واجهة Ethereum API إلى نشاط Solana:

* `eth_sendRawTransaction` → يرسل واحدة أو أكثر من معاملات Solana v1: ذرّية `DoTx`، وأجزاء الحافظات (`TransmitTx`) بالإضافة إلى `DoTxHolder`، أو مراحل تكرارية. يوقّع دافع مجمّع ويدفع SOL. ويجمع مستلم رسوم مجمّع غاز المستخدم
* `eth_call` → تشغيل مترجم EVM محليًا في المحاكي على حسابات Solana الحية المقروءة عبر RPC. يشغّل Mollusk برامج Solana التي يتم الوصول إليها عبر CPI. كما يشغّل برنامج Rome EVM عندما يقيس الوكيل وحدات الحوسبة
* `eth_estimateGas` → المحاكاة لتقدير الغاز. وحدة الغاز هي لامبورت واحد من تكلفة Solana. ولا يكون التقدير أبدًا أقل من 21,000
* `eth_getBalance`, `eth_getCode`, `eth_getTransactionCount`, `eth_getStorageAt` → قراءة حسابات Solana الحية عبر المحاكي. `eth_getBlockByNumber`، وتأتي الإيصالات والسجلات من Hercules

كما يوفّر امتدادات Rome: `rome_emulateTx`, `rome_emulateRegRollup`, `rome_mintId`, `rome_buildInfo` و `rome_getResources`. وتتضمن طرق محفظة Solana `rome_emulateCallAccounts`, `rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1`, `rome_submitSignedV1Plan`, `rome_relayUnsignedV1`, `rome_composeExternalDepositV1` و `rome_sendUnsignedTransaction`. كما يوفّر الوكيل أيضًا `rome_solanaTxForEvmTx`.

### Hercules (المفهرس)

يراقب Hercules برنامج Rome EVM على Solana ويعيد بناء كتل متوافقة مع Ethereum في PostgreSQL. وتتضمن هذه المعاملات والإيصالات والسجلات وتغيّرات الحالة. على السلاسل العامة يعمل في وضع محاذاة مع الـ slot، لذا فإن رقم الكتلة يطابق slot في Solana ويعطي الـ slot نفسه الكتلة نفسها على أي مفهرس. ويعرض الوكيل هذه الكتل للمحافظ والمستكشفات.

يفهرس Hercules الكتل المؤكدة. ويعيد التحقق من كل كتلة عند finalization ويعيد تحميلها إذا تغيّر blockhash. الـ [عبر المستكشف](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md) يقرأ بيانات Hercules.

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

تطبّق Rome دوال ecrecover وSHA-256 وRIPEMD-160 وidentity وعمليات منحنى BN254 وblake2f بدلالات Ethereum، باستثناء بيانات الفشل من BN254 وblake2f. ويعيد استدعاء BN254 أو blake2f الفاشل بيانات Rome `Error(string)` بيانات إرجاع الفشل بدلًا من مخزن فارغ. Modexp (`0x05`) معطّل ويرجع مع `"تم تعطيل استدعاء big_mod_exp"`. يرفض blake2f أكثر من 1,000,000 جولة، وهو ما تسمح به Ethereum.

تتداخل precompiles غير الخاصة بـEVM مع Solana: **CpiProgram** (`0xFF…08`، CPI اعتباطي)، **النظام** (`0xFF…07`، اشتقاق PDA ومساعدات base58)، **HelperProgram** (`0xFF…09`، إنشاء ATA/PDA، تحويلات SPL، الغاز↔اللامبورتات)، و **السحب** (`0x42…16`). وعائلة cached هي **SystemCached** (`0xff…04`), **SplCached** (`0xff…05`), **ASplCached** (`0xff…06`) و **WithdrawCached** (`0xff…0b`). تعمل CPIs القديمة فورًا وفقط في المعاملات الذرّية. تُسجَّل CPIs المخزّنة أثناء التنفيذ وتُرسل عند الالتزام. وتُرجَع مع EVM. ويمكنها العمل في معاملات تكرارية. راجع [عناوين العقود](https://docs.rome.builders/ar/almrja/contract-addresses.md) المرجع للحصول على الجدول الكامل.

## أنماط التنفيذ

تنفّذ Rome معاملة EVM بإحدى طريقتين:

### ذرّي (VmAt)

معاملة Solana واحدة. يُنفَّذ كامل معاملة EVM ضمن ميزانية الحوسبة الخاصة بمعاملة Solana واحدة (\~1.4M وحدة حوسبة). تُستخدم لمعظم العمليات — التحويلات، استدعاءات العقود العادية، عمليات المبادلة.

### تكراري (VmIt)

للعمل الذي يتجاوز ميزانية معاملة واحدة. يُقسَّم التنفيذ عبر عدة معاملات Solana:

1. كل خطوة (معاملة Solana) تشغّل أكبر عدد من تعليمات EVM التي تتسع لها في ميزانيتها الحاسوبية — حجم الخطوة متكيّف، وليس ثابتًا
2. تُسلسَل حالة VM بصيغة Borsh إلى `StateHolder` حساب بين الخطوات
3. تُقفل الحسابات بقفل TTL لبضع ثوانٍ أثناء التنفيذ

يلجأ الوكيل إلى التنفيذ التكراري عندما لا تتسع وحدات الحوسبة أو heap أو عدد التعليمات في معاملة Solana واحدة. الجلسة محددة بحد أقصى 160 تكرارًا. ويُرفض CPI من المسار القديم في معاملة تكرارية لأنه لا يمكن تقسيمه عبر المراحل. أما CPIs من المسار cached فهي مسموحة.

## تعيين الحسابات

كل عنوان Ethereum يُربط بشكل حتمي بحساب PDA لرصيد Solana مشتق من معرّف السلسلة والعنوان ضمن برنامج Rome EVM. رصيد الغاز الأصلي هو حقل في ذلك الـ PDA، إلى جانب nonce وكود العقد. توجد خانات التخزين في PDAs تخزين منفصلة. وتوجد أرصدة SPL في حسابات رموز مملوكة لـ PDA للسلطة الخارجية المنفصلة. وهذه السلطة مشتركة عبر كل سلسلة على البرنامج نفسه.

## طريقان للدخول

* **مسار مفتاح EVM:** ترسل المحفظة معاملة EVM موقعة بـ secp256k1 إلى Rome Proxy. ويقدّم الوكيل معاملات Solana.
* **مسار مفتاح Solana:** تفوّض المحفظة هيئة EIP-1559 غير موقعة باستخدام مفتاح Solana الخاص بها. بالنسبة إلى المسار المباشر v1، يؤلف الوكيل معاملة Solana. وتوقّعها المحفظة وتقدّمها مباشرة إلى Solana RPC. يستخدم مسار الترحيل الوكيل للإرسال بدلًا من ذلك. أما المسار القديم الأقدم فيجعل المحفظة تنشئ وتوقّع وتدفع مقابل `DoTxUnsigned` معاملة Solana، ويستخرج البرنامج المرسل من موقّع Solana.

يُربط المفتاح العام في Solana بالعنوان الاصطناعي `keccak256(pubkey)[12:]`، وهي آخر 20 بايت من التجزئة. راجع [كيف يلتقي Solana وEVM على Rome](https://docs.rome.builders/ar/almfahym-alasasyh/how-solana-and-evm-meet.md).

## من يوقّع استدعاءً إلى Solana

يوقّع برنامج Rome EVM على CPI باستخدام PDA الخاص بالسلطة الخارجية للمتصل المباشر بالـ precompile. يوقّع العقد بصفته هو نفسه. ولإنفاق رموز SPL الخاصة بالمستخدم، يحتاج العقد إلى تفويض SPL من ذلك المستخدم. ويمنحه المستخدم باستخدام `HelperProgram.approve_spl(spender, amount, mint)`. ويستخدم الاستدعاء المباشر من عنوان EVM الخاص بالمستخدم أو العنوان الاصطناعي إلى الـ precompile PDA الخاص بالسلطة الخارجية للمستخدم.

## حسابات الحافظة

تُحدَّد معاملات Solana (v1) بحد 4 KB، لكن معاملات EVM (خصوصًا نشر العقود) قد تكون أكبر بكثير. تقسم Rome المعاملات الكبيرة إلى أجزاء بحجم 3,600 بايت وتكتبها بالتسلسل في **حسابات الحافظة** (حتى 80 KB). ثم يجمّع كل معاملة وينفذها على السلسلة. يتولى Rome SDK إدارة ذلك بشفافية. تُحمَّل رسوم التوقيع لكل جزء على غاز المرسل.

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

لكل سلسلة رمز غاز خاص بها: SOL أو رمز SPL. ومصدر السعر هو Hermes API، أو مجمع Meteora DAMM v1، أو مجمع Meteora DAMM v2، أو سعر ثابت. وهو يوفّر التحويل بين رمز الغاز وSOL لرسوم معاملات Solana الأساسية.

* وحدة الغاز هي لامبورت واحد من تكلفة Solana
* `eth_gasPrice` هو wei رمز الغاز لكل لامبورت
* يدفع المرسل لمتلقي الرسوم من رصيد الغاز الأصلي لديه. ويدفع دافع الوكيل SOL
* من دون متلقٍ للرسوم، كما في مسار ذرّي محفظة Solana، لا تُفرض رسوم غاز EVM. وتدفع المحفظة SOL مباشرة
* للرصيد الأصلي 18 خانة عشرية. وهو مدعوم برمز SPL الخاص بالغاز والمحتفَظ به في محفظة برنامج خاصة بكل سلسلة

## النهائية

تستخدم Rome نهائية Solana. ينتظر SDK حتى `مؤكَّد`. يعيد Hercules التحقق من كل كتلة مفهرسة عند `المثبت نهائيًا` ويعيد تحميلها إذا تغيّر blockhash.

## ما التالي

* [الشبكات](https://docs.rome.builders/ar/alshbkat/networks.md) — الاتصال بـ Hadrian (شبكة الاختبار) وRubicon (الشبكة الرئيسية)
* [البدء السريع](https://docs.rome.builders/ar/albda-1/quickstart.md) — انشر عقدك الأول
* [نموذج التنفيذ](https://docs.rome.builders/ar/almfahym-alasasyh/execution-model.md) — التنفيذ الذري مقابل التنفيذ التكراري بعمق
* [التوافق البيني للرموز](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md)
* [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md)
* [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md)
* [استدعِ EVM من Solana](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md)
* [مرجع Precompile](https://docs.rome.builders/ar/almrja/precompiles.md)
* [كيف يلتقي Solana وEVM على Rome](https://docs.rome.builders/ar/almfahym-alasasyh/how-solana-and-evm-meet.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/architecture.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.
