> 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/how-it-works.md).

# 工作原理

跟随一个 Ostia 区块从 reth 经证明到其 Canton 提交。

构建器持续运行。只要有交易在等待，它就会切出一个区块、为其生成证明并提交到 Canton。代码默认一次只允许一个区块在处理中；DevNet 最多允许两个，并配备一个 GPU 证明器。区块仍按顺序在 Canton 上提交。当 DevNet 连续 60 秒没有生成区块时，构建器会切出一个空区块作为心跳（代码默认关闭此功能），因此即使链上没有活动，也大约每分钟会生成一个区块。Canton 决定每个区块是否成为链上的下一个头部。EVM 区块及其记录的 Canton 操作会在同一笔交易中提交。

本页介绍发布版本 `v0.1.0` 并在注明之处说明 DevNet 当前运行的内容。 [状态](https://docs.rome.builders/zh/canton-zk-evm/status.md) 标明 DevNet 运行的提交版本。阅读完整的 [设计](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md)。若要沿着以下步骤追踪自己的交易，请跳转到 [从你的交易到在 Canton 上最终确认](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["EVM 交易"] --> Q["公共 RPC：仅显示最终确认的区块"]
    Q --> R["reth 按需构建"]
    R --> B["构建器读取网关操作并查找对应的 Canton 合约"]
    B -->|"某项操作无法结算：排除其交易并重新构建"| R
    B -->|"所有操作均可结算"| P["ZisK 为区块生成证明"]
    P --> A["Advance：在一笔 Canton 交易中提交区块、证明和操作"]
    A --> S["外部调用：边车程序检查证明和网关状态"]
    S --> D["Daml 检查头部并结算各项操作"]
    D --> C["Canton 一并提交区块及其操作"]
    C --> F["reth 将区块标记为最终确认"]
    F --> Q
    C --> X["区块浏览器索引器读取区块记录并与 reth 核对"]
```

## 基于 Canton 的头部构建

钱包将 EVM 交易发送到公共 RPC，后者再将交易转发给 reth。RPC 仅显示已在 Canton 上最终确认的区块，因此区块最终确认后才会显示收据。提供的启动器会关闭对等节点发现。构建器请求 reth 构建区块时，reth 才会生成区块。

构建器首先读取 Canton 上当前有效的 `ZkChain` 合约，并将 reth 的头部、安全区块和最终确认区块推进到该已提交头部。它按价格选择待处理交易，同时保持每个发送方的 nonce 顺序。自 2026-10-25 起，区块按交易实际使用的 gas 填充（由 reth 计算），而不是按交易声明的 gas 限额填充：钱包通常声明的 gas 约为实际使用量的三倍，若按声明限额计算，区块容量大约只能用到三分之一。区块在达到 gas 上限时结束。在 DevNet 上，构建器通常还会限制提交给 reth 的交易原始字节数不超过 393,216，因为参与方处理区块的工作量会随区块大小增加；但如果首笔交易超出此限制，仍会将其提交，以免它一直等待。构建器会向 reth 提供明确的交易列表并请求构建区块。

需要执行 Canton 操作的 EVM 交易会调用网关。网关记录一项操作，并将其纳入持续累积的哈希值。构建器按日志顺序读取网关事件，并查找每项操作所需的 Canton 合约。

如果某项分配已不存在、接收方尚未接受提款，或缺少其他必需合约，构建器就会排除该交易及该发送方后续的交易。随后，它会将 reth 恢复到 Canton 的头部并重新构建。这些检查在生成证明之前进行。 [构建器 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) 列出了每项操作对应的检查。

## 为区块生成证明

构建器会保存区块和 reth 的执行见证。输入工具将区块、见证和创世配置整合为证明器输入。ZisK 运行 guest，由其根据链的固定规则验证区块。

证明器会返回一个 1,344 字节的封装证明，其中包含区块哈希。构建器提交 `Advance` 以及区块头、交易、证明、各项操作，还有网关在区块状态根处的账户证明和存储证明。

## 在一笔交易中检查并结算

每个确认参与方都会运行一个边车程序。Canton 的外部调用会将区块发送给该参与方的边车程序进行 `verify`。它会检查证明、固定的程序密钥和 ZisK 版本、区块头哈希以及交易列表的根哈希。

在 Ostia DevNet 上，Rome 运行着唯一一个托管所有 Ostia party 的参与方，因此它的一个边车程序是唯一的确认方，证明也由 Rome 自己的节点检查。Canton 的同步器会对区块排序，但不会查看证明。本地演示网络有两个确认参与方。 [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md) 说明了这会带来哪些变化。

Daml 会将结果与 `ZkChain`进行核对：父区块必须是当前头部，区块号必须是下一个编号，gas 限额和已用 gas 都必须符合上限。Daml 会比较边车程序返回的结果；它本身不会验证零知识证明。

然后，Daml 会根据各项操作所指明的 Canton 合约，为每项操作写入一条记录。提款的 ID、销毁方和金额由构建器提供；经证明的哈希会将这些内容绑定到区块记录中。边车程序的 `legs` 函数会检查网关的账户证明和存储证明，按顺序对这些记录进行哈希，并将结果与经证明状态中的网关值进行比较。不含任何操作的区块也必须通过相同检查，只是传入空列表。

Daml 会按顺序结算各项操作，并创建 `BlockRecord` 以及下一个 `ZkChain`。Canton 会将这些更改一并提交。如果检查或结算失败，则不会提交任何内容。通过使用链上唯一的状态合约，Canton 成为区块顺序的权威来源。请参阅完整的 [Daml 接口](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) 和 [侧车检查](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## 金库与双生代币

除了第一个网关外，链记录还会列出其信任的 EVM 合约，每个合约都是网关或金库，并附有其代码哈希。区块包含每个已注册网关的各项交易腿，Daml 会根据区块携带的账户证明检查每个网关的代码哈希。金库本身没有交易腿：其锁定和释放操作都是网关付款，Daml 将其地址视为这些付款的收款方或付款方。确认器会在接受条目之前检查金库的代码。添加新条目的方式与更改程序类似：由运营方和网关提出，再由确认器接受。

金库是一个小型合约，用于存放 Canton 双生代币对应的 ERC-20 代币。它没有所有者、密钥，也不可升级。锁定操作是一次普通的网关 `pay` ，收款方为金库。释放操作则是 `release(ref, token, to, amount)`，金库会通过网关付款，且该付款使用的 ID 不可能用于任何其他类型的付款；Canton 只会在持有者已签名的赎回请求中结算该操作。

双生代币是 Canton 上对应某个 ERC-20 的代币，由网关方管理。链记录会固定每个双生代币的信息：代币地址、小数位数，以及负责铸造、销毁和转账的规则合约。 `Advance` 仅会在证明所确定的锁定操作对应的情况下铸造双生代币，并且仅会在已签名的赎回请求对应的情况下销毁双生代币。

双生代币注册表服务与构建器并列运行。付款方在付款前向该服务提供收款方和 `ref` ；服务会返回锁定 ID，构建器也会读取相同的信息，将锁定操作附加到区块中。该服务还提供代币标准的双生代币注册表 API，因此，验证器已审核双生代币包的钱包可以发送这些代币。该服务不持有密钥，也不会向 Canton 写入任何内容，而 `Advance` 会检查这些信息是否能得出该 ID。各项流程请参阅 [存款、取款和付款](https://docs.rome.builders/zh/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) 。

## Canton 拒绝时

Canton 提交区块后，构建器会在 reth 中将其标记为最终状态。如果 Canton 拒绝该区块，构建器会将 reth 回退到 Canton 上一次提交的区块，并将被拒区块中的交易送回交易池。下一个区块会再次检查这些交易腿。如果某笔付款的分配已被撤回，该付款就会被排除在外。如果连续两个区块遭到拒绝，构建器会怀疑它们共同包含的交易有问题，并在冷却期内将其排除。

如果构建器丢失了提交响应，该命令仍有可能已经提交。在提交前，构建器会记录账本末端位置，然后从该位置读取该命令自身的完成结果。成功完成即视为已提交；失败则视为遭到拒绝。

Canton 的链头可以确认提交，但它本身绝不会显示“未提交”。如果没有完成结果，构建器只有在 Canton 时间经过 300 秒后才会判定为“未提交”（`CZE_RESOLVE_SECONDS`）。在此之前，构建器不会构建任何内容，并保持 reth 的状态不变。这些恢复规则见 [构建器 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## 从发送交易到在 Canton 上最终确认

1. 你向公共 RPC 发送交易。交易会在交易池中等待下一个区块。
2. 只要有交易在等待且有空位，构建器就会立即生成区块（代码默认允许一个区块处于处理中；DevNet 最多允许两个）。链处于繁忙状态期间，新区块通常每 16.6 秒接续前一个区块（中位数；统计时间为 2026-10-25 01:34 UTC 前 24 小时）。
3. ZisK 会为区块生成证明。在 2026-10-24 的一小时负载测试中，包含 11 至 100 笔交易的区块，其证明耗时中位数为 9.03 秒。
4. 区块记录连同其证明一起在 Canton 上提交。该提交使区块最终确认，随后公共 RPC 会显示你的收据。

在同一小时内，从 RPC 接收交易到该交易所在区块在 Canton 上最终确认，中位耗时为 19.5 秒，95 百分位耗时为 27.1 秒。收据生成时间比大多数链都长，因此需要等待收据的工具应设置较长的超时时间。

[测量结果](https://docs.rome.builders/zh/canton-zk-evm/measurements.md) 说明了各时间间隔的定义，并列出了测试运行记录。在区块浏览器中，打开你的交易，然后打开其所在区块，即可查看包含该记录的 Canton 更新。 [区块浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.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/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.
