> 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/adlh-almtw-ryn/from-home.md).

# من المنزل: الوصول إلى Rome من سلسلة أخرى

اسمح للمستخدمين على سلسلة أخرى بالوصول إلى تطبيق Rome الخاص بك دون مغادرة موطنهم — أدخل الأصول، واجرِ العمليات، ثم أخرجها مرة أخرى.

لا يحتاج مستخدموك إلى الانتقال إلى Rome. من سلسلتهم الأصلية — مثل L2 مثل Arbitrum أو Monad، أو Solana — يجلبون الأصول إلى هنا، يستخدمون تطبيق Rome الخاص بك، ثم يعيدون الأصول إلى الخارج. الجسر على السلسلة ومخوّل بتوقيع المستخدم نفسه؛ وتربط تطبيقك به عبر واجهة API واحدة.

## كيف يعمل

* **الوارد (المنزل → Rome):** على مسار USDC الخاص برمز الغاز عبر CCTP، فإن `settle_inbound_bridge_v2` تعليمات برنامج Rome تُقيّد للمستخدم، بموجب **EIP-712** `SettleAuthorization`، لذلك لا يوجد مُسوّي مميّز. مسارات الوارد الأخرى لا تستخدم تلك التعليمات أو ذلك التوقيع. يصل Wrapper USDC وETH عبر Wormhole وSOL مباشرةً كرمز wrapper في حساب المستخدم. يحتاج Solana USDC على سلسلة يكون رمز الغاز فيها USDC إلى معاملة إضافية واحدة، يوقّعها المستخدم، لتحويل الـ wrapper إلى غاز. يبيّن لك العرض التوضيحي أيّ التواقيع يحتاجها المسار.
* **الصادر (Rome → المنزل):** `RomeBridgeWithdraw` (في [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)) يحرق الأصل على Rome. ثم يطالب به المستخدم على السلسلة الأصلية بمعاملته الخاصة.
* **النقل:** Circle **CCTP** لـ USDC و **Wormhole** لجسر الرموز الخاص بـ ETH. تستخدم سلاسل Solana الأصلية تحويلات SPL العادية إلى الداخل، ثم سحبًا عبر Rome إلى الخارج. Wormhole هو مسار الدخول لـ ETH فقط. يوجد مسار Wormhole عام للخروج فقط، ويجب تفعيل كل أصل عليه أولًا من قِبل مشغّلي Rome.
* **الترتيب:** الخدمة خارج السلسلة [`rome-bridge-api`](https://github.com/rome-protocol/rome-bridge-api) تسعّر المسار، وتتحقق من معاملة سلسلة المصدر، وتتكفّل برسوم التسوية. لا تحتفظ بأي أموال ولا بأي مفاتيح. لا يمكنها إلا تشغيل ما وقّعه المستخدم مسبقًا.

## أنشئه

واجهة API عامة على devnet على `https://bridge-api.devnet.romeprotocol.xyz`. `GET /v1/routes` تُدرج كل المسارات الحية (الأصل، المسار، الاتجاه، سلسلة المصدر، سلسلة Rome، السرعات). الاستدعاءات أدناه هي نفسها الأربعة التي يغلّفها SDK في `@rome-protocol/sdk/bridge` (`requestQuote`, `registerTransfer`, `getTransfer`, `reportStep`). يشغّل لك سطر الأوامر (CLI) التدفق الكامل: `rome fund` و `rome bridge` لعمليات النقل و `rome verify --path from-home` لرحلة ذهاب وإياب، كما هو موضح في صفحة [Rome CLI](https://docs.rome.builders/ar/almntjat/rome-cli.md) .

### اجلب الأصول إلى الداخل

1. **احصل على تسعير المسار.** أرسل سلسلة المصدر الخاصة بالمستخدم، والأصل، والمبلغ، والعناوين. تُمرَّر السلاسل على هيئة معرّفات CAIP-2 مثل `eip155:84532`; `romeChainId` هو سلسلة Rome الخاصة بك. الأسماء القديمة `ethereum` و `solana` لا تزال مقبولة لكنها مهملة، وتعلّم الواجهة هذه الاستجابات بـ `Sunset` ترويسة. الأشكال الكاملة للطلب والاستجابة موجودة في مرجع [API reference](https://github.com/rome-protocol/rome-bridge-api/blob/main/docs/API.md).

   ```bash
   curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \
     -H 'Content-Type: application/json' \
     -d '{
       "asset": "USDC",
       "direction": "to-rome",
       "sourceChain": "eip155:84532",
       "romeChainId": "200010",
       "amount": "1000000",
       "sender": { "ethereum": "0xUSER" },
       "recipient": "0xUSER"
     }'
   ```

   المبالغ هي أعداد صحيحة بوحدات الأساس داخل سلاسل نصية (`"1000000"` هو 1 USDC). مبالغ ETH تكون بالوي، وعند الخروج يجب أن تكون مضاعفًا لـ 10,000,000,000 وي (لأن الـ wrapper يملك 8 منازل عشرية)؛ وترفض الواجهة أي قيمة أدق من ذلك. تسرد الاستجابة `الخطوات`. يوقّع المستخدم معاملات كل خطوة موسومة بـ `userSigns: true`، بترتيب الخطوات: معاملات EVM تكون في `unsignedTxs`، وتعليمات Solana في `unsignedTx`. وقّعها تمامًا كما وردت. الخطوات التي لا تحتاج توقيعًا ينفذها الراعي بعد أن تؤكد Circle أو Wormhole عملية النقل. مطالبة الخروج هي الاستثناء، كما هو موضح أدناه: المستخدم يبنيها.
2. **اجعل المستخدم يوقّع.** بالنسبة إلى عرض CCTP فهذا هو تفويض USDC والحرق على سلسلة المصدر. إذا كان العرض يحتوي على إدخال في `signatureRequests`، فإن المستخدم يوقّع أيضًا ذلك الـ EIP-712 `SettleAuthorization` بعد معرفة تجزئة الحرق؛ املأ تجزئة الحرق ومرّر النتيجة على أنها `userSettleSig` في الاستدعاء التالي. لا يوجد هذا إلا في مسار CCTP الخاص برمز الغاز. لا تحتوي مسارات Wormhole ETH وUSDC بنية wrapper المقصودة ومسارات Solana على ذلك.
3. **سجّل عملية النقل.** `POST /v1/transfers` مع `quoteId` و `step1TxHash`الخاص بالعرض، وهو تجزئة آخر معاملة في الخطوة الأولى (الحرق)، وذلك خلال 15 دقيقة من العرض. على مسار الغاز، أضف توقيع التسوية على أنه `userSettleSig`. ترفض الواجهة كائن عرض كاملًا. وتتحقق من أن المعاملة على سلسلة المصدر تطابق العرض المخزّن، وتعيد معرّف تحويل `id`.
4. **استعلم** `GET /v1/transfers/{id}` كل بضع ثوانٍ حتى يصبح `النتيجة` هو `complete`، وتعامل مع `فشل` و `expired`. عندها يتم تمويل المستخدم على Rome ويمكنه استخدام تطبيقك. يمكن لعملية نقل مكتملة أن تحمل `degradation` ملاحظة مع `degradationReason`، لذا تحقّق منها قبل أن تخبر المستخدم بوصول رصيد الغاز أو رصيد الـ wrapper.

تتبع سلاسل Solana الأصلية الشكل نفسه مع خطوات مختلفة. يرسل المستخدم تحويل SPL إلى حساب الرمز الخاص بحساب Rome الخاص به. يصل SOL على هيئة SOL مغلف بعد ذلك التحويل الواحد. وعلى سلسلة يكون رمز الغاز فيها USDC، مثل Hadrian، يحتاج USDC إلى خطوة ثانية: معاملة على Rome يوقّعها المستخدم وتحول الـ wrapper الذي وصل إلى غاز أصلي. أي رمز SPL آخر يمر عبر مسار `spl-solana-to-rome` الذي يأخذ الـ mint في `splAsset`.

### أعد الأصول إلى الخارج

الخروج عبر الجسر ليس تدفق الوارد نفسه بالعكس. فهو يتطلب أكثر من توقيع واحد، ويُكمل المستخدم العملية على السلسلة الأصلية. احصل على تسعيره مع `direction` مضبوطًا على `from-rome`. `sourceChain` تسمّي الطرف غير Rome بمعرّف CAIP-2، ويذهب الحرق إلى تلك السلسلة. `destinationChainId` اختياري ويجب أن يطابقه عند إرساله. الاسم القديم `ethereum` لا يزال يعني Ethereum Sepolia:

```bash
curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "asset": "USDC",
    "direction": "from-rome",
    "sourceChain": "eip155:84532",
    "destinationChainId": 84532,
    "romeChainId": "200010",
    "amount": "1000000",
    "sender": { "rome": "0xUSER" },
    "recipient": "0xUSER"
  }'
```

بالنسبة إلى USDC عبر CCTP يعيد العرض خطوتين، ويوقّع المستخدم كلتيهما:

1. **على Rome، معاملتان بالترتيب.** الأولى تمنح `RomeBridgeWithdraw` حقوق المفوِّض على wUSDC الخاص بالمستخدم على Solana (`approve_spl`). يغطي التفويض بالضبط مقدار هذا الحرق، لذلك يتضمنه العرض في كل مرة ويوقّعه المستخدم قبل كل حرق. والثانية تحرق wUSDC عبر `RomeBridgeWithdraw`، وهو ما يبدأ عملية نقل CCTP. سجّل عملية النقل بتجزئة الحرق. يستهلك الحرق wUSDC، وهو الرمز الذي يسميه العرض `burnToken`، وليس USDC الغازي الأصلي. الأموال التي دخلت كغاز ليست هي ما يُحرق، لذلك ولرحلة ذهاب وإياب ادخل USDC مع `intent: "wrapper"`.
2. **على السلسلة الوجهة، تكون المطالبة.** استعلم `GET /v1/transfers/{id}` حتى تصبح الخطوة 2 `جاهزة`. ثم تحمل `رسالة` و `شهادة التحقق`. يستدعي المستخدم `receiveMessage(message, attestation)` على ناقل رسائل Circle على السلسلة الوجهة (يسمّي العرض الناقل ومجال CCTP). لا يوجد هنا أي تمويل من الراعي، لذا يحتاج المستخدم إلى غاز على تلك السلسلة. أبلغ عن تجزئة المطالبة باستخدام `POST /v1/transfers/{id}/steps/2`.

الخروج بـ ETH من Rome عبر Wormhole غير متاح اليوم على Hadrian أو Rubicon. يَسرد Hadrian ETH عبر Wormhole باتجاه Rome فقط. ولا يَسرد Rubicon أي مسار ETH.

السحب إلى عنوان Solana لا يحتوي على خطوة مطالبة. USDC هي معاملة Rome واحدة تسحب إلى حساب Solana الخاص بالمستخدم. أما SOL فهي خطوة Rome واحدة بثلاث معاملات: منح التفويض نفسه على wSOL، وإنشاء اختياري لحساب رمز wSOL للمستلم على Solana (ويُتخطّى إذا كان موجودًا بالفعل)، ثم السحب عبر `RomeBridgeWithdraw`.

**عمليات النقل الصادرة لا تحتاج إلى خطوة تفعيل.** ينشئ حرق CCTP حساب رسالة على Solana، وهذا الحساب يحتاج إلى إيجار. يدفع حساب Solana الخاص بعقد الجسر نفسه ذلك الإيجار. وقبل استدعاء CPI مباشرةً، يستدعي العقد `swap_gas_to_lamports`: يقدّم دافع رسوم Solana في المعاملة اللّامبورتس مقدمًا، ويُحاسَب المستخدم عليها كغاز في معاملة الحرق نفسها. ويمكن لمحفظة جديدة أن تنفذ أول تحويل صادر لها دون أي إعداد سابق. `RomeBridgeWithdraw` هو الإصدار 13.0.0 على Hadrian وعلى Rubicon اليوم. تحمل عروض الخروج لا خطوة تفعيل أو تعبئة، لذلك لا يحتاج تطبيقك إلى التحقق من حساب المستخدم قبل أول عرض. كما أن التحويلات الواردة لا تحتاج إلى تفعيل أيضًا. ولا يزال `rome` CLI (0.11.0) لديه فحصه الخاص. `rome bridge --to` (من دون `--dry-run`) يقرأ اللّامبورتس في حساب السلطة الخارجية للمستخدم على Solana. إذا كان أقل من 15,000,000 تتوقف الأوامر وتخبرك بتشغيل `rome activate <chain>`، والذي يدفع 2 USDC على Hadrian عبر عقد `SimpleActivator` . `rome verify --path from-home` ينفّذ الفحص نفسه قبل أن يبدأ. العقد لا يحتاج إلى ذلك التفعيل.

## اقرأ الشيفرة

* [appia](https://github.com/rome-protocol/appia) — تطبيق من المنزل: يجلب المستخدمون USDC من سلسلتهم الأصلية ويستخدمون DeFi على جانب Rome دون مغادرتها.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — المنسق (عرض → تحقق → راعٍ).

## ما التالي

* [الحصول على تمويل](https://docs.rome.builders/ar/almward/faucets.md) — مسار الجسر نفسه يمول محفظة تطوير جديدة.
* [انشر Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md) — ضع تطبيقك على Rome.


---

# 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/adlh-almtw-ryn/from-home.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.
