> 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/albda-1/quickstart.md).

# دليل البدء السريع

انشر أول عقد Solidity لك على Rome في أقل من 5 دقائق.

انشر أول عقد Solidity لك على Rome في أقل من 5 دقائق. هذا الدليل موجّه إلى [**هادريان**](https://docs.rome.builders/ar/alshbkat/hadrian.md)، سلسلة الشبكة التجريبية العامة. [روبيكون](https://docs.rome.builders/ar/alshbkat/rubicon.md) هي سلسلة الشبكة الرئيسية، حيث تكون رسوم الغاز USDC حقيقية؛ جرّب كل شيء أولًا على سلسلة تجريبية.

## المتطلبات الأساسية

* [Node.js](https://nodejs.org/) v22.13+
* [MetaMask](https://metamask.io/) إضافة متصفح
* محفظة Solana مضبوطة على **Devnet**، وذلك فقط إذا قمت بتمويلها من Solana (الخطوة 2). استدعاء العقود من محفظة Solana يحتاج إلى محفظة توقّع معاملات Solana v1، وهو ما يتم شرحه في [افتح عقدك لمستخدمي سولانا](https://docs.rome.builders/ar/adlh-almtw-ryn/open-to-solana-users.md).

## 1. أضف Hadrian إلى MetaMask

أضِفه يدويًا (الإعدادات → الشبكات → إضافة شبكة):

| الحقل            | القيمة                                          |
| ---------------- | ----------------------------------------------- |
| اسم الشبكة       | Rome Hadrian                                    |
| عنوان URL لـ RPC | `https://hadrian.testnet.romeprotocol.xyz/`     |
| معرّف السلسلة    | `200010`                                        |
| رمز العملة       | `USDC`                                          |
| مستكشف الكتل     | `https://via-hadrian.testnet.romeprotocol.xyz/` |

## 2. موّل محفظتك

تُدفع رسوم الغاز برمز الغاز الخاص بالسلسلة، وهو USDC على Hadrian. على Hadrian، يكون مدعومًا بـ USDC الخاص بـ Circle على Solana Devnet (mint `4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`)، لذا فإن SOL على devnet ليس هو الغاز. لا يوجد صنبور Rome. هناك طريقتان للحصول على USDC إلى Hadrian:

**من Solana** — احصل على USDC الخاص بـ Solana Devnet من [صنبور Circle](https://faucet.circle.com/) (اختر Solana Devnet) وبعض SOL على devnet لرسوم Solana من [صنبور سولانا](https://faucet.solana.com/)، مع ضبط محفظة Solana على Devnet. ثم استخدم [جسر روم](https://docs.rome.builders/ar/alttbyqat-ala-rome/bridge-api.md) مع Hadrian كوجهة ومساره الخاص بـ Solana، مع استخدام عنوان محفظة EVM الخاصة بك كمستلم؛ يطلب الجسر من محفظة EVM تلك توقيع معاملة مطالبة على Hadrian، مما يحوّل USDC إلى غاز.

**عبر الجسر من سلسلة EVM** — قم بسكّ USDC تجريبي على Ethereum Sepolia من [صنبور Circle](https://faucet.circle.com/)، ثم انقله إلى Rome باستخدام [جسر روم](https://docs.rome.builders/ar/alttbyqat-ala-rome/bridge-api.md) (CCTP). ستحتاج إلى بعض ETH على Sepolia لمعاملة جهة المصدر — راجع [الحنفيات](https://docs.rome.builders/ar/almward/faucets.md) لكل صنبور.

**كم الكمية؟** الكتابة على Rome تكلف أكثر مما يوحي به حدس Ethereum، لأن معظم رسوم الغاز تُنفق على إنشاء حسابات Solana: مستلم لم يُستخدم من قبل، حساب رمزي جديد، عقد منشور. استخدم `eth_estimateGas`، وهو ما تفعله الأدوات القياسية، ولا تُثبّت 21,000 يدويًا أبدًا. يشمل التقدير إنشاء الحساب، وتفرض Rome رسوم الغاز التي تستخدمها المعاملة فعليًا (في القياسات على Hadrian لم تكن أبدًا أكثر من التقدير)، وميزة SDK الخاصة بـ `submitRomeTx` ترفع التقدير بنسبة 1.3x كهامش أمان، وهو ما لا يكلف شيئًا لأنك تُحاسَب فقط على الغاز المستخدم. موّل ما لا يقل عن **0.5 USDC من الغاز**؛ 1 USDC يترك هامشًا مريحًا. الأرقام في [دعم JSON-RPC](https://docs.rome.builders/ar/almrja/json-rpc.md) تُظهر تكلفة كل عملية كتابة على حدة.

إذا فشل إيداع من جهة Solana مع تحذير "insufficient SOL" رغم تمويل المحفظة، فاضبط محفظة Solana على وضع Testnet / Devnet (انظر [الأسئلة الشائعة](https://docs.rome.builders/ar/almward/faq.md)).

## 3. أنشئ مشروع Hardhat

```bash
mkdir rome-hello && cd rome-hello
npx hardhat --init
```

اقبل الإعدادات الافتراضية عند الطلب — Hardhat 3، والمجلد الحالي، وقالب TypeScript + Node Test Runner + viem — ودعه يثبّت الاعتمادات. يأتي القالب مع مثال `Counter` لعقد مع اختبارات؛ وهي لا تتعارض مع هذا الدليل.

## 4. اضبط Hardhat لـ Rome

عدّل الملف المُولَّد `hardhat.config.ts` وأضف شبكات Rome بداخله `defineConfig({ ... })`:

```typescript
  networks: {
    hadrian: {
      type: "http",
      chainType: "l1",
      chainId: 200010,
      url: "https://hadrian.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
```

`configVariable("PRIVATE_KEY")` تُستَجلب من البيئة، لذا صدّر المفتاح الخاص لـ MetaMask:

```bash
export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
```

(لأي استخدام يتجاوز مفتاحًا مؤقتًا، يُفضَّل مخزن المفاتيح المشفّر المرفق مع مجموعة الأدوات: `npx hardhat keystore set PRIVATE_KEY`.)

## 5. اكتب عقدًا

أنشئ `contracts/HelloRome.sol`:

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

contract HelloRome {
    string public greeting = "Hello from Solana!";
    uint256 public counter;

    event Greeted(address indexed sender, uint256 count);

    function greet() external returns (string memory) {
        counter++;
        emit Greeted(msg.sender, counter);
        return greeting;
    }

    function setGreeting(string calldata _greeting) external {
        greeting = _greeting;
    }
}
```

## 6. انشر

أنشئ `scripts/deploy.ts`:

```typescript
import hardhat from "hardhat";

async function main() {
  const { viem } = await hardhat.network.connect();
  const publicClient = await viem.getPublicClient();

  const hello = await viem.deployContract("HelloRome");
  console.log("HelloRome deployed to:", hello.address);

  const hash = await hello.write.greet();
  await publicClient.waitForTransactionReceipt({ hash });

  console.log("Counter:", (await hello.read.counter()).toString());
  console.log("Greeting:", await hello.read.greeting());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

انشر على Hadrian:

```bash
npx hardhat run scripts/deploy.ts --network hadrian
```

الناتج المتوقع (سيختلف عنوانك):

```
HelloRome deployed to: 0x09c437e305eeb698e1776cff23ca16c1bb25aabd
Counter: 1
Greeting: Hello from Solana!
```

افتح العنوان المنشور في [المستكشف](https://via-hadrian.testnet.romeprotocol.xyz/) لرؤية معاملتك، واتبع رابط "Settled in" إلى معاملة Solana التي سوّتها. أصبح عقد Solidity الخاص بك يعمل الآن على Solana.

## ما التالي

* [انشر Solidity](https://docs.rome.builders/ar/adlh-almtw-ryn/deploy-solidity.md) — النشر باستخدام Hardhat وFoundry بعمق
* [استدعِ Solana من EVM](https://docs.rome.builders/ar/adlh-almtw-ryn/call-solana-from-evm.md) — استدعِ برامج Solana من Solidity عبر CPI
* [المعمارية](https://docs.rome.builders/ar/albda-1/architecture.md) — كيف تنفذ Rome بيئة EVM داخل Solana

## الأخطاء الشائعة

| الخطأ                   | السبب                                                       | الإصلاح                                                                                                                                |
| ----------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `رصد غير كافٍ`          | لا يوجد ما يكفي من رمز الغاز لحد الغاز مضروبًا في سعر الغاز | موّل ما لا يقل عن 0.5 USDC من الغاز (انظر الخطوة 2) باستخدام [جسر روم](https://docs.rome.builders/ar/alttbyqat-ala-rome/bridge-api.md) |
| `nonce منخفض جدًا`      | عدم تطابق nonce للمعاملة                                    | أعد تعيين الحساب (MetaMask → الإعدادات → متقدم → مسح النشاط)                                                                           |
| `تم التراجع عن التنفيذ` | فشل تنفيذ العقد                                             | تحقّق من منطق العقد؛ استخدم `eth_call` للتصحيح                                                                                         |
| انتهاء مهلة الاتصال     | لا يمكن الوصول إلى RPC                                      | تحقّق من عنوان URL الخاص بـ RPC                                                                                                        |


---

# 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/albda-1/quickstart.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.
