> 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/06-tokens-on-both-sides.md).

# 6. الرموز على الجانبين

كيف يظهر رمز SPL واحد كغلاف ERC-20 لمحافظ EVM وكحساب رمز لمحافظ سولانا، والمنح لمرة واحدة التي تسمح للعقود بتحريكه.

الرموز هي أساس كل حالة استخدام في [٢. ما الذي يمكنك بناؤه](https://docs.rome.builders/ar/akadymyh-rwma/02-what-you-can-build.md): سواء كان مجمّعًا أو خزنة أو سوق إقراض، فكلها تحرّك الأصل نفسه الذي تحتفظ به محافظ Solana. يتيح غلاف SPL الوصول إلى إصدار SPL عبر واجهة ERC-20. وبالنسبة إلى الرموز التي تحتفظ بها المحفظة، يقرأ الغلاف الرصيد من حساب الرموز المشتق عبر Rome في المحفظة، كي ترى Solana وSolidity الرصيد نفسه. يشرح هذا الدرس كيفية عمل ذلك، والمنح الوحيد الذي يجب على كل مستخدم تقديمه قبل أن يتمكن عقدك من تحريك رموزه.

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

* كيف يتيح غلاف SPL الوصول إلى رصيد رموز Solana في المحفظة عبر دوال ERC-20.
* وظيفة المصنع والغلاف، والغلاف الذي ينبغي استخدامه.
* كيف تختلف الرموز التي تحتفظ بها العقود عن الرموز التي تحتفظ بها المحافظ.
* منح `approve_spl` لمرة واحدة، وكيفية التحقق منه وما الذي قد يعطّله.

## قبل البدء

* أكمل [٥. استدعاء Solana من Solidity](https://docs.rome.builders/ar/akadymyh-rwma/05-call-solana-from-solidity.md). ستحتاج إلى فهم PDA ذي السلطة الخارجية وتهيئة Helper المسبقة.
* جهّز محفظة Hadrian ممولة وعقدًا منشورًا. عناوين الأغلفة القياسية موجودة في `tokens.json` للشبكة في السجل: الإدخال الذي يحتوي على `kind: "spl_wrapper"` والرمز `wUSDC`. [Hadrian](https://docs.rome.builders/ar/alshbkat/hadrian.md) يؤدي إلى مجلد سجل الشبكة.
* حساب رموز USDC الذي أنشأته باستخدام `createMyAta` في الدرس ٥. يجب أن يكون هذا الحساب موجودًا لكي يعمل المنح.

## رصيد واحد، وقراءتان

لكل عنوان EVM قيمة PDA ذات سلطة خارجية على Solana، وتمتلك هذه القيمة حسابات الرموز الخاصة بالعنوان. تقرأ دالة `balanceOf` في غلاف ERC-20 حساب رموز المحفظة مباشرةً. `totalSupply` تقرأ إصدار الرموز.

داخل Rome، يقرأ رمز SPL في المحفظة وغلافه ERC-20 حساب الرموز نفسه. فمحفظة Solana التي تحتفظ بـUSDC وعنوان EVM الذي يحتفظ بـUSDC يمتلكان الإصدار نفسه، ويتداول كلاهما مقابل حسابات المجمّع نفسها. وهكذا تبقى السيولة في مكان واحد على Rome. تجد الرسم والتفاصيل في [التوافق بين الرموز](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md#the-shared-state-model).

## تحتفظ المحافظ والعقود بالرموز بطرق مختلفة

ينطبق الرصيد المشترك على المحافظ، أما العقود فتختلف. لا يستطيع العقد تقديم المنح لمرة واحدة الموضح أدناه نيابةً عن المستخدم، لذلك تحتفظ الأغلفة العادية برموز العقد في حساب رموز ضماني، وتحتفظ بسجل لما يملكه كل عقد. أما أغلفة Token-2022 ذات الخطافات فلا تحتفظ بسجل، وتستخدم حساب الرموز الخاص بالعقد.

وينتج عن ذلك أمران:

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

تُضيف عملية التحويل إلى عقد عبر الغلاف الرصيد إلى ذلك السجل، لكنها لا تمنح العقد حساب رموز يمكنه الإنفاق منه. أما التدفقات التي تتطلب من العقد التصرّف على Solana فتستخدم المسار الموضح في [دمج برنامج Solana](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-3.-tokens-in-tokens-out).

## المصنع والغلاف

`ERC20SPLFactory` ينشر غلافًا لإصدار SPL. يتيح كل مصنع غلافًا واحدًا لكل إصدار. ويوفر الغلاف واجهة ERC-20 كاملة:

* `balanceOf` و `totalSupply` تقرآن حالة Solana.
* `transfer` و `transferFrom` تنقلان الرموز على Solana.
* `approve` و `allowance` أبقِ مخصصات ERC-20 العادية في تخزين EVM، لأن حساب الرمز المميز لا يتضمن شيئًا من هذا القبيل.

نادراً ما تحتاج إلى نشر غلاف. تتولى Rome والسجل بالفعل توفير الأغلفة المعتمدة لكل من USDC وETH وSOL. لا تنشر غلافًا إلا عند إضافة إصدار جديد من الرمز المميز. استدعاءا المصنع كلاهما في [المصنع](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md#the-factory). يتعامل المصنع أيضًا مع إصدارات Token-2022، لكن امتداداتها تغيّر طريقة التكامل: فالغلاف الذي يستخدم خطافًا يُعيد خطأً عند استدعاء `transfer` و `transferFrom`العاديين، وقد يرسل إصدارٌ يفرض رسومًا على التحويل كمية أقل مما ترسله. اقرأ [إصدارات Token-2022](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md#token-2022-mints) قبل استخدام أحدها في خزنتك.

يجب أن تلائم المبالغ `uint64`، لأن مبالغ SPL تستخدم هذا النوع، ويرفض الغلاف أي قيمة أكبر. للرمز المستخدم للغاز عدد من المنازل العشرية خاص به، بينما تستخدم أرصدة الغاز الأصلية 18 منزلة. يجب أن يكون التحويل بينهما دقيقًا. رمز الغاز على Hadrian وRubicon هو USDC.

## التفويض لمرة واحدة

ينقل الغلاف رموز المستخدم بصفته المفوَّض إليه في SPL لحساب الرموز الخاص بالمستخدم. يجب أن يعيّن حساب الرموز هذا المفوَّض إليه قبل أن يتمكن الغلاف من نقل أي شيء. ينفّذ المستخدم هذه الخطوة مرة واحدة لكل غلاف، باستدعاء واحد للحد الأقصى للمبلغ:

`approve_spl(wrapper, type(uint64).max, mint)` على واجهة Helper المسبقة التجميع.

هناك أربع تفاصيل مهمة عمليًا:

* **يرسلها المستخدم.** يوقّع التفويضَ حسابُ المستخدم نفسه، ويُرسل مباشرةً إلى واجهة Helper المسبقة التجميع. لا يمكن لعقدك إرساله نيابةً عنه. أضف خطوة «تمكين» إلى واجهة المستخدم.
* **ينطبق ذلك على الجميع.** تحتاج محافظ MetaMask والعناوين الاصطناعية لمحافظ Solana إلى هذا التفويض لكل غلاف تريد نقل رموزه.
* **تحقّق منه أولًا.** تعيد الدالة `isEnabled(user)` في الغلاف القيمة `true` بعد إتمام التفويض. تحقّق من ذلك قبل التحويل بدلًا من افتراضه.
* **امنح الحد الأقصى.** `isEnabled` تبقى `true` ما دام جزء من التفويض ذي الحد الأقصى متبقيًا. يؤدي التفويض المحدود إلى تعطّل التحويلات العادية عند انخفاض الرصيد المتاح، ولن يعرف تطبيقك أن عليه طلب التفويض مجددًا.

المُعرّف الذي يجب تمريره هو `mint_id()` على الغلاف. ستجد مثالًا عمليًا لواجهة المستخدم لكلا نوعَي المحافظ في [مرة واحدة: امنح الغلاف التفويض](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#one-time-grant-the-wrapper).

### كيف يتعطّل

لحساب الرموز مفوَّض إليه واحد. إذا منح المستخدم التفويض لجسر أو موجّه، فسيحل هذا التفويض محل تفويض الغلاف، ويتوقف الغلاف عن العمل لهذا المستخدم. يظهر الخلل في صورة خطأ SPL يُعيد `0x4`، وهو عدم تطابق المالك. والحل هو إعادة منح التفويض للغلاف. لذا تحقّق من `isEnabled` قبل تنفيذ أي تدفق يعتمد على الغلاف، لا مرة واحدة عند التسجيل.

يؤدي إصدار جديد من المصنع إلى إنشاء غلاف جديد، ويمنح كل مستخدم المحفظة التفويض للغلاف الجديد بالطريقة نفسها.

## نقل الرموز إلى الخارج

بما أن رصيد الغلاف هو بالفعل رصيد SPL، فإن نقل رمز إلى Solana يتم عبر تحويل SPL.

* إلى محفظة Solana أخرى من محفظة EVM: `transfer_spl` تُرسَل مباشرةً من المحفظة إلى الـ precompile الخاص بـ Helper، أو `RomeBridgeWithdraw.bridgeOutToSolana`، وهي تتطلب أيضًا منح صلاحية لعقد الجسر. وفي كلتا الحالتين، يجب أن يكون حساب رموز المستلِم موجودًا.
* إلى المحفظة التي وقّعت المعاملة: `transfer_spl_to_signer`. تصل إلى محفظة المستخدم نفسه فقط عبر مسار Solana الموقّع بالمحفظة. أما عبر MetaMask، فالموقّع هو الدافع الوكيل الخاص بـ Rome، لذا استخدم الخيارين الآخرين.
* وبالنسبة إلى رمز الغاز، `withdraw_to_ata` و `deposit_from_ata` يحوّلان بين الغاز الأصلي والرمز الموجود في حساب رموز.

يربط Solgate أصول Solana بسلاسل AggLayer EVM في كلا الاتجاهين، على الشبكتين الرئيسية والاختبارية. وعلى الشبكة الاختبارية، يكون تسجيل رموز SPL متاحًا للجميع. ويستخدم USDC بروتوكول CCTP. [الدرس 10](https://docs.rome.builders/ar/akadymyh-rwma/10-from-other-chains.md) يعود إلى تدفقات الإيداع الواردة والجسر. تجد قائمة الطرق في [الإيداع والسحب](https://docs.rome.builders/ar/almfahym-alasasyh/token-interop.md#deposit-and-withdraw).

## اختبر نفسك

على Hadrian، باستخدام المحفظة التي موّلتها:

1. اقرأ `isEnabled` لعنوانك على غلاف wUSDC المعتمد من السجل.
2. تأكّد من وجود حساب رموز USDC لديك. استدعاء `createMyAta` في الدرس 5 أنشأه. إن تجاوزت ذلك، فحوّل قليلًا من الغاز إلى wUSDC باستخدام `withdraw_to_ata`كما في [التطبيق نفسه عبر MetaMask](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#the-same-app-from-metamask).
3. إذا كانت قيمة `isEnabled` هي `false`، فأرسل منحة `approve_spl` إلى الـ precompile الخاص بـ Helper. استخدم الشيفرة في دليل المسارين المرتبط أعلاه.
4. اقرأ `isEnabled` مرة أخرى. من المفترض أن تصبح قيمته الآن `true`.
5. اعثر على معاملة المنحة في [عبر مستكشف الكتل](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md). ابحث عن تعليمة SPL Token `ApproveChecked` .

<details>

<summary>1. لماذا يُظهر غلافان لرمز mint واحد رصيد المحفظة نفسه؟</summary>

كلاهما يقرأ حساب الرموز الخاص بالمحفظة على Solana. الغلاف هو عرض لرمز SPL، وليس سجلًا منفصلًا. ولا يُحتسب لكل غلاف سوى الأرصدة التي تحتفظ بها العقود.

</details>

<details>

<summary>2. يودع مستخدم أصولًا في خزنتك، ثم يستخدم موجّهًا يطلب منحه صلاحية <code>approve_spl</code>. لكن استدعاءك التالي لـ <code>transferFrom</code> يفشل بخطأ SPL ‏0x4. لماذا؟</summary>

لحساب الرموز مفوّض واحد. وقد استبدلت منحة الموجّه منحة الغلاف. يجب على المستخدم منح الصلاحية للغلاف مجددًا، وينبغي لتطبيقك التحقق من `isEnabled` قبل التحويل.

</details>

<details>

<summary>3. ما غلاف مجمّع السيولة الذي تستخدمه لمجمّع سيولة جديد؟</summary>

الغلاف المعتمد الذي يحدده السجل لذلك الإصدار على تلك السلسلة. تختلف الأرصدة المحتفظ بها في العقود بين الأغلفة.

</details>

## التالي

[7. افتح تطبيق EVM الخاص بك على محافظ Solana](https://docs.rome.builders/ar/akadymyh-rwma/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
