> 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/07-open-to-solana-wallets.md).

# 7. افتح تطبيق EVM الخاص بك لمستخدمي Solana

اجعل عقدك قابلًا للاستخدام من محفظة سولانا من دون مفتاح EVM، مع تغطية العنوان الاصطناعي، وقيمة ERC-20، والتوقيعين، والميزانية الذرية.

عقدك يعمل بالفعل مع MetaMask. الآن تتيح لمحفظة Solana استدعاءه بالمفتاح الذي تملكه بالفعل، بحيث لا ينشئ المستخدم أبدًا حساب EVM. إنه يستدعي العقد نفسه، على العنوان نفسه، وعلى الحالة نفسها.

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

* كيف تصبح محفظة Solana عنوانًا عاديًا `msg.sender` في Rome.
* لماذا يأخذ هذا الدرس القيمة كوديعة ERC-20، وما الذي `msg.value` يحتاجه من مستخدم Solana.
* ما الذي يوقّعه مستخدم Solana لكل استدعاء، وإلى أين تذهب المعاملة.
* ما الذي يتّسع له استدعاء واحد في معاملة Solana، وما الذي يحدث للاستدعاء الذي لا يتّسع.
* أي `التبعيات` التي يحتاجها SDK ومن أين تأتي كل واحدة.

## قبل أن تبدأ

