> 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/build-with-canton.md).

# الإنشاء مع كانتون

ما الذي يمكنك استهدافه على أوستيا إلى جانب عقود EVM العادية، وأجزاء كانتون التي يمكنك البناء بها، وما الذي يمكنك القيام به بنفسك على DevNet اليوم وما الذي يشغّله Rome.

تشغّل Ostia عقود EVM العادية، كما تتصل بـCanton. وتُسمّى الطلبات الموجّهة إلى Canton ضمن الكتلة «أرجلًا»، وتُعتمد في معاملة Canton نفسها التي تُعتمد فيها الكتلة. تعرض هذه الصفحة الأهداف المتاحة، والمكوّنات التي تقوم عليها، والجهات القادرة على استخدامها اليوم على DevNet.

يتوفر رمز كل مكوّن في المستودع المفتوح، [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm)، بموجب ترخيص Apache 2.0.

| الهدف                                                      | ما هو                                                                | المتاح اليوم على DevNet                                                                                                                                                                   |
| ---------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [عقود EVM](#evm-contracts)                                 | تطبيقات Solidity، تُنشر باستخدام الأدوات التي تستخدمها على Ethereum. | تقوم بذلك بنفسك.                                                                                                                                                                          |
| [Canton Coin في عقودك](#canton-coin-in-your-contracts)     | Canton Coin بوصفها CC ERC-20.                                        | تقوم بذلك بنفسك، باستخدام [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md).                                                                                                 |
| [رمز EVM على Canton بنسخة توأم](#erc-20-twins-on-canton)   | رمز ERC-20 له نسخة توأم، وهي رمز CIP-0056.                           | تشغّله Rome باستخدام WtROME (من tROME) وTKA. ينقلها الجسر إلى محفظة Canton عند تفعيل المحافظ. لا تحتفظ أي محفظة Canton خارجية بنسخ توأم حتى الآن. وتتولى Rome تسجيل النسخ التوأم الجديدة. |
| [المدفوعات مع أطراف Canton](#payments-with-canton-parties) | دفعة ERC-20 تنفّذ تخصيصًا على Canton ضمن المعاملة نفسها.             | تشغّله Rome باستخدام أطراف اختبار؛ ولا يمكنك تشغيله بنفسك على DevNet.                                                                                                                     |
| [منصة تداول على Canton](#a-canton-venue)                   | تطبيق Daml يستبدل رمز Canton برمز ERC-20.                            | تشغّل Rome منصة التداول؛ وقد شُغّلت مرة واحدة. ولا يمكنك تشغيل منصة تداول على DevNet.                                                                                                     |
| [شبكتك الخاصة](#your-own-network)                          | المكدس بأكمله على شبكة Canton محلية.                                 | تقوم بكل ذلك بنفسك.                                                                                                                                                                       |

## عقود EVM

انشر باستخدام Foundry أو Hardhat، وتحقّق من المصدر في المستكشف، واتصل باستخدام viem أو ethers. [البناء على Ostia](https://docs.rome.builders/ar/canton-zk-evm/build-on-ostia.md) يتضمن الخطوات، و [Ostia DevNet](https://docs.rome.builders/ar/canton-zk-evm/devnet.md#limits) يوضح القيود. وقد شُغّلت على Ostia عقود ERC-20 وERC-721 وERC-1155، ورمز بصلاحيات ERC-3643، وUniswap V2، والعقود التي تتحقق من براهين TACEO Merces. كما نُشر مستهلك أسعار RedStone وتم التحقق منه.

## Canton Coin في عقودك

عملة Canton Coin على Ostia هي رمز ERC-20 عادي يضم 10 منازل عشرية، وعنوانه `0x4db3dea7c13116961fd3e438542ccfcca61a7547`. يمكن لأي عقد الاحتفاظ بها وتحويلها. وتدعمها حيازة البوابة لها على Canton بنسبة واحد إلى واحد، ويعرض المستكشف الأصلين جنبًا إلى جنب في [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) وفي `GET /api/twins`.

يمكنك الحصول على CC بإيداع Canton Coin في صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) ، واستعادة Canton Coin بسحبها. وتتيح الصفحة 20 من عملات Canton Coin الاختبارية يوميًا.

## نسخ ERC-20 التوأم على Canton

تدفع رمز ERC-20 إلى الخزنة، ويحتفظ طرف Canton بالمقدار نفسه من نسخته التوأم. والنسخة التوأم رمز CIP-0056 بمعرّف الأداة `erc20:<token address>`. عند الاسترداد، تُحرق النسخة التوأم ويُعاد رمز ERC-20 إلى عنوان على Ostia.

**من يحتفظ بالنسخ التوأم اليوم.** تطبّق النسخ التوأم معيار CIP-0056، لكن ذلك لا يعني ظهورها في كل محفظة Canton. يمكن للطرف الاحتفاظ بنسخة توأم بعد أن يفحص كل مدقّق يستضيفها ويعتمد `ostia-twin` بالإصدارين 0.1.0 و0.2.0، كما يجب على الطرف الذي يتلقى قفلًا أن يوقّع أيضًا على `TwinAcceptance`لمرة واحدة. اليوم، لا يستوفي هذه الشروط سوى الأطراف التي تديرها Rome. ولا تحتفظ أي محفظة Canton خارجية بالنسخ التوأم أو ترسلها حتى الآن.

**اربط محفظة Canton الخاصة بك: جاهزة، لكنها غير مفعّلة بعد.** تربط صفحة Bridge محفظة Canton التي تملكها بالفعل، وقد أُوقف حساب Bridge الذي يُنشأ بتوقيع المحفظة في 2026-11-17. يُفعَّل الربط لكل محفظة على حدة، من دون موعد محدد. ويتوقف ذلك على ثلاثة أمور يقرّرها مطوّرو المحافظ والمدقّقون: يراجعون حزمة Daml تابعة لجهة خارجية قبل أن تسمح بها محفظتهم، وتحظر بعض قواعدهم أسماء الحزم التي تبدأ بـ `canton-` (اسم حزمة سلسلتنا هو `canton-zk-evm`)، كما يجب أن تحتوي عقد التحقق التي تستضيف الأطراف التابعة للمحفظة على حزم Ostia. وحتى ذلك الحين، لا يمكن لأي محفظة Canton خارجية إجراء أي عملية على Bridge. في DevNet، الأصلان التوأمان هما TKA وWtROME، والخزنة موجودة على `0x69f13a94f986021f1a7650eb611bf9b717aa495a`.

تستجيب خدمة سجل الأصول التوأمة على `https://ostia.devnet.romeprotocol.xyz/twin-registry` (على سبيل المثال `GET /twin-registry/healthz`). ولا تحتفظ بأي مفتاح.

| استدعاء                                                                        | ما الذي يوفّره                                                                                                                                                       |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /healthz`                                                                 | الأصول التوأمة والخزائن.                                                                                                                                             |
| `GET /twin/v1/twins`                                                           | رمز كل أصل توأم ومعرّف الأداة المالية وخزائنه.                                                                                                                       |
| `GET /registry/...`                                                            | واجهة API لسجل معيار الرمز: البيانات الوصفية للأصل التوأم، ومصنعا التحويل والتخصيص، كي تتمكن محفظة اجتازت عقد التحقق التابعة لها مراجعة حزمة الأصل التوأم من إرساله. |
| `POST /twin/v1/lock-parts` مع `{"receiver": <Canton party id>, "ref": <text>}` | معرّف القفل والخزائن المسجّلة، ليستخدمها الدافع في عملية القفل.                                                                                                      |

يوقّع مستلم القفل `TwinAcceptance` مرة واحدة. ومن دونه، يجيب السجل بالرمز 409، ويستبعد المنشئ القفل من الكتلة قبل إثباتها، وبذلك يبقى رمز ERC-20 لدى الدافع. وتوقّع محفظة Canton التي تربطها بصفحة Bridge إقرار القبول ضمن عملية الاشتراك الاختياري. ويتحقق الدافع بنفسه من معرّف القفل ومن بصمة SHA-256 لـ `lock,<receiver>,<ref>`، ويأخذ عنوان الخزنة من مصدر يثق به.

يمكنك التحقق من أن الخزنة هي النسخة المبنية التي خضعت للمراجعة. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` يعطي `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`، وهي أيضًا بصمة الشيفرة التي يعرضها `GET /api/twins` .

حاليًا، لا تسجّل الأصول التوأمة والخزائن على DevNet سوى Rome. لطلب إنشاء أصل توأم لرمز ERC-20 خاص بك، افتح بلاغًا في [المستودع](https://github.com/rome-protocol/canton-zk-evm/issues) أو اسأل في [Discord الخاص بـ Rome](https://discord.gg/vZ9rnCdNSB)؛ وتتخذ Rome القرار بحسب كل حالة.

## المدفوعات مع أطراف Canton

يستدعي دافع EVM الدالة `pay`. وقد وقّع الدافع والمتلقي في Canton على `DvpTerms` التي تحدد التخصيص ومعرّف الدفعة ورمز EVM والمتلقي في EVM والمبلغ. وفي معاملة واحدة على Canton، تُثبَّت الكتلة ويُنفّذ التخصيص، لذا لا يُعد أيٌّ منهما نهائيًا دون الآخر. وقد نُفّذ ذلك على DevNet في الكتلتين 783 و1471. [الإيداعات والسحوبات والمدفوعات](https://docs.rome.builders/ar/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) تتضمن القواعد.

على DevNet، تنفّذ أطراف Rome التجريبية هذه المدفوعات. لا تنفّذها صفحة Bridge؛ فهي تنفّذ عمليات الجسر الأربع. لتنفيذ مدفوعات مرتبطة بتخصيص بين أطراف Canton التي تملكها، شغّل شبكتك الخاصة (أدناه).

## منصة تداول على Canton

السوق هو تطبيق Daml ينفّذ صفقة بين بائع على Canton ومشترٍ على EVM. وتتألف مكوّناته من:

* `otc-venue` 0.1.0، في [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc)، يحتفظ بـ `TradeOffer` و `Trade`. يعتمد فقط على معيار الرموز CIP-0056، ولا يحدد سلسلة بعينها، لذا يمكن لأي منصة تداول استخدامه. وتعرض `Trade` للبائع طلب تخصيص في محفظة معيارية.
* تحتوي حزمة Daml الخاصة بالسلسلة (الإصدار 0.4.0 وما بعده، مع تثبيت الإصدار 0.5.0) على `VenueTrade` و `FundedClaim`. توقّع المنصة والبائع على `VenueTrade` لكل صفقة.
* يدفع المشتري عبر البوابة. ويُنفَّذ تخصيص البائع في معاملة Canton نفسها التي تتم فيها عملية الدفع، ثم يطالب المشتري بالرمز المغلّف باستخدام `FundedClaim`.

شُغّل على DevNet في 2026-10-27 الساعة 15:55 بالتوقيت العالمي المنسق: استُبدل رمز Canton ‏TKB برمز ERC-20 ‏TKA. يظهر دفع المشتري في الكتلة 16816، ضمن تحديث Canton واحد، وتظهر مطالبة المشتري في الكتلة 16823. واستُبعد دفع يقل عن مبلغ الصفقة من الكتلة 16834 ولم ينقل أي شيء. يعرض المستكشف عمليات المبادلة على [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)، ويعيد `GET /api/swaps` هذه العمليات.

على DevNet، يبدأ تشغيل المنشئ بهوية الطرف الخاص بالمنصة، لذا يضيف Rome منصة تداول. أوامر تنفيذ المبادلة موجودة في العرض التوضيحي للمستودع، سواء لشبكة محلية أو لتشغيلك الخاص. ومن المخطط إضافة خطوة يقترح فيها البائع الصفقة قبل إطلاق الشبكة الرئيسية.

## شبكتك الخاصة

[شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md) يبدأ تشغيل شبكة Canton محلية والمكدس الكامل: السلسلة، والمُثبِت أو البديل عنه، والبوابة، والمستكشف. يمكنك تشغيل كل المكونات المذكورة أعلاه بنفسك عليها، باستثناء Canton Coin التي تتطلب مدقّقًا في Canton Network؛ لذلك، شغّل Ostia على مشارك المدقّق الخاص بك (راجع [شغّل نسخة Ostia الخاصة بك](https://docs.rome.builders/ar/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)). استخدم الأطراف الخاصة بك ومنصة التداول الخاصة بك.

يرى تطبيق Daml مراحل المعاملة التي يوقّع عليها. ويمكن لأي شخص الاطلاع على جميع المراحل عبر `GET /api/legs` في المستكشف.

## الخطوات التالية

* [حالات الاستخدام](https://docs.rome.builders/ar/canton-zk-evm/use-cases.md): ما تتيحه هذه المكونات اليوم.
* [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md): صفحة المتصفح الخاصة بالتحركات الأربع والإرسال عبر Canton.
* [كيف يعمل](https://docs.rome.builders/ar/canton-zk-evm/how-it-works.md): كتلة من المعاملة إلى اعتماد 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/build-with-canton.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.
