For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

Ostia — это цепочка EVM, поэтому инструменты, которые вы уже используете, работают с ней. На этой странице показано, как развернуть и верифицировать контракт, как читать события и где увидеть, как ваша транзакция становится окончательной в Canton. Вам нужен адрес с некоторым количеством tROME. Кран кран даёт 1 tROME, а Ostia DevNet здесь есть сведения о сети.

Развертывание с Foundry

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

[profile.default]
# ...строки, записанные forge init, остаются без изменений
evm_version = "london"
export RPC=https://ostia.devnet.romeprotocol.xyz/rpc
forge create src/Counter.sol:Counter \\
  --rpc-url $RPC --private-key $PRIVATE_KEY --broadcast

Пока в Ostia запускались следующие:

Что
Компилятор
Версия EVM

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 может быть любым текстом.

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 принимает тот же ввод, что и стандартный JSON, который меньше. Ограничение прокси применяется к каждому запросу, поэтому JSON-тело больше 300 КБ тоже будет отклонено. Команда набора verify-large.mjs делает это. Она отправила стандартный JSON объёмом 265 КБ для контрактов Merces, который forge не смог отправить. Чтобы использовать её, сначала получите стандартный JSON из вашего проекта Foundry и скопируйте его в папку набора (load/mixed в клоне репозитория):

Затем в папке набора установите его пакеты с помощью npm ci и запустите скрипт. Он берёт адрес обозревателя из config.json. (С Docker ./run.sh node scripts/verify-large.mjs ... делает то же самое.)

Указывайте компилятор как полную строку версии. Для Counter контракта, собранного с solc 0.8.28, с включенным оптимизатором на 200 прогонах, версией EVM 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.

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

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

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

Он выводит Counter deployed to 0x.... тайм-аут применяется к каждому запросу. Развертывание также ожидает своей квитанции, которая появляется только после финализации Canton (см. ниже). В тесте 2026-10-25 команда заняла 20–23 секунды, большую часть времени ожидая, пока блок станет окончательным.

viem и ethers

Определение цепочки viem:

Провайдер ethers:

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

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

Здесь нет WebSocket и нет eth_subscribe, и нет 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 папка разворачивает набор контрактов и прогоняет через них смешанный трафик: ERC-20, ERC-721, ERC-1155, разрешённый токен ERC-3643, Uniswap V2 и контракты частного перевода Merces от TACEO (их доказательства проверяются в цепочке; ничего не рассчитывается). Его README содержит команды. Набор также верифицирует каждый развёрнутый им контракт в обозревателе. В поставляемой конфигурации ему требуется около 12 000 tROME, что гораздо больше, чем даёт кран, поэтому запускайте его на своём собственном Ostia (см. Запустите свой собственный Ostia). Его загрузка компилятора работает только на linux x64. 2026-10-24 один запуск отправил 13 496 транзакций за час, и все они стали окончательными. результаты показывают, что было измерено и что не сработало.

Последнее обновление

Это было полезно?