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

# Обозреватель

Руководство по работающему обозревателю Ostia DevNet, его крану, API и проверке доказательства в браузере.

Обозреватель Ostia доступен по адресу [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz). Он объединяет данные EVM от reth с записями Canton для каждого блока, которые он считывает от имени стороны reader. Используйте его, чтобы найти блок или транзакцию, проверить доказательство в браузере, верифицировать контракт, получить tROME и обращаться к тем же данным через API.

На этой странице описан релиз `v0.1.0` а также, если это указано, версия, которая сейчас работает в DevNet. [Статус](https://docs.rome.builders/ru/canton-zk-evm/status.md) указывает коммит, который работает в DevNet. Полную информацию см. в [README обозревателя](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

Обозреватель помечает блок как финализированный, только когда его запись появляется в Canton. До этого он показывает блок из reth как проходящий проверку, а только что отправленная вами транзакция отображается как ожидающая. Если транзакций в очереди нет, создатель формирует пустой блок раз в минуту, поэтому самый новый блок в спокойной сети обычно отстоит от текущего времени не более чем на пару минут. Время на всех страницах указано в UTC.

## Обзор страниц

| Страница            | Возможности                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Главная             | Ищите по блоку, транзакции, адресу или идентификатору обновления Canton. Просматривайте последний финализированный блок, блок на проверке, время до финализации, время проверки и последние блоки. Полоса состояния показывает, исправны ли узел EVM, Canton, производитель, система проверки доказательств, кран и верификатор. Плитка со временем коммита Canton открывает раздел External calls. |
| Блоки               | Просматривайте список финализированных блоков, фильтруйте блоки с транзакциями, скачивайте CSV-файл и открывайте отдельные блоки.                                                                                                                                                                                                                                                                   |
| Транзакции          | Просматривайте список транзакций и фильтруйте по тем, которые ещё не финализированы, завершились с ошибкой или являются вызовами контрактов. Для каждой транзакции отображаются результат, блок, обновление Canton, комиссия, декодированные входные данные и временная шкала четырёх этапов финализации.                                                                                           |
| Контракты           | Узнайте, какие контракты верифицированы и как часто они используются. На странице контракта представлены верифицированный исходный код, ABI, события, а также вызовы Read и Write. Вызовы Write выполняются через ваш кошелёк.                                                                                                                                                                      |
| Токены              | Просматривайте токены ERC-20, ERC-721 и ERC-1155, а также их держателей и переводы. На отдельной вкладке перечислены токены, поступающие из Canton, например wTKB и CC.                                                                                                                                                                                                                             |
| Внешние вызовы      | Просматривайте коммиты каждого блока в Canton: одна строка на блок со статусом, временем расчёта и числом попыток. Раздел открывается по ссылке "Внешние вызовы" в заголовке. Подробнее см. в разделе [Внешние вызовы](#external-calls).                                                                                                                                                            |
| Статистика          | Просматривайте время до финализации, время проверки, время коммита Canton, число транзакций в секунду и долю успешных операций за 1 час, 6 часов, 24 часа, 7 дней или 30 дней. Карточка активов Canton показывает объём каждого актива и количество, хранящееся в хранилище и шлюзе. Карточка внешних вызовов показывает, как проходят коммиты в Canton.                                            |
| Двусторонние активы | Просматривайте двусторонние активы Canton на странице [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins): объём каждого двустороннего актива в сравнении с балансом хранилища, а также последние блокировки и погашения.                                                                                                                                                                       |
| Обмены              | Просматривайте обмены между площадкой Canton и EVM на странице [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)и открывайте отдельный обмен, чтобы увидеть платёж и его получение.                                                                                                                                                                                                           |
| Мост                | Подключите кошелёк, получите тестовые tROME и переводите токены между Ostia и Canton с помощью уже имеющегося у вас кошелька Canton (функция включается отдельно для каждого кошелька; до этого на кнопке отображается надпись "Скоро"). См. [Мост](https://docs.rome.builders/ru/canton-zk-evm/bridge.md).                                                                                         |
| Кран                | Запросите tROME или войдите через GitHub, чтобы получить 100 tROME в качестве гранта для разработчиков, и отслеживайте запрос до финализации.                                                                                                                                                                                                                                                       |
| API                 | Читайте справочник API, сформированный на основе документа OpenAPI. Кнопка добавляет Ostia DevNet в ваш кошелёк.                                                                                                                                                                                                                                                                                    |

На всех страницах, кроме главной, в заголовке есть поле поиска; на главной используется собственное поле. Клавиша `/` переводит на него фокус. Для блоков, транзакций, транзакций и переводов по адресу, а также переводов токена можно скачать CSV-файл. Страницы подписаны на поток обновлений, поэтому новые блоки появляются без перезагрузки. Страницы адресов и этапов шлюза открываются по ссылкам; адреса также можно открыть из результатов поиска. В заголовке для них нет отдельного пункта.

## Просмотр блока

На странице блока данные EVM показаны рядом с данными Canton: идентификатор обновления, время записи, а также операторы и подтверждающие лица, подписавшие запись. Здесь сравниваются хеш блока reth, хеш записи и хеш заголовка из записи, а также указывается, совпадают ли все три значения. Кроме того, отображаются ключ программы, версия ZisK и хеш блока, прочитанные из доказательства, рядом с ожидаемыми значениями обозревателя. Несовпадающее значение выделяется красным.

Четыре плитки показывают основные параметры блока: транзакции, время проверки, коммит в Canton (время от отправки блока до времени его записи в Canton) и время от создания блока до финализации. В карточках коммита Canton на главной странице и в разделе статистики отсчёт ведётся от отправки блока до получения создателем ответа Canton, поэтому значения там выше, чем в этой плитке. Панель «Как этот блок был финализирован» перечисляет этапы и время их прохождения.

Блок, проходящий проверку, ещё не записан в Canton. На странице это указано, и она обновляется, пока блок не будет финализирован. Транзакция может ожидать обработки, проходить проверку или быть финализированной. На странице блока перечислены этапы шлюза в том виде, в каком их записала EVM. `BlockRecord` не содержит сведений о том, как завершился расчёт каждой операции на Canton, поэтому обозреватель не может это показать. См. [Операции и хранение активов](#legs-and-custody) для операций, доступных в DevNet.

## Операции и хранение активов

Операции шлюза доступны в DevNet, где Rome работает с тестовыми участниками (см. [Депозиты, вывод средств и платежи](https://docs.rome.builders/ru/canton-zk-evm/deposits-withdrawals-payments.md)), поэтому на этих страницах уже есть содержимое. В заголовке ссылки на них пока нет; откройте [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) напрямую или перейдите к операции из её блока.

* **Список** на странице `/legs` показывает все операции с указанием их типа (депозит, платёж или вывод средств), блока, токена, аккаунта и суммы. Откройте отдельную страницу операции по адресу `/leg/<id>`. Для вывода средств указывается участник Canton, которому были перечислены средства. В 11:54 UTC 2026-10-25 в списке было шесть операций из двух запусков за этот день (блоки 780, 783, 784, 1465, 1471 и 1473).
* **API** предоставляет те же данные по адресам `/api/legs`, `/api/legs/<id>` и `/api/blocks/<number>/legs`.
* **Обёрнутый токен** wTKB по адресу `0x294d3049874526910a69f6b61da14d10a8b1b3af`, как и для любого токена ERC-20, имеет отдельную страницу (10 знаков после запятой). На блоке 1473 его предложение составляло 12 wTKB; запуск Rome подтвердил, что шлюз хранит на Canton 12 TKB.
* **Хранение активов и предложение токенов.** На странице токена, обеспеченного активами Canton, отображается карточка «Обеспечение на Canton»: сколько средств хранит шлюз на Canton и каков объём обёрнутых токенов по данным на один и тот же блок. Метод `GET /api/tokens/<address>` возвращает те же показатели в объекте `canton` . Отображается только общая сумма, без сведений об отдельных активах. Данные о хранении доступны в DevNet с 12:27 UTC 2026-10-25. В 12:52 UTC того же дня для wTKB было указано 12 TKB в двух хранилищах при объёме обёрнутых токенов 12 wTKB.

## Твины и активы Canton

Обозреватель показывает двусторонние активы Canton (см. [Депозиты, вывод средств и платежи](https://docs.rome.builders/ru/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)). Откройте [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins). Здесь представлены:

* **Реестр.** Хранилища, зарегистрированные в записи цепочки, с хешем кода каждого хранилища, и связанные с ними твины с указанием количества знаков после запятой.
* **Карточка для каждого твина.** В ней указаны предложение токена на Canton и объём активов в хранилище по данным на один и тот же блок, а также блок, по которому они подсчитаны, и количество блокировок и погашений. После каждой блокировки и погашения значения совпадают.
* **Хранение активов и предложение токенов** для токенов Canton, таких как wTKB и CC: сколько средств шлюз хранит на Canton и каков объём обёрнутых токенов.
* **Последние блокировки и погашения.** Для каждой указаны ссылки на операцию, транзакцию, блок и обновление Canton.
* **Сервис реестра.** Строка со ссылкой на проверку работоспособности сервиса реестра твинов.

В карточке активов Canton на странице статистики отображаются те же объёмы предложения токенов и количество активов в хранилище и у шлюза. Метод `GET /api/twins` возвращает данные всей страницы в формате JSON. Отображаются только общие суммы, без сведений об отдельных активах.

## Внешние вызовы

Открыть **Внешние вызовы** в заголовке, по адресу [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton). Ostia фиксирует каждый блок как отдельную транзакцию Canton. Внешний вызов подтверждающего участника проверяет содержащийся в блоке пруф; в DevNet этим участником является Rome. На этой странице показано, как прошла фиксация каждого блока.

**В заголовке** сводные данные по всем блокам:

* зафиксированные блоки;
* доля успешных фиксаций — отношение числа успешных фиксаций к числу попыток; по состоянию на 2026-11-09 она составляла 99.99% для всех блоков;
* время фиксации: среднее значение и p95 за последние 24 часа или последние 7 дней (на 2026-11-09 за 24 часа — около 9.1 с и 10.7 с соответственно);
* число отклонённых Canton фиксаций и блоков, зафиксированных после повторной попытки;
* число завершённых этапов legs по типам.

**В списке** для каждого блока есть отдельная строка. В ней указаны:

* обновление Canton и содержащийся в нём блок EVM, а также число завершённых транзакций EVM;
* статус: зафиксирован с первой попытки или после нескольких попыток, с указанием числа отклонений со стороны Canton;
* выбранный вариант — `Advance` в контракте `ZkChain` блокчейна;
* завершённые блоком этапы legs по типам;
* время фиксации — от начала создания пруфа блока до времени записи в Canton, а также время записи.

Показывайте все блоки или только зафиксированные с первой попытки, повторно отправленные, хотя бы раз отклонённые Canton или завершившие этапы legs. Сортируйте список сначала от новых к старым или наоборот. **CSV** скачивает первые 1 000 строк открытого представления в том же порядке, а запрос `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` возвращает тот же файл.

**При нажатии на обновление** открывается страница с временной шкалой (создание блока, запуск генерации пруфа, завершение генерации, отправка в Canton, фиксация в Canton), всеми попытками фиксации до успешной включительно, проверкой пруфа и этапами legs, завершёнными блоком. Рядом с результатом проверки отображается собственное сравнение пруфа с закреплёнными значениями, выполненное обозревателем. Данные берутся из записи Canton и собственного журнала сборщика (на странице они помечены как "журнал производителя"); если в журнале нет сведений о блоке, отображаются данные Canton, а остальные сведения опускаются.

Основные показатели доступны на странице **«Статистика»** в карточке «Внешние вызовы», а запрос `GET /api/canton/stats` возвращает их в формате JSON.

## Проверка пруфа в браузере

Чтение значений из пруфа не означает его проверку. Нажмите «Проверить», чтобы скачать сборку WebAssembly функции `verify` из sidecar-компонента и запустить её для записанных пруфа, заголовка и транзакций.

Проверка подтверждает пруф PLONK с использованием закреплённого ключа программы и релиза ZisK. Также проверяется, что хеш заголовка совпадает с доказанным хешем блока, а транзакции соответствуют корню транзакций в заголовке. Кроме того, панель требует, чтобы хеш блока совпадал с хешем этого блока в reth.

Ожидаемые закреплённые значения берутся из ответа обозревателя о состоянии. Проверка запускает проверку блока в sidecar-компоненте; отдельная проверка `legs` не выполняется. Во время генерации пруфа кнопка недоступна. После проверки на панели отображаются результат, длительность и размер загруженного модуля. Время загрузки не учитывается в длительности. См. файл [README средства проверки в браузере](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/verify/README.md).

## Использование крана tROME

Кран выдаёт по 1 tROME за запрос любому пользователю. tROME — тестовая монета Ostia DevNet, не имеющая ценности. Откройте страницу крана или отправьте запрос `POST /api/faucet`. Действуют следующие ограничения:

* один запрос с адреса раз в 24 часа;
* один запрос с IP-адреса раз в 10 минут;
* 5 000 выплат в час для всех клиентов.

Запрос сразу помещается в очередь, а в ответ вы получаете идентификатор заявки. Кран обрабатывает очередь пакетами до 100 выплат, а ваша выплата поступает после финализации блока, в который она включена. `GET /api/faucet/ticket/<id>` показывает состояние вашего запроса. Ограничения хранятся в базе данных, поэтому после перезапуска они не сбрасываются. Подробности см. в [разделе о кране](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet) .

**Грант для разработчиков.** Разработчик, который входит через GitHub, получает 100 tROME вместо 1. Укажите свой адрес на странице крана и выберите «Войти через GitHub» в строке «Разрабатываете на Ostia? Войдите через GitHub, чтобы получить 100 tROME». GitHub перенаправит вас обратно на страницу, где можно следить за грантом до его финализации. Возраст аккаунта GitHub должен быть не менее 30 дней. Каждый аккаунт GitHub и каждый адрес могут получить один грант раз в 7 дней. Всего кран выдает не более 200 грантов в день. Страница не запрашивает у GitHub никаких разрешений. [Ostia DevNet](https://docs.rome.builders/ru/canton-zk-evm/devnet.md#the-builder-grant) содержит инструкции и сведения об ограничениях.

## Использование API

Все три API доступны без ключей. Ограничения применяются отдельно к каждому клиенту.

| API                                                   | Адрес      | Ограничение                                |
| ----------------------------------------------------- | ---------- | ------------------------------------------ |
| JSON-RPC, только финализированные блоки, только HTTP  | `/rpc`     | 300 вызовов в минуту, пакеты до 20 вызовов |
| REST, описание доступно по адресу `/api/openapi.json` | `/api/...` | 20 запросов в секунду, всплески до 60      |
| Совместимый с Etherscan                               | `/api`     | 10 запросов в секунду и 600 в минуту       |

В RPC нет WebSocket и фильтров, поэтому используйте опрос `eth_getLogs`. `GET /api/stream` — это поток данных в реальном времени, который используют страницы. `GET /api/status` сообщает сведения о сети, закрепленном ключе программы и состоянии каждого компонента.

Чтобы проверить исходный код контракта, используйте `forge verify-contract` с верификатором 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
```

Используйте те же версии компилятора и EVM, а также те же настройки оптимизатора, что и при развертывании. Можно отправлять до 30 запросов на верификацию в час. Для контрактов со множеством файлов исходного кода forge может вернуть ошибку HTTP 413: forge отправляет входные данные в формате URL-кодирования, а обратный прокси обозревателя принимает запросы размером примерно до 300 КБ. См. [Верификация крупного контракта](https://docs.rome.builders/ru/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [Разработка на Ostia](https://docs.rome.builders/ru/canton-zk-evm/build-on-ostia.md) содержит инструкции по развертыванию; сведения об [ограничениях частоты запросов](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) приведены в README обозревателя.

## Что видит сторона-наблюдатель

Обозреватель читает данные Canton от имени стороны-наблюдателя, используя токен только для чтения. Эта сторона видит запись блока и больше ничего из Daml-пакета Ostia. Ей доступны номер, хеш, хеш родительского блока, заголовок, транзакции и доказательство для каждой записи, а также идентификатор обновления, время записи и две стороны-подписанта. Она не видит запросы на внесение депозита, подтверждения вывода или условия платежей, поэтому в обозревателе они не отображаются.

Данные о средствах шлюза поступают от второго клиента только для чтения, который считывает данные от имени стороны шлюза. Он показывает сводные значения: карточку «Обеспечено в Canton», страницу `/twins` и карточку активов Canton на странице «Статистика», а также `GET /api/twins`. Он также читает сделки площадки и профинансированные требования, связанные с `/swaps` и `GET /api/swaps`, сохраняя платеж, требование и обновления Canton для них и отбрасывая стороны Canton площадки и продавца.

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

Инструкции по запуску собственного обозревателя с собственной базой данных см. в разделе [Запустите собственный Ostia](https://docs.rome.builders/ru/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/ru/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.
