> 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/10-from-other-chains.md).

# 10. اجلب المستخدمين والأموال من سلاسل أخرى

انقل المستخدمين وأموالهم إلى تطبيق روم الخاص بك من سلاسل أخرى ومن سولانا، باستخدام الجسر وواجهته البرمجية وCLI، وأبقِ شاشة تطبيقك حيّة.

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

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

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

## قبل البدء

* أكمل [9. إنشاء تطبيق ثنائي المسار](https://docs.rome.builders/ar/akadymyh-rwma/09-build-a-dual-lane-app.md). تحتاج إلى الخزنة، أو أي تطبيق تريد أن يصل إليه المستخدمون.
* ثبّت Rome CLI ([Rome CLI + MCP](https://docs.rome.builders/ar/almntjat/rome-cli.md)).
* وفّر USDC تجريبيًا على سلسلة مصدر، والرمز الأصلي للسلسلة المصدر لدفع الرسوم، من [الصنابير](https://docs.rome.builders/ar/almward/faucets.md).

## الدرس

### الخطوة 1. افهم طريقتَي الوصول

يأتي مستخدموك عبر Rome Bridge من أحد مصدرين. ترسل سلسلة EVM عملة USDC عبر CCTP من Circle. وترسل محفظة Solana عملة SOL أو USDC عبر تحويلات SPL عادية. في كلتا الحالتين، تتم عملية الجسر على السلسلة وتُسوّى بتوقيع المستخدم نفسه. أما Bridge API خارج السلسلة، فتقدّم أسعار المسارات، وتتحقق من معاملة المصدر، وتتكفّل برسوم التسوية. ولا تحتفظ بأموال أو مفاتيح، لذا لا يمكنها إلا بدء ما وقّعه المستخدم مسبقًا.

تختلف السلاسل والأصول المدعومة بين شبكة الاختبار والشبكة الرئيسية؛ لذا راجع القوائم بدلًا من افتراضها. ستجدها على [Rome Bridge](https://docs.rome.builders/ar/alttbyqat-ala-rome/bridge-api.md)، أما القائمة المباشرة فهي لدى الواجهة البرمجية عبر `/v1/routes`. يرد نمط وصول المستخدم إلى تطبيقك من سلسلته الأساسية في [من السلسلة الأساسية](https://docs.rome.builders/ar/adlh-almtw-ryn/from-home.md).

### الخطوة 2. اختر بين الغاز وwUSDC

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

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

### الخطوة 3. نفّذ تحويلًا واردًا

يتكوّن التحويل الوارد من أربع خطوات. ويغلّف المسار الفرعي `/bridge` في SDK استدعاءات الواجهة البرمجية على شكل `requestQuote`, `registerTransfer`, `getTransfer` و `reportStep`. ولا تزال نسخته `registerTransfer` (v0.4.0) ترسل عرض السعر كاملًا، وهو ما ترفضه الواجهة البرمجية المباشرة؛ لذا سجّل التحويل باستخدام `quoteId` بنفسك، كما يفعل Rome CLI.

1. اطلب عرضًا للمسار. أرسل سلسلة المصدر والأصل والمبلغ والمرسل والمستلم. تُمرّر السلاسل بمعرّفات CAIP-2، والمبالغ كأعداد صحيحة بوحدات الأساس ضمن سلاسل نصية.
2. يوقّع المستخدم معاملات الخطوة الأولى بالترتيب، تمامًا كما وردت. في تحويل CCTP، تكون هذه معاملة الموافقة على USDC وعملية الحرق. أما في مسار الغاز، فيوقّع المستخدم أيضًا تفويض تسوية واحدًا وفق EIP-712، بعد أن تملأ تجزئة الحرق.
3. سجّل التحويل. أرسل `quoteId` من عرض السعر وتجزئة الحرق على هيئة `step1TxHash` إلى `POST /v1/transfers` خلال 15 دقيقة من عرض السعر. في مسار الغاز، أضف توقيع التسوية باسم `userSettleSig`. تتحقق واجهة API من أن المعاملة تطابق عرض السعر المخزّن، وتُرجع معرّف التحويل.
4. استعلم عن التحويل بشكل دوري حتى تصبح قيمة `outcome` هي `complete`، وتعامل مع الحالتين `failed` و `expired`. قد يتضمن التحويل المكتمل ملاحظة `degradation` ، لذا تحقّق منها قبل إخبار المستخدم بوصول الغاز أو wUSDC.

تتبع التحويلات الواردة من Solana البنية نفسها، ولكن بخطوات مختلفة. يرسل المستخدم تحويل SPL إلى حسابه على Rome. عند اختيار الغاز كغاية للتحويل، يتطلب USDC على سلسلة يكون فيها USDC رمز الغاز معاملة إضافية من المستخدم لتحويل الرمز المغلّف إلى غاز. يسرد عرض السعر كل توقيع يتطلبه المسار. بنية الطلب والاستجابة: [من الشبكة الأصلية](https://docs.rome.builders/ar/adlh-almtw-ryn/from-home.md#bring-assets-in).

### الخطوة 4. شغّل التدفق من واجهة سطر الأوامر أولاً

قبل كتابة أي كود للجسر، شغّل التدفق باستخدام واجهة سطر الأوامر. `rome fund` يُدخل USDC كغاز، و `rome bridge` يقبل الغاز أو الرمز المغلّف كغاية للتحويل، و `rome verify --path from-home` يتحقق من دورة كاملة: التحويل عبر الجسر إلى Rome، وتنفيذ إجراء عليها، ثم التحويل عبر الجسر إلى الخارج. يمنحك ذلك مرجعاً عملياً تقارن به تكاملك. الأوامر والخيارات: [واجهة سطر أوامر Rome وMCP](https://docs.rome.builders/ar/almntjat/rome-cli.md).

### الخطوة 5. تعامل مع التحويل إلى الخارج

التحويل عبر الجسر إلى الخارج ليس مجرد عكس لتدفق التحويل الوارد. بالنسبة إلى USDC عبر CCTP، يوقّع المستخدم على خطوتين. تتألف الخطوة الأولى من معاملتين على Rome: تفويض يسمح لعقد الجسر بنقل المبلغ المحدد لعملية الحرق هذه، ثم عملية الحرق. سجّل التحويل باستخدام تجزئة عملية الحرق. الخطوة الثانية هي المطالبة. عندما تصبح حالة الخطوة الثانية للتحويل `ready`، فإنها تتضمن الرسالة والإثبات، ويستدعي المستخدم `receiveMessage` بهما على سلسلة الوجهة. لا يُتكفّل بأي جزء من المطالبة، لذا يحتاج المستخدم إلى غاز هناك. أبلغ واجهة API بتجزئة معاملة المطالبة (`reportStep` في SDK). الاستدعاءات والبنية: [إخراج الأصول مجدداً](https://docs.rome.builders/ar/adlh-almtw-ryn/from-home.md#take-assets-back-out).

لا يتضمن السحب إلى عنوان Solana خطوة مطالبة. بالنسبة إلى USDC، يتطلب الأمر معاملة واحدة على Rome للسحب إلى حساب المستخدم على Solana.

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

### الخطوة 6. حافظ على تشغيل تطبيقك

تدعم نقاط نهاية Rome استدعاء `eth_subscribe` لكل من `newHeads` و `logs`، على المضيف نفسه الخاص بـ HTTPS RPC. باستخدام ethers، `provider.on("block")` و `contract.on(event)` تعمل كما تعمل في أي مكان. مع viem، فإن `webSocket` وسيلة النقل تُسقط معرّفات الاشتراك الرقمية الخاصة بـRome، لذا مرّر `poll: true` إلى `watchBlocks` و `watchEvent`، أو استخدم ethers للحصول على تحديثات فورية. `newPendingTransactions` لا يصدر أي شيء مطلقًا، لأن Rome لا تملك مجمّع معاملات عامًا. الشيفرة: [اشتراكات WebSocket](https://docs.rome.builders/ar/adlh-almtw-ryn/websocket-subscriptions.md).

عند قراءة السجل، قيّد كل استدعاء لـ `eth_getLogs` بنطاق كتل محدد. ترفض واجهة RPC في Rome النطاقات التي يتجاوز عرضها نحو 12,000 كتلة. بالنسبة إلى معاملة تتفاعل مع Solana، يربط صف «تمت التسوية في» في Via بمعاملة Solana التي سوّت المعاملة، ويعرض مستكشف Solana تعليماتها ووحدات الحوسبة المستخدمة. بهذه الطريقة يمكنك الإجابة عن سؤال المستخدم حول وجهة التحويل. راجع [Via](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md) و [دعم JSON-RPC](https://docs.rome.builders/ar/almrja/json-rpc.md).

## Solgate: أصول Solana وسلاسل AggLayer EVM

[Solgate](https://docs.rome.builders/ar/alttbyqat-ala-rome/solgate.md) يربط أصول Solana بسلاسل AggLayer EVM في كلا الاتجاهين، على الشبكتين الرئيسة والاختبارية. يستخدم USDC بروتوكول CCTP. تستخدم الخطوات أعلاه واجهة Rome Bridge API.

لنقل رموز أخرى أو إرسال رسائل، اقرأ [13. البناء على Solgate](https://docs.rome.builders/ar/akadymyh-rwma/13-build-on-solgate.md).

## اختبر نفسك

نفّذ تحويلًا فعليًا واحدًا وتابع ما يحدث له.

1. موّل محفظة Hadrian جديدة ببعض USDC للغاز، ثم حوّل إليها مزيدًا من USDC باستخدام `rome bridge` واستدعاء الغلاف. احتفظ بكمية كافية من الغاز للموافقات واستدعاءات الخزنة والحرق عند الإرسال.
2. اقرأ رصيد wUSDC في المحفظة على Hadrian، مثلًا باستخدام `rome call` على `balanceOf` الخاص بالغلاف. مع استدعاء الغلاف، يكون الوصول عبر معاملة Solana الخاصة بالجسر (رسالة الاستلام من Circle)، وليس عبر معاملة Rome؛ لذا لا تتوقع ظهور معاملة وصول في مستكشف Hadrian.
3. كرّر التحويل عبر واجهة API: اطلب عرض السعر، ووقّع، وسجّل، ثم استطلع `GET /v1/transfers/{id}` إلى أن تصبح قيمة `outcome` هي `complete`.
4. شغّل `rome verify hadrian --path from-home` مع `--from` (سلسلة المصدر) و `--amount` (مبلغ صغير، مثل 0.2)، ثم اقرأ النتيجة. يستغرق الأمر نحو 20 دقيقة.

ثم أجب عن السؤالين:

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

<details>

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

* wUSDC. يختلف رصيد USDC الذي وصل بوصفه غازًا عن ذلك. يمكن للمستخدم الحصول على wUSDC عبر استدعاء الغلاف، أو بتغليف بعض رصيد الغاز باستخدام `withdraw_to_ata`.
* المستخدم. المطالبة عبارة عن معاملة على السلسلة الوجهة، لذا يحتاج المستخدم إلى رسوم الغاز عليها.

</details>

## التالي

[11. الإرسال إلى Rubicon](https://docs.rome.builders/ar/akadymyh-rwma/11-ship-to-rubicon.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/10-from-other-chains.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.
