> 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/03-first-contract-on-hadrian.md).

# 3. أول عقد لك على Hadrian

اربط محفظة بـ Hadrian، موّلها، وانشر عقدًا باستخدام Hardhat، واتبع معاملتك إلى معاملة سولانا التي تمت تسويتها بها.

تنشر عقد Solidity صغيرًا على هادريان، شبكة الاختبار العامة لـRome. عملية النشر عادية باستخدام Hardhat. الجديد هو أنك تدفع رسوم الغاز بعملة USDC، وأن المستكشف يربطك بالجانب الخاص بـSolana مما فعلته.

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

* كيفية توجيه محفظة وHardhat إلى هادريان.
* لماذا تكون رسوم الغاز USDC، وكيف تحصل عليها المحفظة.
* لماذا تكلف عملية كتابة على Rome رسوم غاز أكثر مما توحي به عادات Ethereum.
* كيفية قراءة معاملتك على مستكشف Via، ومتابعتها إلى معاملة Solana التي تمت بها تسويتها.
* كيفية التحقق من المصدر بحيث يعرضه المستكشف.

## قبل أن تبدأ

لقد قرأت [الدرس 2](https://docs.rome.builders/ar/akadymyh-rwma/02-what-you-can-build.md)، الذي يوضح ما هي الخطوة الأولى التي يمهد لها هذا العقد. جهّز هذه الأشياء:

* Node.js بالإصدار الذي [البدء السريع](https://docs.rome.builders/ar/albda-1/quickstart.md) يذكره.
* تم تثبيت MetaMask.
* حساب جديد، أو مفتاح للاستخدام المؤقت. ستصدر مفتاحه الخاص إلى الصدفة لديك، لذا لا تستخدم مفتاحًا يحتوي على أموال حقيقية.
* محفظة Solana مضبوطة على Devnet، فقط إذا كنت ستموّل من Solana.

## المسار

### الخطوة 1. أضف هادريان إلى محفظتك

هادريان شبكة EVM قياسية. يمكنك إضافتها إلى MetaMask يدويًا باسم، وعنوان RPC، ومعرّف الشبكة، ورمز العملة، وعنوان المستكشف. خذ كل قيمة من الجدول في [البدء السريع، الخطوة 1](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-1.-add-hadrian-to-metamask). القيم موجودة أيضًا في [هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md). اضبط رمز العملة على `USDC`.

يحتاج Hardhat إلى معرّف الشبكة نفسه وعنوان RPC نفسه. ستضعهما في الإعدادات في الخطوة 3.

### الخطوة 2. موّل المحفظة

الغاز على هادريان هو USDC، ومدعوم بـUSDC الخاص بـCircle على Solana Devnet. SOL ليس رمز الغاز. لا يوجد صنبور Rome. تحصل على USDC تجريبي من مكان آخر وتدخله عبر جسر Rome. الإيداع الذي يصل عبر الجسر يصل كغاز افتراضيًا. اترك خيار الاستلام في صفحة الجسر على gas.

هناك مصدران:

* **من Solana Devnet.** خذ USDC الخاص بـdevnet من صنبور Circle وبعض SOL الخاص بـdevnet لدفع رسوم Solana. اجسر USDC باستخدام مساره الخاص بـSolana، وامنح عنوان EVM الخاص بك باعتباره المستلم. يطلب الجسر من محفظة EVM لديك التوقيع على معاملة مطالبة على هادريان، وهذا يحوّل USDC إلى غاز.
* **من شبكة اختبار EVM.** اصك USDC تجريبيًا على Ethereum Sepolia، ثم اجسره إلى الداخل. تحتاج إلى قدر قليل من ETH على Sepolia لدفع معاملة جهة المصدر.

الخطوات وروابط الصنبور موجودة في [البدء السريع، الخطوة 2](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-2.-fund-your-wallet), [موّل محفظة على هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md#fund-a-wallet) و [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md). أما الجسر نفسه فهو على [جسر روم](https://docs.rome.builders/ar/alttbyqat-ala-rome/bridge-api.md).

كم يجب أن تموّل؟ يذكر البدء السريع حدًا أدنى ومقدارًا مريحًا. اقرأه قبل أن تبدأ.

تحقق من الرصيد في MetaMask قبل المتابعة. إذا كان يظهر صفرًا، فهذا يعني أن التحويل لم يكتمل بعد. تعرض صفحة الجسر كل خطوة والوقت المتوقع.

### الخطوة 3. أنشئ مشروع Hardhat

أنشئ مشروع Hardhat 3 باستخدام قالب TypeScript وviem. ثم أضف إدخالًا `hadrian` تحت `networks` مع معرّف الشبكة وعنوان RPC من صفحة هادريان. يأتي المفتاح الخاص من متغير بيئي أو من مخزن المفاتيح المشفر في Hardhat. يُفضّل استخدام مخزن المفاتيح لأي شيء يتجاوز مفتاحًا مؤقتًا.

الأوامر الدقيقة والإعدادات موجودة في البدء السريع، [الخطوة 3](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-3.-create-a-hardhat-project) و [الخطوة 4](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-4.-configure-hardhat-for-rome). [نشر عقود Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md#hardhat) يعرض ملف الإعدادات الكامل، و [التدفق نفسه في Foundry](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md#foundry).

### الخطوة 4. اكتب العقد وانشره

عقد البدء السريع، `HelloRome`، بسيط عمدًا. يخزن تحية، ويعدّ مرات استدعاء `greet()`، ويصدر حدثًا. لا يوجد فيه شيء خاص بـRome.

وهذه هي نقطة هذه الخطوة: `HelloRome` يُنشر دون تغييرات. قبل أن تنقل عقدًا آخر، تحقّق من [القيود المعروفة](https://docs.rome.builders/ar/alamn/known-limitations.md) للاطلاع على التعليمات غير المدعومة واختلافات الغاز. اكتب العقد، ثم شغّل برنامج النشر مقابل `hadrian`. ينشر البرنامج العقد، ويستدعي `greet()` مرة واحدة، ويقرأ العداد والتحية مرة أخرى. انسخ كلاهما من البدء السريع، [الخطوة 5](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-5.-write-a-contract) و [الخطوة 6](https://docs.rome.builders/pages/1fec44ff3cfcd26b4c538ad9cda956b563d72245#id-6.-deploy).

عندما ينجح الأمر يكون لديك عنوان عقد وعدّاد قيمته 1.

### الخطوة 5. افهم ما كلّفه ذلك

استخدم النشر غازًا أكثر بكثير مما كان سيفعله العقد نفسه على Ethereum. معظم غاز الكتابة على Rome يُنفق على إنشاء حسابات Solana. فالعقد المنشور ينشئ حسابات جديدة لشفـرته وتخزينه. وكذلك يفعل النقل إلى مستلم لم يُستخدم من قبل، وكذلك يفعل حساب رمز جديد.

ويترتب على ذلك قاعدتان:

* دع أدواتك تقدّر الغاز باستخدام `eth_estimateGas`Hardhat، `forge create` و `cast send` تفعل. `forge script` يتطلب `--skip-simulation` أن تفعل الشيء نفسه.
* لا تضبط 21000 يدويًا أبدًا. أي كتابة تنشئ حسابات، مثل النشر أو النقل إلى عنوان لم يُستخدم من قبل، ستفشل عند حد منخفض كهذا.

يفرض Rome رسوم الغاز التي تستهلكها المعاملة فعليًا، لذا فإن التقدير المرتفع لا يكلفك شيئًا. احتفظ بهامش الأمان الذي تضيفه أدواتك: ففي الاستدعاء إلى برنامج Solana قد يخرج التقدير منخفضًا. [دعم JSON-RPC](https://docs.rome.builders/ar/almrja/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) لديه أرقام مقاسة للكتابات الحقيقية.

### الخطوة 6. اقرأها على المستكشف

افتح مستكشف Via الخاص بهادريان وابحث عن عنوان عقدك. تربط صفحته معاملة الإنشاء وتعرض `greet()` الاستدعاء ضمن معاملاته. رابط المستكشف موجود في [هادريان](https://docs.rome.builders/ar/alshbkat/hadrian.md).

يعرض Via العرض المعتاد لـEVM: الكتلة، والمرسل، والغاز المستخدم، وسجلات الأحداث. يحتوي صف "Settled in" على توقيع معاملة Solana التي سوّت معاملتك. افتح ذلك الرابط. يعرض مستكشف Solana تعليمات تلك المعاملة، والبرامج التي لمستها، ووحدات الحوسبة التي استهلكتها. [Via Explorer](https://docs.rome.builders/ar/alttbyqat-ala-rome/via.md) يشرح ما الذي يعرضه Via أيضًا.

اقرأ وحدات الحوسبة هناك، وليس من `gasUsed`. على Rome، `gasUsed` ليست مقياسًا أمينًا لحوسبة Solana.

### الخطوة 7. تحقّق من المصدر

يؤدي التحقق إلى نشر المصدر وABI، ثم يعرض المستكشف شارة "Source verified". يشغّل Rome خدمة Sourcify مستضافة، لذا تعمل مسارات التحقق القياسية في Hardhat وFoundry. وتوجّهها إلى أداة التحقق الخاصة بـRome وتمنحها معرّف الشبكة.

توجد نقاط النهاية تحت [نقطة نهاية أداة التحقق](https://docs.rome.builders/ar/adlh-almtw-ryn/verify-contracts.md#verifier-endpoint)، أما الإعدادات والأوامر فموجودة في [Hardhat](https://docs.rome.builders/ar/adlh-almtw-ryn/verify-contracts.md#hardhat) القسم. استخدم أداة التحقق الخاصة بشبكة الاختبار لـHadrian. أداة التحقق للشبكة الرئيسية هي عنوان URL مختلف، وهذا مهم في الدرس 11.

## اختبر نفسك

نتيجتك: افتح عقدك على مستكشف هادريان وشاهد هذه الثلاثة كلها.

* معاملة النشر الخاصة بك، مع توقيع Solana الظاهر في صف "Settled in"، وتعليمات معاملة Solana تلك على مستكشف Solana.
* معاملة ثانية، وهي `greet()` الاستدعاء، مع سجل حدث واحد من عنوان عقدك. ذلك السجل هو `Greeted` الحدث؛ ورمزه الأول هو تجزئة `Greeted(address,uint256)`.
* شارة "Source verified" على العقد.

إذا واجهتك مشكلة، فالأخطاء الشائعة موجودة في [البدء السريع](https://docs.rome.builders/ar/albda-1/quickstart.md#common-errors). والأكثر شيوعًا هو `رصد غير كافٍ`، وهذا يعني أن المحفظة تحتوي على USDC أقل من اللازم لضرب حد الغاز في سعر الغاز.

ثم أجب عن هذه الأسئلة.

1. لماذا تكون عملية النشر الأولى أغلى بكثير بالغاز من Ethereum؟
2. أين تقرأ وحدات الحوسبة الخاصة بمعاملة Solana: `gasUsed`، أم معاملة Solana التي يربطك بها Via؟
3. هل USDC الخاص بشبكة الاختبار الذي استخدمته يساوي أي شيء؟

<details>

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

1. معظم الغاز يُدفع مقابل إنشاء حسابات Solana: العقد، وتخزينه، وأي حسابات رموز جديدة.
2. معاملة Solana. يربطك Via بها من صف "Settled in"، ويعرض مستكشف Solana وحدات الحوسبة الخاصة بها. `gasUsed` ليس بديلًا أمينًا.
3. لا. هادريان يتسوّى على Solana Devnet، لذا فإن USDC وSOL الخاصين به ليسا مالًا حقيقيًا.

</details>

## التالي

[سجّل تطبيقك في Arena](https://arena.mainnet.romeprotocol.xyz/apps/new) واربط به عقد هادريان هذا. ينتقل التطبيق إلى Building.

[4. كيف تشغّل روما شفرتك](https://docs.rome.builders/ar/akadymyh-rwma/04-how-rome-runs-your-code.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/03-first-contract-on-hadrian.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.
