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

# 从这里开始

面向每位 Ostia 读者的起点，介绍你会使用的工具以及应该查看的内容，无论你是在构建应用、在 Canton 上验证、运行证明器、进行审计，还是运行你自己的 Ostia。

| 我想                                     | 从这里开始                                                                                                                                               |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 部署应用                                   | [应用构建者](#app-builders)                                                                                                                              |
| 了解我可以在 Canton 上构建什么，以及 DevNet 上已运行哪些内容 | [使用 Canton 构建](https://docs.rome.builders/zh/canton-zk-evm/build-with-canton.md) 和 [使用场景](https://docs.rome.builders/zh/canton-zk-evm/use-cases.md) |
| 获取钱包和测试币                               | [用户](#users)                                                                                                                                        |
| 作为构建者获取 100 tROME                      | [开发者资助](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#the-builder-grant)                                                                    |
| 使用浏览器钱包在 Ostia 和 Canton 之间转移代币         | [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md)                                                                                         |
| 了解每个区块如何在 Canton 上提交                   | [外部调用](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#external-calls)                                                                      |
| 了解 ERC-20 双生代币和 Canton Coin 的运作方式      | [双向 Canton 资产](#two-way-canton-assets)                                                                                                              |
| 在 Canton 参与方上运行 Ostia，或查看由谁确认区块        | [Canton 验证者和参与方运营者](#canton-validators-and-participant-operators)                                                                                   |
| 运行证明者                                  | [证明者运营者](#prover-operators)                                                                                                                         |
| 了解证明修复了什么，以及没有修复什么                     | [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md)                                                                               |
| 审计代码                                   | [审计人员和研究人员](#auditors-and-researchers)                                                                                                              |
| 运行我自己的 Ostia                           | [运行你自己的 Ostia](https://docs.rome.builders/zh/canton-zk-evm/run-it-locally.md)                                                                       |

所有代码都位于一个公开代码仓库中： [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm)，采用 Apache License 2.0 许可。本页中的代码链接指向其主分支； [状态](https://docs.rome.builders/zh/canton-zk-evm/status.md) 标明 DevNet 所运行的提交。应用位于 [`apps/accounts`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/accounts), [`apps/twin`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin) （及其 [注册表服务](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin/registry)）和 [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc)。版本 [v0.1.0](https://github.com/rome-protocol/canton-zk-evm/releases/tag/v0.1.0) 是首个标签，发布于这些应用出现之前。

## 应用构建者

Ostia 在 Canton DevNet 上通过 HTTP JSON-RPC 运行 EVM 合约。该项目未经审计，测试币没有价值，DevNet 也可能会重置。Rome 运行构建者、证明者和唯一的确认参与方。部分行为与 Ethereum 不同；请先阅读 [与 Ethereum 的差异](https://docs.rome.builders/zh/canton-zk-evm/evm-differences.md) 。为 Osaka 或更早版本构建的合约可在此运行（`london` 是一个稳妥的目标），部署步骤与在 Ethereum 上相同。连接现有应用前，请查看 [RPC 限制](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#limits) 。

**所需工具**

* Foundry 1.8： `forge create` 用于部署，以及 `forge verify-contract` 对接浏览器兼容 Etherscan 的 API。
* 使用 Hardhat 2 进行部署。
* 使用 ethers 进行读取和发送。混合负载工具包（`load/mixed`）会用到它。 [在 Ostia 上构建](https://docs.rome.builders/zh/canton-zk-evm/build-on-ostia.md#viem-and-ethers) 也提供 viem 配置。
* 一个 EVM 钱包，可通过网络参数进行配置，也可点击浏览器 API 页面上的按钮进行配置。
* OpenZeppelin 合约。基于这些合约构建的 ERC-20、ERC-721 和 ERC-1155 代币已在 Ostia 上运行，此外还有 ERC-3643（T-REX）许可型代币和 Uniswap V2。
* 负载工具包还向 TACEO 的 Merces 合约发送了私密转账。Groth16 证明在客户端生成，并在链上验证。没有运行 MPC 网络，也没有进行结算。

这里记录了 viem 配置和钱包操作步骤，但未在此处进行端到端测试。其他 EVM 工具尚未尝试。RPC 不支持 WebSocket、 `eth_newFilter` 或 `eth_subscribe`，因此请轮询 `eth_getLogs`。区块在 Canton 上最终确认后，交易回执才会出现，这通常需要约 10 到 30 秒。

**相关信息**

* [Ostia DevNet](https://docs.rome.builders/zh/canton-zk-evm/devnet.md)：链 ID、RPC、钱包参数、限制以及暂停和维护信息。
* [与 Ethereum 的差异](https://docs.rome.builders/zh/canton-zk-evm/evm-differences.md)：PREVRANDAO、Blob 交易、区块时间等。
* [在 Ostia 上构建](https://docs.rome.builders/zh/canton-zk-evm/build-on-ostia.md)：使用 Foundry 或 Hardhat 部署并验证，然后通过 viem 或 ethers 连接。
* [浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.md)：API、合约验证、水龙头和“外部调用”页面。
* [构建者资助](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#the-builder-grant)：使用 GitHub 登录的构建者可获得 100 tROME。
* [使用 Canton 构建](https://docs.rome.builders/zh/canton-zk-evm/build-with-canton.md)：双生对象、Canton Coin、Canton 参与方之间的支付，以及 Canton 场所。
* [用例](https://docs.rome.builders/zh/canton-zk-evm/use-cases.md)：目前可行的方案，无论是在 DevNet 上还是在你自己的网络上。
* [试用 Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md)：仓库中的简短版指南。
* [load/mixed](https://github.com/rome-protocol/canton-zk-evm/tree/main/load/mixed)：用于部署上述所有内容的工具包。它包含脚本和我们自己的合约；其余内容则通过包导入和一个获取步骤引入。

## 用户

**所需工具**

* 已添加 Ostia DevNet 的钱包。
* 用于获取测试币的水龙头：所有人每天每个地址可领取 1 tROME；使用 GitHub 登录的构建者可获得 100 tROME。tROME 不具有任何价值。
* 使用浏览器查看交易、检查区块，并在 [外部调用](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#external-calls)页面跟踪每个区块在 Canton 上的提交过程。
* 使用 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md) 页面，通过浏览器钱包在 Ostia 和 Canton 之间转移代币，也可在 Canton 上发送代币。

**相关信息**

* [Ostia DevNet](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#add-it-to-a-wallet)：钱包设置。
* [获取 tROME](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#get-trome)：水龙头和 [构建者资助](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#the-builder-grant).
* [浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.md)：在浏览器中读取区块并检查其证明。
* [外部调用](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#external-calls)：每个区块的 Canton 提交及其结算时间。
* [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md)：使用你已有的 Canton 钱包，在 Ostia 和 Canton 之间转移代币。
* [工作原理](https://docs.rome.builders/zh/canton-zk-evm/how-it-works.md#from-your-transaction-to-final-on-canton)：从你的交易到 Canton 区块提交，解释“最终确认”的含义。

## 双向 Canton 资产

自 2026-10-29 起，资产可以双向转移。Ostia 上的 ERC-20 可以在 Canton 上对应一个孪生代币：你将其存入金库，Canton 账户便会持有等量代币；赎回时，ERC-20 会返还给你。Canton Coin 可以作为 CC 代币转入 Ostia，也可以转回。浏览器中的 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md) 页面可通过浏览器钱包和你已有的 Canton 钱包完成这些转移；需要逐个钱包启用。请先获取测试用 tROME。浏览器会显示每种孪生代币的供应量与金库持有量的对比。

**相关信息**

* [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md)：桥接页面、四种转移操作及实测耗时。
* [存入、提取和支付](https://docs.rome.builders/zh/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)：锁定和赎回流程，以及 Canton Coin。
* [Ostia DevNet](https://docs.rome.builders/zh/canton-zk-evm/devnet.md#canton-assets-on-devnet)：金库、孪生代币和 CC 代币的地址，以及孪生代币注册表服务。
* [浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#twins-and-canton-assets)： `/twins` 页面。
* [使用 Canton 构建](https://docs.rome.builders/zh/canton-zk-evm/build-with-canton.md)：孪生代币注册表的调用、作为 ERC-20 的 Canton Coin、支付和 OTC 交易场所。
* [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md#what-the-twins-trust)：孪生代币依赖的基础。
* [试用 Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md#canton-twins-and-canton-coin-on-devnet)：仓库中的简短版指南。

## Canton 验证者和参与方运营者

在 Ostia 上，只有在负责确认的参与方旁运行的 sidecar 检查通过后，Canton 才会提交区块。在 DevNet 上，该参与方是 Rome。sidecar 运行验证器，并检查证明、区块头和交易根。如果检查失败，区块就不会提交。

在 DevNet 上，只有一个参与方——Rome 自己——承载所有 Ostia party。其 sidecar 是唯一的确认方。目前没有其他参与方会确认 Ostia DevNet 区块。Rome 的验证节点运行 Splice 0.10.1 和 Canton 3.7.2。 [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md#local-demo-vs-ostia-devnet) 将这种单确认方设置与本地网络的双确认方设置进行比较。目前，你可以使用已有参与方，以现有参与方模式运行自己的 Ostia。

**所需工具**

* sidecar，Canton 通过其外部调用扩展调用它。
* 它用于检查封装证明的验证器。
* 保存链及其区块的 Daml 软件包。
* 用于在你已运行的参与方上设置 Ostia 的脚本。

**相关信息**

* [sidecar/](https://github.com/rome-protocol/canton-zk-evm/tree/main/sidecar)：Canton 调用的服务。
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier)：使用纯 Rust 编写的证明检查程序。
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml)：Daml 软件包，包含 `Advance`.
* [network/README.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/network/README.md#running-on-an-existing-participant-the-canton-network)：“在现有参与方上运行”。
* [network/external/](https://github.com/rome-protocol/canton-zk-evm/tree/main/network/external)：参与方配置、sidecar 和设置脚本。
* [运行自己的 Ostia](https://docs.rome.builders/zh/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)：这些文档中的相同步骤。
* [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md#operator-confirmer-and-gateway-authority)：运营方和确认方能够查看和执行的操作。

## 证明者运营者

证明器会将每个区块转换为证明，由确认方的 sidecar 进行检查。你需要运行一个配备单个 GPU 工作器的 ZisK。DevNet 的证明器运行在一台配备 48 个 vCPU 的机器上，使用一块 NVIDIA RTX PRO 6000 Blackwell Server Edition（96 GB）GPU。在 DevNet 上，Rome 运行这一个证明器。这些脚本用于为你自己的 Ostia 运行证明器。

**所需工具**

* `install.sh` 用于安装固定版本的 ZisK 及其密钥。
* `start.sh` 以启动协调器和 GPU 工作节点。
* `prove-one.sh` 以证明一个输入并验证结果。
* guest 是被证明的程序。它的构建会在一个固定目录中运行，因此你可以检查构建结果是否与记录的 programVK 一致。

**相关信息**

* [prover/](https://github.com/rome-protocol/canton-zk-evm/tree/main/prover)：上述脚本，以及 `build-guest.sh`.
* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest)：guest，以及如何检查构建结果是否与记录的 programVK 一致。
* [Ostia prover 主机](https://docs.rome.builders/zh/canton-zk-evm/prover-host.md)：主机要求、构建与运行，以及重现 guest 密钥。
* [测量数据](https://docs.rome.builders/zh/canton-zk-evm/measurements.md)：证明耗时及测量所用的硬件。

## 审计人员和研究人员

**所需工具**

* 编译进 guest 的链规则。
* 证明验证和存储证明代码。
* Daml 链记录及其 `Advance` 选项。
* 网关合约。

**相关信息**

* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest)：被证明的程序及其执行的规则。
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier)：对封装证明的验证。
* [mpt/](https://github.com/rome-protocol/canton-zk-evm/tree/main/mpt)：Merkle-Patricia 存储证明。
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml)：链记录和 `Advance`.
* [gateway/](https://github.com/rome-protocol/canton-zk-evm/tree/main/gateway)：告知 Canton 区块要求的唯一 EVM 合约。
* [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md) 和 [证明了什么，未证明什么](https://docs.rome.builders/zh/canton-zk-evm/what-is-proven.md)：证明确定了哪些内容，以及由谁检查哪些内容。
* [docs/DESIGN.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md) 和 [SECURITY.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/SECURITY.md)：设计说明，以及如何私下报告问题。

## 运行你自己的 Ostia

[运行你自己的 Ostia](https://docs.rome.builders/zh/canton-zk-evm/run-it-locally.md) 介绍测试、带 GPU 的本地 Canton 网络，以及如何在现有 Canton 参与方上部署。


---

# 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/start-here.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.
