> 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/explorer.md).

# Explorador

Una guía del explorador en vivo de Ostia DevNet, su faucet, sus APIs y la comprobación de la prueba en el navegador.

El explorador de Ostia está disponible en [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz). Combina los datos de la EVM de reth con los registros de Canton de cada bloque, que lee como parte lectora. Úsalo para buscar un bloque o una transacción, comprobar una prueba en el navegador, verificar un contrato, obtener tROME y consultar los mismos datos mediante una API.

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 el commit que ejecuta DevNet. Lee el [README del explorador](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

El explorador marca un bloque como final solo cuando su registro está en Canton. Hasta entonces, muestra el bloque de reth como en proceso de prueba, y una transacción que acabas de enviar aparece como pendiente. Cuando no hay transacciones en espera, el constructor crea un bloque vacío una vez por minuto, así que, en una cadena inactiva, el bloque más reciente no suele tener más de un par de minutos. Todas las horas de las páginas están en UTC.

## Recorrido por las páginas

| Página             | Qué puedes hacer ahí                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Inicio             | Busca por bloque, transacción, dirección o ID de actualización de Canton. Consulta el bloque final más reciente, el bloque en proceso de prueba, el tiempo hasta la finalización, el tiempo de prueba y los bloques más recientes. Una franja de estado indica si el nodo EVM, Canton, el productor, el probador, el grifo y el verificador funcionan correctamente. El recuadro del tiempo de commit en Canton abre Llamadas externas. |
| Bloques            | Consulta los bloques finales, filtra los bloques con transacciones, descarga un CSV y abre un bloque.                                                                                                                                                                                                                                                                                                                                   |
| Transacciones      | Consulta las transacciones y filtra las que aún no son finales, las fallidas o las llamadas a contratos. Una transacción muestra su resultado, bloque, actualización de Canton, tarifa, datos de entrada decodificados y una cronología de sus cuatro etapas de finalización.                                                                                                                                                           |
| Contratos          | Consulta qué contratos están verificados y con qué frecuencia se usan. La página de un contrato muestra el código fuente verificado, la ABI, los eventos y las llamadas de lectura y escritura. Las llamadas de escritura se realizan a través de tu cartera.                                                                                                                                                                           |
| Tokens             | Explora tokens ERC-20, ERC-721 y ERC-1155, con sus titulares y transferencias. Una pestaña muestra los tokens procedentes de Canton, como wTKB y CC.                                                                                                                                                                                                                                                                                    |
| Llamadas externas  | Consulta cómo se registró cada bloque en Canton, con una fila por bloque que indica su estado, hora de liquidación e intentos. El enlace «Llamadas externas» de la cabecera abre esta página. Consulta [Llamadas externas](#external-calls).                                                                                                                                                                                            |
| Estadísticas       | Consulta el tiempo hasta la finalización, el tiempo de prueba, el tiempo de commit en Canton, las transacciones por segundo y la tasa de éxito en periodos de 1 hora, 6 horas, 24 horas, 7 días o 30 días. Una tarjeta de activos de Canton muestra cada suministro en comparación con lo que tienen la bóveda y la pasarela. Una tarjeta de llamadas externas muestra el estado de los commits en Canton.                              |
| Activos vinculados | Consulta los activos bidireccionales de Canton en [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins): el suministro de cada activo vinculado comparado con el saldo de la bóveda, y los bloqueos y reembolsos más recientes.                                                                                                                                                                                                       |
| Intercambios       | Consulta los intercambios que realizó una plataforma de Canton con la EVM en [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps), y abre un intercambio para ver su pago y reclamación.                                                                                                                                                                                                                                             |
| Puente             | Conecta tu cartera, obtén tROME de prueba y mueve tokens entre Ostia y Canton con la cartera de Canton que ya tienes (la función se habilita cartera por cartera; hasta entonces, el botón dice «Próximamente»). Consulta [Puente](https://docs.rome.builders/es/canton-zk-evm/bridge.md).                                                                                                                                              |
| Grifo              | Solicita tROME o inicia sesión con GitHub para obtener la subvención de 100 tROME para desarrolladores, y sigue tu solicitud hasta que sea final.                                                                                                                                                                                                                                                                                       |
| API                | Consulta la referencia de la API generada a partir del documento OpenAPI. Un botón añade Ostia DevNet a tu cartera.                                                                                                                                                                                                                                                                                                                     |

La cabecera tiene un cuadro de búsqueda en todas las páginas excepto Inicio, que tiene uno propio; la tecla `/` le da el foco. Los bloques, las transacciones, las transacciones y transferencias de una dirección, y las transferencias de un token se pueden descargar como CSV. Las páginas siguen una transmisión en directo, así que aparecen nuevos bloques sin recargar. Las páginas de direcciones y de tramos de la pasarela se abren desde enlaces; las direcciones también se abren desde la búsqueda. No hay una entrada para ellas en la cabecera.

## Consultar un bloque

La página del bloque muestra sus datos de la EVM junto a los de Canton: el ID de actualización, la hora del registro y el operador y el confirmante que firmaron el registro. Compara el hash del bloque de reth, el hash del registro y el hash de la cabecera registrada, e indica si los tres coinciden. También muestra la clave del programa, la versión de ZisK y el hash del bloque leídos de la prueba, junto a los valores esperados por el explorador. Si un valor no coincide, aparece en rojo.

Cuatro recuadros resumen el bloque con cifras: transacciones, tiempo de prueba, commit en Canton (el tiempo transcurrido desde el envío del bloque hasta la hora de su registro en Canton) y el tiempo desde la creación del bloque hasta su finalización. Las tarjetas de Inicio y Estadísticas para el commit en Canton miden desde el mismo envío hasta que el constructor recibe la respuesta de Canton, por lo que muestran un valor superior al de este recuadro. Un panel, «Cómo se finalizó este bloque», enumera los pasos con sus horas.

Un bloque en proceso de prueba aún no está en Canton. La página lo indica y se actualiza hasta que el bloque sea final. Una transacción puede estar en espera, en proceso de prueba o ser final. La página del bloque enumera los tramos de la pasarela tal como los registró la EVM. `BlockRecord` no indica cómo se liquidó cada tramo en Canton, por lo que el explorador no puede mostrarlo. Consulta [Tramos y custodia](#legs-and-custody) para ver los tramos activos en DevNet.

## Tramos y custodia

Los tramos del gateway están activos en DevNet, operados por Rome con partes de prueba (consulta [Depósitos, retiros y pagos](https://docs.rome.builders/es/canton-zk-evm/deposits-withdrawals-payments.md)), así que estas páginas ya tienen contenido. Aún no hay una entrada para ellas en el encabezado; abre [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) directamente o sigue un tramo desde su bloque.

* **La lista** en `/legs` muestra todos los tramos, con su tipo (depósito, pago o retiro), bloque, token, cuenta e importe. Abre uno para ver su propia página en `/leg/<id>`. Un retiro indica la parte de Canton a la que se pagó. A las 11:54 UTC del 2026-10-25, la lista contenía seis tramos de las dos ejecuciones de ese día (bloques 780, 783, 784, 1465, 1471 y 1473).
* **La API** proporciona los mismos datos en `/api/legs`, `/api/legs/<id>` y `/api/blocks/<number>/legs`.
* **El token envuelto** wTKB, en `0x294d3049874526910a69f6b61da14d10a8b1b3af`, tiene una página de token como cualquier ERC-20 (10 decimales). Su suministro era de 12 wTKB en el bloque 1473, y la ejecución de Rome comprobó que el gateway tenía 12 TKB en Canton.
* **Custodia frente al suministro.** La página de un token respaldado por Canton muestra una tarjeta «Respaldado en Canton»: lo que el gateway tiene en Canton junto al suministro envuelto, consultados en el mismo bloque, y `GET /api/tokens/<address>` incluye las mismas cifras en un objeto `canton` . Solo se muestra el total, nunca una tenencia individual. La consulta de custodia está disponible en DevNet desde las 12:27 UTC del 2026-10-25. A las 12:52 UTC de ese día, wTKB registraba una custodia de 12 TKB, distribuidos en dos tenencias, frente a un suministro envuelto de 12 wTKB.

## Tokens gemelos y activos de Canton

El explorador muestra los activos bidireccionales de Canton (consulta [Depósitos, retiros y pagos](https://docs.rome.builders/es/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)). Abre [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins). Incluye:

* **El registro.** Las bóvedas registradas en el registro de la cadena, con el hash de código de cada bóveda, y los tokens gemelos que esta fija, con sus decimales.
* **Una tarjeta para cada token gemelo.** Su suministro en Canton junto a lo que tiene la bóveda, consultados en el mismo bloque, con el bloque hasta el que se contabilizan y el número de bloqueos y canjes. Ambos valores coinciden después de cada bloqueo y canje.
* **Custodia frente al suministro** para los tokens de Canton, como wTKB y CC: lo que el gateway tiene en Canton junto al suministro envuelto.
* **Los bloqueos y canjes más recientes.** Cada uno enlaza con su tramo, transacción, bloque y actualización de Canton.
* **El servicio de registro.** Una línea con un enlace a la comprobación de estado del servicio de registro de tokens gemelos.

La tarjeta de activos de Canton en Estadísticas muestra los mismos suministros junto a lo que tienen la bóveda y el gateway, y `GET /api/twins` proporciona la página completa en formato JSON. Solo se muestran los totales, nunca una tenencia individual.

## Llamadas externas

Abierto **Llamadas externas** en el encabezado, en [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton). Ostia confirma cada bloque como una única transacción de Canton. La llamada externa del participante que confirma comprueba la prueba del bloque dentro de la propia transacción; en DevNet, ese participante es Rome. Esta página muestra cómo se realizó cada confirmación.

**El encabezado** muestra las cifras de todos los bloques:

* bloques confirmados;
* la tasa de éxito, es decir, las confirmaciones completadas respecto de los intentos realizados: 99,99 % para todos los bloques hasta el 2026-11-09;
* el tiempo de liquidación, como promedio y p95, durante las últimas 24 horas o los últimos 7 días (el 2026-11-09, en 24 horas, unos 9,1 s y 10,7 s);
* las confirmaciones que Canton rechazó y los bloques que se confirmaron tras reintentarlo;
* las patas liquidadas, por tipo.

**La lista** tiene una fila por bloque. Cada fila muestra:

* la actualización de Canton y el bloque de EVM que contiene, además de cuántas transacciones de EVM liquidó;
* el estado: confirmado en el primer intento o tras más intentos, y cuántos rechazó Canton;
* la opción, `Advance` en el contrato `ZkChain` de la cadena;
* las patas que liquidó el bloque, por tipo;
* el tiempo de liquidación, desde el inicio de la prueba del bloque hasta la hora de registro de Canton, y la hora de registro.

Muestra todos los bloques o solo los confirmados en el primer intento, los que se reintentaron, los que Canton rechazó al menos una vez o los que liquidaron patas. Ordena la lista de más recientes a más antiguos o al revés. **CSV** descarga las primeras 1.000 filas de la vista abierta, en el orden en que aparecen, y `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` devuelve el mismo archivo.

**Una actualización** abre una página con una cronología (bloque creado, inicio de la prueba, fin de la prueba, envío a Canton, confirmación en Canton), todos los intentos de confirmación hasta el que se completó, la comprobación de la prueba y las patas que liquidó el bloque. Junto a la comprobación aparece la comparación que hace el explorador entre la prueba y los valores fijados. Los datos provienen del registro de Canton y del registro del propio creador (la página marca estos datos como "registro del productor"); si el registro no contiene un bloque, se muestra lo que consta en Canton y se omite el resto.

Las cifras principales están en la página de **Estadísticas** , en una tarjeta de llamadas externas, y `GET /api/canton/stats` las proporciona en formato JSON.

## Comprueba la prueba en tu navegador

Leer los valores de la prueba no significa verificarla. Al pulsar Verificar, se descarga una compilación WebAssembly de la función `verify` del sidecar y se ejecuta sobre la prueba, el encabezado y las transacciones registradas.

La comprobación verifica la prueba PLONK con la clave de programa y la versión de ZisK fijadas. Comprueba que el hash del encabezado coincida con el hash del bloque probado y que las transacciones coincidan con la raíz de transacciones del encabezado. El panel también exige que el hash del bloque coincida con el hash de reth para ese bloque.

Los valores fijados esperados provienen de la respuesta de estado del explorador. La verificación ejecuta la comprobación de bloque del sidecar; no ejecuta la comprobación independiente de `legs`  . El botón está deshabilitado mientras se genera la prueba del bloque. Tras la comprobación, el panel muestra el resultado, la duración y el tamaño de descarga del módulo. La duración no incluye la descarga. Consulta el [README del verificador del navegador](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/verify/README.md).

## Usa el faucet de tROME

El faucet entrega 1 tROME por solicitud a cualquiera. tROME es la moneda de prueba de Ostia DevNet y no tiene valor. Abre la página del faucet o envía `POST /api/faucet`. Los límites son:

* una solicitud por dirección cada 24 horas;
* una solicitud por dirección IP cada 10 minutos;
* 5.000 pagos por hora entre todos los clientes.

La solicitud se pone en cola de inmediato y se responde con un ticket. El faucet procesa la cola en lotes de hasta 100 solicitudes, y el pago llega una vez que su bloque alcanza la finalidad. `GET /api/faucet/ticket/<id>` indica dónde está tu solicitud. Los límites se guardan en la base de datos, así que reiniciar el servicio no los restablece. Lee la [sección del faucet](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet) para obtener más información.

**La subvención para desarrolladores.** Quienes desarrollan y acceden con GitHub reciben 100 tROME en lugar de 1. Escribe tu dirección en la página del Faucet y elige «Sign in with GitHub» en la línea «¿Desarrollas en Ostia? Inicia sesión con GitHub para recibir 100 tROME». GitHub te redirigirá a la página, que hará un seguimiento de tu subvención hasta que alcance la finalidad. La cuenta de GitHub debe tener al menos 30 días. Cada cuenta de GitHub y cada dirección reciben una subvención cada 7 días, y el faucet concede como máximo 200 subvenciones al día entre todos. La página no solicita ningún permiso a GitHub. [Ostia DevNet](https://docs.rome.builders/es/canton-zk-evm/devnet.md#the-builder-grant) incluye los pasos y los límites.

## Usa las API

Las tres API están abiertas y no requieren claves. Los límites se aplican por cliente.

| API                                           | Dirección  | Límite                                              |
| --------------------------------------------- | ---------- | --------------------------------------------------- |
| JSON-RPC, solo bloques finalizados, solo HTTP | `/rpc`     | 300 llamadas por minuto, lotes de hasta 20          |
| REST, descrita en `/api/openapi.json`         | `/api/...` | 20 solicitudes por segundo, con ráfagas de hasta 60 |
| Compatible con Etherscan                      | `/api`     | 10 solicitudes por segundo y 600 por minuto         |

La API RPC no admite WebSocket ni filtros, así que consulta periódicamente `eth_getLogs`. `GET /api/stream` es el flujo en tiempo real que usan las páginas. `GET /api/status` informa de la cadena, la clave de programa fijada y el estado de cada componente.

Para verificar el código fuente de un contrato, usa `forge verify-contract` con el verificador de Etherscan:

```sh
forge verify-contract <address> src/Counter.sol:Counter \
  --chain-id 770101 \
  --evm-version london \
  --verifier etherscan \
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \
  --etherscan-api-key any
```

Usa la misma versión del compilador, la misma configuración del optimizador y la misma versión de EVM que en el despliegue. Puedes enviar 30 verificaciones por hora. Un contrato con muchos archivos de código fuente puede provocar que forge devuelva HTTP 413, porque forge envía la entrada codificada como URL y el proxy frontal del explorador admite unos 300 KB por solicitud. Consulta [Verificar un contrato grande](https://docs.rome.builders/es/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [Desarrollar en Ostia](https://docs.rome.builders/es/canton-zk-evm/build-on-ostia.md) explica cómo desplegar; los [límites de frecuencia](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) están en el README del explorador.

## Qué puede ver la parte lectora

El explorador lee Canton como una parte lectora, con un token de solo lectura. Esa parte observa el registro del bloque y nada más del paquete Daml de Ostia. Ve el número, el hash, el hash del bloque anterior, el encabezado, las transacciones y la prueba de cada registro, además del ID de actualización, la hora del registro y los dos firmantes. No puede ver las solicitudes de depósito, las aceptaciones de retiro ni las condiciones de pago, por lo que nada de eso aparece en el explorador.

Los fondos que posee la pasarela se obtienen de un segundo cliente de solo lectura que lee como parte de la pasarela. Muestra totales: la tarjeta «Respaldado en Canton», la página `/twins` , la tarjeta de activos de Canton en Estadísticas y `GET /api/twins`. También lee las operaciones de la plataforma y las reclamaciones financiadas que están detrás `/swaps` y `GET /api/swaps`, conservando el pago, la reclamación y sus actualizaciones de Canton, y descartando las partes de Canton del mercado y del vendedor.

El límite del lector es el del propio explorador. El operador del participante que aloja las partes de Ostia puede seguir viéndolo todo allí; en DevNet, ese operador es Rome, que ejecuta el participante como su propio validador de Canton DevNet. [Modelo de confianza y limitaciones](https://docs.rome.builders/es/canton-zk-evm/trust-model.md) explica qué significa eso. Verify ejecuta en tu navegador la comprobación del sidecar sobre los datos que sirve este explorador.

Para ejecutar tu propio explorador con su base de datos, consulta [Ejecuta tu propio Ostia](https://docs.rome.builders/es/canton-zk-evm/run-it-locally.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/explorer.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.
