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

# Depósitos, retiros y pagos

Cómo la pasarela vincula los depósitos, retiros y pagos de EVM con sus tramos de Canton, y cómo los gemelos ERC-20 y Canton Coin se mueven en ambos sentidos.

El gateway es un contrato EVM incluido en el génesis de la cadena. Registra lo que un bloque necesita que haga Canton. Cada solicitud es una operación. La prueba del bloque compromete el estado del gateway, incluido el hash de las operaciones en el orden en que se registraron.

Los depósitos, retiros y pagos están activos en Ostia DevNet, operado por Rome con partes de prueba. Se ejecutaron por primera vez en la demostración local del 2026-10-05. El 2026-10-25, se registró en el gateway un token de prueba de Canton, TKB (el token de prueba de referencia que distribuye Splice), y su forma envuelta, wTKB, existe en Ostia en `0x294d3049874526910a69f6b61da14d10a8b1b3af`. Desde el 2026-11-08 puedes depositar y retirar Canton Coin por tu cuenta desde la página [Puente](https://docs.rome.builders/es/canton-zk-evm/bridge.md) del explorador; consulta [Activo en DevNet](#live-on-devnet) más abajo.

Desde el 2026-10-29, el gateway también admite activos de Canton en ambas direcciones: un ERC-20 puede tener un gemelo en Canton, y Canton Coin puede pasar a Ostia y regresar. Consulta [Gemelos de tokens ERC-20 en Canton](#canton-twins-of-erc-20-tokens) y [Canton Coin](#canton-coin).

La mayoría de los enlaces de esta página llevan a la versión `v0.1.0`; el enlace al archivo README del gateway lleva a la rama principal. DevNet ejecuta ahora código de la rama principal del repositorio con el paquete Daml 0.5.0, y las operaciones siguen las mismas reglas. [Estado](https://docs.rome.builders/es/canton-zk-evm/status.md) indica el commit. Para saber qué puedes crear sobre las operaciones, consulta [Crear con Canton](https://docs.rome.builders/es/canton-zk-evm/build-with-canton.md). Lee el archivo README completo del [gateway](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md) y la [interfaz de Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md).

| Operación | Llamada al gateway               | Acción de EVM                                     | Acción de Canton en `Advance`                                          |
| --------- | -------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------- |
| Depósito  | `claim(id, token, amount)`       | Emite tokens envueltos para quien llama.          | Ejecuta la asignación del depositante al gateway.                      |
| Retiro    | `withdraw(token, amount, party)` | Quema los tokens envueltos de quien llama.        | Paga el token de Canton bajo custodia del gateway a la parte indicada. |
| Pago      | `pay(id, token, to, amount)`     | Transfiere un ERC-20 del pagador al beneficiario. | Ejecuta la asignación indicada en los términos de pago acordados.      |

## Activo en DevNet

El 2026-10-25 se ejecutaron dos veces en DevNet un depósito, un pago y un retiro:

| Ejecución                                                | Depósito                                        | Pago                                                                                                               | Retiro                                                 |
| -------------------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
| Primera, de 08:08 a 08:10 UTC                            | Bloque 780: entraron 10 TKB y salieron 10 wTKB. | Bloque 783: V pagó a U 1 WtROME (tROME envuelto, un ERC-20 en Ostia) a cambio de la asignación de 10 TKB de U a V. | Bloque 784: se quemaron 4 wTKB y se pagaron 4 TKB a U. |
| Segunda, de 11:31 a 11:34 UTC, con el paquete Daml 0.2.0 | Bloque 1465.                                    | Bloque 1471.                                                                                                       | Bloque 1473.                                           |

Cada tramo estaba en su propio bloque. En cada uno, el registro del bloque y el cambio en la tenencia formaban una única actualización de Canton. Tras la segunda ejecución, el suministro de wTKB era de 12, algo que cualquiera puede consultar en Ostia. La ejecución de Rome comprobó que la pasarela tenía entonces 12 TKB en Canton, la misma cantidad que ese suministro. Desde el 2026-10-25, el explorador también muestra esto: la página del token wTKB tiene una tarjeta «Respaldado en Canton» con una custodia de 12 TKB junto a un suministro de 12 wTKB.

U y V son partes de prueba que Rome creó y ejecuta en su propio participante, y Rome realizó todos los pasos. Puedes ver los tramos en el explorador: abre [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) para ver la lista, o la página de un bloque para consultar los tramos que contiene. Un retiro indica la parte de Canton a la que se pagó. wTKB es un ERC-20 ordinario con 10 decimales, por lo que su suministro y sus saldos se consultan como los de cualquier otro token (consulta [Explorador](https://docs.rome.builders/es/canton-zk-evm/explorer.md#legs-and-custody)).

Rome ejecuta un depósito, un pago y un retiro cada 10 minutos, y comprueba su estado cada 30 segundos.

Para depositar y retirar Canton Coin por tu cuenta, conecta tu cartera de Canton en la página [Puente](https://docs.rome.builders/es/canton-zk-evm/bridge.md) del explorador, una vez que se haya habilitado para tu cartera. La página Puente también bloquea tROME y TKA para Canton (una pasarela `pay` en la bóveda). Los demás pagos y los depósitos de TKB de esta página los realizan las partes de prueba de Rome.

## Depositar un token de Canton

El depositante asigna un token de Canton a la pasarela, con el operador como ejecutor. El depositante firma un `DepositRequest` que especifica el identificador del depósito, la dirección EVM autorizada para reclamarlo y la asignación. El identificador del depósito es el SHA-256 de `deposit,<depositor's party id>,<label>`, por lo que solo el depositante puede crear un identificador a partir de su propia parte.

Esa dirección EVM llama a `claim`. La pasarela acuña los tokens para quien la llama y registra el tramo del depósito. El destinatario necesita tROME para pagar el gas. El constructor vincula el tramo con la solicitud, el token registrado y la asignación.

`Advance` ejecuta la asignación para depositarla en la custodia de la pasarela y confirma el bloque que acuñó los tokens envueltos. Un token envuelto tiene 10 decimales, igual que las cantidades de Canton. La conversión entre ambas cantidades es exacta, sin redondeo.

## Retirar a una parte de Canton

El titular llama a `withdraw` con el token envuelto, la cantidad y el identificador completo de la parte de Canton. La pasarela quema los tokens envueltos y registra al destinatario en el tramo.

El destinatario debe haber firmado un `WithdrawalAcceptance`. Sigue activo hasta que se archive. El constructor también necesita tener suficientes activos registrados desbloqueados en la pasarela. Si no se cumplen estas condiciones, deja fuera la transacción.

`Advance` paga al destinatario mediante la fábrica de transferencias del registro de tokens. La transferencia de Canton y el bloque que contiene la quema se confirman conjuntamente. El constructor incluye como máximo un retiro de un instrumento por bloque, tal como se describe en el [README del constructor](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## Vincular un pago a una asignación

El pagador de Canton asigna un token de Canton al beneficiario de Canton. Ambos firman `DvpTerms` que especifica la asignación, el identificador del pago, el token EVM, el beneficiario EVM y la cantidad. El identificador del pago es el SHA-256 del texto UTF-8 `<Canton payer's party id>,<Canton payee's party id>,<label>`, expresado en hexadecimal en minúsculas. Los términos rechazan cualquier otro identificador.

Un pagador EVM autoriza a la pasarela y llama a `pay` con el identificador, el token, el destinatario y la cantidad acordados. La pasarela transfiere el ERC-20 del pagador al beneficiario EVM y registra el tramo del pago. En la demostración, el pagador estaba controlado por el beneficiario de Canton; el protocolo no exige esa relación. `Advance` usa los términos firmados para ejecutar la asignación del pagador de Canton al beneficiario de Canton. El pago en ERC-20 y el pago de Canton se confirman conjuntamente, de modo que ninguno es definitivo sin el otro.

Una transferencia ERC-20 normal no registra ningún tramo. Ni siquiera una transferencia del mismo token al mismo beneficiario en el mismo bloque puede sustituir a `pay`. El [flujo de pago del diseño](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#the-flows) explica esta vinculación.

## Réplicas en Canton de tokens ERC-20

Una réplica es la forma en Canton de un ERC-20 que existe en Ostia. Es un token CIP-0056, el estándar de tokens de Canton, con el identificador de instrumento `erc20:<token address>` y se mueve mediante la transferencia del estándar del token entre partes cuyos participantes han validado ostia-twin, lo que hoy significa cuentas de los participantes de Rome. Cada twin corresponde uno a uno al ERC-20 que posee la bóveda. TKA y WtROME (tROME envuelto) tienen twins en DevNet.

**Bloquear.** Se paga el ERC-20 a la bóveda mediante una pasarela simple `pay`, y se indica la parte de Canton que debe poseer el twin. Antes de pagar, se comunica al servicio de registro de twins el destinatario y un `ref` a elección; el servicio responde con el identificador del bloqueo, que es el SHA-256 de `lock,<receiver>,<ref>`. El bloque confirma el pago a la bóveda y, en la misma transacción de Canton, acuña la misma cantidad del twin para el destinatario. A continuación, el suministro del twin equivale a lo que posee la bóveda.

**Canjear.** El titular firma una solicitud de canje en Canton y, después, se llama a `release` en la bóveda con el mismo `ref`. La bóveda paga el ERC-20 a la dirección de EVM indicada en la solicitud y el twin se quema en el mismo bloque. Canton liquida una liberación únicamente si coincide con una solicitud de canje.

Según las reglas de la cadena, un twin solo se acuña en `Advance`, contra un pago demostrado a una bóveda registrada; actualmente, el administrador del twin, es decir, la parte de la pasarela, también puede acuñarlo y quemarlo por su cuenta. [Modelo de confianza y limitaciones](https://docs.rome.builders/es/canton-zk-evm/trust-model.md#what-the-twins-trust) explica en qué se basa.

| Paso     | Dónde ocurre                                                        | Acción de Canton en `Advance`        |
| -------- | ------------------------------------------------------------------- | ------------------------------------ |
| Bloquear | Una pasarela `pay` a la bóveda.                                     | Acuñar el twin para el destinatario. |
| Canjear  | `release` en la bóveda, contra la solicitud firmada por el titular. | Quemar el twin del titular.          |

El 2026-10-29, un bloqueo de 5 TKA para una parte de Canton se incluyó en el bloque 28389, y la parte recibió 5 twins. Envió 2 twins a una segunda parte de Canton, y el canje de esos 2 se incluyó en el bloque 28392. Después, tanto el suministro del twin como el saldo de la bóveda eran 3. La página [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) del explorador muestra el suministro de cada twin junto al saldo de la bóveda (consulta [Explorador](https://docs.rome.builders/es/canton-zk-evm/explorer.md#twins-and-canton-assets)).

Solo se crea un bloqueo para un destinatario que haya aceptado twins. Una parte firma una única vez para aceptarlos, y el creador solo genera un bloqueo para una parte que los haya aceptado. Al conectar una cartera de Canton en la página [Puente](https://docs.rome.builders/es/canton-zk-evm/bridge.md) se firma esa aceptación como parte de la inscripción voluntaria, de modo que puedes completar todo el ciclo con una parte propia.

## Canton Coin

Canton Coin llega a Ostia mediante el mismo depósito en la pasarela que cualquier token de Canton. El token envuelto CC (`0x4db3dea7c13116961fd3e438542ccfcca61a7547`, 10 decimales; los registros anteriores lo llaman wCC) está registrado en la fábrica que indica el proxy de escaneo del validador. Una parte asigna Canton Coin a la pasarela y firma una solicitud de depósito etiquetada; el destinatario reclama CC en Ostia y, al retirar, se devuelve Canton Coin. Canton Coin requiere un dato adicional: un contexto de elección que proporciona el proxy de escaneo y que el creador obtiene antes de demostrar el bloque.

El 2026-10-29, una parte depositó 5 Canton Coin mediante el bloque 28473, con lo que pasó a tener 15, la pasarela a tener 5 y el suministro de CC a ser 5. La retirada del bloque 28474 restableció los tres valores: 20, 0 y 0. DevNet no cobró ninguna comisión por estas transferencias.

## Qué garantiza la prueba

Cada tramo registra su tipo, identificador, token, cuenta, importe y, cuando corresponde, la parte de Canton. La pasarela calcula el hash de los tramos en orden. `Advance` comprueba que los tramos adjuntos produzcan el hash del estado probado de la pasarela. Si falta un tramo, sobra uno, cambia el orden o se modifica alguno, la transacción falla. La comprobación también abarca los bloques que no contienen tramos.

Demostrar el bloque no reserva la asignación de Canton. El emisor aún puede recuperarla antes de la liquidación. Si eso ocurre después de la demostración, Canton rechaza `Advance` y reth vuelve al último bloque confirmado. El mismo bloque probado no se puede volver a enviar con su tramo eliminado. La siguiente compilación omite el pago, como se muestra en [ejecución 4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## Límites de los tokens y la custodia

Quién posee los tokens de Canton y qué comportamientos de los tokens no cubre la pasarela se detallan en [Modelo de confianza y límites](https://docs.rome.builders/es/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/es/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.
