> 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/run-it-locally.md).

# Ostiaを自分で実行する

検証の実行、GPU なしのリハーサル、GPU 上のローカルデモ、再起動しても存続するチェーン、そして既存の Canton 参加者上の Ostia。

デフォルトでは、付属のスクリプトはローカルのテストネットワークを実行します。Cantonは状態をメモリに保持するため、再起動するたびにその状態が破棄され、新しいネットワークが作成されます。チェーンを維持する方法はほかに2つあります。永続モード（`CZE_PERSIST=1`）と、既存のCanton参加者上でOstiaを実行する方法です。Ostia DevNetは後者の方法で動作しています。GPUデモはブロックの証明を生成します。リハーサルでは代用の証明を使用するため、GPUは必要ありません。

このページではリリース `v0.1.0`について説明します。詳しくは、 [ネットワークガイド](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/network/README.md) と [デモガイド](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md)を参照してください。以下のコマンドは `canton-zk-evm` リポジトリのルートから実行してください。

## 必要なもの

| 作業           | 要件                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------ |
| リポジトリのチェック   | Docker、 `bash`, `curl`, `jq`, `openssl` 、Python 3。Rustのテストでは `rust-toolchain.toml`.              |
| Canton統合テスト  | Linux x86-64、Java 21、ネットワークアクセス。                                                                 |
| デモのリハーサル     | Linux x86-64、Docker、Java 21、Rust、Python 3.12以降。                                                  |
| エクスプローラーのテスト | Node 22.18以降。                                                                                    |
| GPUネットワークとデモ | Linux x86-64、ドライバーがインストールされたNVIDIA GPU、Docker、Rust、Python 3.12以降、 `jq`, `curl`, `openssl` 、ZisK。 |