* أنهِ [6. الرموز على الجانبين](https://docs.rome.builders/ar/akadymyh-rwma/06-tokens-on-both-sides.md)هذه الدرس يفترض أنك تعرف ما هو الغلاف ولماذا يمنحه المستخدم مرة واحدة.
* لديك `HelloRome` مُنشَرًا على Hadrian من [3. أول عقد لك على Hadrian](https://docs.rome.builders/ar/akadymyh-rwma/03-first-contract-on-hadrian.md).
* ثبّت TypeScript SDK، كما في [Rome SDK](https://docs.rome.builders/ar/almntjat/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* امتلك محفظة Solana توقّع معاملات Solana v1، مع قليل من SOL على devnet وUSDC على devnet. تُدرج صنابير التمويل في [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md). يختلف دعم معاملات v1 بين المحافظ، لذا اختبر محفظتك أولًا. [أنشئ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md) يسمّي المحافظ التي تم فحصها حتى الآن.

## الدرس

### الخطوة 1. تعرّف إلى العنوان الاصطناعي

لا تملك محفظة Solana عنوان EVM، لذا يستخرج Rome واحدًا من مفتاحها العام. والنتيجة هي العنوان الاصطناعي للمحفظة. وهو `msg.sender` الذي يراه عقدك، ويحمل nonce والتخزين الخاصَّين به مثل أي حساب آخر. تُحوَّل المحفظة نفسها دائمًا إلى العنوان نفسه.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // عنوان عادي مكوّن من 20 بايت
```

في مسار هذا الدرس، لا يحتفظ العنوان الاصطناعي بأي توكنات عند السكون. تبدأ في محفظة Solana الخاصة بالمستخدم. ينقلها مسار التمويل إلى حساب التوكنات الخاص بالعنوان الاصطناعي قبل الإيداع، وعندها فقط يقوم رصيد الـ wrapper `balanceOf(synthetic)` بعرضها. ينقلها مسار السحب مرة أخرى إلى المحفظة بعد السحب. اقرأ النموذج الكامل في [استدعِ EVM من Solana](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md#synthetic-addresses).

### الخطوة 2. اجعل العقد جاهزًا لـ Solana

لا تحتاج معظم العقود إلى أي تغيير. ثلاث قواعد تحدد ما إذا كان عقدك من بينها:

* استقبل القيمة كتوكّن ERC-20. اسحب باستخدام `transferFrom` بعد `approve`، وأعِدها باستخدام `transfer`.
* أشِر إلى الغلاف القياسي لكل توكن. لا تنشر غلافك الخاص.
* أبقِ كل استدعاء في مسار Solana داخل معاملة Solana واحدة.

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

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

هذا يعمل مع الاثنين، لأن كلا المسارين يمكنه تمويل `transferFrom`:

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
```

عناوين الغلاف موجودة على [عناوين العقود](https://docs.rome.builders/ar/almrja/contract-addresses.md). وفحوصات العقد الجاهز لـ Solana موجودة في [افتح عقد Solidity الخاص بك لمستخدمي Solana](https://docs.rome.builders/pages/10e24a1a9cd4d72991c7b2aea18d21a36a1a5052#id-2.-what-makes-a-contract-solana-ready).

### الخطوة 3. اعرف ما الذي توقّعه المحفظة

استدعاء SDK هو `submitRomeTxV1`. لكل استدعاء، يُنشئ الوكيل معاملة Solana v1 واحدة. توقّع المحفظة مرتين بالمفتاح نفسه. أولًا توقّع رسالة تفويض قابلة للقراءة تذكر تجزئة معاملة EVM. ثم توقّع المعاملة نفسها.

يرسل التطبيق المعاملة الموقّعة إلى Solana RPC، لا إلى وكيل Rome. تتحقق السلسلة من التفويض عبر برنامج Ed25519 وتنفذ استدعاءك باعتباره العنوان الاصطناعي. لا يملك المستخدم أبدًا مفتاح EVM.

قبل أن توقّع المحفظة المعاملة، يتحقق SDK من أنها تحمل بالضبط الاستدعاء الذي فوّضه المستخدم. أي شيء آخر يُرفض. التفاصيل في [افتح عقد Solidity الخاص بك لمستخدمي Solana](https://docs.rome.builders/pages/10e24a1a9cd4d72991c7b2aea18d21a36a1a5052#id-3.-let-a-solana-wallet-call-it).

### الخطوة 4. اربط المسار

يحتاج SDK إلى خمس قيم: عنوان URL للوكيل، ومعرّف السلسلة، ومعرّف برنامج Rome، واتصال Solana RPC، وموقّع. أربع منها تصف السلسلة. واحدة تأتي من المحفظة.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: عقدك من الدرس 3; data: استدعاء greet() المرمّز وفق ABI
```

بالنسبة إلى Hadrian، اقرأ قيم السلسلة الأربع من السجل. التعيين موجود في `التبعيات` جدول الدليل المرتبط في الخطوة 3، والقيم موجودة على [هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md). يغطي الدرس 11 التوصيل نفسه لـ Rubicon.

تأتي خطوتان لمرة واحدة قبل أول استدعاء ينقل قيمة لمستخدم جديد. زوّد العنوان الاصطناعي باستخدام `buildCreatePdaCall`، وامنح التفويض للغلاف إذا كانت `isEnabled` تساوي false. `submitRomeTxV1` لا يقوم بالتهيئة نيابةً عنك. ينفذ الدرس 9 كلاهما بالترتيب.

### الخطوة 5. ابقَ داخل معاملة واحدة

يجب أن يتسع استدعاء مسار Solana ضمن معاملة Solana واحدة: حوالي 1.4 مليون وحدة حساب، و64 حسابًا، و4 كيلوبايت. قِس باستخدام `computeUnitsConsumed` من إيصال Solana، وليس من EVM `gasUsed`. اطلب المعاملة باستخدام `maxSupportedTransactionVersion: 1`؛ من دونه يرفض RPC الطلب.

عندما لا يتسع الاستدعاء، يرفضه المُركِّب ويسلّمه SDK إلى الوكيل لتمريره بالتوقيع التفويضي نفسه. لا يزال المستخدم يرى مطالبة واحدة. وتحمل النتيجة `route: "relay"`. يستهلك الاستدعاء المُرحَّل الغاز الأصلي للعنوان الاصطناعي، لذا اشحنه أولًا باستخدام `fundSyntheticGas`. الاستدعاء المُرحَّل الذي يرتدّ لا يرمي خطأً. تحقّق من `receipt.status`. القواعد موجودة في [الاستدعاءات المُرحَّلة والاستدعاءات الطويلة](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md#relayed-calls-and-long-calls). الحدود في جدول واحد: [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md).

## اختبر نفسك

أجب عن هذه الأسئلة ثم افتح الإجابات.

1. لماذا يفشل إيداع `قابل للدفع` لدى مستخدم Solana؟
2. كم عدد التوقيعات التي تنتجها المحفظة لكل استدعاء، وما الذي يغطيه كل توقيع؟
3. إلى أين تذهب المعاملة الموقّعة؟
4. قد يحتاج الاستدعاء إلى أكثر من معاملة واحدة. ماذا يرى المستخدم، ومن يدفع؟

<details>

<summary>الإجابات</summary>

1. أموال المستخدم هي توكن SPL في محفظته، ويُعرض على Rome باعتباره الغلاف. لا يحتفظ العنوان الاصطناعي بأي رصيد أصلي في نموذج الإيداع والسحب إلا إذا موّلته، لذا لا يوجد `msg.value` ما يُرسَل.
2. اثنان. الأول يغطي رسالة تفويض قابلة للقراءة تتضمن تجزئة معاملة EVM. والثاني يغطي معاملة Solana.
3. إلى Solana RPC، ويُرسلها التطبيق. يُنشئ الوكيل المعاملة ولا يستقبلها، إلا في حالة الاستدعاء المُرحَّل.
4. مطالبة تفويض واحدة. يمرر الوكيل الاستدعاء، ويُدفع ثمنه من رصيد الغاز الأصلي للعنوان الاصطناعي.

</details>

## التالي

[8. افتح برنامج سولانا الخاص بك لمستخدمي EVM](https://docs.rome.builders/ar/akadymyh-rwma/08-open-your-solana-program-to-evm-users.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/07-open-to-solana-wallets.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.
