> 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/how-it-works.md).

# كيف يعمل

تتبّع كتلة Ostia واحدة من reth عبر الإثبات حتى اعتمادها في Canton.

يعمل المُنشئ باستمرار. ويُنشئ كتلة كلما انتظرت المعاملات، ثم يثبتها ويرسلها إلى Canton. الإعداد الافتراضي في الشيفرة هو وجود كتلة واحدة قيد التنفيذ في كل مرة، بينما يشغّل DevNet ما يصل إلى كتلتين، مع مُثبت واحد يعمل على GPU. ومع ذلك، تُعتمد الكتل على Canton بالترتيب. في DevNet، إذا لم تُنشأ أي كتلة لمدة 60 ثانية، ينشئ المُنشئ كتلة فارغة، أي نبضة دورية (وهذا الخيار معطّل افتراضيًا في الشيفرة)، حتى تُنشئ السلسلة الهادئة كتلةً تقريبًا مرة كل دقيقة. ويقرر Canton ما إذا كانت كل كتلة ستصبح الرأس التالي للسلسلة. تُعتمد كتلة EVM وعمليات Canton التي سجّلتها ضمن المعاملة نفسها.

تصف هذه الصفحة الإصدار `v0.1.0` وتوضح، حيثما أشارت إلى ذلك، ما يشغّله DevNet حاليًا. [الحالة](https://docs.rome.builders/ar/canton-zk-evm/status.md) يحدّد الالتزام البرمجي الذي يشغّله DevNet. اقرأ [التصميم](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md). لتتبّع معاملتك عبر هذه الخطوات، انتقل إلى [من معاملتك إلى اعتمادها نهائيًا على Canton](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["معاملات EVM"] --> Q["RPC عام: يعرض الكتل النهائية فقط"]
    Q --> R["reth ينشئ الكتل عند الطلب"]
    R --> B["يقرأ المُنشئ عمليات البوابة ويعثر على عقود Canton الخاصة بها"]
    B -->|"تعذّر تسوية إحدى العمليات: استبعد معاملتها وأعِد البناء"| R
    B -->|"يمكن تسوية جميع العمليات"| P["يثبت ZisK الكتلة"]
    P --> A["التقدّم: الكتلة والإثبات والعمليات ضمن معاملة واحدة على Canton"]
    A --> S["استدعاء خارجي: تتحقق البرامج الجانبية من الإثبات وحالة البوابة"]
    S --> D["يتحقق Daml من الرأس ويسوّي العمليات"]
    D --> C["يعتمد Canton الكتلة وعملياتها معًا"]
    C --> F["يضع reth علامة نهائي على الكتلة"]
    F --> Q
    C --> X["يقرأ مفهرس المستكشف سجل الكتلة ويتحقق منه بمقارنته مع reth"]
```

## البناء انطلاقًا من رأس Canton

ترسل المحافظ معاملات EVM إلى نقطة RPC العامة، التي تمررها إلى reth. لا تعرض نقطة RPC إلا الكتل النهائية على Canton، لذا تظهر الإيصال بمجرد اعتماد الكتلة نهائيًا. يُبقي المشغّل المرفق اكتشاف الأقران معطّلًا. وينشئ reth كتلة عندما يطلب منه المُنشئ ذلك.

يقرأ المُنشئ أولًا عقد `ZkChain` النشط على Canton. وينقل رأس reth والكتلة الآمنة والكتلة النهائية إلى ذلك الرأس المعتمَد. ويختار المعاملات المعلّقة حسب السعر، مع الحفاظ على ترتيب nonce لكل مُرسِل. ومنذ 2026-10-25، يملأ الكتلة وفقًا لكمية الغاز التي تستهلكها المعاملات، والتي يحسبها reth، لا وفقًا لحدود الغاز التي تعلنها: فكثيرًا ما تعلن المحافظ حدودًا تقارب ثلاثة أضعاف ما تستهلكه فعليًا، واحتساب الحدود المعلنة سيوقف ملء الكتلة عند نحو ثلث سعتها. وتنتهي الكتلة عند بلوغ حد الغاز. كذلك، لا يتيح المُنشئ عادةً لـ reth أكثر من 393,216 بايتًا خامًا من المعاملات على DevNet، لأن عمل المشارك على الكتلة يزداد مع حجمها؛ لكنه يتيح معاملة أولى تتجاوز هذا الحجم، حتى لا تنتظر إلى الأبد. ويطلب المُنشئ من reth بناء الكتلة باستخدام قائمة المعاملات المحددة صراحةً.

تستدعي معاملة EVM التي تتطلب إجراءً على Canton البوابة. وتسجل البوابة عمليةً وتضمّها إلى تجزئة متراكمة للكتلة. ويقرأ المُنشئ أحداث البوابة بترتيب السجل، ويعثر على عقود Canton التي تتطلبها كل عملية.

إذا لم يعد تخصيص ما موجودًا، أو لم يقبل مستلم عمليات السحب، أو كان هناك عقد مطلوب آخر مفقودًا، يستبعد المُنشئ المعاملة والمعاملات اللاحقة لذلك المُرسِل. ثم يعيد reth إلى رأس Canton ويعيد البناء. وتُجرى هذه الفحوص قبل الإثبات. ويسرد [ملف README الخاص بالمُنشئ](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) الفحوص الخاصة بكل عملية.

## إثبات الكتلة

يحفظ المُنشئ الكتلة وشاهد التنفيذ الخاص بـ reth. وتجمع أداة الإدخال الكتلة والشاهد وبيانات التكوين الأولي في مدخلات المُثبِت. ويشغّل ZisK البرنامج الضيف، الذي يتحقق من صحة الكتلة وفقًا للقواعد الثابتة للسلسلة.

يعيد المُثبِت إثباتًا مغلّفًا حجمه 1,344 بايتًا، يلتزم بتجزئة الكتلة. ويرسل المُنشئ `Advance` مع الترويسة والمعاملات والإثبات والعمليات وإثباتات الحساب والتخزين الخاصة بالبوابة عند جذر حالة الكتلة.

## التحقق والتسوية ضمن معاملة واحدة

يشغّل كل مشارك مؤكِّد برنامجًا جانبيًا. ويرسل الاستدعاء الخارجي من Canton الكتلة إلى البرنامج الجانبي لذلك المشارك لإجراء `verify`. ويتحقق البرنامج من الإثبات ومفتاح البرنامج المثبّت وإصدار ZisK وتجزئة الترويسة وجذر قائمة المعاملات.

في Ostia DevNet، يشغّل Rome المشارك الوحيد الذي يستضيف جميع أطراف Ostia، لذا فإن برنامجه الجانبي هو المؤكِّد الوحيد، ويُتحقق من الإثبات بواسطة عقدة Rome نفسها. ويرتّب مُزامِن Canton الكتل ولا يرى الإثبات. وتضم شبكة العرض التوضيحي المحلية مشاركَين مؤكِّدين. [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md) يوضح ما الذي يتغير نتيجةً لذلك.

يتحقق Daml من الإجابة بمقارنتها مع `ZkChain`؛ يجب أن يكون الأصل هو الرأس الحالي، وأن يكون الرقم هو الرقم التالي، وأن يتوافق حد الغاز والغاز المستهلك مع الحد الأقصى. ويقارن Daml الإجابات الواردة من البرنامج الجانبي، لكنه لا يتحقق من إثبات المعرفة الصفرية نفسه.

بعد ذلك، يكتب Daml سطرًا لكل عملية، مستمدًا البيانات من عقود Canton التي تسميها. ويأتي معرّف السحب وعنوان الحارق والمبلغ من المُنشئ؛ وتربطها التجزئة المُثبتة بما سجلته الكتلة. وتتحقق الدالة `legs` من إثباتات حساب البوابة وتخزينها، وتحسب تجزئة هذه الأسطر بالترتيب، ثم تقارن النتيجة بقيمة البوابة في الحالة المُثبتة. ويجب أن تجتاز الكتلة التي لا تتضمن أي عمليات الفحص نفسه باستخدام قائمة فارغة.

يسوّي Daml العمليات بالترتيب وينشئ الـ `BlockRecord` واللاحقة `ZkChain`. تلتزم Canton بهذه التغييرات معًا. إذا فشل أحد الفحوص أو عمليات التسوية، فلن يُعتمَد أي شيء. واستهلاك عقد الحالة الوحيد للسلسلة يجعل Canton المرجع المعتمد لترتيب الكتل. اطّلع على [واجهة Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) و [فحوصات الخدمة المرافقة](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## الخزنة والتوأمان

إلى جانب البوابة الأولى، يسرد سجل السلسلة عقود EVM التي يثق بها، وكل منها بوابة أو خزنة، مع تجزئة شيفرتها. تحمل الكتلة أرجل كل بوابة مسجّلة، وتتحقق Daml من تجزئة شيفرة كل بوابة بمقارنتها بإثبات الحساب الذي تحمله الكتلة. ليس للخزنة أرجل خاصة بها: أقفالها وعمليات تحريرها هي مدفوعات بوابة، وتثق Daml بعنوانها بوصفه المستفيد أو الدافع فيها. ويتحقق المُصدِّق من شيفرة الخزنة قبل قبول الإدخال. وتُضاف الإدخالات الجديدة بالطريقة نفسها التي يُغيَّر بها البرنامج: يقترحها المشغّل والبوابة، ويقبلها المُصدِّق.

الخزنة عقد صغير يحتفظ برموز ERC-20 التي تقف وراء توأمي Canton. وليس لها مالك أو مفتاح أو آلية ترقية. والقفل هو استدعاء عادي للبوابة `pay` تكون فيه الخزنة هي المستفيد. أما التحرير فهو `release(ref, token, to, amount)`، وتدفع الخزنة من خلال البوابة مقابله باستخدام معرّف لا يمكن أن تحمله أي مدفوعات من نوع آخر، ولا تسوّيه Canton إلا مقابل طلب استرداد وقّعه الحائز.

التوأم هو رمز على Canton يقابل رمز ERC-20 واحدًا، وتتولى جهة البوابة إدارته. ويثبّت سجل السلسلة بيانات كل توأم: عنوان الرمز، وعدد منازله العشرية، وعقد القواعد الذي يصدره ويحرقه وينقله. `Advance` لا يصدر توأمًا إلا مقابل قفل ثبّته الإثبات، ولا يحرقه إلا مقابل طلب استرداد موقّع.

توجد خدمة سجل التوأم إلى جانب المُنشئ. ويخبرها الدافع بالمستلم وبـ `ref` قبل الدفع؛ فتجيبه بمعرّف القفل، ويقرأ المُنشئ الأجزاء نفسها لإرفاق القفل بالكتلة. كما توفّر واجهة برمجة التطبيقات الخاصة بسجل معيار الرمز للتوأم، كي تتمكن المحفظة التي تحقّق مدقّقوها من حزمة التوأم من إرساله. ولا تحتفظ الخدمة بأي مفتاح ولا تكتب أي شيء على Canton، كما أن `Advance` يتحقق من أن الأجزاء تعطي المعرّف. اطّلع على [الإيداعات والسحوبات والمدفوعات](https://docs.rome.builders/ar/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) للتعرّف على مسارات العمل.

## عندما ترفض Canton

بعد أن تعتمد Canton الكتلة، يعلّمها المُنشئ على أنها نهائية في reth. وإذا رفضتها Canton، يعيد المُنشئ reth إلى آخر كتلة اعتمدتها Canton، ويرسل معاملات الكتلة المرفوضة إلى مجمّع المعاملات. وتُفحَص أرجلها مجددًا في الكتلة التالية. ويُستبعَد أي دفع سُحبت حصته المخصّصة. وبعد رفض كتلتين متتاليتين، يشتبه المُنشئ في المعاملة المشتركة بينهما ويستبعدها مؤقتًا.

إذا فقد المُنشئ ردّ الإرسال، فقد يظل الأمر معتمدًا. وقبل الإرسال، يسجّل المُنشئ نهاية السجل. ثم يقرأ إكمال الأمر نفسه ابتداءً من تلك النقطة. ويُعدّ الإكمال الناجح اعتمادًا، أما الإكمال الفاشل فيُعدّ رفضًا.

يمكن لرأس Canton تأكيد الاعتماد، لكنه لا يُظهر وحده أن الأمر «لم يُعتمَد». وفي غياب إكمال، لا يقرر المُنشئ أن الأمر «لم يُعتمَد» إلا بعد انقضاء 300 ثانية من وقت Canton (`CZE_RESOLVE_SECONDS`‏). وحتى ذلك الحين، لا ينشئ أي شيء ويُبقي reth على حاله. وترد قواعد الاسترداد هذه في [ملف README الخاص بالمُنشئ](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## من معاملتك إلى نهائيتها على Canton

1. ترسل معاملة إلى نقطة RPC العامة. وتنتظر في المجمّع إلى حين إنشاء الكتلة التالية.
2. ينشئ المُنشئ كتلة بمجرد وجود معاملة منتظرة ومكان شاغر (الإعداد الافتراضي في الشيفرة هو وجود كتلة واحدة قيد التنفيذ، بينما يشغّل DevNet ما يصل إلى كتلتين). وعندما كانت السلسلة مشغولة، كانت كتلة جديدة تتبع سابقتها كل 16.6 ثانية عند الوسيط (خلال 24 ساعة حتى 2026-10-25 01:34 UTC).
3. ينشئ ZisK إثباتًا للكتلة. وخلال فترة الحمل التي استمرت ساعة واحدة في 2026-10-24، استغرق إنشاء الإثبات وسيطًا قدره 9.03 ثانية للكتل التي تضم من 11 إلى 100 معاملة.
4. يُعتمَد سجل الكتلة، مع إثباته، على Canton. وهذا الاعتماد هو ما يجعل الكتلة نهائية، ثم تعرض نقطة RPC العامة إيصال معاملتك.

خلال الساعة نفسها، استغرقت المعاملة وسيطًا قدره 19.5 ثانية من لحظة قبول نقطة RPC لها إلى نهائية كتلتها على Canton، وبلغت المدة 27.1 ثانية عند المئين الخامس والتسعين. ويستغرق الحصول على الإيصال وقتًا أطول مقارنةً بمعظم السلاسل، لذا تحتاج الأدوات التي تنتظره إلى مهلة طويلة.

[تحدّد القياسات](https://docs.rome.builders/ar/canton-zk-evm/measurements.md) كل فترة وتسرد عمليات التشغيل. وفي المستكشف، افتح معاملتك ثم كتلتها للاطّلاع على تحديث Canton الذي يتضمن السجل. [يوضّح المستكشف](https://docs.rome.builders/ar/canton-zk-evm/explorer.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/canton-zk-evm/how-it-works.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.