テストの前提条件は [リポジトリのREADME](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/README.md#running-the-tests) に記載されています。GPUインストーラーはDebianまたはUbuntuで `sudo` と `apt` を使用し、約100 GBのディスク空き容量を必要とします。システムパッケージをインストールし、メモリロックの上限を変更します。ネットワークのツール取得機能は、Java 21がない場合にインストールします。テスト済みのハードウェアについては [Ostia証明生成ホスト](https://docs.rome.builders/ja/canton-zk-evm/prover-host.md) を参照してください。GPUメモリの最小要件はまだ確定していません。

## テストを実行する

まず、次のクイックチェックを実行します。出典： [CONTRIBUTING.md](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/CONTRIBUTING.md#building-and-testing):

```sh
tests/static.sh                  # 固定されたバージョン、ジェネシス、ライセンス行が一致していることを確認
tests/refuses_missing_flag.sh    # フラグがない場合や誤っている場合にrethが起動を拒否することを確認
tests/fixtures.sh                # 記録された証明の整合性を確認
gateway/build.sh --check         # チェックイン済みのゲートウェイコードがGateway.solのコンパイル結果と一致することを確認（Docker）
```

リポジトリのREADMEにも、以下のチェックが記載されています。GPUは不要です。

```sh
tests/udp_control.sh             # UDPリスナーを持つコンテナでUDPチェックが失敗することを確認（reth不要）
tests/discovery.sh               # バージョンを固定したrethを起動し、ピアがないことを確認して停止
tests/network_static.sh          # rethがlaunch.sh経由でのみ起動されること、Cantonの設定、記録済みのスモークテスト結果を確認
tests/network_checks.sh          # コンパイラーのバージョン固定、DARのID、異なるprogramVKでの停止を確認（GPU不要）
tests/canton_network.sh          # バージョンを固定したCanton、実際のDamlパッケージ、1回のAdvanceを確認（Linux x86-64、Java 21、Python 3、GPU不要）
gateway/tests/run.sh             # ピア検出を無効にして起動した実際のreth上でゲートウェイをテスト（Docker、curl、jq、demo/requirements.txt内のパッケージを含むPython 3）
tests/guest-repro.sh             # ゲストビルドが固定フォルダーで実行され、ソースフォルダーによってELFが変わらないことを確認（ZisKツールの代役を使用。実際のZisKでの同じチェックは2026-10-04に成功。guest/README.mdを参照）
tests/demo_static.sh             # デモのバージョン固定、改ざんスイッチ、ジェネシスの上書き、および記録済みの結果を確認（GPU不要）
tests/demo_explorer_static.sh    # エクスプローラーのイメージが固定されていることと、コンテナに渡される内容を確認（Docker不要）
(cd explorer && npm ci && npm test)  # フェイクを使用したエクスプローラーのテスト（Node 22.18以上。CIではPINSのEXPLORER_NODE_IMAGEを使用）
(cd guest/rules && cargo test)   # チェーンルールとそのハッシュをテスト（Rustが必要）
```

## GPUなしでリハーサルする

```sh
tests/demo_rehearsal.sh          # 代役の証明を使ってデモとエクスプローラーをテスト（Linux x86-64、Docker、Java 21、Rust、Python 3.12以上、GPU不要）
```

これにより、実際のreth、Canton、Damlパッケージ、トークン標準、ビルダーが実行されます。サイドカーはゲートウェイの各レッグをストレージ証明と照合し、代役が証明の `verify` 呼び出しに応答します。このリハーサルでは、ブロックの証明も実際のゼロ知識証明の検証も行いません。

エクスプローラーとfaucetもチェックします。エクスプローラーの「検証」チェックは、代役の証明を拒否する必要があります。リハーサルの対象範囲については、 [デモのREADME](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#the-rehearsal) を参照してください。

## GPUを使ってローカルネットワークを起動する

ネットワークを起動する前に、 `prover/install.sh` を使ってZisKをインストールしてください。rethは必ず付属のランチャーを通して起動してください。 `network/up.sh` はこのランチャーを使用します。

```sh
network/up.sh       # ツール、ゲストビルド、reth、サイドカー、prover、Canton、チェーン
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) network/smoke.sh    # 空のブロックを1つ証明してコミット
network/down.sh
```

`up.sh` はゲストをビルドし、プログラムキー、ZisKルート、ルールハッシュが記録済みの値と異なる場合は処理を拒否します。ネットワークには1つのシンクロナイザーと3つの参加者があります。operatorとconfirmerの各参加者はそれぞれサイドカーを実行します。usersという名前の参加者は、テスト用のpartyとreaderをホストします。

スモークテストは空のブロックをコミットし、チェーンの先頭とreaderのブロックレコードを確認するとともに、rethがそのブロックを最終確定済みとマークしたことを確認します。状態とログは `state/`、または `CZE_STATE_DIR` が設定されている場合はそのディレクトリに保存されます。

## GPUで5つのデモケースを実行する

デモには新しいローカルネットワークを使用してください。

```sh
demo/prepare.sh
CZE_GENESIS_FILE=$PWD/state/demo/genesis.json network/up.sh
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) network/smoke.sh      # 任意：最初に空のブロックを1つ実行
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) demo/run.sh
network/down.sh
```

準備スクリプトは、実行用のテストキーと資金を割り当てたジェネシスを作成します。デモでは、セットアップブロック、入金、支払い、出金、割り当ての拒否、改ざんされた証明の拒否を実行します。スクリプトはチェックが失敗すると停止し、結果を `demo/results/`.

に書き込みます。エクスポートされたソースに `.git`がない場合は、 `CZE_SOURCE_COMMIT` にエクスポート元のコミットの完全なハッシュを設定してください。faucetを含めるには、ネットワークを起動する前に資金を割り当てたジェネシスを準備する必要があります。詳細は次を参照してください。 [エクスプローラーを自分で実行する](#run-the-explorer-yourself) 以下およびデモの完全ガイドを参照してください。

## 再起動後もチェーンを維持する

実際に使われるチェーンは、クラッシュや再起動後も存続する必要があります。 `up.sh` は、永続モードを指定しない限り、実行のたびに新しいチェーンを作成します。

```sh
CZE_PERSIST=1 network/up.sh     # 初回起動: 新しいチェーンを作成して保持
network/down.sh                 # すべてを停止し、データを保持
network/restart.sh              # 再起動後: 同じチェーンが復旧
network/down.sh --wipe          # すべてを停止し、チェーンを完全に削除
```

Cantonはノードを127.0.0.1上のPostgreSQLに保存します。パスワードはマシン上で生成され、モード0600のファイルに保存されます。rethはデータを `$CZE_STATE_DIR/reth-data` に保存し、ブロックを取り込むたびにディスクに書き込みます。 `restart.sh` は何も作成しません。保持されているデータを使ってデータベース、reth、サイドカー、prover、Cantonを起動し、rethをCantonの最新ブロックに進めます。データベースを作成したCantonのバージョンが、 `PINS`に記載されたバージョンと異なる場合は停止します。ネットワークを停止した状態で、データベースと `reth-data` を一緒にバックアップしてください。 [ネットワークガイド](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/network/README.md#keeping-the-chain-across-restarts) にあらゆるケースが記載されています。

## 既存の参加者で実行する

Ostiaはローカルネットワークではなく、すでに稼働しているCanton参加者上で実行できます。たとえば、Canton Network DevNet上にあるSpliceバリデーターの参加者が該当します。Ostia DevNetはこの方法で実行されます。 `up.sh` はその後、reth、prover、および指定した場合は1つのサイドカーを起動し、その参加者上にチェーンを設定します。Cantonは起動せず、ブートストラップ処理も行いません。

必要なもの:

* 参加者のJSON Ledger API（v2）。次のいずれかを指定します: `https` URL、または `http` 同一マシン上のURL。
* Ledger APIユーザー4人分のトークンファイル: `ADMIN` （パッケージをアップロードし、パーティとユーザーを作成するため、このトークンが必要なのは `up.sh` と `setup.py` のみです）と、 `OPERATOR`, `CONFIRMER` と `BUILDER` （これらのユーザーは `setup.py` が作成します: `ostia-operator`, `ostia-confirmer` と `ostia-builder`）。各トークンは、audienceが `https://canton.network.global` で、ユーザーIDを `sub`。参加者を実行する人がトークンを作成します。Ostiaがトークンを作成、出力、保存することはありません。
* 参加者はアクセスでき、ほかの誰もアクセスできないサイドカー。

トークンの有効期間は短いため、新しいトークンを発行するたびに、同じファイルに上書きしてください。ビルダーは呼び出しのたびにファイルを読み直します。 `setup.py` と `propose.py` はトークンを一度だけ読み込むため、新しいトークンを用意してから起動してください。

まず、参加者に必要な行を、コンテナの追加の `ADDITIONAL_CONFIG` 変数として渡し、再起動します:

```sh
network/external/participant-config.sh <sidecar address> 8085
# prints: ADDITIONAL_CONFIG_ZK_EVM=canton.participants.participant.parameters.engine.extensions.canton-zk-evm { address = "<sidecar address>", port = 8085, validate-on-startup = false }
```

の場合、 `validate-on-startup` が false の場合、サイドカーが停止していても参加者は起動します。その場合、ブロックの検証に失敗し、ブロックはコミットされません。次に、チェーンを起動します。

```sh
export CZE_CANTON=external CZE_LEDGER_URL=https://<participant's Ledger API>
export CZE_TOKEN_FILE_ADMIN=... CZE_TOKEN_FILE_OPERATOR=... \
       CZE_TOKEN_FILE_CONFIRMER=... CZE_TOKEN_FILE_BUILDER=...
CZE_PERSIST=1 CZE_SIDECAR_LISTEN=<sidecar address>:8085 network/up.sh
```

`CZE_PERSIST=1` ここで必要です。チェーンは参加者上で稼働し続け、rethもブロックを保持する必要があるためです。サイドカーを別のマシンで実行する場合は、そのマシン上で次のコマンドを実行して起動します。 `network/external/sidecar.sh start <sidecar address>:8085` （公開アドレスではなく、参加者から到達できるアドレスを指定します）。次に、以下を実行します。 `up.sh` ただし、 `CZE_SIDECAR_LISTEN`. `up.sh` ゲストをビルドし、rethと証明者を起動して、さらに次を実行します。 `external/setup.py`。このスクリプトはパッケージをアップロードし、参加者を割り当て、各ユーザーをロールに応じた権限のみで作成して、チェーンを提案します。2回実行しても問題ありません。 `restart.sh` チェーンを復元し、ビルダーのトークンだけを必要とします。 `down.sh --wipe` 参加者には影響しません。チェーンのコントラクトは、運用者が削除するまでそのまま残ります。

このモードには、次の3つのルールがあります。

* **Ledger APIを決して公開しないでください。** 参加者がホストするすべてのパーティとして動作できます。マシン自身のアドレスでのみアクセスできるようにするか、呼び出し元を確認するプロキシの背後に置いてください。
* **トークンファイルのパーミッションを0600に設定し、**&#x5171;有マシンには置かないでください。
* **参加者の運用者には、すべてが見えます。** 1つの参加者がOstiaのすべてのパーティをホストするため、運用者はすべてのコントラクトを読み取り、ゲートウェイのカストディを含むすべてのパーティの代理として操作できます。その唯一のサイドカーが、唯一の確認者です。Ostia DevNetでは、その運用者はRomeです。参加者と、自身のCanton DevNetバリデーターを実行します。

## ビルダーを継続的に実行する

`builder.py once` はブロックを1つ作成します。 `builder.py run` はブロックを作り続けます。

```sh
python3 builder/builder.py run [--heartbeat-seconds N] [--status-file <path>]
```

同じ [設定](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md#settings) を読み込みます。 `once`。デフォルトのストラテジーである `on_demand`では、投入可能なトランザクションが待機しているとブロックを生成します。デフォルトでは一度に処理中にできるブロックは1つです（`--max-in-flight` で上限を増やせます）。静かなチェーンでは、 `--heartbeat-seconds N` を指定して、ブロックが生成されないままN秒が経過した後に空のブロックを要求しない限り、ブロックは生成されません。デフォルトではハートビートは無効です。ブロックが2回連続で拒否されると、ビルダーはトランザクションに問題があると判断し、クールダウン期間中はそのトランザクションを除外します。

ビルダーは同時に1つだけ実行できます。 `run` と `once` はロックを取得し、別のプロセスがロックを保持している場合は起動を拒否します。停止シグナルを受けると、処理中のブロックを完了して終了します。プルーフの作成時間とCantonの応答時間を合わせた長さよりも長い停止タイムアウトを設定したうえで、再起動するサービスマネージャーのもとでビルダーを実行してください。再起動はいつでも安全です。次回起動時にはCantonの先頭から処理を再開し、中断されたブロックのトランザクションを再びrethに送信します。ビルダーは作業フォルダーに `status.json` とジャーナルを書き込み、エクスプローラーはその両方を読み込みます。

## エクスプローラーを自分で実行する

エクスプローラーは、表示対象のチェーンと並べて、DockerをインストールしたLinuxマシン上のコンテナとして実行します。専用のPostgreSQLデータベースがあり、 `network/explorer-db.sh`で起動します。インデクサーはCantonの記録をもとにこのデータベースを更新します。フォーセットへの資金供給はネットワークの起動前にジェネシスへ含める必要があるため、まず `setup` を実行します。

```sh
explorer/run.sh setup           # フォーセット用のキーと、資金を含むジェネシスを作成
CZE_GENESIS_FILE=state/faucet/genesis.json network/up.sh
explorer/run.sh start           # 次に http://127.0.0.1:8088 を開く
explorer/run.sh stop
```

`start` はデータベースを起動し、マイグレーションを適用して、インデクサーを専用コンテナとして起動した後、エクスプローラーを起動します。フォーセットキーがない場合、フォーセットは無効です。フォーセットからの支払いはrethへのトランザクションなので、ビルダーが実行されて初めて確定します。ネットワークやエクスプローラーを起動しても、ビルダーは起動しません。 `explorer/run.sh start`を実行する前にビルダーを一度実行するか、最初のビルダー実行後にもう一度 `start` を実行してください。それまではエクスプローラーにビルダーの作業フォルダーがなく、ブロックのライフサイクルは空欄のままです。 `CZE_PERSIST`, `を指定せずに作成したネットワークでは、` stop

を実行すると、フォーセットへのリクエストや検証済みコントラクトのソースを含むエクスプローラーのデータベースも削除されます。永続化されたネットワークではデータベースは保持されます。 `explorer/run.sh start` をデフォルト設定で実行すると、 `EXPLORER_VERIFIER=1` （および `SOLC_LIST_URL`）を設定しない限りコントラクト検証は無効です。また、 `/rpc` も、 `PUBLIC_RPC=1`を設定しない限り、コントラクトのRead呼び出しも利用できません。設定は [explorer/run.sh](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/run.sh).

のヘッダーに記載されています。`LEDGER_TOKEN_FILE`を指定し、既存の参加者では、リーダーユーザー用のモード0600のトークンファイル、参加者の `LEDGER_URL` 、および `READER_PARTY`。コンテナは引き続き127.0.0.1でリッスンします。パブリックアドレスが必要な場合は、ご自身でプロキシを用意してください。 [エクスプローラーガイド](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#running-it) にすべての設定が記載されています。

## 現実的な組み合わせで負荷をかけるには、

`load/mixed` に、1時間の実行を支えるキットが含まれています。 [測定](https://docs.rome.builders/ja/canton-zk-evm/measurements.md)。複数種類のトークン、DEX、許可型トークン、プライベート送金コントラクトをチェーンにデプロイし、その後200個のウォレットからさまざまなトラフィックを送信します。手順は [README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/README.md) に記載されています。Dockerと、キットに同梱されている設定を使う場合、約12,000 tROMEを保有するアカウントが必要です。独自のチェーンでは、ジェネシスで資金を割り当ててください。DevNetのフォーセットでは、これほどの量を供給できません。


---

# 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/run-it-locally.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.
