> 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/ru/canton-zk-evm/run-it-locally.md).

# Запустить свой собственный Ostia

Запустите проверки, репетицию без GPU, локальную демоверсию на GPU, цепочку, переживающую перезапуски, и Ostia на существующем участнике Canton.

По умолчанию предоставленные скрипты запускают локальную тестовую сеть. Canton хранит состояние в памяти, поэтому при каждом перезапуске оно сбрасывается и создаётся новая сеть. Два других режима сохраняют цепочку: постоянный режим (`CZE_PERSIST=1`) и Ostia на уже имеющемся у вас участнике Canton — именно так работает 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, GPU NVIDIA с установленным драйвером, 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 использует `sudo` и `apt` в Debian или Ubuntu и требует около 100 ГБ свободного места на диске. Он устанавливает системные пакеты и меняет ограничения на блокировку памяти. Средство загрузки инструментов для сети установит Java 21, если она отсутствует. См. [Хост для prover Ostia](https://docs.rome.builders/ru/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                  # согласованы пины, genesis и строки лицензий
tests/refuses_missing_flag.sh    # запуск reth отклоняется при отсутствии или неверном флаге
tests/fixtures.sh                # записанное доказательство согласовано
gateway/build.sh --check         # проверяет, что код gateway в репозитории соответствует тому, во что компилируется 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 и остановки при использовании другого programVK (без GPU)
tests/canton_network.sh          # закреплённая версия Canton, настоящий пакет Daml и одна операция Advance (Linux x86-64, Java 21, Python 3; без GPU)
gateway/tests/run.sh             # gateway с настоящим reth, запущенным с отключённым обнаружением пиров (Docker, curl, jq, Python 3 с пакетами из demo/requirements.txt)
tests/guest-repro.sh             # сборка guest выполняется в одной фиксированной папке, поэтому папка с исходным кодом не влияет на ELF (используются заглушки инструментов ZisK; такая же проверка на настоящем ZisK прошла 2026-10-04, см. guest/README.md)
tests/demo_static.sh             # проверяет закреплённые версии demo, переключатель подмены и переопределение genesis, а также записанные результаты (без GPU)
tests/demo_explorer_static.sh    # проверяет закреплённые образы explorer и содержимое, передаваемое его контейнеру (без Docker)
(cd explorer && npm ci && npm test)  # тесты explorer на поддельных компонентах (Node 22.18+; в CI используется EXPLORER_NODE_IMAGE из PINS)
(cd guest/rules && cargo test)   # правила цепочки и их хеш (требуется Rust)
```

## Репетиция без GPU

```sh
tests/demo_rehearsal.sh          # demo и explorer с заглушкой доказательства (Linux x86-64, Docker, Java 21, Rust, Python 3.12+; без GPU)
```

Здесь используются настоящие reth, Canton, пакет Daml, стандарт токенов и builder. Sidecar сверяет части gateway с доказательствами по хранилищу, а заглушка отвечает на вызов доказательства `verify` . Во время репетиции не доказывается блок и не проверяется настоящее доказательство с нулевым разглашением.

Кроме того, проверяются explorer и faucet. Проверка Verify в explorer должна отклонить заглушку доказательства. В [README demo](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#the-rehearsal) описан охват репетиции.

## Запуск локальной сети на GPU

Перед запуском сети установите ZisK с помощью `prover/install.sh` . Всегда запускайте reth через предоставленный скрипт запуска; это делает `network/up.sh` .

```sh
network/up.sh       # инструменты, сборка guest, reth, sidecar-компоненты, prover, Canton, цепочка
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) network/smoke.sh    # один пустой блок: доказательство сформировано, блок добавлен в цепочку
network/down.sh
```

`up.sh` собирает guest и прекращает работу, если ключ программы, корневой каталог ZisK или хеш правил отличаются от записанных значений. В сети один синхронизатор и три участника. У участников operator и confirmer запущен sidecar. Участник с именем users размещает тестовые стороны и reader.

Дымовой тест добавляет в цепочку пустой блок, проверяет вершину цепочки и запись блока в reader, а также проверяет, что reth пометил блок как финализированный. Состояние и журналы сохраняются в `state/`или в `CZE_STATE_DIR` , если переменная задана.

## Запуск пяти сценариев demo на GPU

Для demo используйте новую локальную сеть:

```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      # необязательно: сначала добавить один пустой блок
CZE_SOURCE_COMMIT=$(git rev-parse HEAD) demo/run.sh
network/down.sh
```

Скрипт подготовки создаёт тестовые ключи и профинансированный genesis для запуска. Demo выполняет блок настройки, депозит, платёж, снятие средств, отказ в распределении и отказ для подменённого доказательства. Скрипт останавливается при сбое любой проверки и записывает результаты в `demo/results/`.

При экспорте исходного кода без `.git`задайте `CZE_SOURCE_COMMIT` равным полному хешу коммита, использованного для экспорта. Чтобы включить faucet, его профинансированный genesis нужно подготовить до запуска сети; см. [Запустите обозреватель самостоятельно](#run-the-explorer-yourself) ниже и полное руководство по демонстрации.

## Сохраняйте цепочку после перезапуска

Цепочка, которой пользуются люди, должна переживать сбои и перезагрузки. `up.sh` при каждом запуске создает новую цепочку, если не включить постоянный режим:

```sh
CZE_PERSIST=1 network/up.sh     # первый запуск: создается новая цепочка и сохраняется
network/down.sh                 # останавливает все компоненты и сохраняет данные
network/restart.sh              # после перезагрузки запускает ту же цепочку
network/down.sh --wipe          # останавливает все компоненты и окончательно удаляет цепочку
```

Canton хранит данные своих узлов в PostgreSQL на 127.0.0.1, а пароль, созданный на этой машине, — в файле с режимом 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, например на валидаторе Splice в Canton Network DevNet, а не в локальной сети. Так работает Ostia DevNet. `up.sh` затем запускает reth, prover и, если указать соответствующий параметр, один вспомогательный процесс, а также настраивает цепочку на этом участнике. Canton не запускается, начальная настройка не выполняется.

Вам понадобятся:

* JSON Ledger API (v2) участника: URL с `https` или URL с `http` на той же машине.
* Файл токена для каждого из четырех пользователей Ledger API: `ADMIN` (загружает пакет и создает стороны и пользователей, поэтому он нужен только `up.sh` и `setup.py` ), а также `OPERATOR`, `CONFIRMER` и `BUILDER` (пользователи, которых создает `setup.py` ): `ostia-operator`, `ostia-confirmer` и `ostia-builder`). Каждый токен использует HS256, значение audience — `https://canton.network.global` , а в качестве `sub`. Токены создаёт тот, кто запускает участника. Ostia никогда не создаёт, не выводит и не хранит токены.
* Сайдкар, доступный участнику и никому больше.

