> 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/08-open-your-solana-program-to-evm-users.md).

# 8. أَتِح برنامج سولانا الخاص بك لمستخدمي EVM

اسمح لمستخدمي MetaMask باستدعاء برنامج تديره بالفعل على سولانا، عبر عقد Solidity خفيف و precompile الخاص بـ CPI، من دون نقل أو نسخة ثانية من حالتك.

لديك برنامج Solana يعمل. يحتفظ مستخدموه بمحافظ Solana. تتيح Rome لجمهور ثانٍ الوصول إليه، وهم الأشخاص الذين يملكون محفظة EVM مثل MetaMask، من دون أن تعيد كتابة البرنامج بلغة Solidity.

## ما ستتعلّمه

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

## حالة الاستخدام

هذا الدرس يخدم حالة استخدام من [ما الذي يمكنك بناؤه](https://docs.rome.builders/ar/akadymyh-rwma/02-what-you-can-build.md) : تطبيق Solana موجود يريد مزيدًا من المستخدمين. سوق إقراض، أو AMM، أو خزنة، أو سوق توقعات، أو برنامج خصوصية كلها مناسبة.

جمهور EVM كبير ولديه بالفعل محافظ وأدوات وعادات. إذا نقلت برنامجك إلى Solidity، فستحافظ على قاعدتي كود وتفصل حالتك. على Rome تحتفظ ببرنامج واحد وحالة واحدة. يصل مستخدمو EVM إليه عبر عقد Solidity صغير، ويواصل مستخدمو Solana استدعاءه محليًا. ويتداول الطرفان ضد الحسابات نفسها والسيولة نفسها. [اختر النواة المناسبة](https://docs.rome.builders/ar/almfahym-alasasyh/choose-your-core.md) يسمي هذا الشكل (b)، نواة Solana أصلية مع موجّه CPI رفيع.

[rome-dex](https://github.com/rome-protocol/rome-dex) هو المرجع: تجمع Solana أصلية، مع موجّه EVM أمامها.

## قبل أن تبدأ

* أنهِ [7. افتح تطبيق EVM الخاص بك لمستخدمي محافظ سولانا](https://docs.rome.builders/ar/akadymyh-rwma/07-open-to-solana-wallets.md)، الفكرة نفسها من الجانب الآخر.
* اعرف [5. استدعِ سولانا من Solidity](https://docs.rome.builders/ar/akadymyh-rwma/05-call-solana-from-solidity.md) و [6. الرموز على الجانبين](https://docs.rome.builders/ar/akadymyh-rwma/06-tokens-on-both-sides.md). يجمعها هذا الدرس.
* يجب أن يكون برنامجك منشورًا على devnet في Solana. Hadrian يُسوّي هناك، لذا يجب أن يكون البرنامج موجودًا على تلك المجموعة. انظر [هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md).

## المسار باختصار

### الخطوة 1: ضع عقدًا رفيعًا واحدًا أمام برنامجك

العقد هو محوّل. لا يحمل منطقًا تجاريًا. يتحقق من المستدعي، ويبني تعليماتك، ويستدعي precompile الخاص بـ CPI مع `invoke_signed`. ويبقى كل شيء آخر داخل برنامجك على Solana. تفاصيل آلية الاستدعاء موجودة في [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md#calling-custom-solana-programs)، والواجهة هي `contracts/interface.sol` في المستودع العام [rome-solidity](https://github.com/rome-protocol/rome-solidity) المستودع.

يمتلك محوّلك ثلاث طرق للاحتفاظ بمركز المستخدم. يقارن الدليل بينها في [ثلاث طرق للاحتفاظ بمركز المستخدم](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-2.-three-ways-to-hold-a-users-position):

| الشكل                          | ما هو                                             | يناسب                                                  |
| ------------------------------ | ------------------------------------------------- | ------------------------------------------------------ |
| عقد المحوّل                    | يسحب رموز المستخدم، ويستدعي برنامجك بصفته هو نفسه | واجهة قابلة لإعادة الاستخدام لبرنامج يتعامل مع الودائع |
| المستخدم يستدعي الـ precompile | توقّع سلطة المستخدم نفسها، من دون عقد             | منح لمرة واحدة وبرامج بسيطة                            |
| موجّه من دون حفظ وصاية         | لا يحتفظ بالرموز أبدًا، ويستخدم تفويض المستخدم    | المبادلات وإجراءات أخرى لمرة واحدة                     |

اختر المحوّل لبرنامج خزنة أو إقراض، والموجّه لمبادلة.

### الخطوة 2: اعرف من يراه برنامجك

لكل عنوان EVM هوية على Solana، وهي PDA للسلطة الخارجية الخاصة به، مشتقة تحت برنامج Rome. عندما يستدعي عقدٌ الـ precompile، يوقّع Rome بسلطة ذلك العقد. يرى برنامجك مفتاحًا عامًا بطول 32 بايت مُعلَّمًا كموقّع. وهو لا يرى أبدًا عنوان EVM بطول 20 بايت، ولا يرى المستخدم أبدًا.

لذا فالمستخدم ليس هو الموقّع. ولتمييز المستخدمين عن بعضهم، يمرر المحوّل قيمة خاصة بكل مستخدم في بيانات التعليمات، أو يطلب من Rome أن يوقّع أيضًا باستخدام PDA فرعي مُملَّح مشتق من عنوان المستخدم. ثم يحتفظ برنامجك بمركز واحد لكل PDA فرعي. قواعد التوقيع موجودة في [لكل عنوان EVM هوية واحدة على Solana](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-1.-every-evm-address-has-one-solana-identity).

اكتب برنامجك ليتصرف وفقًا لأي سلطة توقّع. عندها سيخدم محفظة Solana ومحوّلًا على حد سواء.

### الخطوة 3: انقل رموز المستخدم

في Rome، تُعد USDC الخاصة بالمستخدم رمز SPL واحدًا يُرى من جهتين، كما أوضح الدرس 6. يوجد رصيد المستخدم في حساب رموز تملكه سلطته. وللسماح لمحوّل بإنفاقه، يمنح المستخدم المحوّل تفويض SPL قبل الإيداع. يسحب المحوّل الرموز إلى حساب رموز يملكه، ثم يستدعي برنامجك. وعند الخروج، يدفع برنامجك إلى حساب الرموز الخاص بالمستخدم، ويراه المستخدم على الفور كرصيد ERC-20.

فخّان مهمّان هنا:

* رمز ERC-20 `transferFrom` إلى عقد لا يضيف إلا إلى دفتر الضمان الخاص بالغلاف. ولا يحصل العقد على حساب رموز ينفق منه. استخدم التفويض، لا الغلاف.
* لحساب الرموز مفوَّض واحد. منحتك تُزاحِم منحة الغلاف، وتتوقف التحويلات العادية لرموز المستخدم حتى يمنحوا الغلاف مرة أخرى. تحقّق من `isEnabled` بعد هذا المسار.

التسلسل الكامل موجود في [رموز داخلة، رموز خارجة](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-3.-tokens-in-tokens-out).

### الخطوة 4: التزم بالحدود

* **مسار واحد.** استدعاء برنامج مخصص هو CPI في المسار القديم. لا يجوز للمعاملة خلطه مع استدعاءات مسار التخزين المؤقت، لذا أبقِ الغلاف المخزَّن مؤقتًا خارج تلك المعاملة.
* **ذرّي فقط.** لا يمكن لـ CPI في المسار القديم أن يعمل داخل معاملة تكرارية. يجب أن يستوعب الاستدعاء كله معاملة Solana واحدة، بنحو 1.4 مليون وحدة حساب، و64 عنوانًا و4 كيلوبايت. ويتقاسم برنامجك ميزانية الحساب هذه مع برنامج Rome.
* **الحسابات مقدمًا.** يحاكي Rome الاستدعاء ويضع كل حساب يلمسه في معاملة Solana. يجب أن يكون كل حساب قابلًا للاشتقاق من المدخلات التي يملكها المحوّل. ولا يزال الحساب الجديد مذكورًا بالاسم.
* **عمق سطحي.** يعمل برنامجك مستوى واحدًا أسفل Rome. وكل برنامج يستدعيه يستخدم مستوى آخر.
* **الإيجار على عاتق المستخدم.** الحسابات التي يُنشئها استدعاؤك تُدفع تكلفتها من غاز المستخدم.

اجعل كل إجراء حركة رمزية واحدة وCPI واحدًا إلى برنامجك. قسّم أي شيء أكبر إلى معاملتين للمستخدم. الحدود موجودة في جدول واحد في [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md).

## مثال عملي

افترض أن برنامجك خزنة. يودع مستخدم Solana عملة USDC ثم يسحبها لاحقًا. وتريد لمستخدمي MetaMask أن يفعلوا الشيء نفسه.

1. تنشر محوّلًا يعرف معرّف برنامجك وسك USDC. وفي مُنشئه ينشئ هويته الخاصة على Solana وحساب رموز له.
2. يرسل مستخدم MetaMask معاملة واحدة تمنح المحوّل تفويض SPL على USDC الخاصة به.
3. يستدعي المستخدم `إيداع`. يسحب المحوّل USDC إلى حساب الرموز الخاص به، ثم يستدعي برنامجك بسلطته الخاصة وبـ PDA فرعي مُملَّح لذلك المستخدم بوصفهما موقّعين.
4. ينقل برنامجك USDC إلى خزّنته ويسجّل المركز تحت الـ PDA الفرعي.
5. حلّت منحة المحوّل محل منحة الغلاف، لذا يقرأ تطبيقك `isEnabled` على الغلاف للمستخدم. ثم يعيد `false`، ويرسل المستخدم `approve_spl` إلى الغلاف مرة أخرى. ويتطلب الإيداع التالي منحة جديدة للمحوّل.
6. يستدعي المستخدم `withdraw`. يجعل المحوّل برنامجك يدفع من الخزنة مباشرة إلى حساب رموز المستخدم. ويظهر الرصيد في MetaMask كرمز ERC-20.

لم يلمس مستخدمو Solana المحوّل أبدًا. إنهم يستدعون الخزنة مباشرة ويرون الإجماليات نفسها. والمخطط المقابل بلغة Solidity موجود في [إيداع وسحب، بلغة Solidity](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-7.-a-deposit-and-a-withdraw-in-solidity).

اختبر على Hadrian أولًا. `eth_call` و `eth_estimateGas` شغّل نفس المحاكاة التي يستخدمها الوكيل للإرسال، لذا فإن CPI الذي يفشل هناك يفشل على السلسلة للسبب نفسه، ويحمل الارتداد خطأ برنامجك. بعد الإرسال، اقرأ جانب Solana من المعاملة باستخدام `rome_solanaTxForEvmTx`. انظر [الاختبار](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-8.-testing).

## اختبر نفسك

خذ برنامجًا صغيرًا من عندك، أو البرنامج الموجود في rome-dex، واكتب، من دون كود:

1. الموقّع الذي يراه برنامجك عندما يستدعيه محوّل.
2. الحسابات التي يسميها إيداع واحد.
3. عدد حركات الرموز وعمليات CPI في ذلك الإيداع.

ثم انشر محوّلك على Hadrian، وموّل حساب رموز المستخدم، وأرسل منحة SPL إلى المحوّل، وشغّل الإيداع عبر `eth_estimateGas` مع عنوان المستخدم كـ `من`. يجب أن ينجح التقدير. وإذا فشل، فإن بيانات الإرجاع تذكر خطأ Solana.

<details>

<summary>1. يودع مستخدم MetaMask عبر محوّلك. من يوقّع لبرنامجك؟</summary>

PDA لسلطة المحوّل الخارجية، بالإضافة إلى أي PDA فرعي مُملَّح يدرجه المحوّل. ليس المستخدم. تأتي حقوق المستخدم من تفويض SPL الذي منحه.

</details>

<details>

<summary>2. لماذا لا نسحب USDC الخاصة بالمستخدم باستخدام <code>transferFrom</code>?</summary>

ستصل الرموز إلى حساب الضمان الخاص بالغلاف وتُسجَّل في دفتره. ولن يكون لدى المحوّل حساب رموز خاص به ليمرره إلى برنامجك.

</details>

<details>

<summary>3. يكبر إيداعك حتى يصبح فيه عشرة عمليات CPI ويشغله Rome بشكل تكراري. ماذا يحدث؟</summary>

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

</details>

## التالي

[9. ابنِ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/akadymyh-rwma/09-build-a-dual-lane-app.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/08-open-your-solana-program-to-evm-users.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.
