> 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/09-build-a-dual-lane-app.md).

# 9. ابنِ تطبيقًا ثنائي المسار

ابنِ عقد خزانة واحدًا يودع فيه مستخدم MetaMask ومستخدم محفظة سولانا ويسحبان منه، وشاهد الرصيد نفسه من كلا الجانبين.

هذا هو درس البناء ([2. ما الذي يمكنك بناؤه](https://docs.rome.builders/ar/akadymyh-rwma/02-what-you-can-build.md) يسرد حالة الاستخدام). تكتب خزنة USDC صغيرة واحدة، وتنشرها مرة واحدة، وتستخدمها من محفظتين: MetaMask ومحفظة Solana. في النهاية يكون لدى كلا المستخدمين رصيد في الحالة نفسها للعقد.

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

* شكل عقد ثنائي المسار: خزنة ERC-20 بسيطة.
* الخطوات المرتبة التي يسلكها كل مسار للإيداع والسحب.
* لماذا يحتوي مسار Solana على خطوة تمويل وخطوة سحب نهائي، بينما لا يحتوي مسار EVM على ذلك.
* كيف تختار بين نواة Solidity ونواة برنامج Solana.
* كيف تقيس تكلفة كل خطوة.

## قبل أن تبدأ

* أنهِ [8. افتح برنامج سولانا الخاص بك لمستخدمي EVM](https://docs.rome.builders/ar/akadymyh-rwma/08-open-your-solana-program-to-evm-users.md). يغطي الدرس 7 مسار Solana الذي يستخدمه هذا البناء، لذا اقرأ [7. افتح تطبيق EVM الخاص بك لمستخدمي محافظ سولانا](https://docs.rome.builders/ar/akadymyh-rwma/07-open-to-solana-wallets.md) أولًا إذا كنت قد تخطَّيته.
* تأكد من توفر MetaMask على Hadrian ومحفظة Solana على شبكة Solana devnet توقّع معاملات v1، وكلاهما ممول كما في الدرس 3 و [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md).
* تأكد من تثبيت TypeScript SDK ([Rome SDK](https://docs.rome.builders/ar/almntjat/rome-sdk.md#typescript-sdk-rome-protocol-sdk)) و Foundry أو Hardhat ([نشر عقود Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md)).

## الدرس

### الخطوة 1. اختر النواة

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

هذه الدورة تبني الشكل الأول. إنه المسار الأقصر ويستخدم أدوات EVM القياسية. إذا كان لديك برنامج Solana بدلًا من ذلك، فالدرس 8 و [دمج برنامج سولانا](https://docs.rome.builders/ar/adlh-almtw-ryn/integrate-solana-program.md) يغطّيان من يوقّع، وكيف تتحرك الرموز، وقاعدة المسار الواحد. وتنتقل النقطة الأساسية إلى هذا الدرس: لا يستطيع العقد تحريك رموز المستخدم بنفسه، لذلك يمنح المستخدم حقًا أولًا.

### الخطوة 2. اكتب الخزنة

تسحب الخزنة رمزًا باستخدام `transferFrom` وتعيده باستخدام `transfer`. لا يوجد فيها شيء خاص بـ Rome.

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

يأخذ المُنشئ عنوان غلاف wUSDC. انشره على Hadrian كما فعلت في الدرس 3، ثم تحقّق من المصدر ([التحقق من العقود](https://docs.rome.builders/ar/adlh-almtw-ryn/verify-contracts.md)). العقد الكامل موجود في [أنشئ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md).

### الخطوة 3. شغّل مسار EVM

يمتلك مستخدم MetaMask USDC كغاز أصلي، بينما تأخذ الخزنة wUSDC. لذلك يحتوي المسار على أربع خطوات، وكل خطوة معاملة عادية:

1. قم بتغليف بعض الغاز إلى wUSDC باستخدام `withdraw_to_ata` على الـ precompile الخاص بـ Withdraw.
2. امنح الغلاف الإذن مرة واحدة، إذا `isEnabled(user)` تساوي false.
3. `approve` الخزنة على wUSDC.
4. `إيداع` إلى الخزنة.

لا توجد خطوات تمويل أو سحب نهائي. الرموز المغلفة موجودة بالفعل في عنوان EVM الخاص بالمستخدم. الكود موجود في [التطبيق نفسه من MetaMask](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#the-same-app-from-metamask). عناوين الـ precompile موجودة على [الاستدعاءات المسبقة](https://docs.rome.builders/ar/almrja/precompiles.md).

### الخطوة 4. شغّل مسار Solana

يمتلك مستخدم Solana ‏SOL وSPL USDC. كل خطوة هي معاملة v1 موقعة من تلك المحفظة:

1. هيّئ الحساب/العنوان الاصطناعي باستخدام `create_pda`، مرة واحدة.
2. خطوة التمويل: انقل USDC من حساب الرموز الخاص بالمحفظة إلى حساب الرموز الخاص بالعنوان الاصطناعي.
3. امنح الغلاف الإذن، إذا `isEnabled` تساوي false.
4. `approve` الخزنة.
5. `إيداع`.

يتم السحب بالعكس. `withdraw` يعيد الرموز إلى الحساب الاصطناعي، وتقوم خطوة السحب النهائي بنقلها إلى محفظة المستخدم نفسها. بعد سحب كامل وتجميع، يعود رصيد الرموز المودعة في الحساب الاصطناعي إلى الصفر. هذه معاملات منفصلة، لذلك إذا فشل إيداع أو فشل سحب نهائي، فاقرأ رصيد الرموز في الحساب الاصطناعي ودع المستخدم يعيد المحاولة أو يسحب الباقي مرة أخرى. الكود التفصيلي موجود في [القيمة الداخلة](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#value-in-deposit-step-by-step) و [القيمة الخارجة](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#value-out-withdraw-step-by-step).

أبقِ فحص الإذن في مسار أول إيداع في تطبيقك لكلا المسارين. لحساب الرموز مفوّض واحد فقط، لذا فإن منحًا لاحقًا لبرنامج آخر، مثل جسر أو موجّه، يستبدل إذن الغلاف. تحقّق من `isEnabled` قبل كل إيداع بدلًا من افتراض أن الإذن السابق ما يزال موجودًا ([منح لمرة واحدة لكل محفظة](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md#one-time-grant-per-wallet)).

### الخطوة 5. قِس كل خطوة

اقرأ `computeUnitsConsumed` من إيصال Solana لكل خطوة في مسار Solana، كما في الدرس 7. يسرد الدليل وحدات الحوسبة والبايتات والحسابات التي استخدمتها كل خطوة على Hadrian. تقع كل خطوة في ذلك الجدول بأقل بكثير من الميزانية الذرّية. استخدم هذه الأرقام كخط أساس، ثم قارن أرقامك أنت.

إذا وصلت خطوة إلى ما يقارب 1.4M من وحدات الحوسبة أو 64 حسابًا، فمرّرها عبر المرحّل أو بسّطها. راجع [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md) و [ميزانية الحوسبة](https://docs.rome.builders/ar/almfahym-alasasyh/compute-budget.md).

## اختبر نفسك

افعل ذلك على Hadrian واحتفظ بالروابط.

1. إيداع من MetaMask. إيداع من محفظة Solana.
2. اقرأ `balanceOf` في الخزنة لكلا العنوانين. يعرض كل واحد إيداعه الخاص. بالنسبة لمستخدم Solana، اقرأ عند العنوان الاصطناعي.
3. افتح كل معاملة في مستكشف Hadrian ([هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md) يحتوي على الرابط؛ [Via](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md) ويشرح ما الذي يعرضه).
4. اسحب من كليهما. يعود USDC الخاص بمستخدم Solana إلى محفظته الخاصة.

إذا تراجع إيداع في مسار Solana مع خطأ SPL `0x4`، فالإذن الخاص بالغلاف مفقود.

ثم أجب:

* أي جانب من التطبيق يحتاج إلى خطوة تمويل، ولماذا؟
* ما الذي يحتفظ به الحساب الاصطناعي لمستخدم Solana بعد رحلة ذهاب وعودة كاملة؟

<details>

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

* مسار Solana. يبدأ USDC الخاص بالمستخدم في حساب الرموز الخاص بمحفظته. تنقله خطوة التمويل إلى حساب الرموز الخاص بالحساب الاصطناعي، لذلك يظهر رصيد الغلاف. أما رموز مستخدم MetaMask فهي موجودة بالفعل في عنوان EVM الخاص به.
* لا توجد رموز مودعة. تعيد خطوة السحب النهائي الرموز إلى محفظة المستخدم.

</details>

## التالي

[10. اجلب المستخدمين والأموال من سلاسل أخرى](https://docs.rome.builders/ar/akadymyh-rwma/10-from-other-chains.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/09-build-a-dual-lane-app.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.