Срок действия токенов короткий, поэтому при каждом обновлении записывайте новый токен на место старого в тот же файл. Сборщик перечитывает свой файл при каждом вызове. `setup.py` и `propose.py` читают каждый токен только один раз, поэтому запускайте их с новыми токенами.

Сначала передайте участнику необходимую строку в качестве ещё одной переменной `ADDITIONAL_CONFIG` контейнера и перезапустите его:

```sh
network/external/participant-config.sh <sidecar address> 8085
# выводит: 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`, который загружает пакет, распределяет стороны, создаёт пользователей только с правами, соответствующими их ролям, и предлагает цепочку. Его можно безопасно запустить дважды. `restart.sh` восстанавливает цепочку и требует только токен сборщика. `down.sh --wipe` не затрагивает участника: контракты цепочки остаются на нём, пока оператор не удалит их.

В этом режиме действуют три правила:

* **Никогда не открывайте доступ к Ledger API.** Через него можно действовать от имени любой стороны, размещённой на участнике. Оставьте его доступным только по адресу самой машины или разместите за прокси, который проверяет, кто к нему обращается.
* **Устанавливайте для файлов токенов права доступа 0600**, и не храните их на общих машинах.
* **Оператор участника видит всё.** Один участник размещает все стороны Ostia, поэтому оператор может читать любой контракт и действовать от имени любой стороны, включая сторону, отвечающую за хранение средств шлюза. Единственный сайдкар выполняет роль конфирмера. В Ostia DevNet этим оператором является Rome: он запускает участника — собственный валидатор Canton DevNet.

## Непрерывная работа сборщика

`builder.py once` создаёт один блок. `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`, блок создаётся, когда ожидают транзакции, которые можно включить в него; по умолчанию одновременно выполняется не более одного блока (`--max-in-flight` увеличивает это значение). На неактивной цепочке блоки не создаются, если только `--heartbeat-seconds N` не задаёт создание пустого блока, если новый блок не создавался в течение N секунд; по умолчанию периодические блоки не создаются. После двух отклонённых блоков подряд сборщик подозревает, что проблема связана с транзакцией, и временно исключает её.

Одновременно может работать только один сборщик; команды `run` и `once` захватывают блокировку и отказываются запускаться, если она уже занята. При получении сигнала остановки сборщик завершает текущий блок и выходит. Запускайте сборщик под управлением службы, которая перезапускает его; время ожидания остановки должно превышать суммарное время создания доказательства и ответа Canton. Перезапуск безопасен в любой момент: при следующем запуске сборщик возвращается к текущей вершине Canton и повторно отправляет транзакции прерванного блока в reth. Сборщик записывает `status.json` и журнал в рабочую папку; оба файла используются обозревателем.

## Запустите обозреватель самостоятельно

Обозреватель работает в контейнере рядом с отображаемой им цепочкой на компьютере с Linux и Docker. Для него используется собственная база данных 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`и вызовов Read для контрактов, если не задана переменная [PUBLIC\_RPC=1](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/run.sh).

. Настройки перечислены в заголовке файла`explorer/run.sh`В предоставленной локальной сети для Ledger API не требуется вход в систему. Обозреватель выполняет чтение только от имени стороны reader, однако любой, кто может подключиться к этому участнику, также может читать данные других его сторон. Поэтому не назначайте контейнеру общедоступный адрес. Для существующего участника предоставьте обозревателю файл токена режима 0600 для пользователя reader ( `LEDGER_TOKEN_FILE` ), адрес участника `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` содержит набор инструментов, использованный для часового запуска на странице [«Измерения»](https://docs.rome.builders/ru/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/ru/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.
