> 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/open-to-solana-users.md).

# افتح عقدك لمستخدمي سولانا

انشر عقد Solidity على Rome (شبكة Hadrian التجريبية، الشبكة الرئيسية Rubicon) وافتحه أمام محافظ Solana — ما الذي يحتاجه العقد، وكيف يستدعيه مستخدم محفظة Solana، والعناوين الخاصة بكل شبكة، وقائمة إطلاق ch

نشر واحد، ونوعان من المستخدمين. يتم الوصول إلى عقد على Rome بواسطة مستخدمي MetaMask بمفتاح EVM الخاص بهم وبواسطة مستخدمي محافظ Solana (Solflare، على سبيل المثال) بمفتاح Solana الخاص بهم — العنوان نفسه، والحالة نفسها. هذه الصفحة هي المسار من البداية إلى النهاية: انشر، واجعل العقد جاهزًا لـ Solana، واربط مسار Solana في تطبيقك، ثم أطلقه على الشبكة الرئيسية.

## 1. انشر على الشبكة التي تريدها

سلاسل Rome هي أهداف EVM قياسية: تعمل Hardhat وFoundry وviem وethers دون تغيير (الشرح الكامل في [نشر عقود Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md)).

| الشبكة                                                                             | معرّف السلسلة | RPC                                         | المستكشف                                                                              | رمز الغاز     | كيفية الحصول على الغاز                                                                                                                                                              |
| ---------------------------------------------------------------------------------- | ------------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**روبيكون**](https://docs.rome.builders/ar/alshbkat/rubicon.md) (الشبكة الرئيسية) | `7531`        | `https://rubicon.mainnet.romeprotocol.xyz/` | [via-rubicon.mainnet.romeprotocol.xyz](https://via-rubicon.mainnet.romeprotocol.xyz/) | USDC          | انقل USDC من Ethereum أو Base أو Arbitrum أو Polygon أو Avalanche أو Monad أو OP (CCTP) أو من Solana باستخدام [جسر روم](https://bridge-api.mainnet.romeprotocol.xyz/); فيصل كغاز    |
| **هادريان** (شبكة الاختبار)                                                        | `200010`      | `https://hadrian.testnet.romeprotocol.xyz/` | [via-hadrian.testnet.romeprotocol.xyz](https://via-hadrian.testnet.romeprotocol.xyz/) | USDC التجريبي | انقل USDC التجريبي من شبكة اختبار ([الحنفيات](https://docs.rome.builders/ar/almward/faucets.md)) أو لفّه من محفظة Solana devnet في [تطبيق روم](https://app.devnet.romeprotocol.xyz) |

الغاز هو USDC بثمانية عشر منزلة عشرية على جانب EVM؛ لا توجد صنبور Rome على Rubicon أو Hadrian. تكاليف الكتابة أعلى من الحدس المعتاد في Ethereum، لأن معظم التكلفة ناتج عن إنشاء حسابات Solana: مستلم لم يُستخدم من قبل، حساب رمزي جديد، عقد منشور. استخدم `eth_estimateGas`، وهو ما تفعله الأدوات القياسية، ولا تثبت 21,000 بشكل صلب أبدًا. عند القياس على Hadrian، استغرق نشر عقد بحجم 10 بايت 1,147,921 غازًا كقيمة مقدرة ومستخدمة، واستغرق تحويل أصلي إلى عنوان لم يُستخدم من قبل 1,086,961، مقابل 21,000 لتحويل إلى عنوان موجود. تفرض Rome الغاز المستخدم فعليًا، والذي لم يكن في هذه القياسات أكثر من التقدير. موّل بضعة USDC قبل أول نشر. تحقّق من المصدر في المستكشف بعد ذلك ([التحقق من العقود](https://docs.rome.builders/ar/adlh-almtw-ryn/verify-contracts.md); ومحقّق الشبكة الرئيسية هو `https://verify.mainnet.romeprotocol.xyz`).

طوّر على Hadrian، ثم أعد نشر نفس الملفات الناتجة على Rubicon مع استبدال chain id وعناوين الغلاف الخاصة بالشبكة الرئيسية؛ لا يتغير شيء في العقد بين الشبكات. Rubicon موجود في السجل العام ابتداءً من v0.3.0، لكن `create-rome-app` و `rome-cli` ما زالت الأدوات تثبّت registry v0.2.0، الذي لا يحتوي على إدخال لـ Rubicon، لذا لا يمكنها استهدافه؛ وبالنسبة لتلك الأدوات، املأ القيم يدويًا من [روبيكون](https://docs.rome.builders/ar/alshbkat/rubicon.md). الغاز على Rubicon هو USDC حقيقي بسعر يقارب عشرة أضعاف سعر الغاز في Hadrian، لذا فإن النشر هناك يكلف أموالًا حقيقية.

## 2. ما الذي يجعل العقد جاهزًا لـ Solana

هوية EVM لمستخدم Solana هي **العنوان الاصطناعي**, `keccak256(solana_pubkey)[12:]`؛ وهو `msg.sender`، مع nonce عادي. معظم العقود لا تحتاج إلى أي تغيير على الإطلاق. الأمور الثلاثة المهمة:

* **خذ القيمة بصيغة ERC-20، وليس `msg.value`.** أموال مستخدم Solana هي رموز SPL في محفظته، وتُرى على جانب EVM كغلاف الرمز (`wUSDC`, `wETH`, `wSOL`). لا يحتفظ الرمز المولد بأي شيء في حالة السكون وتصل أصول المستخدم على شكل الغلاف، لذا اسحب باستخدام `transferFrom` بعد `approve` وأعد باستخدام `transfer`. يمنح كل مستخدم الغلاف حق التفويض SPL مرة واحدة قبل أول سحب ([مرة واحدة: امنح الغلاف](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#one-time-grant-the-wrapper)). `قابل للدفع` لا يعمل مدخل `rome_composeExternalDepositV1`) إلا بعد أن يُمنح الرمز المولد غازًا أصليًا (وهو ما لا يفعله مسار الإيداع ثم السحب). إن خزنة ERC-20 موجودة أو AMM أو سوق إقراض لديها بالفعل الشكل المناسب.
* **استخدم الأغلفة القياسية.** لكل سلسلة غلاف واحد لكل mint؛ العناوين موجودة في [عناوين العقود](https://docs.rome.builders/ar/almrja/contract-addresses.md) (وعناوين Hadrian أيضًا في السجل العام [السجل](https://github.com/rome-protocol/rome-registry)). وجّه المنشئات إلى تلك العناوين؛ لا تنشر خاصتك.
* **اجعلها تناسب الميزانية الذرية حيث توقّع المحفظة.** توقّع محفظة Solana معاملة Solana واحدة، لذا يجب أن يناسبها استدعاء مسار Solana: حوالي 1.4 مليون وحدة حوسبة، و64 حسابًا، و4 كيلوبايت ([القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md)). عند القياس على Hadrian: تناسب عملية تحويل، وapprove، وAave supply؛ وتناسب عملية swap في Uniswap V3 بهامش صغير (حوالي 1.24 مليون CU)؛ أما Aave borrow فلا تناسب وتستخدم مسار الترحيل في القسم التالي. قِس باستخدام قيمة الإيصال في Solana `computeUnitsConsumed`، مع طلب المعاملة باستخدام `maxSupportedTransactionVersion: 1` (مقاطع Rome هي معاملات v1؛ وبدونه يرفض RPC الطلب).

ما لا تحتاج إليه: برنامج Solana، أو جسر، أو نشر ثانٍ، أو أي Solidity خاص بـ Rome. إذا كان العقد يستدعي أيضًا برامج Solana عبر precompiles، فراجع [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md).

## 3. دع محفظة Solana تستدعيه

مسار EVM في تطبيقك لا يتغير (MetaMask + `submitRomeTx`، أو viem/ethers عادي). بالنسبة لمسار Solana، هناك شكلان.

**مسار SDK — معاملة Solana v1 واحدة لكل استدعاء.** [`@rome-protocol/sdk`](https://github.com/rome-protocol/rome-sdk-ts) (`submitRomeTxV1`) يجعل الوكيل يُنشئ معاملة Solana v1 واحدة لاستدعاء EVM الخاص بك (حتى 64 حسابًا و4 كيلوبايت، ومن دون address lookup table؛ لا توجد instruction لـ ComputeBudget، ولا محفظة كنز، ولا اكتشاف للحسابات في كودك). توقّع المحفظة مرتين بالمفتاح نفسه: أولًا رسالة تفويض مقروءة (`تفويض Rome` في سطر واحد، `0x` ثم في السطر التالي تجزئة معاملة EVM)، والتي تتحقق السلسلة منها عبر برنامج Ed25519، ثم المعاملة. يرسل التطبيق المعاملة الموقّعة إلى Solana RPC؛ ويُرجع الاستدعاء تجزئة معاملة EVM وإيصالها. قبل أن توقّع المحفظة المعاملة، يتحقق منها SDK: الدافع هو الموقّع الوحيد، ولا يعمل إلا برنامج Rome ومتحقق Ed25519، وتحمل تعليمات Rome بالضبط الاستدعاء الذي فوّضه المستخدم، ولا توجد رسوم أولوية. يُرفض أي شيء آخر.

إذا لم يناسب الاستدعاء معاملة واحدة، يرفضه المُركِّب ويسلّمه SDK إلى الوكيل لترحيله، مع نفس توقيع التفويض، بحيث يرى المستخدم مع ذلك مطالبة تفويض واحدة. عندها تكون النتيجة لديها `route: "relay"`. قواعد الاستدعاءات المُرحَّلة والاستدعاءات الطويلة موجودة في [الاستدعاءات المُرحَّلة والاستدعاءات الطويلة](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md#relayed-calls-and-long-calls); ومحقّق الشبكة الرئيسية هو `fundSyntheticGas(deps, amountWei)` ينقل رمز الغاز الخاص بالسلسلة (USDC على Hadrian وRubicon) من حساب الرمز الخاص بالمحفظة إليه، في معاملة v1 واحدة موقّعة من المحفظة.

مرحلة التمويل (`buildFundLeg`) وإنشاء حساب الرمز للمحفظة قبل السحب هما تعليمات Solana عادية؛ `submitSolanaInstructionsV1` يرسلها أيضًا كمعاملات v1، موقّعة بالموقّع نفسه للمحفظة، من دون أي وكيل. أما استدعاء السحب نفسه (`buildSweepLeg`, `HelperProgram.transfer_spl`) فيمر عبر `submitRomeTxV1` مثل أي استدعاء آخر، ويعثر الوكيل على حسابات الرموز. `submitRomeTxV1` لا ينشئ حسابًا جديدًا للرمز المولد بنفسه: قبل أول استدعاء ينقل قيمة، تحقق من `isSyntheticProvisioned(...)` وإذا كانت false، فأرسل `buildCreatePdaCall(synthetic)` عبر `submitRomeTxV1` مرة واحدة. يوجد شرح كامل للإيداع والسحب مع الكود في [أنشئ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md); والآليات موجودة في [استدعِ EVM من Solana](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md). أما `submitRomeTxSolanaLane`، التي تبني معاملة Solana قديمة في العميل، وما زالت موجودة في SDK كمسار أقدم.

**من أين تأتي كل `التبعيات` قيمة.** كائن `التبعيات` SDK يحتوي على خمسة حقول مطلوبة (أما البقية، مثل `fetchImpl` وtimeouts، فهي اختيارية). أربعة تأتي من السلسلة وواحد من المحفظة:

| `التبعيات` الحقل | مصدره                                                                                           | جالب السجل (`@rome-protocol/registry` v0.2.0)                                                      |
| ---------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `proxyUrl`       | عنوان RPC الخاص بالسلسلة                                                                        | `getChain(chainId).rpcUrl`                                                                         |
| `chainId`        | معرّف السلسلة                                                                                   | `getChain(chainId).chainId`                                                                        |
| `programId`      | معرّف برنامج Rome الذي تعمل عليه السلسلة                                                        | `getChain(chainId).romeEvmProgramId`                                                               |
| `Solana`         | Solana RPC لعنقود السلسلة، حيث تُرسل المعاملة الموقّعة (devnet لـ Hadrian، وmainnet لـ Rubicon) | `getChain(chainId).solana.rpc` (عنوان devnet عام لـ Hadrian)؛ وللشبكة الرئيسية استخدم RPC خاصًا بك |
| `signer`         | خاص بالمحفظة `LaneSigner`، أو `Keypair` في البرامج النصية                                       | لا شيء                                                                                             |

تأخذ منشئات المراحل قيمًا ليست ضمن `التبعيات`. و `mint` (المسمى `usdcMint` في الشرح) هو mint الخاص بـ Solana لرمز الغاز، من `getTokens(chainId)` (المدخل ذو `kind: "gas"`، الحقل `mintId`). عنوان غلاف wUSDC ليس مدخلًا لمنشئ المراحل؛ بل تستخدمه لاستدعاءات ERC-20، وهو المدخل ذو `kind: "spl_wrapper"` والرمز `wUSDC` (الحقل `address`). يغطي السجل Hadrian، ومن v0.3.0، Rubicon. ولملء قيم Rubicon يدويًا بدلًا من ذلك: `proxyUrl` `https://rubicon.mainnet.romeprotocol.xyz/`, `chainId` `7531`, `programId` `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX`, `mint` `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`، والغلاف من الجدول في القسم التالي، وSolana mainnet RPC لـ `Solana`. [روبيكون](https://docs.rome.builders/ar/alshbkat/rubicon.md) يحتوي على القائمة الكاملة.

**نقاط نهاية external-V1 الخاصة بالوكيل — المسار نفسه من دون SDK.** يغلّف SDK عملية التركيب الذرّي، والترحيل، وإيداع الغاز (`fundSyntheticGas`). وتبقى طرق RPC الخام متاحة للعملاء الذين لا يستخدمون SDK، وتشمل التركيب التكراري، الذي لا يغلّفه SDK. وتوقّع المحفظة رسالة Ed25519 واحدة على الاستدعاء (الصيغة المقروءة `Rome authorization\n0x<hash>` أو التجزئة الخام)، ثم إما أن يركّب الوكيل معاملة/معاملات Solana لتوقّعها المحفظة (`rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1` + `rome_submitSignedV1Plan`) أو ينفذ العملية كاملة بنفسه بتوقيع واحد من المحفظة (`rome_relayUnsignedV1`، بعد `rome_composeExternalDepositV1` (الخاصة بـ SDK `fundSyntheticGas`) التي تموّل رصيد الغاز للرمز المولد؛ تستنزفها الاستدعاءات المُرحَّلة، لذا أعد تعبئتها عندما ينخفض رصيدها). أشكال الطرق في [دعم JSON-RPC](https://docs.rome.builders/ar/almrja/json-rpc.md); وقواعد التفويض في [استدعِ EVM من Solana](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md#the-external-v1-endpoints). استخدم الترحيل لأي شيء تكراري، ومسار SDK لكل ما يناسب.

في كلتا الحالتين يرى العقد معاملة عادية من عنوان الرمز المولد، ولا يملك المستخدم أبدًا مفتاح EVM.

## 4. عناوين الغلاف الخاصة بكل شبكة

| الشبكة           | `wUSDC` الغلاف                               | أغلفة أخرى                                                                                               |
| ---------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Rubicon (7531)   | `0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3` | `wETH` `0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9`, `wSOL` `0xc4e29e0f726a906e93277cbbc37bf27a9848a113` |
| Hadrian (200010) | `0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d` | `wETH` `0x02aeace038269f9961c93d04dcacd6fb3adfa55f`, `wSOL` `0x39f36444fcb79b3e691544aee2a832ebef54ca9f` |

يظهر رمز الغاز الأصلي على شكل `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` في قوائم الرموز؛ وهو ليس عقد ERC-20. تحمل الأغلفة منازل عشرية الخاصة بـ SPL mint، وليس 18: wUSDC ‏6، وwETH ‏8، وwSOL ‏9.

## 5. قائمة التحقق قبل الإطلاق

1. تم النشر على Hadrian؛ ويعمل مسار EVM من MetaMask.
2. كل نقطة دخول تنقل قيمة تعتمد على ERC-20 وموجّهة إلى الغلاف القياسي للسلسلة.
3. محفظة Solana التي توقّع معاملات v1 (Solflare يفعل ذلك على devnet اليوم؛ أما Phantom فلا يفعل بعد) تُكمل الرحلة ذهابًا وإيابًا كاملة على Hadrian: وفّر الرمز المولد (`create_pda`، مرة واحدة) → مرحلة التمويل → المنح → approve → الاستدعاء → مرحلة السحب، باستخدام مسار SDK؛ أو مسار الترحيل إذا كان الاستدعاء تكراريًا.
4. كل استدعاء في مسار Solana `computeUnitsConsumed` يُقرأ من إيصال Solana ويبقى ضمن الميزانية الذرية، أو يُوجَّه الاستدعاء عبر الترحيل.
5. منح الغلاف موجود في مسار أول إيداع في تطبيقك لكلا المسارين: `isEnabled(user)` يُتحقق من `approve_spl` ويُرسل مرة واحدة عندما تكون false ([مرة واحدة: امنح الغلاف](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md#one-time-grant-the-wrapper)).
6. تم التحقق من المصدر على المستكشف.
7. أعيد نشره على Rubicon مع عناوين الغلاف الخاصة بالشبكة الرئيسية. وتأتي `التبعيات` قيمه من السجل (v0.3.0 أو أحدث) أو يدويًا من [روبيكون](https://docs.rome.builders/ar/alshbkat/rubicon.md). تُجرى نفس الرحلة ذهابًا وإيابًا مرة واحدة بأموال حقيقية، باستخدام محفظة تحققت من أنها توقّع معاملات v1 على الشبكة الرئيسية.

## ما التالي

* [أنشئ تطبيقًا ثنائي المسار](https://docs.rome.builders/ar/adlh-almtw-ryn/dual-lane-app.md) — مثال الخزنة، خطوة بخطوة، وكلتا المحفظتين
* [استدعِ EVM من Solana](https://docs.rome.builders/ar/adlh-almtw-ryn/call-evm-from-solana.md) — عناوين الرموز المولدة، واكتشاف الحسابات، ونقاط نهاية external-V1
* [نشر عقود Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md) · [التحقق من العقود](https://docs.rome.builders/ar/adlh-almtw-ryn/verify-contracts.md) · [عناوين العقود](https://docs.rome.builders/ar/almrja/contract-addresses.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/adlh-almtw-ryn/open-to-solana-users.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.
