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

# المستكشف

دليل إلى مستكشف Ostia DevNet المباشر، وحنفيته، وواجهات برمجة التطبيقات الخاصة به، والتحقق من الإثبات في المتصفح.

مستكشف Ostia متاح الآن على [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz). يجمع بيانات EVM من reth مع سجلات Canton لكل كتلة، ويقرأها بصفته طرف القارئ. استخدمه للعثور على كتلة أو معاملة، والتحقق من إثبات في متصفحك، والتحقق من عقد، والحصول على tROME، وقراءة البيانات نفسها عبر واجهة API.

تصف هذه الصفحة الإصدار `v0.1.0` وتوضح، حيثما يُذكر ذلك، ما يشغّله DevNet حاليًا. [الحالة](https://docs.rome.builders/ar/canton-zk-evm/status.md) يحدد اسم الالتزام البرمجي الذي يشغّله DevNet. اقرأ ملف [README الخاص بالمستكشف](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

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

## جولة في الصفحات

| الصفحة             | ما يمكنك فعله فيها                                                                                                                                                                                                                                                                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| الرئيسية           | ابحث برقم كتلة أو معاملة أو عنوان أو معرّف تحديث Canton. اطّلع على أحدث كتلة نهائية، والكتلة قيد الإثبات، والوقت حتى النهائية، ووقت الإثبات، وأحدث الكتل. يعرض شريط الحالة سلامة عقدة EVM وCanton والمنتِج والمُثبِت والصنبور والمدقّق. وتفتح بطاقة وقت الالتزام بـCanton صفحة «المكالمات الخارجية».             |
| الكتل              | اعرض قائمة بالكتل النهائية، وصفِّها لإظهار الكتل التي تتضمن معاملات، ونزّل ملف CSV، وافتح كتلة.                                                                                                                                                                                                                  |
| المعاملات          | اعرض قائمة بالمعاملات وصفِّها لإظهار ما لم يصل إلى النهائية بعد، أو الفاشلة، أو استدعاءات العقود. تعرض المعاملة نتيجتها وكتلتها وتحديث Canton ورسومها ومدخلاتها المفككة وخطًا زمنيًا لمراحل النهائية الأربع.                                                                                                     |
| العقود             | اطّلع على العقود التي تم التحقق منها ومدى استخدامها. تعرض صفحة العقد مصدره الذي تم التحقق منه وABI والأحداث واستدعاءات القراءة والكتابة. تمر استدعاءات الكتابة عبر محفظتك.                                                                                                                                       |
| الرموز             | استعرض رموز ERC-20 وERC-721 وERC-1155، مع حامليها وتحويلاتها. تعرض إحدى علامات التبويب الرموز القادمة من Canton، مثل wTKB وCC.                                                                                                                                                                                   |
| المكالمات الخارجية | اطّلع على كيفية التزام كل كتلة على Canton، مع صف لكل كتلة وحالتها ووقت التسوية وعدد المحاولات. يفتح رابط الترويسة «المكالمات الخارجية» هذه الصفحة. راجع [المكالمات الخارجية](#external-calls).                                                                                                                   |
| الإحصاءات          | اطّلع على الوقت حتى النهائية، ووقت الإثبات، ووقت الالتزام بـCanton، والمعاملات في الثانية، ومعدل النجاح خلال ساعة واحدة أو 6 ساعات أو 24 ساعة أو 7 أيام أو 30 يومًا. تعرض بطاقة أصول Canton كل كمية معروض مقابل ما يحتفظ به كل من الخزنة والبوابة. وتعرض بطاقة المكالمات الخارجية حالة عمليات الالتزام بـCanton. |
| التوائم            | اطّلع على أصول Canton ثنائية الاتجاه على [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins): كمية معروض كل توأم مقابل رصيد الخزنة، وأحدث عمليات القفل والاسترداد.                                                                                                                                           |
| المبادلات          | اطّلع على المبادلات التي أجراها أحد مراكز Canton مع EVM على [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)، وافتح مبادلة للاطّلاع على دفعتها ومطالبتها.                                                                                                                                                 |
| الجسر              | صِل محفظتك، واحصل على tROME تجريبي، وانقل الرموز بين Ostia وCanton باستخدام محفظة Canton الموجودة لديك (يُفعّل ذلك لكل محفظة على حدة؛ وإلى أن يحدث ذلك، يظهر على الزر «قريبًا»). راجع [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md).                                                            |
| الصنبور            | اطلب tROME، أو سجّل الدخول باستخدام GitHub للحصول على منحة الباني البالغة 100 tROME، وتابع طلبك حتى يصل إلى النهائية.                                                                                                                                                                                            |
| واجهة API          | اقرأ مرجع API المستمد من مستند OpenAPI. يضيف أحد الأزرار Ostia DevNet إلى محفظتك.                                                                                                                                                                                                                                |

تحتوي الترويسة على مربع بحث في كل صفحة باستثناء الصفحة الرئيسية التي لها مربعها الخاص؛ ويؤدي المفتاح `/` إلى التركيز عليه. يمكن تنزيل الكتل والمعاملات ومعاملات العنوان وتحويلاته وتحويلات الرمز بصيغة CSV. تتابع الصفحات تدفقًا مباشرًا، لذا تظهر الكتل الجديدة دون إعادة تحميل. تُفتح صفحات العناوين وأطراف البوابة من الروابط، كما يمكن فتح العناوين من البحث؛ ولا يوجد لها مدخل في الترويسة.

## قراءة كتلة

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

تلخّص أربع بطاقات أرقام الكتلة: المعاملات، ووقت الإثبات، والالتزام بـCanton (المدة من إرسال الكتلة إلى وقت تسجيلها في Canton)، والمدة من إنشاء الكتلة إلى وصولها إلى النهائية. تُحتسب بطاقتا الالتزام بـCanton في صفحتي الرئيسية والإحصاءات من الإرسال حتى استلام المُنشئ رد Canton، لذا تكون قيمتهما أعلى من قيمة هذه البطاقة. وتسرد لوحة «كيف وصلت هذه الكتلة إلى النهائية» الخطوات وأوقاتها.

الكتلة قيد الإثبات لم تُسجّل بعد على Canton. توضح الصفحة ذلك وتُحدّث نفسها إلى أن تصبح الكتلة نهائية. قد تكون المعاملة قيد الانتظار أو قيد الإثبات أو نهائية. وتسرد صفحة الكتلة أطراف البوابة كما سجّلها EVM. `BlockRecord` لا يتضمن كيفية تسوية كل ساق على Canton، لذا لا يستطيع المستكشف عرض ذلك. راجع [الأرجل والحفظ](#legs-and-custody) للأرجل النشطة على DevNet.

## الأرجل والحفظ

أرجل البوابة نشطة على DevNet، وتشغّلها Rome باستخدام أطراف اختبار (راجع [الإيداعات والسحوبات والمدفوعات](https://docs.rome.builders/ar/canton-zk-evm/deposits-withdrawals-payments.md))، لذا أصبحت هذه الصفحات تتضمن محتوى. لم يُضَف لها مدخل في الترويسة بعد؛ افتح [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) مباشرةً، أو انتقل إلى إحدى الأرجل من كتلتها.

* **تعرض القائمة** في `/legs` كل رجل، مع نوعها (إيداع أو دفعة أو سحب) والكتلة والرمز والحساب والمبلغ. افتح إحداها لعرض صفحتها الخاصة على `/leg/<id>`. يذكر السحب طرف Canton الذي دُفع إليه. في 11:54 UTC بتاريخ 2026-10-25، تضمنت القائمة ست أرجل من عمليتي التشغيل في ذلك اليوم (الكتل 780 و783 و784 و1465 و1471 و1473).
* **توفر واجهة API** البيانات نفسها عبر `/api/legs`, `/api/legs/<id>` و `/api/blocks/<number>/legs`.
* **الرمز المغلف** wTKB، على العنوان `0x294d3049874526910a69f6b61da14d10a8b1b3af`، له صفحة رمز كأي رمز ERC-20 (بـ10 منازل عشرية). بلغ معروضه 12 wTKB عند الكتلة 1473، وتأكد تشغيل Rome من أن البوابة تحتفظ بـ12 TKB على Canton.
* **الحفظ مقارنةً بالمعروض.** تعرض صفحة الرمز المدعوم على Canton بطاقة «مدعوم على Canton»: ما تحتفظ به البوابة على Canton إلى جانب معروض الرمز المغلف، وتُقرأ القيم عند الكتلة نفسها، كما أن `GET /api/tokens/<address>` يتضمن الأرقام نفسها في كائن `canton` . لا يُعرض سوى الإجمالي، ولا يُعرض أي رصيد فردي. أصبحت قراءة الحفظ متاحة على DevNet منذ 12:27 UTC بتاريخ 2026-10-25. وفي 12:52 UTC من ذلك اليوم، أظهر wTKB رصيد حفظ قدره 12 TKB موزعًا على حيازين، مقابل معروض مغلف قدره 12 wTKB.

## التوائم وأصول Canton

يعرض المستكشف أصول Canton ثنائية الاتجاه (راجع [الإيداعات والسحوبات والمدفوعات](https://docs.rome.builders/ar/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)). افتح [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins). وتضم الصفحة ما يلي:

* **السجل.** الخزائن التي يسجلها سجل السلسلة، مع تجزئة الشفرة لكل خزانة، والتوائم التي تربطها، مع منازلها العشرية.
* **بطاقة لكل توأم.** معروضه على Canton إلى جانب ما تحتفظ به الخزانة، وتُقرأ القيم عند الكتلة نفسها، مع بيان الكتلة التي حُسبت القيم عندها وعدد عمليات القفل والاسترداد. وتتطابق القيمتان بعد كل عملية قفل واسترداد.
* **الحفظ مقارنةً بالمعروض** لرموز Canton، مثل wTKB وCC: ما تحتفظ به البوابة على Canton إلى جانب معروض الرمز المغلف.
* **أحدث عمليات القفل والاسترداد.** يرتبط كل منها بساقها ومعاملتها وكتلتها وتحديث Canton.
* **خدمة السجل.** سطر يتضمن رابطًا إلى فحص الحالة لخدمة سجل التوائم.

تعرض بطاقة أصول Canton في «الإحصاءات» المعروض نفسه مقابل ما تحتفظ به الخزانة والبوابة، كما أن `GET /api/twins` يوفر الصفحة كاملةً بصيغة JSON. لا تُعرض سوى الإجماليات، ولا يُعرض أي رصيد فردي.

## المكالمات الخارجية

فتح **المعاملات الخارجية** في الترويسة، عند [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton). تُسجّل Ostia كل كتلة كمعاملة واحدة على Canton. ويتحقق الاتصال الخارجي للمشارك المؤكِّد من إثبات الكتلة داخلها؛ وعلى DevNet يكون هذا المشارك هو Rome. تعرض هذه الصفحة تفاصيل كل عملية تسجيل.

**تعرض الترويسة** الإحصاءات الخاصة بجميع الكتل:

* عدد الكتل المسجّلة؛
* معدل النجاح، أي نسبة عمليات التسجيل الناجحة إلى إجمالي المحاولات؛ وقد بلغ 99.99% لجميع الكتل حتى 2026-11-09؛
* زمن التسوية، بمتوسطه وقياسه عند المئين 95، خلال آخر 24 ساعة أو آخر 7 أيام (في 2026-11-09، بلغ نحو 9.1 s و10.7 s خلال 24 ساعة)؛
* عدد عمليات التسجيل التي رفضتها Canton، وعدد الكتل التي سُجّلت بعد إعادة المحاولة؛
* عدد الأرجل التي تمت تسويتها، حسب النوع.

**تتضمن القائمة** صفًا واحدًا لكل كتلة. ويعرض كل صف ما يلي:

* تحديث Canton وكتلة EVM التي يتضمنها، وعدد معاملات EVM التي تمت تسويتها؛
* الحالة: سُجّلت من المحاولة الأولى، أو بعد محاولات إضافية، مع عدد مرات رفض Canton؛
* الخيار `Advance` في عقد `ZkChain` على السلسلة؛
* الأرجل التي سوّتها الكتلة، حسب النوع؛
* زمن التسوية، من بدء إثبات الكتلة حتى وقت تسجيلها في Canton، ووقت التسجيل.

اعرض جميع الكتل، أو الكتل المسجّلة من المحاولة الأولى فقط، أو تلك التي أُعيدت المحاولة بشأنها، أو التي رفضتها Canton مرة واحدة على الأقل، أو التي سوّت أرجلًا. رتّب القائمة من الأحدث إلى الأقدم أو بالعكس. **CSV** ينزّل أول 1,000 صف من العرض المفتوح، وفق ترتيبه، ويُرجع `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` الملف نفسه.

**يؤدي فتح تحديث** إلى صفحة تعرض خطًا زمنيًا (إنشاء الكتلة، بدء الإثبات، اكتمال الإثبات، الإرسال إلى Canton، التسجيل في Canton)، وكل محاولات التسجيل حتى المحاولة التي نجحت، وفحص الإثبات والأرجل التي سوّتها الكتلة. وتظهر بجانب الفحص مقارنة المستكشف نفسه للإثبات بالقيم المثبّتة. تأتي الحقائق من سجل Canton ومن سجل المنشئ نفسه (وتضع الصفحة وسم "سجل المُنتِج" على هذه الحقائق)؛ وإذا لم يتضمن السجل كتلةً ما، فتعرض الصفحة ما تحتفظ به Canton وتترك الباقي.

تظهر الإحصاءات الرئيسية في صفحة **الإحصاءات** ضمن بطاقة «المعاملات الخارجية»، كما يوفّرها `GET /api/canton/stats` بتنسيق JSON.

## تحقّق من الإثبات في متصفحك

قراءة القيم من الإثبات لا تعني التحقق منه. يؤدي الضغط على «تحقّق» إلى تنزيل نسخة WebAssembly من دالة `verify` في sidecar وتشغيلها على الإثبات والترويسة والمعاملات المسجّلة.

يتحقق الفحص من إثبات PLONK باستخدام مفتاح البرنامج وإصدار ZisK المثبّتَين. كما يتحقق من أن تجزئة الترويسة تطابق تجزئة الكتلة المثبتة، وأن المعاملات تطابق جذر معاملات الترويسة. وتشترط اللوحة أيضًا أن تطابق تجزئة الكتلة تجزئة reth للكتلة.

تأتي القيم المثبّتة المتوقعة من استجابة الحالة الخاصة بالمستكشف. ينفّذ «تحقّق» فحص الكتلة في sidecar؛ ولا ينفّذ فحص `legs` المنفصل. ويظل الزر معطّلًا أثناء إثبات الكتلة. وبعد الفحص، تعرض اللوحة النتيجة والمدة وحجم تنزيل الوحدة. ولا تشمل المدة وقت التنزيل. راجع [ملف README الخاص بأداة التحقق في المتصفح](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/verify/README.md).

## استخدم صنبور tROME

يوزّع الصنبور 1 tROME لكل طلب، لأي شخص. وtROME هي العملة التجريبية لشبكة Ostia DevNet ولا قيمة لها. افتح صفحة الصنبور، أو أرسل `POST /api/faucet`. الحدود هي:

* طلب واحد لكل عنوان كل 24 ساعة؛
* طلبًا واحدًا لكل عنوان IP كل 10 دقائق؛
* 5,000 عملية صرف في الساعة عبر جميع العملاء.

يُدرَج الطلب في قائمة الانتظار فورًا، ويُجاب عنه بتذكرة. يوزّع الصنبور مستحقات القائمة على دفعات تصل إلى 100، ويصلك المبلغ بعد إقرار كتلته نهائيًا. `GET /api/faucet/ticket/<id>` يوضّح موضع طلبك. تُحفَظ الحدود في قاعدة البيانات، لذا لا تؤدي إعادة التشغيل إلى تصفيرها. اقرأ [قسم الصنبور](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet) للاطلاع على التفاصيل.

**منحة المطوّرين.** يحصل المطوّر الذي يسجّل الدخول باستخدام GitHub على 100 tROME بدلًا من 1. أدخل عنوانك في صفحة Faucet واختر "تسجيل الدخول باستخدام GitHub" في السطر "هل تبني على Ostia؟ سجّل الدخول باستخدام GitHub لتحصل على 100 tROME." يعيدك GitHub إلى الصفحة، التي تتابع منحتك حتى إقرارها نهائيًا. يجب ألا يقل عمر حساب GitHub عن 30 يومًا. يحصل كل حساب GitHub وكل عنوان على منحة واحدة كل 7 أيام، ويقدّم الصنبور 200 منحة كحد أقصى يوميًا للجميع. لا تطلب الصفحة من GitHub أي أذونات. [شبكة Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#the-builder-grant) تتضمن الخطوات والحدود.

## استخدام واجهات API

واجهات API الثلاث مفتوحة ولا تتطلب مفاتيح. تُطبّق الحدود لكل عميل.

| واجهة API                                  | العنوان    | الحد                                             |
| ------------------------------------------ | ---------- | ------------------------------------------------ |
| JSON-RPC، الكتل النهائية فقط، عبر HTTP فقط | `/rpc`     | 300 طلب في الدقيقة، وبحد أقصى 20 طلبًا في الدفعة |
| REST، موصوفة في `/api/openapi.json`        | `/api/...` | 20 طلبًا في الثانية، مع دفعات مفاجئة تصل إلى 60  |
| متوافقة مع Etherscan                       | `/api`     | 10 طلبات في الثانية و600 طلب في الدقيقة          |

لا يدعم RPC اتصالات WebSocket ولا عوامل التصفية، لذا استطلع `eth_getLogs`. `GET /api/stream` هو البث المباشر الذي تستخدمه الصفحات. `GET /api/status` يعرض معلومات السلسلة ومفتاح البرنامج المثبّت وحالة كل جزء.

للتحقق من مصدر عقد، استخدم `forge verify-contract` مع أداة التحقق من Etherscan:

```sh
forge verify-contract <address> src/Counter.sol:Counter \
  --chain-id 770101 \
  --evm-version london \
  --verifier etherscan \
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \
  --etherscan-api-key any
```

استخدم إصدار المترجم وإعدادات المُحسِّن وإصدار EVM نفسها المستخدمة عند النشر. يمكنك إرسال 30 عملية تحقق في الساعة. قد يتلقى العقد الذي يضم ملفات مصدر كثيرة خطأ HTTP 413 من forge، لأن forge يرسل مدخلاته بترميز url-encoded، ولأن الوكيل الأمامي للمستكشف يحدّ حجم الطلب إلى نحو 300 KB. راجع [التحقق من عقد كبير](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [البناء على Ostia](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md) يتناول النشر؛ أما [حدود المعدل](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) فمذكورة في ملف README الخاص بالمستكشف.

## ما الذي يمكن لطرف القراءة الاطلاع عليه

يقرأ المستكشف Canton بصفته طرف قراءة باستخدام رمز مميّز للقراءة فقط. يطّلع هذا الطرف على سجل الكتلة، ولا يرى أي شيء آخر في حزمة Daml الخاصة بـOstia. ويمكنه رؤية رقم كل سجل وتجزئته وتجزئة السجل السابق والرأس والمعاملات وإثباتها، ومعرّف التحديث ووقت التسجيل والموقّعين الاثنين. ولا يمكنه الاطلاع على طلبات الإيداع أو موافقات السحب أو شروط الدفع، لذا لا يظهر أي منها في المستكشف.

تأتي أرصدة البوابة من عميل ثانٍ للقراءة فقط، يقرأ بصفته طرف البوابة. ويعرض هذا العميل الإجماليات: بطاقة "مدعوم على Canton"، وصفحة `/twins` وبطاقة أصول Canton في الإحصاءات و `GET /api/twins`كما يقرأ صفقات المنصة والمطالبات المموّلة الكامنة وراء `/swaps` و `GET /api/swaps`، مع الإبقاء على الدفعة والمطالبة وتحديثاتهما على Canton، وحذف أطراف Canton الخاصة بمكان التداول والبائع.

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

لتشغيل مستكشفك الخاص وقاعدة بياناته، راجع [شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.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/explorer.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.
