> 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/ja/canton-zk-evm/how-it-works.md).

# 仕組み

rethから証明を経てCantonへのコミットに至るまで、1つのOstiaブロックを追います。

ビルダーは常時稼働します。トランザクションが待機しているとブロックを切り出し、証明してCantonに送信します。コードのデフォルトでは一度に処理中にできるブロックは1つで、DevNetではGPU証明器1台で最大2つを処理します。ブロックはCanton上で引き続き順番にコミットされます。DevNetでは、60秒間ブロックが作られないと、ビルダーが空のブロック、つまりハートビート（コードのデフォルトでは無効）を切り出すため、静かなチェーンでもおよそ1分に1回ブロックが作られます。各ブロックがチェーンの次のヘッドになるかどうかはCantonが決定します。EVMブロックと、そのブロックに記録されたCanton上の処理は、同じトランザクションでコミットされます。

このページでは、リリース `v0.1.0` について説明し、明記されている箇所では、現在DevNetで稼働している内容も説明します。 [ステータス](https://docs.rome.builders/ja/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：ブロック、証明、処理を1つのCantonトランザクションにまとめる"]
    A --> S["外部呼び出し：サイドカーが証明とゲートウェイの状態を検証"]
    S --> D["Damlがヘッドを確認し、処理を確定"]
    D --> C["Cantonがブロックとその処理をまとめてコミット"]
    C --> F["rethがブロックを最終確定済みとしてマーク"]
    F --> Q
    C --> X["エクスプローラーのインデクサーがブロックレコードを読み取り、rethと照合"]
```

## Cantonのヘッドを基準にビルドする

ウォレットはEVMトランザクションをパブリックRPCに送信し、RPCはそれをrethに転送します。RPCに表示されるのはCanton上で最終確定したブロックのみなので、レシートはブロックの最終確定後に表示されます。付属のランチャーではピア検出が無効になっています。ビルダーから要求されると、rethはブロックを作成します。

ビルダーはまず、Canton上のアクティブな `ZkChain` コントラクトを読み取ります。rethのヘッド、安全ブロック、最終確定ブロックを、そのコミット済みヘッドに移動します。保留中のトランザクションは価格順に選び、各送信元のナンス順は維持します。2026-10-25以降は、宣言されたガス上限ではなく、トランザクションが実際に使用するガス量（rethが算出）に基づいてブロックを埋めます。ウォレットが宣言するガス量は実使用量の約3倍になることが多く、宣言された上限で数えると、ブロックに収まる量の約3分の1でブロックがいっぱいになってしまうためです。ブロックはガス上限に達すると終了します。またビルダーは通常、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はゲストを実行し、チェーンの固定ルールに従ってブロックを検証します。

証明器は、ブロックハッシュに結び付けられた1,344バイトのラップ済み証明を返します。ビルダーは、 `Advance` を、ヘッダー、トランザクション、証明、処理、およびブロックの状態ルートにおけるゲートウェイのアカウント証明とストレージ証明とともに送信します。

## 1つのトランザクションで検証と確定を行う

各確認参加者はサイドカーを実行します。Cantonの外部呼び出しは、ブロックをその参加者のサイドカーに送信し、 `verify`を実行します。サイドカーは、証明、固定されたプログラムキーとZisKのリリース、ヘッダーのハッシュ、トランザクション一覧のルートを検証します。

Ostia DevNetでは、すべてのOstiaパーティをホストする唯一の参加者をRomeが実行しているため、唯一の確認者はそのサイドカーであり、証明はRome自身のノードで検証されます。Cantonのシンクロナイザーはブロックを順序付けますが、証明は参照しません。ローカルのデモネットワークには、確認参加者が2つあります。 [信頼モデルと制限事項](https://docs.rome.builders/ja/canton-zk-evm/trust-model.md) では、それによって何が変わるかを説明しています。

Damlは、回答を `ZkChain`と照合します。親ブロックは現在のヘッドであること、ブロック番号は次の番号であること、ガス上限と使用ガス量は上限内であることが必要です。Damlはサイドカーの回答を比較しますが、ゼロ知識証明そのものは検証しません。

次にDamlは、各処理について、その処理が指定するCantonコントラクトを基に1行ずつ書き込みます。出金の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は、保有者が署名した償還リクエストに対してのみ、これを決済します。

ツインは、1つのERC-20に対応するCantonトークンで、ゲートウェイのパーティーが管理します。チェーンレコードには各ツインの情報が固定されています。トークンのアドレス、小数桁数、そしてトークンを発行、焼却、転送するルールコントラクトです。 `Advance` は、証明によって確定されたロックに対してのみツインを発行し、署名済みの償還リクエストに対してのみツインを焼却します。

ツインのレジストリサービスはビルダーの隣で稼働します。支払人は支払いの前に、受取人と `ref` をサービスに伝えます。サービスはロックIDを返し、ビルダーは同じ要素を読み取ってロックをブロックに紐付けます。また、ツイン向けにトークン規格のレジストリAPIも提供するため、バリデーターがツインのパッケージを審査済みのウォレットであれば、ツインを送信できます。サービスは鍵を保持せず、Cantonへの書き込みも行いません。また、 `Advance` は、各要素からIDが得られることをチェックします。フローについては、 [入金、出金、支払い](https://docs.rome.builders/ja/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) を参照してください。

## Cantonが拒否した場合

Cantonがブロックをコミットした後、ビルダーはreth上でそのブロックを確定済みとしてマークします。Cantonがブロックを拒否した場合、ビルダーはrethをCantonで最後にコミットされたブロックまで戻し、拒否されたブロックのトランザクションをプールに戻します。次のブロックでは、それらのレッグを再度チェックします。割り当てが取り消された支払いは除外されます。ブロックが2回連続で拒否された場合、ビルダーは両方に含まれていたトランザクションを疑わしいと判断し、クールダウン期間中は除外します。

ビルダーが送信への応答を受け取れなくても、コマンドがコミットされている可能性があります。送信の前に、ビルダーは台帳の終端を記録します。その後、その時点以降に記録されたコマンド自体の完了結果を読み取ります。成功した完了はコミットとして扱います。失敗した場合は拒否として扱います。

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. トランザクションが待機中で、空き枠があれば、ビルダーはすぐにブロックを作成します（コードのデフォルトでは同時に処理中のブロックは1つで、DevNetでは最大2つです）。チェーンが混雑していた間、新しいブロックは中央値で16.6秒ごとに前のブロックに続いて生成されました（2026-10-25 01:34 UTCまでの24時間）。
3. ZisKがブロックを証明します。2026-10-24の1時間の負荷測定では、トランザクション数が11～100件のブロックの証明にかかった時間は、中央値で9.03秒でした。
4. 証明を含むブロックレコードがCanton上でコミットされます。このコミットによってブロックが確定し、その後パブリックRPCにレシートが表示されます。

同じ1時間の測定では、RPCがトランザクションを受け付けてから、そのブロックがCanton上で確定するまでの時間は、中央値で19.5秒、95パーセンタイルで27.1秒でした。大半のチェーンよりレシートの取得に時間がかかるため、レシートを待つツールでは長めのタイムアウトが必要です。

[測定](https://docs.rome.builders/ja/canton-zk-evm/measurements.md) では各時間間隔を定義し、測定実行の一覧を掲載しています。エクスプローラーでトランザクションを開き、続けてそのブロックを開くと、レコードを保持するCantonの更新を確認できます。 [エクスプローラー](https://docs.rome.builders/ja/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/ja/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.
