> 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/rome-zk-evm/run-a-rollup.md).

# شغّل rollup

سجّل وشغّل سلسلة Rome ZK EVM الخاصة بك على Solana devnet باستخدام مشغّل rollup v0.3.0.

الأسماء `./rollup` يبدأ المُشغِّل سلسلة واحدة مقابل برامج شبكة سولانا التجريبية المشتركة الخاصة بـ Rome. أنت تشغّل عقدتها وتدفع تكاليفها على سولانا. أنت لا تنشر برامج التسوية بنفسك. التسجيل لا يتطلب إذنًا، لكن الجذور المُثبتة تحتاج إلى مفتاح تحقق خاص بالسلسلة تسجله Rome.

تستخدم هذه الصفحة **v0.3.0**الـ [الدليل الكامل للشبكة التجريبية](https://github.com/rome-protocol/solana-zk-evm/blob/v0.3.0/docs/RUN-ON-DEVNET.md) يغطي كل إعداد وخطوة فشل واستعادة.

## قبل أن تبدأ

استخدم جهاز Linux x86-64 مع bash 4 أو أحدث، وGit، وDocker Engine 28 أو أحدث مع Compose، وcurl، وjq، وopenssl، وواجهة Solana CLI، وPython 3.11 أو أحدث. تحتاج إلى نقطة نهاية RPC لشبكة Solana التجريبية، وزوج مفاتيح دافع Solana ممول، وهو أيضًا سلطة السلسلة لديك، ومفتاح توقيع للمُسلسِل. احتفظ بكلا الملفين خاصين وقابلين للقراءة من قِبل المستخدم 999 داخل الحاوية. يشرح الدليل كيفية إنشائهما.

خصص ميزانية تقارب **7 SOL على الشبكة التجريبية** للدافع. يجمّد التسجيل 5 SOL؛ `./rollup check` يتوقع بقاء ما لا يقل عن 1 SOL للنشر والإيجار. يصبح الإيداع قابلاً للاسترداد بعد أول جذر نهائي أو بعد عشرة جذور منشورة. إذا تمت استعادة السلسلة قبل ذلك، يذهب الإيداع إلى الخزانة. وتحتاج السلسلة أيضًا إلى عنوان مستلم رسوم EVM تتحكم فيه.

لتسوية الجذور، تحتاج إلى مضيف إثبات مزود ببطاقة NVIDIA GPU واحدة بذاكرة تزيد عن 30 جيجابايت. بطاقة بسعة 24 جيجابايت صغيرة جدًا لخطوة البرهان النهائية. [مضيف الإثبات](https://docs.rome.builders/ar/rome-zk-evm/prover-host.md) يوفر ميزانية الذاكرة العشوائية والقرص. يمكن للعقدة أن تعمل وتنشر دفعات قبل أن يصبح المُثبِت جاهزًا، لكن لن يكون أي من جذورها نهائيًا.

## ابدأ العقدة

انسخ الإصدار واشتغل من دليل rollup الخاص به:

```sh
git clone --branch v0.3.0 https://github.com/rome-protocol/solana-zk-evm.git
cd solana-zk-evm/deploy/rollup
cp .env.example .env
cp chain.toml.example chain.toml
```

اضبط RPC الخاص بسولانا ومواقع ملفات التوقيع و `ROME_ZK_TAG=v0.3.0` في `.env`. واحتفظ `PROGRAMS_JSON=programs.devnet.json`. اضبط `ROME_ZK_GUEST_TAG=v0.3.0` و `ZISK_RELEASE=1.3.1-alpha` من أجل بناء الضيف لاحقًا. أبقِ RPC مربوطًا بـ loopback للتشغيل المحلي الأول. اترك `PROVER` غير مضبوط حتى يصبح الضيف ومفتاحه جاهزين.

اضبط `genesis.fee_recipient` في `chain.toml` إلى عنوان EVM الخاص بك. لا تختر معرّف سلسلة. تستنتج التسوية واحدًا من الدافع وعدد مرات تسجيله؛ `init` يقرأه قبل إرسال أي شيء. نحو نصف جميع المعرّفات كبيرة جدًا على MetaMask. إذا كان معرّفك من بينها، `init` يتوقف مع `ChainIdNotWalletSafe`؛ أنشئ مفتاح دافع جديدًا، وأشر `PAYER_KEYPAIR_PATH` إليه وشغّل `init` مرة أخرى.

تبدأ السلسلة الجديدة بأرصدة صفرية. إذا أعلنتَ رصيدًا مدعومًا واحدًا للحصول على الغاز قبل فتح الودائع، فاقفل المبلغ نفسه من SOL المغلف في خزنة السلسلة قبل طلب مفتاح التحقق.

```sh
./rollup init
./rollup register --dry-run
./rollup register --confirm
./rollup up
./rollup check
```

`init` يعرض إعدادات genesis والخدمة. `register --confirm` يجمّد وديعة 5 SOL ويُنشئ مؤشر الدفعات. `up` يبدأ عقدة المُسلسِل وbatcher وderive وverifier. `check` يسمّي أي خدمة مفقودة، ثم يقارن معرّف السلسلة، والرؤوس، وتقدم batcher، وصندوق الوارد، والجذور. شغّله مرة أخرى بعد أن تتاح للدُفعات وقت للإغلاق؛ ففحص تقدم الدفعة الأول لا يسجل سوى عينة.

من دون مُثبِت، يقدّم المُسلسِل RPC، وينشر batcher بيانات المعاملات إلى صندوق الوارد، وتعيد derive بناء السلسلة. دفعة صندوق الوارد ليست جذر تسوية نهائيًا. وحتى جذر genesis ينتظر برهانًا.

## الانتقال من الدُفعات إلى الجذور النهائية

ابنِ الضيف لـ genesis الخاص بسلسلتك:

```sh
./rollup guest-build
```

يستخدم البناء ضيف v0.3.0 وZisK 1.3.1-alpha. وينتج برنامج الضيف وبيانات وصفية لمفتاح التحقق الخاص بالسلسلة. يتطلب الحساب `programVK` يحتاج إلى مفاتيح الإثبات الخاصة بـ ZisK ونحو 36 جيجابايت من ذاكرة RAM. تسجيل السلسلة لا يسجل مفتاح تحقق. أرسل [طلب مفتاح التحقق](https://docs.rome.builders/ar/rome-zk-evm/verification-key.md) بعد البناء. تتحقق Rome من genesis والضيف الخاصين بك، ثم تسجل المفتاح مع فتحة تفعيل.

على مضيف الإثبات، اضبط `PROVER=on` وإعدادات الضيف وبيانات التحقق الوصفية وإعدادات ZisK الموضحة في دليل التشغيل الكامل. بعد تفعيل المفتاح:

```sh
./rollup init
./rollup up
./rollup check
```

تحقق من أن `خدمة المُثبِت` و `مفتاح التحقق` العناصر تجتاز الاختبار. يعمل المُثبِت عبر دفعات صندوق الوارد بالترتيب. كل برهان صالح ينشر جذرًا يصبح نهائيًا بمجرد وصول معاملة سولانا الخاصة به.

## أنشئ الكتلة الأولى

من دون رصيد genesis مدعوم، لا تمتلك السلسلة غازًا لمعاملة حتى تُفتح الودائع. تحتاج الودائع إلى جذر مُثبت أولًا. الإعداد الافتراضي `empty_block_interval_secs = 0` يترك السلسلة الخاملة بلا كتل، لذا اضبطه على `60` أقل من `[profile]` في `chain.toml` بعد أن يصبح المفتاح نشطًا ويعمل المُثبِت. أعِد العرض وأعِد التشغيل:

```sh
./rollup init
./rollup up
./rollup check
```

بمجرد أن يصبح الجذر الأول نهائيًا، أعد الفاصل إلى `0` وأعد تشغيل `init` و `up` إلا إذا كنت تريد كتلًا فارغة منتظمة. تشغيلها أثناء انتظار Rome لتسجيل المفتاح يخلق تراكمًا. يجب إثبات كل دفعة بالترتيب.

مع فاصل 60 ثانية للكتل الفارغة وإغلاق الدفعات بعد 60 ثانية، تُنتج السلسلة نحو دفعة واحدة في الدقيقة، أو نحو 1,440 دفعة يوميًا. على الشبكة التجريبية، كلف الجذر المثبت الدافع حوالي **0.003 SOL**: نحو 0.002 SOL كإيجار للحسابات المعلقة، ورسوم تسوية قدرها 0.001 SOL ورسوم معاملة إضافية فوق ذلك. هذا الإيقاع يعادل نحو 4.4 SOL يوميًا قبل تكاليف نشر صندوق الوارد. يبقى إيجار الحسابات المعلقة مقفلاً بالإعدادات الافتراضية. مع إيقاف الكتل الفارغة، لا تسجل السلسلة الخاملة أي دفعات ولا تدفع أي تكاليف للنشر.

لقبول الودائع، أنشئ أولًا الخزنة، ثم فعّل إعدادات الخروج بعد تأخيرها، وافتح قائمة انتظار للإيداع. تلك الأوامر وعمليات التحقق موجودة في [الودائع والسحوبات](https://docs.rome.builders/ar/rome-zk-evm/deposits-and-withdrawals.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/rome-zk-evm/run-a-rollup.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.
