> 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/ko/canton-zk-evm/build-on-ostia.md).

# Ostia에서 빌드

Foundry 또는 Hardhat을 사용해 Ostia DevNet에 Solidity 컨트랙트를 배포하고, 검증한 다음 viem 또는 ethers로 연결하세요.

Ostia는 EVM 체인이므로 기존에 사용하던 도구를 그대로 사용할 수 있습니다. 몇 가지 차이점이 있습니다. 자세한 내용은  [이더리움과의 차이점](https://docs.rome.builders/ko/canton-zk-evm/evm-differences.md)을 참조하세요. 이 페이지에서는 컨트랙트를 배포하고 검증하는 방법, 이벤트를 읽는 방법, Canton에서 트랜잭션이 최종 확정되는 것을 확인할 수 있는 위치를 안내합니다. tROME이 조금 있는 주소가 필요합니다.  [수도꼭지](https://docs.rome.builders/ko/canton-zk-evm/devnet.md#get-trome) 에서 1 tROME을 받을 수 있으며,  [Ostia DevNet](https://docs.rome.builders/ko/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` |
| TACEO의 Merces 계약                                                                     | solc 0.8.37         | `osaka`    |

Ostia 체인은 2026-10-28 이후 Osaka까지의 모든 포크를 실행했으므로, 체인은 다음 EVM 타깃까지 빌드된 코드를 모두 허용합니다. `osaka`. 표의 타깃은 실제로 실행된 타깃입니다. `london` 은 안전한 선택입니다. Osaka 이후에 추가된 옵코드는 실행되지 않습니다.

## 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
```

탐색기는 클라이언트 하나에서 시간당 검증 요청을 30건까지 받습니다. 이 한도를 넘으면 잠시 기다렸다가 요청을 다시 보내세요. 검증된 컨트랙트는 탐색기의 컨트랙트 페이지에 소스 코드가 표시됩니다.

## 대형 컨트랙트 검증

소스 파일이 많은 컨트랙트는 HTTP `413`로 거부될 수 있습니다. 탐색기의 프록시 앞단은 요청당 약 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`이 될 때까지 확인합니다. 동일하게 시간당 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` 터미널에서 질문을 하고 자체 샘플 컨트랙트를 작성하므로, 세 파일을 직접 만듭니다. 먼저 컨트랙트입니다.

```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`도 포함됩니다. 익스플로러는 제공된 설정으로 컴파일합니다. 시간당 검증 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초를 고려하세요. 한 계정의 트랜잭션은 순서대로 전송하세요. 자세한 내용은 [이더리움과의 차이점](https://docs.rome.builders/ko/canton-zk-evm/evm-differences.md#nonces-and-the-order-of-sends).

viem에서 `multicall` 을 사용하려면 체인에 Multicall3이 있어야 합니다. Ostia에는 일반적으로 사용되는 주소에 배포되어 있으므로 체인 정의에 추가하세요: `contracts: { multicall3: { address: "0xcA11bde05977b3631167028862bE2a173976CA11" } }` (자세한 내용은 [이더리움과의 차이점](https://docs.rome.builders/ko/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분에 한 번 빈 블록이 생성됩니다. 분당 300회 호출을 넘지 마세요.

## Canton에서 트랜잭션 확인하기

1. 탐색기에서 다음 주소로 트랜잭션을 여세요. `/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이 필요합니다. 이는 faucet에서 제공하는 양보다 훨씬 많으므로, 직접 Ostia를 실행해 사용하세요(자세한 내용은 다음을 참조하세요: [직접 Ostia 실행하기](https://docs.rome.builders/ko/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/ko/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.
