> 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/es/canton-zk-evm/how-it-works.md).

# Cómo funciona

Sigue un bloque de Ostia desde reth, pasando por la prueba, hasta su confirmación en Canton.

El generador está en funcionamiento todo el tiempo. Cuando hay transacciones en espera, crea un bloque, genera su prueba y lo envía a Canton. De forma predeterminada, el código permite tener un bloque en curso a la vez; DevNet permite hasta dos y usa un único generador de pruebas con GPU. Los bloques siguen confirmándose en Canton en orden. En DevNet, si no se ha creado ningún bloque durante 60 segundos, el generador crea un bloque vacío, un latido (desactivado de forma predeterminada en el código), para que incluso una cadena inactiva produzca un bloque aproximadamente una vez por minuto. Canton decide si cada bloque se convierte en la nueva cabeza de la cadena. Un bloque EVM y las operaciones de Canton que registra se confirman en la misma transacción.

Esta página describe la versión `v0.1.0` y, cuando se indica, lo que ejecuta DevNet actualmente. [Estado](https://docs.rome.builders/es/canton-zk-evm/status.md) indica la confirmación que ejecuta DevNet. Lee el [diseño](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md). Para seguir tu propia transacción a través de estos pasos, ve a [De tu transacción a la confirmación final en Canton](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["Transacciones EVM"] --> Q["RPC público: muestra solo los bloques confirmados"]
    Q --> R["reth crea bloques bajo demanda"]
    R --> B["El generador lee las operaciones de la pasarela y encuentra sus contratos de Canton"]
    B -->|"Una operación no se puede liquidar: excluye su transacción y vuelve a crear el bloque"| R
    B -->|"Todas las operaciones se pueden liquidar"| P["ZisK genera la prueba del bloque"]
    P --> A["Avance: bloque, prueba y operaciones en una transacción de Canton"]
    A --> S["Llamada externa: los sidecars comprueban la prueba y el estado de la pasarela"]
    S --> D["Daml comprueba la cabeza y liquida las operaciones"]
    D --> C["Canton confirma el bloque y sus operaciones juntos"]
    C --> F["reth marca el bloque como confirmado"]
    F --> Q
    C --> X["El indexador del explorador lee el registro del bloque y lo comprueba con reth"]
```

## Crear bloques sobre la cabeza de Canton

Las carteras envían transacciones EVM al RPC público, que las reenvía a reth. El RPC solo muestra los bloques confirmados en Canton, así que el recibo aparece cuando se confirma el bloque. El iniciador proporcionado mantiene desactivado el descubrimiento de pares. reth crea un bloque cuando el generador se lo solicita.

Primero, el generador lee el contrato activo `ZkChain` en Canton. Mueve la cabeza, el bloque seguro y el bloque finalizado de reth a esa cabeza confirmada. Selecciona las transacciones pendientes por precio y respeta el orden de nonce de cada emisor. Desde el 2026-10-25, llena el bloque según el gas que consumen las transacciones, calculado por reth, y no según los límites de gas que declaran: las carteras suelen declarar aproximadamente el triple de lo que consumen, y contar los límites declarados haría que el bloque se detuviera cuando apenas estuviera lleno a un tercio de su capacidad. El bloque termina al alcanzar el límite de gas. Normalmente, el generador también ofrece a reth como máximo 393,216 bytes sin procesar de transacciones en DevNet, porque el trabajo del participante para un bloque aumenta con su tamaño; aun así, ofrece una primera transacción que supere ese límite para que no se quede esperando indefinidamente. El generador pide a reth que cree un bloque con esa lista explícita de transacciones.

Una transacción EVM que requiere una acción de Canton llama a la pasarela. La pasarela registra una operación y la incorpora a un hash acumulado para el bloque. El generador lee los eventos de la pasarela en el orden de los registros y encuentra los contratos de Canton que necesita cada operación.

Si una asignación ya no existe, un destinatario no ha aceptado los retiros o falta otro contrato necesario, el generador excluye la transacción y las transacciones posteriores de ese emisor. Hace que reth vuelva a la cabeza de Canton y vuelve a crear el bloque. Estas comprobaciones se realizan antes de generar la prueba. El [README del generador](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) enumera las comprobaciones de cada operación.

## Generar la prueba del bloque

El generador guarda el bloque y el testigo de ejecución de reth. La herramienta de entrada combina el bloque, el testigo y el génesis para crear la entrada del generador de pruebas. ZisK ejecuta el programa invitado, que valida el bloque según las reglas fijas de la cadena.

El generador de pruebas devuelve una prueba encapsulada de 1,344 bytes que confirma el hash del bloque. El generador envía `Advance` con la cabecera, las transacciones, la prueba, las operaciones y las pruebas de cuenta y almacenamiento de la pasarela en la raíz de estado del bloque.

## Comprobar y liquidar en una sola transacción

Cada participante confirmador ejecuta un sidecar. La llamada externa de Canton envía el bloque al sidecar de ese participante para que lo `verify`. Comprueba la prueba, la clave de programa fijada y la versión de ZisK, el hash de la cabecera y la raíz de la lista de transacciones.

En Ostia DevNet, Rome ejecuta el único participante que aloja todas las partes de Ostia, por lo que su único sidecar es el único confirmador y la prueba se comprueba en el propio nodo de Rome. El sincronizador de Canton ordena los bloques y no ve la prueba. La red de demostración local tiene dos participantes confirmadores. [Modelo de confianza y límites](https://docs.rome.builders/es/canton-zk-evm/trust-model.md) explica qué cambia con eso.

Daml comprueba la respuesta con `ZkChain`: el padre debe ser la cabeza actual, el número debe ser el siguiente y el límite de gas y el gas usado deben ajustarse al máximo. Daml compara las respuestas del sidecar; no verifica la prueba de conocimiento cero en sí.

A continuación, Daml escribe una línea para cada operación a partir de los contratos de Canton que esta menciona. El identificador, el quemador y el importe de un retiro proceden del generador; el hash probado los vincula con lo que registró el bloque. La función `legs` del sidecar comprueba las pruebas de cuenta y almacenamiento de la pasarela, calcula el hash de esas líneas en orden y compara el resultado con el valor de la pasarela en el estado probado. Un bloque sin operaciones debe superar la misma comprobación con una lista vacía.

Daml liquida las operaciones en orden y crea el `BlockRecord` y el siguiente `ZkChain`. Canton confirma estos cambios conjuntamente. Si falla una comprobación o una liquidación, no se confirma nada. Consumir el único contrato de estado de la cadena convierte a Canton en la autoridad sobre el orden de los bloques. Consulta la [interfaz de Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) y las [comprobaciones auxiliares](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## La bóveda y los twins

Además del primer gateway, el registro de la cadena enumera los contratos EVM en los que confía, cada uno de ellos un gateway o una bóveda, junto con el hash de su código. Un bloque contiene las partes de cada gateway registrado, y Daml comprueba el hash del código de cada gateway frente a la prueba de cuenta incluida en el bloque. Una bóveda no tiene partes propias: sus bloqueos y liberaciones son pagos del gateway, y Daml confía en su dirección como destinatario o emisor. El confirmador comprueba el código de una bóveda antes de aceptar la entrada. Se añade una entrada nueva del mismo modo que se modifica un programa: el operador y el gateway la proponen, y el confirmador la acepta.

La bóveda es un pequeño contrato que guarda los tokens ERC-20 que respaldan los twins de Canton. No tiene propietario, clave ni posibilidad de actualización. Un bloqueo es un `pay` sencillo del gateway con la bóveda como destinataria. Una liberación es `release(ref, token, to, amount)`, mediante la cual la bóveda paga a través del gateway usando un identificador que no puede tener ningún otro tipo de pago; Canton solo lo liquida frente a una solicitud de canje firmada por el titular.

Un twin es un token de Canton correspondiente a un ERC-20, administrado por la parte del gateway. El registro de la cadena fija cada twin: la dirección del token, sus decimales y el contrato de reglas que lo acuña, quema y transfiere. `Advance` acuña un twin únicamente frente a un bloqueo fijado por la prueba, y solo lo quema frente a una solicitud de canje firmada.

El servicio de registro de twins está junto al generador. Antes de pagar, el pagador le indica quién es el destinatario y un `ref` ; el servicio responde con el identificador del bloqueo, y el generador lee las mismas partes para adjuntar el bloqueo al bloque. También ofrece la API de registro del estándar de tokens para los twins, de modo que una billetera cuyos validadores hayan verificado el paquete del twin pueda enviarlos. No guarda claves ni escribe nada en Canton, y `Advance` comprueba que las partes generen el identificador. Consulta [Depósitos, retiros y pagos](https://docs.rome.builders/es/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) para conocer los flujos.

## Cuando Canton rechaza un bloque

Después de que Canton confirma el bloque, el generador lo marca como definitivo en reth. Si Canton lo rechaza, el generador devuelve reth al último bloque confirmado por Canton y devuelve al pool las transacciones del bloque rechazado. El siguiente bloque vuelve a comprobar sus partes. Se excluye cualquier pago cuya asignación se haya retirado. Tras dos bloques rechazados consecutivos, el generador sospecha que la transacción compartida entre ambos es la causa y la excluye durante un periodo de espera.

Si el generador pierde la respuesta al envío, el comando aún podría confirmarse. Antes de enviarlo, el generador registra el final del libro mayor. Después, consulta desde ese punto el resultado de la finalización del propio comando. Si se completó correctamente, cuenta como confirmado. Si falló, se considera rechazado.

La cabeza de Canton puede confirmar una operación, pero por sí sola nunca indica que «no se confirmó». Si no hay resultado de finalización, el generador solo decide que «no se confirmó» cuando han transcurrido 300 segundos de tiempo de Canton (`CZE_RESOLVE_SECONDS`). Hasta entonces, no genera nada y deja reth donde está. Estas reglas de recuperación están en el [README del generador](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## De tu transacción a su confirmación definitiva en Canton

1. Envías una transacción al RPC público. Espera en el pool hasta el siguiente bloque.
2. El generador crea un bloque en cuanto hay una transacción esperando y un espacio libre (el valor predeterminado del código es un bloque en curso; DevNet permite hasta dos). Mientras la cadena estuvo ocupada, se añadió un nuevo bloque después del anterior cada 16,6 segundos de mediana (durante las 24 horas hasta 2026-10-25 01:34 UTC).
3. ZisK demuestra la validez del bloque. En la prueba de carga de una hora del 2026-10-24, la prueba mediana tardó 9,03 segundos para bloques de entre 11 y 100 transacciones.
4. El registro del bloque, junto con su prueba, se confirma en Canton. Esa confirmación hace que el bloque sea definitivo; entonces, el RPC público muestra tu recibo.

Durante esa misma hora, una transacción tardó una mediana de 19,5 segundos desde que el RPC la aceptó hasta que su bloque quedó confirmado definitivamente en Canton; en el percentil 95, tardó 27,1 segundos. Obtener un recibo lleva más tiempo que en la mayoría de las cadenas, así que las herramientas que esperan uno necesitan un tiempo de espera prolongado.

[Mediciones](https://docs.rome.builders/es/canton-zk-evm/measurements.md) define cada intervalo y enumera las ejecuciones. En el explorador, abre tu transacción y luego su bloque para ver la actualización de Canton que contiene el registro. [El explorador](https://docs.rome.builders/es/canton-zk-evm/explorer.md) muestra cómo.


---

# 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/es/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.
