> 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/alttbyqat-ala-rome/bridge-api.md).

# جسر Rome

Rome Bridge — جسر مستقل وواجهة API قابلة للدمج، من دون مفاتيح وصاية.

جسر Rome هو شيئان:  **جسر مستقل** بين Rome وسبع سلاسل EVM بالإضافة إلى Solana، و **واجهة برمجة تطبيقات الجسر** أي تطبيق يدمجه ليوفر الجسر داخل تجربة المستخدم الخاصة به. ينقل الأصول عبر CCTP v2 (USDC)، ومسارات Solana الأصلية (SOL وUSDC)، وعلى شبكة الاختبار، Wormhole (ETH إلى Rome).

إنه لا يحتفظ **بمفاتيح الحفظ** — إذ تتطلب التسوية دائمًا توقيع المستخدم نفسه، وليس توقيع الخدمة أبدًا. تنسق واجهة برمجة التطبيقات ويمكنها تحمل الرسوم؛ أما الجسر الحقيقي فهو على السلسلة.

## السلاسل والأصول المدعومة

يعمل الجسر على Rubicon (الشبكة الرئيسية) وعلى Hadrian (شبكة الاختبار العامة). ولكلٍ منهما صفحة جسر ومضيف واجهة برمجة تطبيقات خاص به. الوقت المتوقع للتحويل مذكور في عرض السعر.

على كلتا الشبكتين، بالإضافة إلى SOL وUSDC، `POST /v1/quote` مع `asset: "SPL"` و `splAsset: {mint, decimals}` يعرض التحويل لأي رمز SPL بين محفظة Solana وRome، وتوقّع محفظتك المعاملات التي يعيدها. يصل الرمز إلى Rome على شكل غلافه. هذا المسار غير مُدرج في `/v1/routes`.

### Rubicon (الشبكة الرئيسية)

| الأصل             | المسار  | الاتجاه           | السلاسل                                                 |
| ----------------- | ------- | ----------------- | ------------------------------------------------------- |
| **USDC**          | CCTP v2 | إلى Rome ومن Rome | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad, OP |
| **SOL**, **USDC** | Solana  | إلى Rome ومن Rome | محفظة Solana                                            |

لا يوجد مسار ETH على الشبكة الرئيسية. يعمل الوضع الخالي من الغاز في MetaMask مع ودائع CCTP. عندما يرسل مرحّل MetaMask إيداعك، يقبله الجسر إذا كان المودِع هو المرسل المذكور في عرض السعر وكانت عملية الحرق مطابقة لعرض السعر. قد تحتوي المعاملة المُمرَّرة على حرق واحد فقط.

نقل USDC خارج Rome باستخدام CCTP يستهلك رمز wUSDC، وليس USDC الخاص بالغاز، وينتهي التحويل بمعاملة مطالبة على سلسلة الوجهة. تحوّل علامة التبويب Wrap في صفحة الجسر الغاز إلى wUSDC بتوقيع واحد.

قائمة المسارات هي [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) تسرد سلسلة Rome مع أصول السجل وقدراتها. وعلى الشبكة الرئيسية ما زالت تلك القائمة تذكر Wormhole وETH، رغم عدم وجود مسار ETH.

### Hadrian (شبكة الاختبار)

| الأصل             | المسار   | الاتجاه           | السلاسل                                                                                                   |
| ----------------- | -------- | ----------------- | --------------------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2  | إلى Rome ومن Rome | Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, Monad Testnet, OP Sepolia |
| **ETH**           | Wormhole | إلى Rome          | Ethereum Sepolia                                                                                          |
| **SOL**, **USDC** | Solana   | إلى Rome ومن Rome | محفظة Solana                                                                                              |

توجد المجموعة الحية دائمًا في [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) و [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains). هل تحتاج إلى رموز اختبار؟ راجع [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md).

## استخدمه بشكل مستقل

افتح واجهة الجسر للشبكة التي تريدها:

* Rubicon (الشبكة الرئيسية): [bridge-api.mainnet.romeprotocol.xyz](https://bridge-api.mainnet.romeprotocol.xyz/?chain=7531)
* Hadrian (شبكة الاختبار): [bridge-api.devnet.romeprotocol.xyz](https://bridge-api.devnet.romeprotocol.xyz/?chain=200010)

الأسماء `?chain=` تحدد المعلمة سلسلة Rome.

## ادمج واجهة برمجة التطبيقات

واجهة برمجة التطبيقات عامة. اعرض السلاسل والمسارات المدعومة:

```bash
curl https://bridge-api.mainnet.romeprotocol.xyz/v1/chains   # Rubicon
curl https://bridge-api.devnet.romeprotocol.xyz/v1/chains    # Hadrian
```

`POST /v1/quote` يأخذ الجانب غير Rome من التحويل في `sourceChain`، في كلا الاتجاهين: CAIP-2 (`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`) أو الأسماء الأقدم `ethereum` / `solana`، والتي لا تزال مقبولة مع `Sunset` ترويسة (استخدم CAIP-2). `GET /v1/routes` لا يأخذ أي معاملات ويسرد التحويلات المتاحة. طلب عرض سعر:

```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":"<your 0x address>"},"recipient":"<recipient on Rome>"}'
```

`المبلغ` هو سلسلة من الوحدات الأساسية. لدى USDC ستة منازل عشرية، لذا `"1000000"` يمثل 1 USDC. وتحمل الاستجابة الوقت المتوقع بـ `etaSeconds`. راجع استجابات نقطة النهاية لمعرفة مجموعة المسارات والحقول الأخرى.

## كيف تتم التسوية

واجهة برمجة التطبيقات خارج السلسلة هي منسق وممول للرسوم فقط. تتم تسوية التحويلات الواردة على السلسلة عبر تفويض موقَّع من المستخدم؛ أما عمليات السحب الصادرة فتمر عبر عقد الجسر على السلسلة. لا تُخصم أموال المستخدم في أي خطوة من دون توقيعه.


---

# 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/alttbyqat-ala-rome/bridge-api.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.
