> 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/canton-zk-evm/run-it-locally.md).

# شغّل Ostia الخاصة بك

شغّل عمليات التحقق، والبروفة بدون GPU، والعرض التوضيحي المحلي على GPU، وسلسلة تصمد أمام عمليات إعادة التشغيل، وOstia على مشارك Canton موجود بالفعل.

تُشغّل النصوص البرمجية المرفقة، افتراضيًا، شبكة اختبار محلية. يحتفظ Canton بحالته في الذاكرة، لذا يؤدي كل إعادة تشغيل إلى حذف تلك الحالة وإنشاء شبكة جديدة. يوجد وضعان آخران يُبقيان السلسلة: الوضع الدائم (`CZE_PERSIST=1`) وOstia على مشارك Canton لديك بالفعل، وهي الطريقة التي تعمل بها Ostia DevNet. يثبت عرض GPU الكتل. أما التمرين التجريبي فيستخدم إثباتًا بديلًا ولا يحتاج إلى GPU.

تصف هذه الصفحة الإصدار `v0.1.0`. اقرأ [دليل الشبكة](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/network/README.md) و [دليل العرض التوضيحي](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md). نفّذ الأوامر أدناه من `canton-zk-evm` جذر المستودع.

## المتطلبات

| المهمة                   | المتطلبات                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| فحوصات المستودع          | Docker و `bash`, `curl`, `jq`, `openssl` وPython 3. تستخدم اختبارات Rust `rust-toolchain.toml`.                                              |
| اختبارات تكامل Canton    | Linux x86-64 وJava 21 واتصال بالشبكة.                                                                                                        |
| التمرين التجريبي للعرض   | Linux x86-64 وDocker وJava 21 وRust وPython 3.12 أو إصدار أحدث.                                                                              |
| اختبارات المستكشف        | Node 22.18 أو إصدار أحدث.                                                                                                                    |
| شبكة GPU والعرض التوضيحي | Linux x86-64 ووحدة GPU من NVIDIA مع تثبيت برنامج التشغيل الخاص بها وDocker وRust وPython 3.12 أو إصدار أحدث و `jq`, `curl`, `openssl` وZisK. |

