> 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/build-on-ostia.md).

# Разрабатывайте на Ostia

Разверните Solidity-контракт в Ostia DevNet с помощью Foundry или Hardhat, проверьте его и подключитесь к сети через viem или ethers.

Ostia — это EVM-сеть, поэтому привычные вам инструменты работают и в ней. Есть несколько отличий; см. [Отличия от Ethereum](https://docs.rome.builders/ru/canton-zk-evm/evm-differences.md). На этой странице показано, как развернуть и верифицировать контракт, читать события и узнать, где транзакция становится окончательной в Canton. Вам понадобится адрес с некоторым количеством tROME. Кран [кран](https://docs.rome.builders/ru/canton-zk-evm/devnet.md#get-trome) выдаёт 1 tROME, а в разделе [Ostia DevNet](https://docs.rome.builders/ru/canton-zk-evm/devnet.md) указаны параметры сети.

## Развёртывание с помощью Foundry

Эти команды проверены в Foundry 1.8. Сначала выполните `foundryup` (или `brew upgrade foundry`). Работайте в проекте Foundry (команда`forge init ostia-counter` создаёт такой проект с контрактом `Counter` ) и храните пополненный ключ в `PRIVATE_KEY`. `forge init` уже создаёт таблицу `[profile.default]` в файле `foundry.toml`. Добавьте под ней одну строку, чтобы при развёртывании и верификации использовались одинаковые настройки компиляции:

```toml
[profile.default]
# ...оставьте без изменений строки, созданные forge init
evm_version = "london"
```

```sh
export RPC=https://ostia.devnet.romeprotocol.xyz/rpc
forge create src/Counter.sol:Counter \
  --rpc-url $RPC --private-key $PRIVATE_KEY --broadcast
```

На Ostia уже запускали следующие проекты:

| Что                                                                                                   | Компилятор          | Версия EVM |
| ----------------------------------------------------------------------------------------------------- | ------------------- | ---------- |
| Набор для [смешанной нагрузки](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) | solc 0.8.17         | `london`   |
| Uniswap V2                                                                                            | solc 0.5.16 и 0.6.6 | `istanbul` |
| Контракты Merces от TACEO                                                                             | solc 0.8.37         | `osaka`    |

Сеть Ostia поддерживает все форки вплоть до Osaka с 2026-10-28, поэтому принимает код, собранный для любой целевой версии EVM вплоть до `osaka`. В таблице указаны версии, для которых уже запускали код; `london` — безопасный выбор. Операкод, добавленный после Osaka, не будет работать.

## Верификация с помощью Foundry

Эксплорер использует API Etherscan, поэтому `forge verify-contract` работает с верификатором Etherscan. В качестве API-ключа можно указать любой текст.

```sh
forge verify-contract <address> src/Counter.sol:Counter \
  --chain-id 770101 \
  --verifier etherscan \
  --verifier-url https://ostia.devnet.romeprotocol.xyz/api \
  --etherscan-api-key any \
  --watch
```

Эксплорер принимает от одного клиента не более 30 запросов на верификацию в час. Если превысить этот лимит, подождите и отправьте запрос повторно. У верифицированного контракта исходный код отображается на странице контракта в эксплорере.

## Верификация большого контракта

Контракт с большим количеством файлов исходного кода может получить отказ с кодом HTTP `413`. Передний прокси-сервер эксплорера принимает около 300 КБ на запрос, а forge отправляет данные в формате URL-кодирования, из-за чего размер превышает размер файлов. `POST /api/verify` принимает те же данные в формате standard JSON, который занимает меньше места. Ограничение прокси-сервера применяется ко всем запросам, поэтому запрос с телом JSON размером более 300 КБ тоже будет отклонён. Скрипт из набора [`verify-large.mjs`](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/scripts/verify-large.mjs) решает эту проблему. С его помощью были отправлены данные standard JSON контрактов Merces размером 265 КБ, которые forge не смог отправить. Для этого сначала получите данные standard JSON из проекта Foundry и скопируйте их в папку набора (`load/mixed` в клоне репозитория):

```sh
forge verify-contract <address> <path:Name> --show-standard-json-input > std.json
cp std.json <your clone of canton-zk-evm>/load/mixed/
```

Затем в папке набора установите зависимости командой `npm ci` и запустите скрипт. Адрес эксплорера он берёт из файла `config.json`набора. (При использовании Docker то же самое можно сделать командой `./run.sh node scripts/verify-large.mjs ...` .)

```sh
node scripts/verify-large.mjs <address> <path:Name> std.json <compiler> <runs> <evm> <constructor-args|->
```

Укажите полную строку версии компилятора. Для контракта `Counter` , собранного с помощью solc 0.8.28, включённым оптимизатором с 200 итерациями и версией EVM `london` без аргументов конструктора:

```sh
node scripts/verify-large.mjs 0xC249f8828EAe40Ad6a77178e4de88049ed5e962f \
  src/Counter.sol:Counter std.json v0.8.28+commit.7893614a 200 london -
```

Эксплорер компилирует контракт с настройками из std.json, которые forge формирует на основе foundry.toml. Поэтому верификация проходит с теми настройками оптимизатора, с которыми был собран контракт. Скрипт отправляет запрос на верификацию, а затем опрашивает `GET /api/verify/<guid>` до получения ответа `Pass` или `Fail`. Здесь действует тот же лимит — 30 запросов в час.

## Развёртывание с Hardhat

Инструкции предназначены для Hardhat 2 (для Hardhat 3 требуется конфигурация ESM). Шаги начинаются с пустой папки; они проверены в Ostia DevNet с Hardhat 2.29 и Node 22. Храните пополненный ключ в `PRIVATE_KEY`, вместе с его префиксом `0x`.

```sh
mkdir ostia-hardhat && cd ostia-hardhat
npm init -y
npm i -D hardhat@2 @nomicfoundation/hardhat-toolbox@hh2
mkdir contracts scripts
```

`npx hardhat init` задаёт вопросы в терминале и самостоятельно записывает пример контракта, поэтому создайте три файла вручную. Сначала контракт:

```solidity
// contracts/Counter.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

contract Counter {
    uint256 public number;

    function setNumber(uint256 newNumber) public {
        number = newNumber;
    }

    function increment() public {
        number++;
    }
}
```

Конфигурация. Её `solidity` версия соответствует директиве pragma:

```js
// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: { version: "0.8.17", settings: { evmVersion: "london" } },
  networks: {
    ostia: {
      url: "https://ostia.devnet.romeprotocol.xyz/rpc",
      chainId: 770101,
      accounts: [process.env.PRIVATE_KEY],
      timeout: 120000,
    },
  },
};
```

Скрипт развёртывания:

```js
// scripts/deploy.js
const hre = require("hardhat");

async function main() {
  const counter = await hre.ethers.deployContract("Counter");
  await counter.waitForDeployment();
  console.log("Counter deployed to", await counter.getAddress());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

```sh
npx hardhat run scripts/deploy.js --network ostia
```

Команда выводит `Counter deployed to 0x...`. Параметр `timeout` применяется к каждому запросу. При развёртывании также ожидается квитанция транзакции, которая появляется только после достижения финальности в Canton (см. ниже). В тесте, проведённом 2026-10-25, выполнение команды заняло от 20 до 23 секунд; большая часть времени ушла на ожидание финализации блока.

## Верификация с помощью Hardhat

Добавьте обозреватель как пользовательскую сеть в `@nomicfoundation/hardhat-verify`, который `hardhat-toolbox` включает в приведённую выше конфигурацию. В качестве API-ключа подойдёт любой текст. Проверка поиска была выполнена с Hardhat 2.29.1 и hardhat-verify 2.1.3 для уже верифицированного контракта: плагин нашёл пользовательскую сеть, запросил API обозревателя и ответил «уже верифицирован». Новую отправку не проверяли, поэтому сообщите нам, если она не сработает. Плагин выводит предупреждение об устаревании API-ключей для отдельных сетей. Это ожидаемое предупреждение: оставьте параметр `apiKey` ниже, поскольку форма с одной строкой не работает в этой сети («Выбранная сеть (ostia) неверна»).

```js
// hardhat.config.js, рядом с solidity и networks
etherscan: {
  apiKey: { ostia: "any" },
  customChains: [
    {
      network: "ostia",
      chainId: 770101,
      urls: {
        apiURL: "https://ostia.devnet.romeprotocol.xyz/api",
        browserURL: "https://ostia.devnet.romeprotocol.xyz",
      },
    },
  ],
},
```

```sh
npx hardhat verify --network ostia <address> <constructor arguments>
```

Сохраните те же `solidity` настройки, включая `evmVersion`, что и при развертывании. Обозреватель компилирует код с заданными ему настройками. Действует то же ограничение: не более 30 проверок в час.

## viem и ethers

Определение сети для viem:

```ts
import { createPublicClient, defineChain, http } from "viem";

export const ostia = defineChain({
  id: 770101,
  name: "Ostia DevNet",
  nativeCurrency: { name: "tROME", symbol: "tROME", decimals: 18 },
  rpcUrls: { default: { http: ["https://ostia.devnet.romeprotocol.xyz/rpc"] } },
  blockExplorers: {
    default: { name: "Ostia explorer", url: "https://ostia.devnet.romeprotocol.xyz" },
  },
});

const client = createPublicClient({ chain: ostia, transport: http() });
```

Провайдер ethers:

```js
import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider(
  "https://ostia.devnet.romeprotocol.xyz/rpc",
  { chainId: 770101, name: "ostia-devnet" },
  { polling: true },
);
```

В RPC нет WebSocket и фильтров, поэтому ethers v6 нужен параметр `{ polling: true }` для отслеживания событий (`contract.on`, или `provider.on` с фильтром). Квитанция появляется только после финализации блока, поэтому при настройке тайм-аута закладывайте примерно 10–30 секунд. Отправляйте транзакции одного аккаунта по порядку; см. [Отличия от Ethereum](https://docs.rome.builders/ru/canton-zk-evm/evm-differences.md#nonces-and-the-order-of-sends).

В viem `multicall` требуется Multicall3 в сети. В Ostia он находится по стандартному адресу, поэтому добавьте его в определение сети: `contracts: { multicall3: { address: "0xcA11bde05977b3631167028862bE2a173976CA11" } }` (см. [Отличия от Ethereum](https://docs.rome.builders/ru/canton-zk-evm/evm-differences.md#the-standard-contracts)).

## Квитанции и события

RPC показывает только блоки, финализированные в Canton. После отправки транзакции `eth_getTransactionReceipt` ничего не возвращает, пока блок не будет финализирован; это занимает примерно 10–30 секунд. При настройке тайм-аута ожидания квитанции в инструменте учитывайте время на создание доказательства и подтверждение в Canton.

WebSocket отсутствует, как и `eth_subscribe`, а eth\_newFilter не поддерживается `eth_newFilter`. Чтобы отслеживать события, запрашивайте `eth_getLogs` с диапазоном блоков, начиная с момента последнего запроса. Достаточно опрашивать раз в несколько секунд. За 24 часа до 2026-10-25 01:34 UTC медианный интервал между блоками при высокой нагрузке на сеть составлял 16,6 секунды, а при низкой нагрузке пустой блок создаётся раз в минуту. Не превышайте 300 запросов в минуту.

## Просмотр транзакции в Canton

1. Откройте транзакцию в обозревателе по адресу `/tx/<hash>`.
2. Перейдите по ссылке на её блок: `/block/<number>`.
3. На странице блока отображается обновление Canton, содержащее запись блока, время, когда Canton её зафиксировала, а также факты, подтверждающие корректность, рядом с ожидаемыми значениями обозревателя.
4. Нажмите **Проверить**. Браузер самостоятельно проверит доказательство, заголовок и транзакции, предоставленные обозревателем. Кнопка неактивна, пока для блока ещё формируется доказательство.

Те же данные доступны через API, например `GET /api/blocks/<number>` и `GET /api/canton/updates/<update id>`.

## Пример побольше

В папке [`load/mixed`](https://github.com/rome-protocol/canton-zk-evm/tree/v0.1.0/load/mixed) разворачивается набор контрактов и создаётся смешанный трафик для них: ERC-20, ERC-721, ERC-1155, токен с разрешительным доступом ERC-3643, Uniswap V2 и контракты конфиденциальных переводов Merces от TACEO (их доказательства проверяются в сети; расчёты не производятся). Инструкции приведены в файле [README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/README.md) . Комплект также проверяет в обозревателе каждый развёрнутый им контракт. С настройками по умолчанию ему требуется около 12 000 tROME — намного больше, чем выдаёт кран. Поэтому запускайте его в собственной Ostia (см. раздел [Запуск собственной Ostia](https://docs.rome.builders/ru/canton-zk-evm/run-it-locally.md#load-it-with-a-realistic-mix)). Загрузка компилятора работает только в Linux x64. Во время одного запуска 2026-10-24 за час было отправлено 13 496 транзакций, и все они завершились финализацией. В разделе [результаты](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/RESULTS-2026-10-24.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/ru/canton-zk-evm/build-on-ostia.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.
