> 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/zh/canton-zk-evm/explorer.md).

# Explorer

关于可用的 Ostia DevNet 浏览器、水龙头、API，以及在浏览器中进行证明校验的指南。

Ostia 浏览器现已上线： [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz)。它将 reth 的 EVM 数据与每个区块的 Canton 记录结合起来，并以读取方身份读取这些记录。你可以用它查找区块或交易、在浏览器中检查证明、验证合约、获取 tROME，并通过 API 读取相同的数据。

本页面介绍的是 `v0.1.0` 版本；如有说明，也会介绍 DevNet 当前运行的内容。 [状态](https://docs.rome.builders/zh/canton-zk-evm/status.md) 列出 DevNet 正在运行的提交版本。请阅读完整的 [浏览器 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

只有当区块记录已写入 Canton 后，浏览器才会将区块标记为最终确定。在此之前，它会显示来自 reth、正在等待证明的区块；你刚发送的交易则会显示为待处理状态。当没有待处理交易时，区块构建器会每分钟生成一个空区块，因此在链上活动较少时，最新区块的时间也不会比当前时间早太多，通常不超过几分钟。所有页面上的时间均为 UTC。

## 页面导览

| 页面     | 可在此执行的操作                                                                                                                                            |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 首页     | 按区块、交易、地址或 Canton 更新 ID 搜索。查看最新的最终确定区块、正在等待证明的区块、最终确定所需时间、证明时间和最新区块。状态栏会显示 EVM 节点、Canton、区块生产器、证明器、水龙头和验证器是否运行正常。Canton 提交时间卡片会打开“外部调用”页面。          |
| 区块     | 列出已最终确定的区块，可筛选出包含交易的区块、下载 CSV 文件或打开某个区块。                                                                                                            |
| 交易     | 列出交易，并可筛选出尚未最终确定、失败或合约调用的交易。交易页面会显示结果、区块、Canton 更新、费用、解码后的输入，以及交易最终确定四个阶段的时间线。                                                                      |
| 合约     | 查看哪些合约已验证，以及它们的使用频率。合约页面会显示已验证的源代码、ABI、事件，以及读取和写入调用。写入调用通过你的钱包发起。                                                                                   |
| 代币     | 浏览 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，并使用你已有的 Canton 钱包在 Ostia 和 Canton 之间转移代币（按钱包逐步启用；启用前，按钮会显示“即将推出”）。请参阅 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md). |
| 水龙头    | 申请 tROME，或通过 GitHub 登录以领取 100 tROME 的构建者奖励，并跟踪申请直至最终确定。                                                                                             |
| API    | 查看根据 OpenAPI 文档生成的 API 参考。点击按钮即可将 Ostia DevNet 添加到你的钱包。                                                                                             |

除首页外，每个页面的页眉都带有搜索框；首页有自己的搜索框。按 `/` 键可聚焦搜索框。区块、交易、地址的交易和转账记录，以及代币的转账记录，均可下载为 CSV 文件。页面会订阅实时数据流，因此新区块会自动显示，无需重新加载。地址页面和网关分段页面可通过链接打开；地址页面也可通过搜索打开，但页眉中没有指向这些页面的入口。

## 查看区块

区块页面会并列显示其 EVM 数据和 Canton 相关信息：更新 ID、记录时间，以及为记录签名的操作方和确认方。页面会比较 reth 的区块哈希、记录中的哈希和记录的区块头哈希，并显示三者是否一致。页面还会将证明中读取到的程序密钥、ZisK 版本和区块哈希与浏览器预期值并列显示。不匹配的值会以红色显示。

四个信息卡片以数字呈现区块数据：交易数、证明时间、Canton 提交耗时（从提交区块到 Canton 记录该区块的时间），以及从区块生成到最终确定所需的时间。首页和统计页面中的 Canton 提交时间卡片，统计的是从提交区块到区块构建器收到 Canton 回复的时间，因此显示的数值会高于此处的信息卡片。一个名为“此区块如何最终确定”的面板会按顺序列出各步骤及其耗时。

