> 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/start-here.md).

# ابدأ هنا

نقطة انطلاق لكل قارئ لـ Ostia، مع الأدوات التي تستخدمها وأين تنظر، سواء كنت تبني تطبيقات، أو تتحقق على Canton، أو تشغّل مُثبِتًا، أو تجري تدقيقًا، أو تشغّل Ostia الخاصة بك.

| أريد أن                                                             | ابدأ من هنا                                                                                                                                                              |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| انشر تطبيقًا                                                        | [مطوّرو التطبيقات](#app-builders)                                                                                                                                        |
| تعرّف على ما يمكنك بناؤه باستخدام Canton، وما جرى تشغيله على DevNet | [البناء باستخدام Canton](https://docs.rome.builders/ar/canton-zk-evm/build-with-canton.md) و [حالات الاستخدام](https://docs.rome.builders/ar/canton-zk-evm/use-cases.md) |
| احصل على محفظة وعملة تجريبية                                        | [المستخدمون](#users)                                                                                                                                                     |
| احصل على 100 tROME بصفتك مطوّرًا                                    | [منحة المطوّرين](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#the-builder-grant)                                                                                |
| انقل الرموز بين Ostia وCanton باستخدام محفظة متصفح                  | [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md)                                                                                                           |
| تعرّف على كيفية إتمام تثبيت كل كتلة على Canton                      | [المكالمات الخارجية](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#external-calls)                                                                             |
| اقرأ عن آلية عمل التوائم المتوافقة مع ERC-20 وCanton Coin           | [أصول Canton ثنائية الاتجاه](#two-way-canton-assets)                                                                                                                     |
| شغّل Ostia على مشارك في Canton، أو تعرّف على الجهات التي تؤكد الكتل | [مدقّقو Canton ومشغّلو المشاركين](#canton-validators-and-participant-operators)                                                                                          |
| شغّل مُثبِتًا                                                       | [مشغّلو المُثبِّتات](#prover-operators)                                                                                                                                  |
| تعرّف على ما يعالجه الإثبات وما لا يعالجه                           | [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md)                                                                                        |
| دقّق في الشيفرة                                                     | [المدقّقون والباحثون](#auditors-and-researchers)                                                                                                                         |
| شغّل نسخة Ostia الخاصة بي                                           | [شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md)                                                                               |

توجد الشيفرة كاملةً في مستودع عام واحد، [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm)، بموجب ترخيص Apache 2.0. تشير روابط الشيفرة في هذه الصفحة إلى الفرع الرئيسي؛ [الحالة](https://docs.rome.builders/ar/canton-zk-evm/status.md) يحدّد الالتزام البرمجي الذي يشغّله DevNet. توجد التطبيقات في [`apps/accounts`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/accounts), [`apps/twin`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin) (مع [خدمة السجل](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin/registry)) و [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc). الإصدار [v0.1.0](https://github.com/rome-protocol/canton-zk-evm/releases/tag/v0.1.0) هو الوسم الأول، وقد صدر قبل إضافة التطبيقات.

## مطوّرو التطبيقات

يشغّل Ostia عقود EVM عبر واجهة JSON-RPC باستخدام HTTP على Canton DevNet. لم يخضع لتدقيق أمني، ولا قيمة للعملة التجريبية، وقد يُعاد ضبط DevNet. يشغّل Rome أداة البناء والمُثبِّت والمشارك الوحيد الذي يؤكد الكتل. تختلف بعض السلوكيات عن Ethereum؛ اقرأ [الاختلافات عن Ethereum](https://docs.rome.builders/ar/canton-zk-evm/evm-differences.md) أولًا. تعمل هنا العقود المبنية لـ Osaka أو الإصدارات الأقدم (`london` هدف آمن)، وبخطوات النشر نفسها المستخدمة على Ethereum. اطّلع على [حدود RPC](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#limits) قبل ربط تطبيق موجود.

**الأدوات التي تستخدمها**

* Foundry 1.8: `forge create` للنشر، و `forge verify-contract` مقابل واجهة برمجة التطبيقات المتوافقة مع Etherscan الخاصة بمستكشف الكتل.
* استخدام Hardhat 2 للنشر.
* واستخدام ethers للقراءة والإرسال. وتستخدمه مجموعة التحميل المختلط (`load/mixed`). [البناء على Ostia](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md#viem-and-ethers) يتضمن أيضًا إعدادًا لـ viem.
* محفظة EVM، أُعدّت باستخدام قيم الشبكة أو عبر الزر الموجود في صفحة واجهة برمجة التطبيقات بمستكشف الكتل.
* عقود OpenZeppelin. وقد عملت على Ostia رموز ERC-20 وERC-721 وERC-1155 المبنية عليها، إلى جانب رمز مُصرّح به من نوع ERC-3643 (T-REX) وUniswap V2.
* أرسلت مجموعة التحميل أيضًا تحويلات خاصة إلى عقود Merces التابعة لـ TACEO. أُنشئت براهين Groth16 على العميل، ثم جرى التحقق منها على السلسلة. لم تُشغَّل أي شبكة MPC ولم تتم تسوية أي شيء.

تم توثيق إعداد viem وخطوات المحفظة، لكن لم تُختبر هنا من البداية إلى النهاية. ولم تُجرَّب أدوات EVM الأخرى. لا يدعم RPC اتصالات WebSocket، ولا `eth_newFilter` ولا `eth_subscribe`؛ لذا استخدم الاستطلاع عبر `eth_getLogs`. يظهر الإيصال بعد نهائية الكتلة على Canton، ويستغرق ذلك نحو 10 إلى 30 ثانية.

**أين تجد المعلومات**

* [Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md): معرّف السلسلة، وRPC، وقيم المحفظة، والحدود، والإيقافات والصيانة.
* [الاختلافات عن Ethereum](https://docs.rome.builders/ar/canton-zk-evm/evm-differences.md): PREVRANDAO، ومعاملات البيانات الثنائية الكبيرة، ووقت الكتلة، وغير ذلك.
* [البناء على Ostia](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md): انشر وتحقق باستخدام Foundry أو Hardhat، ثم اتصل باستخدام viem أو ethers.
* [مستكشف الكتل](https://docs.rome.builders/ar/canton-zk-evm/explorer.md): واجهات برمجة التطبيقات، والتحقق من العقود، والصنبور، وصفحة الاتصالات الخارجية.
* [منحة المطورين](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#the-builder-grant): ‏100 tROME للمطورين الذين يسجلون الدخول باستخدام GitHub.
* [البناء باستخدام Canton](https://docs.rome.builders/ar/canton-zk-evm/build-with-canton.md): التوائم، وCanton Coin، والمدفوعات باستخدام أطراف Canton، ومنصة Canton.
* [حالات الاستخدام](https://docs.rome.builders/ar/canton-zk-evm/use-cases.md): ما المتاح اليوم على DevNet أو على شبكة خاصة بك.
* [جرّب Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md): النسخة المختصرة في المستودع.
* [load/mixed](https://github.com/rome-protocol/canton-zk-evm/tree/main/load/mixed): مجموعة الأدوات التي تنشر كل ما سبق. وهي تتضمن البرامج النصية والعقود الخاصة بنا؛ أما استيراد الحزم وخطوة الجلب فيوفّران البقية.

## المستخدمون

**الأدوات التي تستخدمها**

* محفظة أُضيفت إليها Ostia DevNet.
* صنبور عملة الاختبار: ‏1 tROME لكل عنوان يوميًا للجميع، و100 tROME للمطورين الذين يسجلون الدخول باستخدام GitHub. ليس لـ tROME أي قيمة.
* مستكشف الكتل للعثور على معاملتك والتحقق من كتلتها، وفي [الاتصالات الخارجية](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#external-calls)، لمتابعة كيفية تثبيت كل كتلة على Canton.
* صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) لنقل الرموز بين Ostia وCanton، وإرسال الرموز على Canton باستخدام محفظة المتصفح.

**أين تجد المعلومات**

* [Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#add-it-to-a-wallet): إعداد المحفظة.
* [احصل على tROME](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#get-trome): الصنبور و [منحة المطورين](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#the-builder-grant).
* [مستكشف الكتل](https://docs.rome.builders/ar/canton-zk-evm/explorer.md): اقرأ كتلة وتحقق من برهانها في متصفحك.
* [الاستدعاءات الخارجية](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#external-calls): اعتماد كل كتلة في Canton، مع وقت تسويتها.
* [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md): انقل الرموز بين Ostia وCanton باستخدام محفظة Canton التي لديك بالفعل.
* [آلية العمل](https://docs.rome.builders/ar/canton-zk-evm/how-it-works.md#from-your-transaction-to-final-on-canton): المقصود بـ"نهائي"، من معاملتك إلى كتلة Canton معتمدة.

## أصول Canton ثنائية الاتجاه

منذ 2026-10-29، تنتقل الأصول في كلا الاتجاهين. يمكن لرمز ERC-20 على Ostia أن يكون له نظير على Canton: تودع الرمز في الخزنة، ويحتفظ حساب على Canton بالمقدار نفسه، وعند الاسترداد يُعاد إليك رمز ERC-20. ينتقل Canton Coin إلى Ostia على هيئة رمز CC، ويمكن إعادته. وتتيح صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) في المستكشف تنفيذ هذه التحويلات باستخدام محفظة متصفح ومحفظة Canton التي لديك بالفعل، مع تفعيل كل محفظة على حدة. احصل على tROME الاختباري أولًا. يعرض المستكشف معروض كل رمز نظير مقارنةً بما تحتفظ به الخزنة.

**أين تجد المعلومات**

* [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md): صفحة الجسر، والتحويلات الأربعة وأوقاتها المقاسة.
* [الإيداعات والسحوبات والمدفوعات](https://docs.rome.builders/ar/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens): عمليات القفل والاسترداد وCanton Coin.
* [Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#canton-assets-on-devnet): عناوين الخزنة والرموز النظيرة ورمز CC، وخدمة سجل الرموز النظيرة.
* [المستكشف](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#twins-and-canton-assets): صفحة `/twins` .
* [البناء باستخدام Canton](https://docs.rome.builders/ar/canton-zk-evm/build-with-canton.md): استدعاءات سجل الرموز النظيرة، وCanton Coin بصفتها رمز ERC-20، والمدفوعات ومنصة التداول خارج البورصة.
* [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md#what-the-twins-trust): ما تستند إليه الرموز النظيرة.
* [جرّب Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md#canton-twins-and-canton-coin-on-devnet): النسخة المختصرة في المستودع.

## مدقّقو Canton ومشغّلو المشاركين

على Ostia، لا تعتمد Canton كتلةً إلا بعد أن يتحقق منها sidecar بجوار مشارك مؤكِّد. في DevNet، هذا المشارك هو Rome. يشغّل sidecar أداة التحقق ويفحص الإثبات والرأس وجذر المعاملات. وإذا أخفق الفحص، فلا تُعتمد الكتلة.

في DevNet، يستضيف مشارك واحد، وهو Rome نفسه، جميع أطراف Ostia. وsidecar الخاص به هو المؤكِّد الوحيد. لا يؤكّد أي مشارك آخر كتل Ostia DevNet حاليًا. يشغّل مدقّق Rome الإصدار Splice 0.10.1 مع Canton 3.7.2. [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md#local-demo-vs-ostia-devnet) يقارن إعداد المؤكِّد الواحد هذا بإعداد الشبكة المحلية الذي يستخدم مؤكدَين. يمكنك اليوم تشغيل Ostia الخاصة بك على مشارك تديره بالفعل، باستخدام وضع المشاركين الحاليين.

**الأدوات التي تستخدمها**

* خدمة sidecar التي تستدعيها Canton عبر امتداد الاستدعاءات الخارجية.
* أداة التحقق التي تستخدمها لفحص الإثبات المغلّف.
* حزمة Daml التي تحتفظ بالسلسلة وكتلها.
* البرامج النصية لإعداد Ostia على مشارك تشغّله بالفعل.

**أين تجد المعلومات**

* [sidecar/](https://github.com/rome-protocol/canton-zk-evm/tree/main/sidecar): الخدمة التي تستدعيها Canton.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): فحص الإثبات، مكتوب بلغة Rust واضحة.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): حزمة Daml، بما فيها `Advance`.
* [network/README.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/network/README.md#running-on-an-existing-participant-the-canton-network): «التشغيل على مشارك حالي».
* [network/external/](https://github.com/rome-protocol/canton-zk-evm/tree/main/network/external): إعدادات المشارك وsidecar والبرامج النصية للإعداد.
* [شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant): الخطوات نفسها الواردة في هذه الوثائق.
* [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md#operator-confirmer-and-gateway-authority): ما الذي يمكن للمشغّل والمؤكِّد رؤيته وفعله.

## مشغّلو المُثبِّتات

يحوّل مُثبِت الإثبات كل كتلة إلى إثبات يفحصه sidecar لدى المؤكِّد. شغّل ZisK باستخدام عامل GPU واحد. يتكوّن مُثبِت الإثبات في DevNet من جهاز NVIDIA RTX PRO 6000 Blackwell Server Edition واحد (96 GB) على جهاز يضم 48 وحدة معالجة مركزية افتراضية. في DevNet، يشغّل Rome مُثبِت الإثبات الوحيد هذا. هذه البرامج النصية مخصّصة لتشغيل مُثبِت إثبات لنسخة Ostia الخاصة بك.

**الأدوات التي تستخدمها**

* `install.sh` لتثبيت إصدار ZisK المحدد مسبقًا ومفاتيحه.
* `start.sh` لبدء المنسّق وعامل GPU.
* `prove-one.sh` لإثبات مُدخل واحد والتحقق من النتيجة.
* الضيف هو البرنامج الذي يجري إثباته. يُبنى في مجلد ثابت، لذا يمكنك التحقق من أن عملية البناء لديك تنتج البرنامج المسجّلVK.

**أين تجد المعلومات**

* [prover/](https://github.com/rome-protocol/canton-zk-evm/tree/main/prover): السكربتات المذكورة أعلاه، بالإضافة إلى `build-guest.sh`.
* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): الضيف وكيفية التحقق من أن عملية البناء لديك تنتج البرنامج المسجّلVK.
* [مضيف مُثبِت Ostia](https://docs.rome.builders/ar/canton-zk-evm/prover-host.md): متطلبات المضيف، والبناء والتشغيل، وإعادة إنتاج مفتاح الضيف.
* [القياسات](https://docs.rome.builders/ar/canton-zk-evm/measurements.md): أزمنة الإثبات والأجهزة التي أُجريت عليها القياسات.

## المدقّقون والباحثون

**الأدوات التي تستخدمها**

* قواعد السلسلة المضمّنة في الضيف.
* التحقق من الإثبات وشيفرة إثبات التخزين.
* سجل سلسلة Daml وخيار `Advance` .
* عقد البوابة.

**أين تجد المعلومات**

* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): البرنامج الذي يجري إثباته والقواعد التي يفرضها.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): التحقق من الإثبات المغلّف.
* [mpt/](https://github.com/rome-protocol/canton-zk-evm/tree/main/mpt): إثباتات تخزين Merkle-Patricia.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): سجل السلسلة وخيار `Advance`.
* [gateway/](https://github.com/rome-protocol/canton-zk-evm/tree/main/gateway): عقد EVM الوحيد الذي يحدّد لـ Canton ما يتطلبه الحظر.
* [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md) و [ما الذي يجري إثباته وما الذي لا يجري إثباته](https://docs.rome.builders/ar/canton-zk-evm/what-is-proven.md): ما الذي يثبته الإثبات، ومن يتحقق من ماذا.
* [docs/DESIGN.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md) و [SECURITY.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/SECURITY.md): التصميم وكيفية الإبلاغ عن مشكلة بسرية.

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

[شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md) يتناول الاختبارات، وشبكة Canton محلية مزوّدة بوحدة GPU، والنشر على مشارك Canton قائم.


---

# 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/start-here.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.
