> 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/ru/canton-zk-evm/deposits-withdrawals-payments.md).

# Депозиты, выводы и платежи

Как шлюз связывает депозиты, вывод средств и платежи в EVM с их соответствующими операциями в Canton, а также как двойники ERC-20 и Canton Coin перемещаются в обоих направлениях.

Gateway — это EVM-контракт, включённый в генезис цепочки. Он записывает, какие действия блок должен выполнить в Canton. Каждый запрос — это операция (leg). Доказательство блока фиксирует состояние gateway, включая хеш операций в порядке их записи.

В Ostia DevNet доступны депозиты, выводы и платежи; сетью управляет Rome с тестовыми участниками. Впервые они были запущены в локальной демонстрации 2026-10-05. 2026-10-25 тестовый токен Canton TKB (эталонный тестовый токен, поставляемый Splice) был зарегистрирован в gateway, а его обёрнутая форма, wTKB, существует в Ostia по адресу `0x294d3049874526910a69f6b61da14d10a8b1b3af`. С 2026-11-08 вы можете самостоятельно вносить и выводить Canton Coin на странице [Мост](https://docs.rome.builders/ru/canton-zk-evm/bridge.md) в обозревателе; см. [Работает в DevNet](#live-on-devnet) ниже.

С 2026-10-29 gateway также поддерживает двусторонний перевод активов Canton: токен ERC-20 может иметь двойник в Canton, а Canton Coin можно переводить в Ostia и обратно. См. [Двойники токенов ERC-20 в Canton](#canton-twins-of-erc-20-tokens) и [Canton Coin](#canton-coin).

Большинство ссылок на этой странице ведут на выпуск `v0.1.0`; ссылка на README gateway ведёт в основную ветку. Сейчас в DevNet работает код из основной ветки репозитория с пакетом Daml 0.5.0, а операции подчиняются тем же правилам. [В разделе «Статус»](https://docs.rome.builders/ru/canton-zk-evm/status.md) указан коммит. О том, что можно создавать на основе операций, см. [Разработка с Canton](https://docs.rome.builders/ru/canton-zk-evm/build-with-canton.md). Ознакомьтесь с полным текстом [README gateway](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).

| Операция | Вызов gateway                    | Действие в EVM                                    | Действие в Canton в `Advance`                                                |
| -------- | -------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------------- |
| Депозит  | `claim(id, token, amount)`       | Выпустить обёрнутые токены на адрес вызывающего.  | Выполнить распределение средств вкладчика в пользу gateway.                  |
| Вывод    | `withdraw(token, amount, party)` | Сжечь обёрнутые токены вызывающего.               | Перевести токен Canton из хранилища gateway указанному участнику.            |
| Платёж   | `pay(id, token, to, amount)`     | Перевести токен ERC-20 от плательщика получателю. | Выполнить распределение средств, указанное в согласованных условиях платежа. |

## Работает в DevNet

На DevNet дважды провели депозит, платёж и вывод — 2026-10-25:

| Запуск                                             | Депозит                                       | Платёж                                                                                                                   | Вывод                                        |
| -------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
| Первый: с 08:08 до 08:10 UTC                       | Блок 780: поступило 10 TKB, выпущено 10 wTKB. | Блок 783: V заплатил U 1 WtROME (обёрнутый tROME, токен ERC-20 в Ostia) в обмен на распределение 10 TKB от U в пользу V. | Блок 784: сожжено 4 wTKB, U выплачено 4 TKB. |
| Второй: с 11:31 до 11:34 UTC, с пакетом Daml 0.2.0 | Блок 1465.                                    | Блок 1471.                                                                                                               | Блок 1473.                                   |

Каждая операция выполнялась в отдельном блоке. В каждом блоке запись операции и изменение баланса составляли одно обновление Canton. После второго запуска предложение wTKB составляло 12 — это значение может проверить любой пользователь в Ostia. Во время запуска Rome проверила, что шлюз на Canton хранит 12 TKB, то есть столько же, сколько составляет предложение. С 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/ru/canton-zk-evm/explorer.md#legs-and-custody)).

Rome выполняет пополнение, платёж и вывод каждые 10 минут, а проверка их работоспособности проводится каждые 30 секунд.

Чтобы самостоятельно вносить и выводить Canton Coin, подключите кошелёк Canton на странице обозревателя [«Мост»](https://docs.rome.builders/ru/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) объясняет, как обеспечивается эта связь.

## Токены ERC-20 и их аналоги в Canton

Аналог — это форма токена ERC-20, существующая в Canton, тогда как сам ERC-20 работает в Ostia. Это токен CIP-0056, соответствующий стандарту токенов Canton, с идентификатором инструмента `erc20:<token address>`, и он перемещается между сторонами посредством перевода, предусмотренного стандартом токена, если их участники одобрили ostia-twin. Сейчас это означает, что учётные записи должны принадлежать участникам Rome. Каждому twin соответствует один ERC-20, хранящийся в хранилище. У TKA и WtROME (обёрнутого tROME) есть twin в DevNet.

**Блокировка.** Вы переводите ERC-20 в хранилище с помощью обычного шлюза `pay`и указываете сторону Canton, которая должна получить twin. Перед переводом вы сообщаете службе реестра twin получателя и выбранный вами параметр `ref` . В ответ она возвращает идентификатор блокировки — SHA-256-хеш строки `lock,<receiver>,<ref>`. Блок фиксирует перевод средств в хранилище и в той же транзакции Canton выпускает такое же количество twin для получателя. После этого предложение twin равно количеству токенов в хранилище.

**Погашение.** Владелец подписывает запрос на погашение в Canton, после чего для хранилища вызывается `release` с тем же параметром `ref`. Хранилище переводит ERC-20 на EVM-адрес, указанный в запросе, а twin сжигается в том же блоке. Canton проводит погашение только при наличии соответствующего запроса на погашение.

По правилам сети twin выпускается только в ходе `Advance`, при наличии подтверждённого перевода в зарегистрированное хранилище; администратор twin — сторона шлюза — также может самостоятельно выпускать и сжигать токены. [Модель доверия и ограничения](https://docs.rome.builders/ru/canton-zk-evm/trust-model.md#what-the-twins-trust) описывает, на чём всё это основано.

| Этап       | Где происходит                                                        | Действие в Canton в `Advance`  |
| ---------- | --------------------------------------------------------------------- | ------------------------------ |
| Блокировка | Шлюз выполняет `pay` для хранилища.                                   | Выпустить twin для получателя. |
| Погашение  | `release` для хранилища на основании подписанного владельцем запроса. | Сжечь twin владельца.          |

29.10.2026 блокировка 5 TKA для стороны Canton попала в блок 28389, после чего у стороны было 5 twin. Она отправила 2 twin другой стороне Canton, а погашение этих 2 токенов попало в блок 28392. После этого предложение twin и баланс хранилища составляли по 3. На странице обозревателя [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) предложение каждого twin отображается рядом с балансом хранилища (см. [Обозреватель](https://docs.rome.builders/ru/canton-zk-evm/explorer.md#twins-and-canton-assets)).

Блокировка создаётся только для получателя, принявшего twin. Сторона однократно подписывает согласие на получение twin, и конструктор создаёт блокировку только для такой стороны. При подключении кошелька Canton на странице [Мост](https://docs.rome.builders/ru/canton-zk-evm/bridge.md) это согласие подписывается в рамках процедуры подключения, поэтому весь цикл можно выполнить со своей стороной.

## Canton Coin

Canton Coin поступает в Ostia через тот же шлюзовой депозит, что и любой токен Canton. Обёрнутый токен CC (`0x4db3dea7c13116961fd3e438542ccfcca61a7547`, 10 десятичных знаков; в более ранних записях он обозначен как wCC) зарегистрирован в фабрике, указанной сканирующим прокси валидатора. Сторона выделяет Canton Coin шлюзу и подписывает помеченный запрос на депозит, получатель получает CC в Ostia, а при выводе Canton Coin возвращается. Для Canton Coin требуется дополнительный входной параметр — контекст выбора, предоставляемый сканирующим прокси. Конструктор получает его до подтверждения блока.

29.10.2026 сторона внесла 5 Canton Coin через блок 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).

## Ограничения токенов и хранения

В разделе [Модель доверия и ограничения](https://docs.rome.builders/ru/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/ru/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.
