> 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/05-call-solana-from-solidity.md).

# 5. استدعِ Solana من Solidity

استخدم precompiles الخاصة بـ CPI وHelper في روم لقراءة حسابات سولانا، وإنشاء حسابات رمزية، واستدعاء برامج سولانا من عقد Solidity.

على Rome يمكن لعقد Solidity أن يقرأ حسابات Solana ويستدعي برامج Solana في نفس المعاملة. ستقرأ رصيد توكن Solana، وتنشئ حساب توكن، وتتعلّم كيف تبني استدعاءً لبرنامج.

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

* ما هو الـ precompile في Rome وأيّ ثلاثة ستستخدمها أكثر.
* توقيع أيّ برنامج Solana يراه عندما يستدعيه عقدك.
* كيفية قراءة حالة Solana وإنشاء حساب توكن من Solidity.
* القواعد التي تحدد ما إذا كان استدعاء Solana ينجح: الحسابات المصرّح بها، مسار واحد، وذرّي فقط.

## قبل أن تبدأ

* أنهِ [4. كيف تشغّل روما شفرتك](https://docs.rome.builders/ar/akadymyh-rwma/04-how-rome-runs-your-code.md)الميزانية الذرّية وحدّ 64 حسابًا مهمّان هنا.
* تأكّد من تمويل محفظة Hadrian لديك وأن إعداد النشر من الدرس 3 يعمل. الصنابير مُدرجة في [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md).
* ثبّت واجهات Rome Solidity من `rome-solidity` المستودع، كما هو موضح في [انشر Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md#using-the-rome-solidity-sdk).

## الـ precompiles هي البوابة

الـ precompile هو عنوان ثابت يشغّل كودًا أصليًا بدلًا من bytecode. لدى Ethereum بضعة أمثلة، مثل `ecrecover`. وتضيف Rome precompiles وظيفتها الوصول إلى Solana. تستدعيها مثل أي عقد، عبر واجهة.

ستستخدم ثلاثة:

| Precompile    | ما الذي يقدّمه لك                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| CpiProgram    | `invoke` و `invoke_signed` لاستدعاء أي برنامج Solana، بالإضافة إلى طرق عرض للقراءة فقط لحسابات Solana |
| HelperProgram | عمليات جاهزة للرموز والحسابات: إنشاء حساب توكن، نقل رموز SPL، اشتقاق العناوين                         |
| النظام        | اشتقاق PDA والتحويل إلى base58                                                                        |

العناوين موجودة في [مرجع Precompile](https://docs.rome.builders/ar/almrja/precompiles.md) و [عناوين العقود](https://docs.rome.builders/ar/almrja/contract-addresses.md). لا تحتاج إلى كتابتها. استيراد `interface.sol` من `rome-solidity` يمنحك ثوابت جاهزة باسم `CpiProgram`, `HelperProgram` و `SystemProgram`.

## من يوقّع

عندما يستدعي عقدك precompile، ترى Solana هوية عقدك نفسه، لا هوية المستخدم. لكل عنوان EVM عنوان مشتق من برنامج Solana، وهو PDA الخاص بالسلطة الخارجية. وهو يملك حسابات التوكن الخاصة بذلك العنوان ويوقّع نيابةً عنه.

هذه هي القاعدة نفسها التي تعرفها من ERC-20: لا يمكن لعقد أن ينقل أصول المستخدم ما لم يسمح له المستخدم بذلك. يوضّح الدرس 6 كيف يمنح المستخدم هذا الإذن على Rome. القاعدة والطرق الثلاث للاحتفاظ بمركز المستخدم موجودة في [دمج برنامج سولانا](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-1.-every-evm-address-has-one-solana-identity).

## الخطوة 1: اقرأ قبل أن تكتب

ابدأ بالقراءة. فهي لا تغيّر الحالة وتعمل في التنفيذ الذرّي والتنفيذ التكراري. اقرأ قبل أن تُجري تعديلًا: فبمجرد تنفيذ استدعاء مخبّأ، تُرفض قراءات المسار legacy لبقية المعاملة.

```solidity
import "@rome-protocol/rome-solidity/contracts/interface.sol";

contract SolanaPeek {
    // حساب التوكن الذي يستخدمه Rome للمتصل ورمز الغاز الخاص بالسلسلة
    function myTokenAccount() external view returns (bytes32) {
        return HelperProgram.ata(msg.sender, SystemProgram.mint_id());
    }

    // رصيد المتصل في ذلك الحساب
    function myBalance() external view returns (uint64) {
        return HelperProgram.user_balance(msg.sender, SystemProgram.mint_id());
    }
}
```

عناوين Solana هي `bytes32` هنا، وليست عناوين بطول 20 بايت. أما القراءات الأخرى، `account_info`, `account_data_at` و `account_u64_at`فهي تتيح لك فحص أي حساب في Solana. راجع [قراءة بيانات الحساب](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md#reading-account-data).

## الخطوة 2: استخدم المساعد

للأعمال الشائعة لا تحتاج إلى تعليمات تُنشئها يدويًا. يقوم Helper بإنشاء حسابات التوكن، ونقل رموز SPL واللامبورتات، والتحويل بين الغاز واللامبورتات. التواقيع موجودة في `contracts/interface.sol`، وعقد تطبيقي موجود في [نقل اللامبورتات](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md#transfer-lamports).

```solidity
function createMyAta() external {
    HelperProgram.create_ata(msg.sender, SystemProgram.mint_id());
}
```

العقد الذي يستدعي Helper يتصرف بوصفه نفسه. الرموز التي ينقلها هي رموزه هو، وليست رموز المستخدم.

## الخطوة 3: استدعِ أي برنامج Solana

بالنسبة إلى برنامج لا تغطيه أدوات المساعدة، ابنِ قائمة الحسابات وبايتات التعليمة بنفسك واستدعِ `invoke`. كل حساب هو pubkey مع علامتين، signer وwritable. وبيانات التعليمة هي ما يتوقعه البرنامج الهدف، وعادةً بصيغة Borsh.

العقد الكامل موجود في [استدعاء برامج Solana المخصّصة](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md#calling-custom-solana-programs). `invoke_signed` يضيف sub-PDAs مُملّحة عندما يحتاج الهدف إلى أكثر من موقّع واحد من عقدك. للحصول على عنوان PDA داخل Solidity، استخدم `find_program_address` على precompile الخاص بـ System؛ راجع [اشتقاق PDA](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md#pda-derivation).

## القواعد التي تحدد ما إذا كان ذلك ينجح

* **صرّح بكل حساب.** تحتاج Solana إلى قائمة الحسابات كاملة قبل تنفيذ الاستدعاء. يعثر البروكسي عليها بمحاكاة معاملتك أولًا، لذلك يجب أن يكون كل حساب قابلًا للاشتقاق من المدخلات التي يملكها العقد. يجب أن يبقى الإجمالي ضمن حد 64 عنوانًا.
* **ابقَ ذريًا.** لا يمكن لاستدعاء ينشئ CPI من المسار legacy أن يعمل بشكل تكراري. يجب أن يتسع في معاملة ذرّية واحدة، لذا اجعل كل إجراء يقتصر على نقل توكن واحد وCPI واحد.
* **اختر مسارًا واحدًا.** لدى Rome عائلتان من precompiles تغيّران حالة Solana: legacy (`CpiProgram`, `HelperProgram`, `السحب`) وcached (مجموعة الـ `...Cached` ). تستخدم المعاملة عائلة واحدة. ولا يمكن إلا لمسار legacy استدعاء برنامج مخصّص. اقرأ الجدول في [دمج برنامج سولانا](https://docs.rome.builders/pages/2eefebcaecd49b1215ce009e624aa6c6592ae751#id-4.-one-track-per-contract-and-per-transaction).
* **أبقِ العمق ضحلًا.** استدعاؤك لبرنامج Solana يستخدم مستويات CPI، وكذلك كل برنامج يستدعيه بدوره. حدّ العمق في Solana منخفض. [القيود](https://docs.rome.builders/ar/almfahym-alasasyh/constraints.md#cpi-constraints) يشرح المستويات.
* **لا استدعاءات إلى Rome من جديد.** لا يمكن لـ CPI تسمية برنامج Rome أو استدعاؤه. ولا يمكنه تسمية دافع رسوم Solana إلا في تعليمة تحويل System عادية.

## اختبر نفسك

أضف `createMyAta` إلى `SolanaPeek` وانشره على Hadrian. ثم:

1. استدعِ `myTokenAccount` و `myBalance` باستدعاء قراءة من عنوان محفظتك.
2. أرسِل معاملة تستدعي `createMyAta`.
3. افتح المعاملة على مستكشف Hadrian. راجع [عبر المستكشف](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md).

يجب أن ترى التعليمة الخاصة بـ Solana خلف استدعائك ووحدات الحوسبة الخاصة بها. الاستدعاء الذي يصل إلى Solana يُظهر برنامج Solana في المستكشف، وليس مجرد استدعاء EVM.

<details>

<summary>1. يستدعي عقدٌ ما <code>HelperProgram.transfer_spl</code>. رموز من تتحرك؟</summary>

رموزه هو. والموقّع هو PDA الخاص بالسلطة الخارجية للعقد. ولكي تنقل رموز المستخدم، يجب أن يمنح المستخدم حقًا أولًا.

</details>

<details>

<summary>2. لماذا يجب أن يكون الاستدعاء الذي يستخدم <code>invoke</code> متوافقًا مع معاملة ذرّية واحدة؟</summary>

يُرفض CPI الخاص بمسار legacy داخل معاملة تكرارية. إذا احتاج الاستدعاء إلى أكثر من معاملة Solana واحدة، فإنه يفشل.

</details>

<details>

<summary>3. على أي القراءات يمكنك الاعتماد في أي وضع تنفيذ؟</summary>

عروض القراءة فقط: `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` وقراءات Helper مثل `user_balance`. ليس لها آثار جانبية. شغّلها قبل أي تعديل مخبّأ في المعاملة نفسها.

</details>

## التالي

[6. الرموز على الجانبين](https://docs.rome.builders/ar/akadymyh-rwma/06-tokens-on-both-sides.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/05-call-solana-from-solidity.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.
