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

# Ostia上で構築する

FoundryまたはHardhatを使ってOstia DevNetにSolidityコントラクトをデプロイし、検証して、viemまたはethersで接続します。

OstiaはEVMチェーンなので、すでにお使いのツールをそのまま利用できます。いくつか異なる点があるため、 [Ethereumとの違い](https://docs.rome.builders/ja/canton-zk-evm/evm-differences.md)をご覧ください。このページでは、コントラクトのデプロイと検証、イベントの読み取り方法、Canton上でトランザクションがファイナリティに達したことを確認できる場所を説明します。tROMEを少量保有するアドレスが必要です。 [フォーセット](https://docs.rome.builders/ja/canton-zk-evm/devnet.md#get-trome) では1 tROMEを受け取れます。また、 [Ostia DevNet](https://docs.rome.builders/ja/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`に作成されます。その下に1行追加して、デプロイと検証で同じ設定を使ってコンパイルできるようにします。

```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バージョン   |
| ----------------------------------------------------------------------------------------- | ------------------- | ---------- |
| 「 [mixed-load kit](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` |
| TACEOのMercesコントラクト                                                                        | solc 0.8.37         | `osaka`    |

Ostiaのチェーンでは2026-10-28以降、大阪までのすべてのフォークが実行されているため、チェーンは `osaka`までの任意のEVMターゲット向けにビルドされたコードを受け入れます。表に記載したターゲットは実際に実行されたものです。 `london` は安全な選択肢です。大阪より後に追加されたオペコードは実行されません。

## Foundryで検証する

エクスプローラーはEtherscan APIに対応しているため、 `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
```

エクスプローラーは、1つのクライアントから1時間あたり30件の検証を受け付けます。上限を超えた場合は、しばらく待ってからリクエストを再送してください。検証済みのコントラクトは、エクスプローラーのコントラクトページにソースコードが表示されます。

## 大きなコントラクトを検証する

ソースファイルが多数あるコントラクトは、HTTP `413`で拒否されることがあります。エクスプローラーのフロントプロキシが1リクエストあたり約300 KBまでしか受け付けないうえ、forgeは入力をURLエンコードして送信するため、ファイルサイズより大きくなるからです。 `POST /api/verify` は標準JSONと同じ入力を受け付け、サイズも小さくなります。プロキシの上限はすべてのリクエストに適用されるため、300 KBを超えるJSON本文も拒否されます。キットの [`verify-large.mjs`](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/load/mixed/scripts/verify-large.mjs) がこの処理を行います。forgeでは送信できなかったMercesコントラクトの265 KBの標準JSONを送信しました。使用するには、まずFoundryプロジェクトから標準JSONを取得し、キットのフォルダー（リポジトリをクローンした場合は`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`になるまで確認します。こちらも同じく、上限は1時間あたり30件です。

## Hardhatでデプロイする

これはHardhat 2向けです（Hardhat 3ではESM設定が必要です）。以下の手順は空のフォルダーから始め、Node 22上のHardhat 2.29を使ってOstia DevNetで実行しました。資金を入れたキーは `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` ターミナルで質問に答え、独自のサンプルコントラクトを作成するため、3つのファイルは手動で作成します。まずコントラクトです。

```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
// solidity と networks の隣にある hardhat.config.js
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`も含まれます。エクスプローラーは指定された設定でコンパイルします。1時間あたり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/ja/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/ja/canton-zk-evm/evm-differences.md#the-standard-contracts)).

## レシートとイベント

RPC が表示するのは、Canton 上でファイナライズされたブロックのみです。トランザクションを送信した後、 `eth_getTransactionReceipt` は、そのブロックがファイナライズされるまで何も返しません。これには約10～30秒かかります。ツールでレシートのタイムアウトを設定する場合は、証明の生成と Canton の確認にかかる時間を見込んでください。

WebSocket はなく、 `eth_subscribe`、また、 `eth_newFilter`は使わないでください。イベントを追跡するには、 `eth_getLogs` を使い、前回のポーリング以降のブロック範囲を指定してポーリングします。数秒ごとのポーリングで十分です。2026-10-25 01:34 UTCまでの24時間では、チェーンが活発な時間帯のブロック間隔の中央値は16.6秒でした。また、静かなチェーンでも1分に1つ空のブロックが生成されます。呼び出しは1分あたり300回までにしてください。

## Canton上でトランザクションを確認する

1. エクスプローラーでトランザクションを開きます。URLは `/tx/<hash>`.
2. ブロックへのリンクをたどります。 `/block/<number>`.
3. ブロックページには、そのブロックの記録を含むCantonの更新、Cantonが記録した時刻、およびエクスプローラーの期待値と並んで証明に関する情報が表示されます。
4. ［ **検証**］を押します。ブラウザーは、エクスプローラーが提供する証明、ヘッダー、トランザクションを使って、証明の検証をローカルで実行します。ブロックの証明が完了するまでは、ボタンは無効になります。

同じデータはAPIからも取得できます。たとえば、 `GET /api/blocks/<number>` および `GET /api/canton/updates/<update id>`.

## より大きな例

&#x20;[`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、およびTACEOのMercesプライベート転送コントラクトが対象です（それらの証明はオンチェーンで検証されますが、決済は行われません）。その [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/ja/canton-zk-evm/run-it-locally.md#load-it-with-a-realistic-mix)」を参照）。コンパイラーのダウンロードはlinux x64でのみ実行できます。2026-10-24のある実行では、1時間で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/ja/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.
