> 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/adlh-almtw-ryn/call-evm-from-solana.md).

# استدعاء EVM من Solana

اسمح لمحفظة Solana بتشغيل عقود EVM على Rome — من دون مفتاح Ethereum. المحفظة توقّع، وتنتقل معاملتها إلى Solana.

عكس [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md): تستدعي محفظة سولانا (مثل Solflare) أي عقد EVM على Rome مباشرةً، مع **من دون مفتاح إيثريوم**. هكذا [Aerarium](https://docs.rome.builders/ar/alttbyqat-ala-rome/apps.md) يتيح لمستخدمي سولانا الأصليين مشاركة العقود نفسها مع مستخدمي EVM.

الطريقة ذات الاستدعاء الواحد هي ما يتيحه الـ SDK: `submitRomeTxV1`، حيث يقوم الوكيل بتركيب معاملة Solana v1 واحدة للاستدعاء؛ تشرح هذه الصفحة الآلية.

## العناوين الاصطناعية

هوية EVM لمحفظة سولانا هي **العنوان الاصطناعي** — آخر 20 بايت من `keccak256` لمفتاحها العام في سولانا المكوّن من 32 بايت:

```
synthetic_evm_address = keccak256(solana_pubkey)[12:]
```

هذا هو `msg.sender` عندما تستدعي المحفظة عقدًا، وهو الهوية الثابتة التي يوجد تحتها nonce والتخزين. إن الاشتقاق مثبت في البروتوكول، لذا تُربط المحفظة دائمًا بالعنوان نفسه.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // 0x… 20 بايت
```

## العنوان الاصطناعي مجرد ممرّ — لا يحتفظ بأي رموز عند السكون

الرصيد القابل للإنفاق لمستخدم سولانا الأصلي يوجد في **Solana** (بوصفها رموز SPL)، وتظهر بنسبة 1:1 على جانب EVM على أنها **غلاف ERC20SPL** (مثل `wUSDC`). لا يحتفظ العنوان الاصطناعي بأي شيء عند السكون، لذا تتدفق القيمة *عبر* من خلاله — وكل خطوة موقعة من محفظة سولانا:

1. **التجهيز (مرة واحدة).** لا يوجد PDA للمصادقة الخارجية لعنوان اصطناعي جديد تمامًا حتى `create_pda` يتم تشغيله — وتُوقَّع التحويلات أدناه بواسطة ذلك الـ PDA. `submitRomeTxSolanaLane` يجهزه تلقائيًا عند أول استخدام (أو استدعِ `provisionSynthetic` لخطوة "تنشيط" صريحة؛ تحقّق باستخدام `isSyntheticProvisioned`). مع `submitRomeTxV1`، تحقّق من `isSyntheticProvisioned` وأرسِل `buildCreatePdaCall` من خلاله مرة واحدة.
2. **خطوة التمويل (المحفظة → العنوان الاصطناعي).** انقل الرمز من ATA الخاص بالمحفظة إلى الخاص بالعناوين الاصطناعي — `ActivateAta` الخطوة، التي ينشئها `buildFundLeg`. الآن `wrapper.balanceOf(synthetic)` يقرأ ذلك الرصيد، لذا ينفقه العنوان الاصطناعي كرمز ERC-20 عادي (`transfer` / `transferFrom`) — **ليس** كرصيد أصلي `msg.value`، وهو لا يحتفظ به.
3. **الاستدعاء(ات) (`DoTxUnsigned`).** يشغّل العنوان الاصطناعي معاملات EVM — مثلًا `approve` ثم خزنة `إيداع` الذي يسحب عبر `transferFrom`.
4. **خطوة السحب (العنوان الاصطناعي → المحفظة).** بعد أن تُسقِط عملية سحب / اقتراض / مطالبة الرموز في العنوان الاصطناعي، `buildSweepLeg` يعيد دفعها إلى ATA الخاص بمحفظة المستخدم نفسه (`HelperProgram.transfer_spl`)، بحيث تنتهي محصلة العنوان الاصطناعي إلى الصفر.

يصف القسم التالي ما الذي يفعله الإصدار الأقدم `submitRomeTxSolanaLane` يُبنى على جهة العميل. `submitRomeTxV1` يجعل الوكيل يركّب معاملة v1 بدلًا من ذلك، من دون اكتشاف الحسابات أو ComputeBudget أو محفظة treasury في شيفرتك؛ انظر [نقاط نهاية external-V1](#the-external-v1-endpoints) أدناه.

## كيف يُبنى الاستدعاء

`submitRomeTxSolanaLane` يتولى كل ذلك. الآلية:

1. **ابنِ معاملة EIP-1559 غير موقعة** مع `من` = العنوان الاصطناعي — من دون توقيع secp256k1.
2. **اكتشف الحسابات** — استدعِ [`rome_emulateCallAccounts`](https://docs.rome.builders/ar/almrja/json-rpc.md) بـ `من`, `إلى`, `بيانات`, **و `القيمة`** (عندما يكون الاستدعاء قابلًا للدفع). تمرير `القيمة` مهم: يحاكي الوكيل *الحقيقي* الاستدعاء، لذا يُخصَّص أي كتابة تخزين تعتمد على القيمة — مثل خانة mapping جديدة — ويُعاد حسابها في سولانا. إذا أغفلته سيغيب ذلك الحساب، وتفشل المعاملة مع *"عدّل التعليمة بيانات حساب للقراءة فقط."*
3. **جمّع معاملة سولانا:** اثنتان **ComputeBudget** تعليمتا (تحتاج EVM الخاصة بـ Rome إلى حد CU أعلى ≈1.35 مليون وإطار heap كبير ≈250 كيلوبايت — القيم الافتراضية في سولانا تفشل) + **`DoTxUnsigned`** التعليمة (RLP غير الموقّع + الحسابات المكتشفة) + **محفظة الخزانة** (يدفع التنفيذ لها رسومًا صغيرة؛ والاكتشاف لا يضمّها، لذا يضيفها الـ SDK).
4. **توقّع المحفظة وتُرسِل.** الأسماء **توقّع محفظة سولانا معاملة سولانا (Ed25519) وتُرسلها إلى Solana RPC — وليس إلى الوكيل.** يتحقق وقت تشغيل سولانا من التوقيع؛ وعلى السلسلة، يشتق البرنامج `msg.sender` من ذلك الموقّع. السلطة هي توقيع سولانا، لا توقيع إيثريوم. (يُستخدم الوكيل فقط للمحاكاة/اكتشاف في الخطوة 2.)

PDA الخاص بالمستخدم (`["EXTERNAL_AUTHORITY", synthetic_address]`) يملك حسابات الرموز الخاصة به ويوقّع استدعاءات SPL البينية نيابةً عنه — لذا يمكن لمستخدم سولانا الإيداع والاقتراض والمبادلة وتوفير السيولة بالكامل من محفظة سولانا الخاصة به.

## نقاط نهاية external-V1

`submitRomeTxV1` هي الطريقة ذات الاستدعاء الواحد: تطلب من الوكيل معاملة v1 مركّبة، وتتحقق منها، وتطلب من المحفظة توقيعها وإرسالها إلى Solana RPC، مع الترحيل عبر الوكيل عندما لا يتسع الاستدعاء. يوفّر الوكيل المسار نفسه كطرق RPC، لذا يمكن لأي عميل استخدامه من دون الـ SDK (القائمة الكاملة في [دعم JSON-RPC](https://docs.rome.builders/ar/almrja/json-rpc.md)):

* `rome_composeUnsignedAtomicV1(rlp, pubkey, signature)` — معاملة Solana v1 واحدة؛ توقّعها المحفظة ويبثّها التطبيق إلى Solana RPC. تُرفض عندما لا يتسع الاستدعاء لمعاملة ذرّية واحدة.
* `rome_composeUnsignedIterativeV1(rlp, pubkey, signature)` — كل خطوة من التنفيذ (ذرّية إذا اتسعت، وإلا فالخطوات التكرارية)؛ توقّع المحفظة كل واحدة، `rome_submitSignedV1Plan` وتبثّها. الحدود على الخطة الطويلة موجودة في [الاستدعاءات المُرحَّلة والاستدعاءات الطويلة](#relayed-calls-and-long-calls).
* `rome_relayUnsignedV1(rlp, pubkey, signature)` — توقيع واحد من المحفظة، ويدير الدافع التابع للوكيل الخطوات ويعيد تجزئة معاملة EVM؛ يدفع العنوان الاصطناعي غاز Rome، لذا موّله مرة واحدة باستخدام `rome_composeExternalDepositV1`.

**توقيع التفويض.** `rlp` هو نص EIP-1559 غير الموقّع الخام المكوّن من 9 حقول. توقّع المحفظة، بمفتاح Ed25519 الخاص بها، إما الـ 32 بايت الخام من `keccak256(0x02 ‖ rlp)` أو الرسالة المقروءة

```
Rome authorization\n0x<64 lowercase hex chars of that hash>
```

كلاهما مقبول؛ والصيغة المقروءة هي ما تعرضه المحفظة بشكل واضح في `signMessage` نافذة المطالبة. يعيد البرنامج احتساب التجزئة من النص الذي ينفذه، ويشترط أن تكون الرسالة الموقعة مطابقة تمامًا لإحدى الصيغتين، لذا لا يمكن لتوقيع على نص أن يصرّح بنص آخر، كما يمنع nonce الخاص بالنص إعادة الإرسال.

## الاستدعاءات المُرحَّلة والاستدعاءات الطويلة

بعض الاستدعاءات لا تتسع لمعاملة سولانا واحدة. يغطّي هذا القسم ما يحدث حينها، وما الحدود المطبّقة.

### عندما يرفض المركّب الذرّي

`rome_composeUnsignedAtomicV1` يرفض استدعاءً لا يتسع لمعاملة ذرّية واحدة. `submitRomeTxV1` ثم يرحّل الاستدعاء عبر الوكيل باستخدام **نفس** توقيع التفويض، فلا يُطلب من المحفظة مرة أخرى. والنتيجة تحتوي على `route: "relay"` ومن دون أي `توقيع سولانا`. مرّر `relayOnRefusal: false` للحصول على الرفض كخطأ بدلًا من ذلك، أو استدعِ `relayV1` بنفسك للترحيل عمدًا.

ثلاثة أشياء يجب معرفتها عن الاستدعاء المُرحَّل:

* **العنوان الاصطناعي يدفع الغاز.** في مسار الترحيل يرسل الوكيل معاملات سولانا ويدفع تكلفتها، ويُدفع ثمن الاستدعاء برمز الغاز الأصلي للسلسلة من رصيد العنوان الاصطناعي. يجب أن يكون الرصيد على الأقل `gasLimit × maxFeePerGas`. `fundSyntheticGas(deps, amountWei)` يُكمل الرصيد من حساب الرمز الخاص بالمحفظة نفسه لرمز غاز السلسلة (USDC على Hadrian وRubicon)؛ وتوقّع المحفظة معاملة v1 عادية واحدة، وتحتاج إلى بعض SOL لدفع رسوم سولانا. `amountWei` هو بوحدة wei ذات 18 منزلة عشرية الخاصة بالسلسلة، ويجب أن يكون مضاعفًا لـ 10^12، وإلا يرفضه الوكيل. من دون الـ SDK، `rome_composeExternalDepositV1` يبني المعاملة نفسها.
* **الـ revert لا يرمي استثناءً.** الاستدعاء المُرحَّل الذي يَرجع revert على جانب EVM يُحَلّ بشكل طبيعي، مع `receipt.status === "0x0"`. تحقّق من `receipt?.status === "0x1"` قبل اعتبار الاستدعاء منتهيًا. `receipt` هو `null` إذا لم تظهر الإيصال في الوقت المناسب.
* **`relayOnRefusal: false` هو خيار يُتخذ في الـ SDK، وليس قيدًا.** يمتلك الوكيل بالفعل توقيع التفويض لذلك الحمولة ويمكنه تشغيلها بأي مسار، حتى `gasLimit × maxFeePerGas`.

```javascript
const res = await submitRomeTxV1(deps, { to, data, value });
if (res.route === "relay" && res.receipt?.status !== "0x1") {
  // استدعاء مُرحَّل أعاد revert يُحلّ؛ ولا يرمي استثناءً
}
```

### الاستدعاءات الطويلة

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

* **رحّله.** `rome_relayUnsignedV1` يأخذ توقيعًا واحدًا من المحفظة ويدفع دافع الوكيل كل خطوة. يدفع العنوان الاصطناعي الغاز، كما سبق.
* **وقّع الخطوات بنفسك.** `rome_composeUnsignedIterativeV1` يعيد كل خطوة مع خانة توقيع فارغة، وتوقّع المحفظة كل واحدة، و `rome_submitSignedV1Plan` تبثها بالترتيب. كل خطوة هي معاملة سولانا منفصلة لتوقّعها المحفظة، لذا فإن المحفظة التي توقّع معاملة واحدة في كل مرة ستطلب التأكيد مرة لكل خطوة، إضافة إلى توقيع التفويض. وتدفع المحفظة رسوم سولانا على كل خطوة.

الحدود:

| الحد                                           | القيمة                 | مصدره                                                                                                    |
| ---------------------------------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| المعاملات في `rome_submitSignedV1Plan` استدعاء | 64                     | يرفض الوكيل خطة أطول                                                                                     |
| الخطوات التي سيخططها المركّب التكراري          | 128                    | الحد في المركّب التكراري لـ Rust Rome SDK، والذي يحدّ أيضًا الخطة `rome_composeUnsignedIterativeV1` يعيد |
| التكرارات في جلسة واحدة                        | 160                    | برنامج Rome EVM؛ بعده تتوقف الجلسة عن الاستئناف، وتحرّر أقفال حساباتها وتنتهي                            |
| حجم معاملة سولانا والحسابات                    | 4 كيلوبايت، 64 عنوانًا | كل خطوة هي معاملة Solana v1                                                                              |

تُنجز معظم الاستدعاءات الفعلية في خطوات أقل بكثير من هذه الحدود. حد الـ 64 معاملة في الخطة الموقعة من المحفظة هو الحد الذي ستصادفه أولًا. الاستدعاء الذي يحتاج إلى خطوات أكثر من ذلك لا يمكن بثه عبر `rome_submitSignedV1Plan`.

الاستدعاء الطويل لا يمكنه إجراء استدعاءات CPI على المسار القديم. الاستدعاءات المُعدِّلة على الـ precompiles القديمة (`0xff…08`, `0xff…09` و `0x42…16`) تُرفض في جلسة تكرارية مع `CpiProhibitedInIterativeTx`. قراءات حالة سولانا وprecompiles المسار المخبأ (`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`) تعمل. الاستدعاء الذي يجري CPIs على المسار القديم يجب أن يتسع لمعاملة ذرّية واحدة، أيًا كان المسار الذي يرسله. انظر [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md) و [ميزانية الحوسبة](https://docs.rome.builders/ar/almfahym-alasasyh/compute-budget.md).

## التطبيقات المرجعية

* **Aerarium** — يشغّل Compound v3 (إيداع / اقتراض) من محفظة سولانا عبر `DoTxUnsigned`. وهو المرجع لمسار المعاملات القديمة الموصوف أعلاه، وليس لـ `submitRomeTxV1`.
* **Rome DEX** ليس مثالًا لهذه الصفحة: جانبه في سولانا هو برنامج سولانا أصلي توقّع له المحفظة مباشرةً، وجانبه في EVM يشارك المجمع نفسه.

لا يحتاج Aerarium إلى محفظة ثانية — فالعنوان الاصطناعي يجعل مفتاح سولانا واحدًا حساب EVM من الدرجة الأولى. بالنسبة لنمط v1، اتبع [أنشئ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md).

## ما التالي

* [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md) — الاتجاه الآخر، عبر CPI
* [التوافق البيني للرموز](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md) — كيف تُشارك الأرصدة عبر EVM وسولانا


---

# 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/adlh-almtw-ryn/call-evm-from-solana.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.