正在等待证明的区块尚未写入 Canton。页面会明确说明这一点，并持续刷新，直到区块最终确定。交易可能处于等待中、证明中或已最终确定的状态。区块页面会列出网关分段，呈现其在 EVM 中的记录。 `BlockRecord` 并未记录每条 leg 在 Canton 上的结算情况，因此浏览器无法显示这些信息。请参阅 [Leg 与托管](#legs-and-custody) 查看在 DevNet 上运行的 leg。

## Leg 与托管

网关的 leg 已在 DevNet 上运行，由 Rome 使用测试参与方运行（参见 [存款、取款和支付](https://docs.rome.builders/zh/canton-zk-evm/deposits-withdrawals-payments.md)），因此这些页面现在已有内容。不过，页眉中尚未添加它们的入口；请直接打开 [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) ，或从区块页面跟进某条 leg。

* **列表** 位于 `/legs` ，显示每条 leg 的类型（存款、支付或取款）、区块、代币、账户和金额。打开某条 leg，可查看其专属页面： `/leg/<id>`。取款记录会注明付款所对应的 Canton 参与方。2026-10-25 11:54 UTC 时，列表中有六条 leg，来自当天的两次运行（区块 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` 对象中提供相同数据。页面只显示总量，不会显示任何单笔持有记录。自 2026-10-25 12:27 UTC 起，DevNet 已支持读取托管量。当天 12:52 UTC 时，wTKB 的托管量为 12 TKB，分为两笔持有记录；封装代币供应量为 12 wTKB。

## Twin 与 Canton 资产

浏览器会显示双向 Canton 资产（参见 [存款、取款和支付](https://docs.rome.builders/zh/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)）。打开 [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins)。页面包含：

* **注册表。** 链上记录注册的金库，包括各金库的代码哈希，以及其绑定的 twin 和对应精度。
* **每个 twin 的卡片。** 展示其在 Canton 上的供应量，以及金库持有量；两者在同一区块读取，并注明统计所对应的区块，以及锁定和赎回的数量。每次锁定和赎回后，两者都会保持一致。
* **托管量与供应量对照** 适用于 Canton 代币，例如 wTKB 和 CC：展示网关在 Canton 上的持有量与封装代币供应量。
* **最近的锁定和赎回记录。** 每条记录都链接到对应的 leg、交易、区块和 Canton 更新。
* **注册表服务。** 提供一行内容，并链接到 twin 注册表服务的健康检查。

Stats 中的 Canton 资产卡片会展示相同的供应量，并对照金库和网关的持有量； `GET /api/twins` 以 JSON 格式提供整个页面的数据。页面只显示总量，不会显示任何单笔持有记录。

## 外部调用

打开 **外部调用** 在页眉中，位于 [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton)。Ostia 将每个区块作为一笔 Canton 交易提交。确认参与方的外部调用会检查区块内的证明；在 DevNet 上，该参与方是 Rome。本页展示了每次提交的情况。

**页眉** 显示所有区块的统计数据：

* 已提交的区块数；
* 成功率，即成功提交次数占尝试次数的比例；截至 2026-11-09，所有区块的成功率为 99.99%；
* 结算时间，以过去 24 小时或过去 7 天的数据计算平均值和 p95 值（截至 2026-11-09，过去 24 小时的平均值约为 9.1 秒，p95 值约为 10.7 秒）；
* 被 Canton 拒绝的提交次数，以及重试后成功提交的区块数；
* 按类型统计的已结算 leg 数。

**列表** 每个区块占一行。每行显示：

* Canton 更新及其包含的 EVM 区块，以及该区块结算的 EVM 交易数；
* 状态：首次尝试即提交成功，或经过多次尝试后提交成功，并显示 Canton 拒绝的次数；
* 在链上 `Advance` 选择 `ZkChain` 合约；
* 按类型统计的该区块已结算 leg 数；
* 结算时间（从区块证明开始到 Canton 记录时间），以及记录时间。

可显示所有区块，也可仅显示首次尝试即提交成功、重试过、至少被 Canton 拒绝过一次，或结算过 leg 的区块。列表可按时间从新到旧或从旧到新排序。 **CSV** 会按当前视图的排序下载前 1,000 行； `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` 则会返回相同的文件。

**单次更新** 打开一个页面，其中包含时间线（区块构建、证明开始、证明完成、提交至 Canton、在 Canton 上提交成功）、直至提交成功为止的每次提交尝试、证明检查结果，以及该区块结算的 leg。页面会在检查结果旁显示区块浏览器对证明与固定值的自行比对。相关信息来自 Canton 记录和构建器自身的日志（页面将这些信息标记为“producer log”）；如果日志中没有某个区块，页面会显示 Canton 记录的内容，而不展示其余信息。

主要统计数据位于 **统计** 页面的“外部调用”卡片中； `GET /api/canton/stats` 则以 JSON 格式提供这些数据。

## 在浏览器中验证证明

读取证明中的值并不等于验证证明。点击“验证”后，浏览器会下载 sidecar 的 WebAssembly 构建版本，其中包含 `verify` 函数，并使用记录的证明、区块头和交易运行该函数。

此检查会使用固定的程序密钥和 ZisK 版本验证 PLONK 证明，并检查区块头的哈希是否与已证明的区块哈希一致，以及交易是否与区块头中的交易根一致。面板还会要求该区块哈希与 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 tROME。在 Faucet 页面输入你的地址，然后在“在 Ostia 上构建？使用 GitHub 登录即可获得 100 tROME。”这行中选择“使用 GitHub 登录”。GitHub 会将你带回该页面，页面会跟踪你的资助，直至最终确认。GitHub 账号必须至少注册满 30 天。每个 GitHub 账号和每个地址每 7 天可领取一次资助；水龙头每天最多向所有人合计发放 200 笔资助。该页面不会向 GitHub 请求任何权限。 [Ostia DevNet](https://docs.rome.builders/zh/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 KB。请参阅 [验证大型合约](https://docs.rome.builders/zh/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [在 Ostia 上构建](https://docs.rome.builders/zh/canton-zk-evm/build-on-ostia.md) 介绍了部署； [速率限制](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) 详见区块浏览器的 README。

## 读取方可见的内容

区块浏览器使用只读令牌，以读取方身份读取 Canton。该读取方只能查看区块记录，无法查看 Ostia 的 Daml 包中的其他内容。它可以看到每条记录的编号、哈希、父哈希、标头、交易和证明、更新 ID 和记录时间，以及两名签署者。它无法查看存款请求、提款受理记录或付款条款，因此这些内容都不会显示在区块浏览器中。

网关持有量来自第二个只读客户端，该客户端以网关方身份读取数据。它显示汇总数据： “在 Canton 上获得支持”卡片、 `/twins` 页面、Stats 页面上的 Canton 资产卡片，以及 `GET /api/twins`。它还会读取场所交易以及背后的已注资申领 `/swaps` 和 `GET /api/swaps`，保留付款、申领及其 Canton 更新，同时丢弃场所和卖方的 Canton 参与方信息。

读取者所受的限制由浏览器本身决定。托管 Ostia 参与方的参与方运营者仍然可以在那里查看所有内容；在 DevNet 上，该运营者是 Rome，它将参与方作为自己的 Canton DevNet 验证者运行。 [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md) 说明了这意味着什么。Verify 会在你的浏览器中，使用此浏览器提供的数据运行 sidecar 的检查。

要运行自己的浏览器及其数据库，请参阅 [运行你自己的 Ostia](https://docs.rome.builders/zh/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/zh/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.
