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

# Как это работает

Проследите один блок Ostia от reth через доказательство до фиксации в Canton.

Билдер работает постоянно. Когда ожидают транзакции, он формирует блок, доказывает его корректность и отправляет в Canton. По умолчанию код допускает только один блок в обработке одновременно; на DevNet — до двух, при этом используется один GPU-доказчик. Блоки по-прежнему фиксируются в Canton по порядку. На DevNet, если в течение 60 секунд не был создан ни один блок, билдер формирует пустой блок — heartbeat (по умолчанию в коде отключён), чтобы даже при отсутствии активности в цепочке примерно раз в минуту появлялся блок. Canton определяет, станет ли каждый блок новой вершиной цепочки. Блок EVM и записанные в нём операции Canton фиксируются в одной транзакции.

На этой странице описан релиз `v0.1.0` и, если указано, то, что сейчас запущено на DevNet. [Статус](https://docs.rome.builders/ru/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["Билдер читает операции gateway и находит соответствующие им контракты Canton"]
    B -->|"Операция не может быть проведена: исключить её транзакцию и пересобрать блок"| R
    B -->|"Все операции могут быть проведены"| P["ZisK доказывает корректность блока"]
    P --> A["Advance: блок, доказательство и операции в одной транзакции Canton"]
    A --> S["Внешний вызов: сайдкары проверяют доказательство и состояние gateway"]
    S --> D["Daml проверяет вершину и проводит операции"]
    D --> C["Canton вместе фиксирует блок и его операции"]
    C --> F["reth помечает блок как финализированный"]
    F --> Q
    C --> X["Индексатор обозревателя читает запись блока и сверяет её с reth"]
```

## Сборка на основе вершины Canton

Кошельки отправляют транзакции EVM в публичный RPC, который перенаправляет их в reth. RPC показывает только финализированные в Canton блоки, поэтому квитанция появляется после финализации блока. В предоставленном сценарии запуска обнаружение пиров отключено. reth формирует блок, когда билдер запрашивает его.

Сначала билдер читает активный контракт `ZkChain` . Он перемещает вершину, безопасный блок и финализированный блок reth к зафиксированной вершине Canton. Билдер выбирает ожидающие транзакции по цене, сохраняя порядок nonce для каждого отправителя. Начиная с 2026-10-25, размер блока определяется объёмом газа, фактически используемого транзакциями, который вычисляет reth, а не указанными ими лимитами газа: кошельки часто указывают примерно втрое больше фактического расхода, и подсчёт по заявленным лимитам ограничил бы блок примерно третью его вместимости. Блок завершается при достижении лимита газа. Кроме того, обычно билдер передаёт reth на DevNet транзакции общим размером не более 393,216 байт в исходном виде, поскольку объём работы участника над блоком растёт вместе с его размером; однако первую транзакцию, даже если она превышает этот размер, билдер всё равно передаёт, чтобы она не ждала бесконечно. Билдер просит reth собрать блок из этого явно заданного списка транзакций.

Транзакция EVM, требующая действия в Canton, вызывает gateway. Gateway записывает операцию и добавляет её в накапливаемый хеш блока. Билдер читает события gateway в порядке записей журнала и находит контракты Canton, необходимые для каждой операции.

Если распределение средств уже отменено, получатель не принял вывод средств или отсутствует другой необходимый контракт, билдер исключает транзакцию и последующие транзакции того же отправителя. Он возвращает reth к вершине Canton и повторно собирает блок. Эти проверки выполняются до построения доказательства. В [README билдера](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) перечислены проверки для каждой операции.

## Построение доказательства для блока

Билдер сохраняет блок и свидетельство выполнения reth. Инструмент подготовки входных данных объединяет блок, свидетельство и генезис в данные для доказчика. ZisK запускает гостевую программу, которая проверяет блок в соответствии с неизменяемыми правилами цепочки.

Доказчик возвращает обёрнутое доказательство размером 1,344 байта, привязанное к хешу блока. Билдер отправляет `Advance` с заголовком, транзакциями, доказательством, операциями, а также доказательствами аккаунта и хранилища gateway для корня состояния блока.

## Проверка и проведение операций в одной транзакции

На каждом подтверждающем участнике работает сайдкар. Внешний вызов Canton передаёт блок сайдкару этого участника для `verify`. Сайдкар проверяет доказательство, закреплённый ключ программы и версию ZisK, хеш заголовка и корень списка транзакций.

В Ostia DevNet Rome запускает единственного участника, на котором размещены все стороны Ostia, поэтому его сайдкар — единственный подтверждающий, а доказательство проверяет собственный узел Rome. Синхронизатор Canton упорядочивает блоки и не проверяет доказательство. В локальной демонстрационной сети два подтверждающих участника. [Модель доверия и ограничения](https://docs.rome.builders/ru/canton-zk-evm/trust-model.md) описывает, что при этом меняется.

Daml сверяет ответ с контрактом `ZkChain`: родительский блок должен быть текущей вершиной, номер блока — следующим по порядку, а лимит газа и использованный газ не должны превышать установленный предел. Daml сравнивает ответы сайдкара, но сам не проверяет доказательство с нулевым разглашением.

Затем Daml записывает для каждой операции строку на основе указанных в ней контрактов Canton. Идентификатор, сжигатель и сумма вывода средств поступают от билдера; доказанный хеш привязывает их к данным, записанным в блоке. Функция сайдкара `legs` проверяет доказательства аккаунта и хранилища gateway, хеширует эти строки по порядку и сравнивает результат со значением gateway в доказанном состоянии. Блок без операций должен пройти ту же проверку с пустым списком.

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` ; в ответ сервис возвращает идентификатор блокировки, а сборщик считывает те же данные, чтобы добавить блокировку в блок. Кроме того, сервис предоставляет API реестра стандартов токенов для токенов-близнецов, поэтому кошелёк, валидаторы которого проверили пакет токена-близнеца, может отправлять такие токены. Сервис не хранит ключей и ничего не записывает в Canton, а `Advance` проверяет, что эти данные соответствуют идентификатору. Описание потоков см. в разделе [Депозиты, вывод средств и платежи](https://docs.rome.builders/ru/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 медианное время создания доказательства для блоков с 11–100 транзакциями составило 9,03 секунды.
4. Запись блока вместе с доказательством фиксируется в Canton. Эта фиксация делает блок окончательным, после чего публичный RPC показывает квитанцию о транзакции.

За тот же час медианное время от принятия транзакции RPC до окончательной фиксации её блока в Canton составило 19,5 секунды, а на 95-м процентиле — 27,1 секунды. Квитанция появляется медленнее, чем в большинстве сетей, поэтому инструментам, ожидающим её, следует задавать длительный тайм-аут.

[Измерения](https://docs.rome.builders/ru/canton-zk-evm/measurements.md) описывает каждый интервал и перечисляет запуски. В обозревателе откройте транзакцию, а затем её блок, чтобы увидеть обновление Canton, содержащее запись. [Обозреватель](https://docs.rome.builders/ru/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/ru/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.