يسرد [ملف README للمستودع](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/README.md#running-the-tests) متطلبات الاختبارات. يستخدم مثبّت GPU `sudo` و `apt` على Debian أو Ubuntu، ويحتاج إلى نحو 100 GB من المساحة الحرة على القرص. وهو يثبّت حزم النظام ويعدّل حدود قفل الذاكرة. وتثبّت أداة جلب الشبكة Java 21 إذا لم تكن مثبتة. راجع [مضيف مُثبتات Ostia](https://docs.rome.builders/ar/canton-zk-evm/prover-host.md) للاطلاع على الأجهزة التي جرى اختبارها؛ إذ لم يُحدَّد الحد الأدنى لذاكرة GPU.

## تشغيل الاختبارات

ابدأ بالفحوصات السريعة الواردة في [CONTRIBUTING.md](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/CONTRIBUTING.md#building-and-testing):

```sh
tests/static.sh                  # تتطابق أرقام الإصدارات الأولية وسجلات التكوين والترخيص
tests/refuses_missing_flag.sh    # يرفض تشغيل reth عند غياب الراية أو كونها غير صحيحة
tests/fixtures.sh                # الإثبات المسجّل متّسق
gateway/build.sh --check         # شيفرة البوابة المضمّنة في المستودع هي ما يُترجم إليه Gateway.sol (Docker)
```

يعرض ملف README في المستودع هذه الفحوص أيضًا. ولا يتطلب أيٌّ منها وحدة معالجة رسومية:

```sh
tests/udp_control.sh             # يفشل فحص UDP على حاوية فيها مستمع UDP (من دون reth)
tests/discovery.sh               # يشغّل إصدار reth المثبّت، ويتحقق من عدم وجود أقران له، ثم يوقفه
tests/network_static.sh          # يستخدم reth عبر launch.sh فقط، ويتحقق من إعداد Canton ونتيجة اختبار الدخان المسجّلة
tests/network_checks.sh          # يتحقق من تثبيت إصدار المترجم، ومعرّف DAR، والإيقاف عند استخدام programVK آخر (من دون وحدة معالجة رسومية)
tests/canton_network.sh          # يستخدم إصدار Canton المثبّت وحزمة Daml الفعلية ومعاملة Advance واحدة (Linux x86-64 وJava 21 وPython 3؛ من دون وحدة معالجة رسومية)
gateway/tests/run.sh             # يشغّل البوابة على reth فعلي، مع تعطيل اكتشاف الأقران (Docker وcurl وjq وPython 3 مع الحزم الواردة في demo/requirements.txt)
tests/guest-repro.sh             # يُبنى الضيف في مجلد ثابت واحد كي لا يغيّر مجلد المصدر ملف ELF (باستخدام بدائل لأدوات ZisK؛ وقد نجح الفحص نفسه على ZisK الفعلي بتاريخ 2026-10-04، راجع guest/README.md)
tests/demo_static.sh             # يتحقق من تثبيت إصدارات العرض التوضيحي، ومفتاح التلاعب، وتجاوز ملف genesis، والنتائج المسجّلة (من دون وحدة معالجة رسومية)
tests/demo_explorer_static.sh    # يتحقق من تثبيت إصدارات صور المستكشف، وما يُمرَّر إلى حاويته (من دون Docker)
(cd explorer && npm ci && npm test)  # اختبارات المستكشف باستخدام بدائل وهمية (Node 22.18+؛ يستخدم CI المتغير EXPLORER_NODE_IMAGE في PINS)
(cd guest/rules && cargo test)   # قواعد السلسلة وتجزئتها (يتطلب Rust)
```

## إجراء تدريب تجريبي من دون وحدة معالجة رسومية

```sh
tests/demo_rehearsal.sh          # العرض التوضيحي والمستكشف باستخدام إثبات بديل (Linux x86-64 وDocker وJava 21 وRust وPython 3.12+؛ من دون وحدة معالجة رسومية)
```

يشغّل ذلك reth وCanton وحزمة Daml ومعيار الرموز ومنشئها الفعلية. ويتحقق البرنامج الجانبي من مطابقة مكوّنات البوابة لإثباتات التخزين، بينما يجيب بديل عن استدعاء `verify` . لا يثبت التدريب التجريبي كتلةً ولا يتحقق من إثبات حقيقي عديم المعرفة.

كما يفحص المستكشف والصنبور. ويجب أن يرفض فحص Verify في المستكشف الإثبات البديل. يشرح [ملف README للعرض التوضيحي](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#the-rehearsal) نطاق تغطية التدريب التجريبي.

## بدء الشبكة المحلية على وحدة معالجة رسومية

ثبّت ZisK باستخدام `prover/install.sh` قبل بدء الشبكة. ابدأ reth دائمًا عبر المشغّل المرفق؛ `network/up.sh` يستخدمه.

```sh
network/up.sh       # الأدوات، وبناء الضيف، وreth، والبرامج الجانبية، والمُثبِت، وCanton، والسلسلة
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) network/smoke.sh    # كتلة فارغة واحدة، تُثبت وتُعتمد
network/down.sh
```

`up.sh` يبني الضيف ويرفض أي مفتاح برنامج أو جذر ZisK أو تجزئة قواعد تختلف عن القيم المسجّلة. تتكون الشبكة من مُزامِن واحد وثلاثة مشاركين. يشغّل كل من المشارك المشغّل والمشارك المؤكِّد برنامجًا جانبيًا. ويستضيف المشارك المسمّى users أطراف الاختبار والقارئ.

يعتمد اختبار الدخان كتلة فارغة، ويتحقق من رأس السلسلة وسجل الكتلة لدى القارئ، كما يتحقق من أن reth وضع عليها علامة نهائية. تُحفظ الحالة والسجلات في `state/`أو في `CZE_STATE_DIR` إذا كان مضبوطًا.

## تشغيل حالات العرض التوضيحي الخمس على وحدة معالجة رسومية

استخدم شبكة محلية جديدة للعرض التوضيحي:

```sh
demo/prepare.sh
CZE_GENESIS_FILE=$PWD/state/demo/genesis.json network/up.sh
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) network/smoke.sh      # اختياري: إنشاء كتلة فارغة واحدة أولًا
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) demo/run.sh
network/down.sh
```

ينشئ سكربت الإعداد مفاتيح اختبار وملف genesis ممولًا للتشغيل. ينفّذ العرض التوضيحي كتلة الإعداد والإيداع والدفع والسحب ورفض التخصيص ورفض الإثبات الذي جرى التلاعب به. يتوقف السكربت عند فشل أي فحص، ويكتب نتائجه في `demo/results/`.

لتصدير المصدر من دون `.git`اضبط `CZE_SOURCE_COMMIT` على التجزئة الكاملة للالتزام المستخدم في التصدير. لإضافة الصنبور، يجب إعداد ملف genesis المموّل قبل بدء الشبكة؛ راجع [شغّل المستكشف بنفسك](#run-the-explorer-yourself) أدناه ودليل العرض التوضيحي الكامل.

## احتفظ بالسلسلة بعد إعادة التشغيل

يجب أن تصمد السلسلة التي يستخدمها الناس أمام التعطل أو إعادة التشغيل. `up.sh` ينشئ سلسلة جديدة عند كل تشغيل ما لم تطلب وضع الاستمرارية:

```sh
CZE_PERSIST=1 network/up.sh     # التشغيل الأول: سلسلة جديدة مع الاحتفاظ بها
network/down.sh                 # يوقف كل شيء ويحتفظ بالبيانات
network/restart.sh              # بعد إعادة التشغيل: تعود السلسلة نفسها
network/down.sh --wipe          # يوقف كل شيء ويحذف السلسلة نهائيًا
```

يحتفظ Canton بعُقده في PostgreSQL على 127.0.0.1، باستخدام كلمة مرور تُنشأ على الجهاز وتُخزّن في ملف بصلاحيات 0600. ويحتفظ reth ببياناته في `$CZE_STATE_DIR/reth-data` ويكتب كل كتلة على القرص أثناء استيرادها. `restart.sh` لا ينشئ شيئًا: بل يشغّل قاعدة البيانات وreth والعمليات المساعدة والمُثبت وCanton اعتمادًا على البيانات التي احتفظت بها، وينقل reth إلى الرأس الحالي لـ Canton. ويتوقف إذا أُنشئت قواعد البيانات بإصدار Canton مختلف عن الإصدار المحدد في `PINS`. احتفظ بنسخة احتياطية من قواعد البيانات ومن `reth-data` معًا، بعد إيقاف الشبكة. يتناول [دليل الشبكة](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/network/README.md#keeping-the-chain-across-restarts) جميع الحالات.

## التشغيل على مشارك موجود

يمكن تشغيل Ostia على مشارك Canton موجود مسبقًا، مثل مدقّق Splice على Canton Network DevNet، بدلًا من تشغيله على الشبكة المحلية. وهذه هي طريقة تشغيل Ostia DevNet. `up.sh` ثم يشغّل reth والمُثبت، وشريطًا جانبيًا واحدًا إذا طلبت ذلك، ويهيّئ السلسلة على ذلك المشارك. ولا يشغّل Canton ولا ينفّذ أي تهيئة أولية.

ستحتاج إلى:

* واجهة JSON Ledger API (v2) الخاصة بالمشارك، على هيئة عنوان URL من نوع `https` أو عنوان URL من نوع `http` على الجهاز نفسه.
* ملف رمز مميز لكل واحد من أربعة مستخدمين لواجهة Ledger API: `ADMIN` (يرفع الحزمة وينشئ الأطراف والمستخدمين، لذا لا يحتاج إليه سوى `up.sh` و `setup.py` ) و `OPERATOR`, `CONFIRMER` و `BUILDER` (المستخدمون الذين `setup.py` ينشئهم، `ostia-operator`, `ostia-confirmer` و `ostia-builder`). كل رمز مميز يستخدم HS256، مع الجمهور `https://canton.network.global` ومعرّف المستخدم بوصفه `sub`. Whoever runs the participant makes them. Ostia never makes, prints or stores a token. إنما ينشئها من يشغّل المشارك. لا تنشئ Ostia أي رمز، ولا تطبعه أو تخزّنه.
* خدمة جانبية يمكن للمشارك الوصول إليها، ولا يمكن لأي جهة أخرى الوصول إليها.

الرموز قصيرة الأجل، لذا اكتب كل رمز جديد في الملف نفسه مباشرةً. يعيد المنشئ قراءة ملفه عند كل استدعاء. `setup.py` و `propose.py` يقرآن كل رمز مرة واحدة، لذا ابدأ تشغيلهما برموز حديثة.

أولاً، زوّد المشارك بالسطر الذي يحتاج إليه، كمتغير إضافي ضمن `ADDITIONAL_CONFIG` لحاويته، ثم أعد تشغيله:

```sh
network/external/participant-config.sh <sidecar address> 8085
# يطبع: ADDITIONAL_CONFIG_ZK_EVM=canton.participants.participant.parameters.engine.extensions.canton-zk-evm { address = "<sidecar address>", port = 8085, validate-on-startup = false }
```

عند ضبط `validate-on-startup` على القيمة false، سيظل المشارك يبدأ حتى عندما تكون الخدمة الجانبية متوقفة؛ وعندئذٍ يفشل فحص الكتلة ولا تُعتمد أي كتلة. بعد ذلك، ابدأ السلسلة:

```sh
export CZE_CANTON=external CZE_LEDGER_URL=https://<participant's Ledger API>
export CZE_TOKEN_FILE_ADMIN=... CZE_TOKEN_FILE_OPERATOR=... \
       CZE_TOKEN_FILE_CONFIRMER=... CZE_TOKEN_FILE_BUILDER=...
CZE_PERSIST=1 CZE_SIDECAR_LISTEN=<sidecar address>:8085 network/up.sh
```

`CZE_PERSIST=1` مطلوب هنا، لأن السلسلة تبقى على المشارك، ويجب أن يحتفظ reth بكتله أيضاً. إذا كانت الخدمة الجانبية تعمل على جهاز آخر، فابدأ تشغيلها عليه باستخدام `network/external/sidecar.sh start <sidecar address>:8085` (العنوان الذي يصل المشارك عبره إليها، وليس عنواناً عاماً)، وشغّل `up.sh` من دون `CZE_SIDECAR_LISTEN`. `up.sh` ينشئ بيئة التنفيذ، ويبدأ reth والمُثبِت، ويشغّل `external/setup.py`، الذي يرفع الحزمة، ويخصّص الأطراف، وينشئ المستخدمين بصلاحيات أدوارهم فقط، ويقترح السلسلة. ويمكن تشغيله مرتين دون أي ضرر. `restart.sh` يعيد تشغيل السلسلة، ولا يحتاج إلا إلى رمز المنشئ. `down.sh --wipe` لا يمسّ المشارك: تظل عقود السلسلة موجودة لديه إلى أن يزيلها مشغّله.

تسري على هذا الوضع ثلاث قواعد:

* **لا تكشف واجهة Ledger API أبداً.** إذ يمكنها التصرّف نيابةً عن كل طرف يستضيفه المشارك. أبقها على عنوان الجهاز نفسه أو خلف وكيل يتحقق من هوية مستدعيها.
* **اضبط صلاحيات ملفات الرموز على 0600**، ولا تضعها على أجهزة مشتركة.
* **يمكن لمشغّل المشارك الاطلاع على كل شيء.** يستضيف مشارك واحد جميع أطراف Ostia، لذا يستطيع مشغّله قراءة كل عقد والتصرّف نيابةً عن كل طرف، بما في ذلك حفظ أصول البوابة. وخدمته الجانبية الوحيدة هي المُؤكِّد الوحيد. في Ostia DevNet، يكون هذا المشغّل هو Rome: فهو يشغّل المشارك، أي مدقّق Canton DevNet الخاص به.

## شغّل المنشئ باستمرار

`builder.py once` ينشئ كتلة واحدة. `builder.py run` يواصل إنشاء الكتل:

```sh
python3 builder/builder.py run [--heartbeat-seconds N] [--status-file <path>]
```

ويقرأ [الإعدادات](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md#settings) نفسها التي يقرأها `once`. مع الاستراتيجية الافتراضية، `on_demand`، يُنشئ كتلةً كلما كانت هناك معاملات قابلة للإدراج قيد الانتظار، مع كتلة واحدة قيد التنفيذ في كل مرة افتراضيًا (`--max-in-flight` يزيد هذا العدد). لا تُنشئ السلسلة الهادئة كتلًا ما لم `--heartbeat-seconds N` يطلب كتلة فارغة بعد مرور N ثانية من دون إنشاء كتلة؛ ولا توجد نبضات دورية افتراضيًا. بعد رفض كتلتين متتاليتين، يشتبه المُنشئ في وجود معاملة ويستبعدها مؤقتًا.

لا يعمل سوى مُنشئ واحد في كل مرة؛ `run` و `once` يستحوذان على قفل ويرفضان البدء إذا كان هناك مُنشئ آخر يحتفظ به. تؤدي إشارة الإيقاف إلى إكمال الكتلة الجاري إنشاؤها ثم الخروج. شغّل المُنشئ ضمن مدير خدمات يعيد تشغيله، واضبط مهلة الإيقاف لتكون أطول من المدة اللازمة لإنتاج الإثبات وتلقي رد Canton معًا. إعادة التشغيل آمنة في أي وقت: يعود التشغيل التالي إلى رأس Canton ويرسل معاملات الكتلة المبتورة إلى reth مجددًا. يكتب المُنشئ `status.json` وسجلًا يوميًا في مجلد العمل الخاص به، ويقرأ المستكشف كليهما.

## شغّل المستكشف بنفسك

يعمل المستكشف في حاوية بجوار السلسلة التي يعرضها، على جهاز Linux يعمل عليه Docker. وله قاعدة بيانات PostgreSQL خاصة به، يبدأ تشغيلها عبر `network/explorer-db.sh`، ويملؤها المفهرس من سجلات Canton. يجب تضمين تمويل صنبور التوزيع في التكوين الأولي قبل بدء الشبكة، لذا يأتي `setup` أولًا:

```sh
explorer/run.sh setup           # ينشئ مفتاح صنبور التوزيع وتكوينًا أوليًا ممولًا
CZE_GENESIS_FILE=state/faucet/genesis.json network/up.sh
explorer/run.sh start           # ثم افتح http://127.0.0.1:8088
explorer/run.sh stop
```

`start` يشغّل قاعدة البيانات، ويطبّق عمليات الترحيل، ويبدأ تشغيل المفهرس في حاوية مستقلة، ثم يشغّل المستكشف. إذا لم يكن هناك مفتاح لصنبور التوزيع، فسيكون الصنبور معطّلًا. دفعة الصنبور معاملة تُرسل إلى reth، لذا لا تصبح نهائية إلا عند تشغيل المُنشئ. بدء الشبكة أو المستكشف لا يشغّل المُنشئ. شغّل المُنشئ مرة واحدة قبل `explorer/run.sh start`، أو شغّله `start` مرة أخرى بعد أول تشغيل للمُنشئ؛ فحتى ذلك الحين، لا يوجد لدى المستكشف مجلد عمل للمُنشئ وتظل دورة حياة الكتل فارغة. على شبكة أُنشئت من دون `CZE_PERSIST`, `stop` يحذف أيضًا قاعدة بيانات المستكشف، بما فيها طلبات صنبور التوزيع ومصادر العقود التي تم التحقق منها. أما الشبكة الدائمة فتُبقيها.

يكون `explorer/run.sh start` الافتراضي مع تعطيل التحقق من العقود، ما لم تضبط `EXPLORER_VERIFIER=1` (مع `SOLC_LIST_URL`)، ولا يوفّر `/rpc` ولا استدعاءات قراءة العقود ما لم تضبط `PUBLIC_RPC=1`. تُدرج الإعدادات في ترويسة [explorer/run.sh](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/run.sh).

في الشبكة المحلية المرفقة، لا تتطلب Ledger API تسجيل الدخول. يقرأ المستكشف بصفة الطرف القارئ فقط، لكن يمكن لأي شخص الوصول إلى هذا المشارك قراءة بيانات الأطراف الأخرى لديه أيضًا، لذا لا تمنح الحاوية عنوانًا عامًا هناك مطلقًا. عند استخدام مشارك قائم، زوّد المستكشف بملف رمز مميز بصلاحية 0600 لمستخدم القارئ (`LEDGER_TOKEN_FILE`)، و `LEDGER_URL` الخاص بالمشارك، و `READER_PARTY`. لا يزال الحاوي يستمع على 127.0.0.1؛ ويتطلب استخدام عنوان عام إعداد وكيل خاص بك. يحتوي [دليل المستكشف](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#running-it) على جميع الإعدادات.

## حمّله بمزيج واقعي

`load/mixed` يتضمن مجموعة الأدوات التي تقف وراء التشغيل الذي استمر ساعة واحدة على [بيئة القياس](https://docs.rome.builders/ar/canton-zk-evm/measurements.md). ينشر على سلسلة رموزًا من عدة أنواع، وبورصة لامركزية (DEX)، ورمزًا مقيّد الصلاحيات، وعقدًا للتحويلات الخاصة، ثم يرسل حركة مرور متنوعة من 200 محفظة. يضم ملف [README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/README.md) الخطوات. ستحتاج إلى Docker وحساب يحتوي على نحو 12,000 tROME عند استخدام إعدادات مجموعة الأدوات كما هي. على سلسلتك الخاصة، موّل الحساب في التكوين الأولي. لا يستطيع صنبور DevNet توفير هذا القدر.


---

# 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/canton-zk-evm/run-it-locally.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.
