> 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/deposits-withdrawals-payments.md).

# الإيداعات، والسحوبات، والمدفوعات

كيف تربط البوابة ودائع EVM وعمليات السحب والمدفوعات بأطرافها في Canton، وكيف تتحرك توائم ERC-20 وCanton Coin في كلا الاتجاهين.

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

تعمل عمليات الإيداع والسحب والمدفوعات على Ostia DevNet، التي تديرها Rome باستخدام أطراف اختبارية. وقد نُفِّذت للمرة الأولى في العرض التوضيحي المحلي بتاريخ 2026-10-05. وفي 2026-10-25، سُجّلت لدى البوابة عملة اختبارية من Canton تُسمّى TKB (العملة الاختبارية المرجعية التي توفّرها Splice)، وأصبح شكلها المغلّف، wTKB، موجودًا على Ostia عند `0x294d3049874526910a69f6b61da14d10a8b1b3af`. ومنذ 2026-11-08، يمكنك إيداع Canton Coin وسحبها بنفسك من صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) في المستكشف؛ راجع [متاح على DevNet](#live-on-devnet) أدناه.

ومنذ 2026-10-29، تنقل البوابة أيضًا أصول Canton في الاتجاهين: يمكن أن يكون لرمز ERC-20 نظير على Canton، كما يمكن نقل Canton Coin إلى Ostia وإعادتها. راجع [نظائر رموز ERC-20 على Canton](#canton-twins-of-erc-20-tokens) و [Canton Coin](#canton-coin).

تحيل معظم الروابط في هذه الصفحة إلى الإصدار `v0.1.0`؛ أما رابط ملف README الخاص بالبوابة فيحيل إلى الفرع الرئيسي. تعمل DevNet الآن بشيفرة الفرع الرئيسي للمستودع، مع حزمة Daml بالإصدار 0.5.0، وتتبع السيقان القواعد نفسها. [الحالة](https://docs.rome.builders/ar/canton-zk-evm/status.md) تحدّد الالتزام البرمجي. لمعرفة ما يمكنك إنشاؤه باستخدام السيقان، راجع [البناء باستخدام Canton](https://docs.rome.builders/ar/canton-zk-evm/build-with-canton.md). اقرأ ملف README الكامل لـ [البوابة](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md) و [واجهة Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md).

| الساق | استدعاء البوابة                  | إجراء EVM                                | إجراء Canton في `Advance`                               |
| ----- | -------------------------------- | ---------------------------------------- | ------------------------------------------------------- |
| إيداع | `claim(id, token, amount)`       | سكّ رموز مغلّفة للمستدعي.                | تنفيذ تخصيص المودِع إلى البوابة.                        |
| سحب   | `withdraw(token, amount, party)` | حرق الرموز المغلّفة الخاصة بالمستدعي.    | دفع رمز Canton من عهدة البوابة إلى الطرف المحدد بالاسم. |
| دفع   | `pay(id, token, to, amount)`     | تحويل رمز ERC-20 من الدافع إلى المستفيد. | تنفيذ التخصيص المحدد في شروط الدفع المتفق عليها.        |

## متاح على DevNet

نُفِّذت عملية إيداع ودفع وسحب على DevNet مرتين بتاريخ 2026-10-25:

| التنفيذ                                                              | إيداع                                   | دفع                                                                                                                | سحب                                            |
| -------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| المرة الأولى، من 08:08 إلى 08:10 بالتوقيت العالمي المنسق             | البلوك 780: دخلت 10 TKB، وخرجت 10 wTKB. | البلوك 783: دفع V إلى U مبلغ 1 WtROME (وهو tROME مغلّف، أي رمز ERC-20 على Ostia) مقابل تخصيص U مقدار 10 TKB إلى V. | البلوك 784: أُحرقت 4 wTKB، ودُفعت 4 TKB إلى U. |
| المرة الثانية، من 11:31 إلى 11:34، باستخدام حزمة Daml بالإصدار 0.2.0 | البلوك 1465.                            | البلوك 1471.                                                                                                       | البلوك 1473.                                   |

كانت كل مرحلة في كتلة مستقلة. وفي كل منها، كان سجل الكتلة والتغيير في الحيازة تحديثًا واحدًا على Canton. بعد التشغيل الثاني، بلغ معروض wTKB مقدار 12، ويمكن لأي شخص الاطلاع عليه على Ostia. وتحقق تشغيل Rome من أن البوابة كانت تحتفظ حينها بـ12 TKB على Canton، بما يساوي ذلك المعروض. ومنذ 2026-10-25، يعرض المستكشف ذلك أيضًا: تتضمن صفحة رمز wTKB بطاقة «مدعوم على Canton» تعرض حيازة قدرها 12 TKB إلى جانب معروض قدره 12 wTKB.

‏U وV طرفان للاختبار أنشأتهما Rome وتشغّلهما على المشارك الخاص بها، وقد نفذت Rome كل خطوة. يمكنك متابعة المراحل في المستكشف: افتح [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) لرؤية القائمة، أو صفحة كتلة للاطلاع على المراحل التي تضمّنتها. يحدد السحب طرف Canton الذي دُفع إليه. وwTKB رمز ERC-20 عادي ذو 10 منازل عشرية، لذا يظهر معروضه وأرصدةه كما تظهر بيانات أي رمز آخر (انظر [المستكشف](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#legs-and-custody)).

تنفذ Rome إيداعًا ودفعًا وسحبًا كل 10 دقائق، وتُراقَب سلامة هذه العمليات كل 30 ثانية.

لإيداع Canton Coin وسحبه بنفسك، صِل محفظة Canton الخاصة بك في صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) في المستكشف، بعد تفعيلها لمحفظتك. وتتيح صفحة الجسر أيضًا قفل tROME وTKA لصالح Canton (أي تنفيذ البوابة لعملية `pay` في الخزنة). أما عمليات الدفع الأخرى وإيداعات TKB في هذه الصفحة، فتُجريها أطراف الاختبار التابعة لـRome.

## إيداع رمز Canton

يخصّص المودِع رمزًا من Canton للبوابة، ويكون المشغّل هو المنفّذ. ويوقّع المودِع على `DepositRequest` الذي يحدد معرّف الإيداع، وعنوان EVM المسموح له بالمطالبة، والتخصيص. ومعرّف الإيداع هو SHA-256 لـ `deposit,<depositor's party id>,<label>`، لذا لا يمكن إلا للمودِع إنشاء معرّف باستخدام معرّف طرفه الخاص.

يستدعي عنوان EVM ذلك `claim`. وتسكّ البوابة الرموز لصالح الجهة المستدعية، وتسجل مرحلة الإيداع. ويحتاج المستلِم إلى tROME لتغطية رسوم الغاز. ويطابق المُنشئ المرحلة مع الطلب والرمز المسجّل والتخصيص.

`Advance` ينفذ التخصيص في حيازة البوابة، ويعتمد الكتلة التي سُكّت فيها الرموز المغلّفة. للرمز المغلّف 10 منازل عشرية، بما يتوافق مع مقادير Canton. والتحويل بين المقدارين دقيق، دون تقريب.

## السحب إلى طرف على Canton

يستدعي حامل الرمز `withdraw` مع الرمز المغلّف والمقدار ومعرّف طرف Canton الكامل. وتحرق البوابة الرموز المغلّفة وتسجل المستلِم في المرحلة.

يجب أن يكون المستلِم قد وقّع على `WithdrawalAcceptance`. ويظل هذا القبول ساريًا إلى أن تتم أرشفته. كما يحتاج المُنشئ إلى حيازات كافية غير مقفلة لدى البوابة من الأداة المسجّلة. وإذا لم تتحقق هذه الشروط، يستبعد المعاملة.

`Advance` يدفع للمستلِم عبر مصنع التحويل في سجل الرموز. ويُعتمد تحويل Canton والكتلة التي تتضمن الحرق معًا. ولا يضمّن المُنشئ أكثر من عملية سحب واحدة لأداة معينة في الكتلة، كما هو موضح في [ملف README الخاص بالمُنشئ](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## ربط عملية دفع بتخصيص واحد

يخصّص الدافع على Canton رمزًا من Canton للمستفيد على Canton. ويوقّع الطرفان على `DvpTerms` الذي يحدد التخصيص ومعرّف الدفع ورمز EVM ومستفيد EVM والمقدار. ومعرّف الدفع هو SHA-256 للنص بترميز UTF-8 `<Canton payer's party id>,<Canton payee's party id>,<label>`، مكتوبًا بصيغة ست عشرية بأحرف صغيرة. وترفض الشروط أي معرّف آخر.

يوافق دافع EVM على استخدام البوابة ثم يستدعي `pay` باستخدام المعرّف والرمز والمستلِم والمقدار المتفق عليها. وتنقل البوابة رمز ERC-20 من ذلك الدافع إلى مستفيد EVM، وتسجل مرحلة الدفع. وفي العرض التوضيحي، كان المستفيد على Canton هو المتحكم بالدافع؛ لكن البروتوكول لا يشترط هذه العلاقة. `Advance` يستخدم الشروط الموقّعة لتنفيذ التخصيص من الدافع على Canton إلى المستفيد على Canton. ويُعتمد دفع ERC-20 ودفع Canton معًا، لذا لا يُعد أيٌّ منهما نهائيًا دون الآخر.

لا يسجل تحويل ERC-20 عادي أي مرحلة. وحتى تحويل الرمز نفسه إلى المستفيد نفسه في الكتلة نفسها لا يمكن أن يحل محل `pay`. ويوضح [تدفق الدفع في التصميم](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#the-flows) كيفية ضمان هذا الربط.

## النسخ النظيرة على Canton لرموز ERC-20

النسخة النظيرة هي الصيغة على Canton لرمز ERC-20 الموجود على Ostia. وهي رمز CIP-0056، معيار الرموز على Canton، وله معرّف الأداة `erc20:<token address>`، وتتم حركته وفق معيار الرمز المميّز، عبر التحويل بين أطراف تحقّق المشاركون فيها من ostia-twin؛ وهذا يعني اليوم حسابات لدى المشاركين في Rome. يقابل كل توأمٍ رمز ERC-20 واحدًا لواحد، وهو الرمز الذي يحتفظ به الخزْن. للرمزين TKA وWtROME (tROME المغلّف) توأمان على DevNet.

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

**الاسترداد.** يوقّع الحائز طلب استرداد على Canton، ثم يُستدعى `release` على الخزْن، مع استخدام `ref`نفسه. يدفع الخزْن رمز ERC-20 إلى عنوان EVM الوارد في الطلب، ويُحرق التوأم في الكتلة نفسها. لا تُسوّي Canton عملية تحرير إلا عند وجود طلب استرداد مطابق.

وفقًا لقواعد السلسلة، لا يُسكّ التوأم إلا ضمن `Advance`، مقابل دفعة مثبتة إلى خزْن مسجّل؛ ويمكن أيضًا لمسؤول التوأم، أي طرف البوابة، أن يسكّ التوأم ويحرقه بنفسه في الوقت الحالي. [نموذج الثقة والقيود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.md#what-the-twins-trust) يوضح ما يستند إليه ذلك.

| الخطوة    | موضع التنفيذ                                           | إجراء Canton في `Advance` |
| --------- | ------------------------------------------------------ | ------------------------- |
| القفل     | بوابة `pay` إلى الخزْن.                                | سكّ التوأم للمستلم.       |
| الاسترداد | `release` على الخزْن، استنادًا إلى طلب الحائز الموقّع. | حرق توأم الحائز.          |

في 2026-10-29، أُدرج قفل بقيمة 5 TKA لصالح طرف في Canton في الكتلة 28389، فأصبح لدى الطرف 5 توائم. وأرسل توأمين إلى طرف ثانٍ على Canton، ثم أُدرج استرداد هذين التوأمين في الكتلة 28392. بعد ذلك، بلغ كل من معروض التوأم ورصيد الخزْن 3. تعرض صفحة [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) في المستكشف معروض كل توأم إلى جانب رصيد الخزْن (راجع [المستكشف](https://docs.rome.builders/ar/canton-zk-evm/explorer.md#twins-and-canton-assets)).

لا يُنشأ القفل إلا لمستلم وافق على قبول التوائم. يوقّع الطرف مرة واحدة موافقته على قبولها، ولا ينشئ المُنشئ قفلًا إلا لطرف وافق على ذلك. يوقّع ربط محفظة Canton في صفحة [الجسر](https://docs.rome.builders/ar/canton-zk-evm/bridge.md) تلك الموافقة ضمن إجراء الاشتراك الاختياري، لذا يمكنك تنفيذ الدورة كاملةً باستخدام طرف خاص بك.

## عملة Canton

تصل عملة Canton إلى Ostia عبر إيداع البوابة نفسه المستخدم لأي رمز مميّز على Canton. يُسجَّل الرمز المغلّف CC (`0x4db3dea7c13116961fd3e438542ccfcca61a7547`، بدقة 10 منازل عشرية؛ وتشير إليه السجلات الأقدم باسم wCC) لدى المصنع الذي يحدّده وكيل المسح الخاص بالمدقّق. يخصّص أحد الأطراف عملة Canton للبوابة ويوقّع طلب إيداع مُعنونًا، ثم يطالب المستلم برموز CC على Ostia، وعند السحب تُعاد إليه عملة Canton. تتطلب عملة Canton مُدخلًا إضافيًا واحدًا، هو سياق اختيار يوفّره وكيل المسح، ويجلبه المُنشئ قبل إثبات الكتلة.

في 2026-10-29، أودع أحد الأطراف 5 من عملة Canton عبر الكتلة 28473، فأصبح رصيده 15، ورصيد البوابة 5، ومعروض CC يساوي 5. أعادت عملية السحب في الكتلة 28474 القيم الثلاث إلى ما كانت عليه: 20 و0 و0. لم تفرض DevNet أي رسوم على هذه التحويلات.

## ما الذي يثبته الإثبات

يسجّل كل مسار نوعه ومعرّفه والرمز المميّز والحساب والكمية وطرف Canton، حيثما ينطبق ذلك. وتحسب البوابة تجزئة للمسارات حسب ترتيبها. `Advance` يتحقق من أن المسارات المرفقة تنتج التجزئة الواردة في حالة البوابة المثبتة. يؤدي غياب أي مسار أو وجود مسار إضافي أو تغيير ترتيبه أو تعديله إلى فشل المعاملة. ويشمل التحقق أيضًا الكتل التي لا تتضمن أي مسارات.

لا يحجز إثبات الكتلة تخصيص Canton. فلا يزال بإمكان المُرسل استرداد التخصيص قبل التسوية. وإذا حدث ذلك بعد الإثبات، ترفض Canton تنفيذ `Advance` ويعود reth إلى آخر كتلة مُعتمدة. ولا يمكن إعادة إرسال الكتلة المُثبتة نفسها بعد إزالة ساقها. ويستبعد البناء التالي عملية الدفع، كما يتضح في [التشغيل 4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## حدود الرموز المميزة والحفظ

توضح الفقرة من يحتفظ برموز Canton، وسلوكيات الرموز التي لا تغطيها البوابة، في [نموذج الثقة والحدود](https://docs.rome.builders/ar/canton-zk-evm/trust-model.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/deposits-withdrawals-payments.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.
