> 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/devnet.md).

# Ostia DevNet

체인 ID, RPC, 탐색기, API, 지갑 설정, 파우셋 및 제한을 포함한 Ostia DevNet의 네트워크 세부 정보.

Ostia DevNet은 공개 Ostia 네트워크입니다. Canton Network DevNet에서 실행되며, 다음 날짜부터 운영되고 있습니다. **2026-10-22**. 지갑, Foundry, Hardhat, ethers, viem 등 일반적인 EVM 도구를 사용할 수 있습니다. 이 페이지에는 연결에 필요한 값이 나와 있습니다. [Ostia에서 빌드하기](https://docs.rome.builders/ko/canton-zk-evm/build-on-ostia.md) 에서 안내하는 과정을 따라 배포 및 검증이 완료된 컨트랙트를 만들 수 있습니다.

이후 **2026-10-29** 네트워크에서는 Canton 자산도 양방향으로 이동합니다. ERC-20 토큰은 Canton에서 트윈으로 표시되며, Canton Coin은 Ostia로 이동한 다음 다시 돌아갈 수 있습니다. 주소는 아래의 [DevNet의 Canton 자산](#canton-assets-on-devnet) 에서 확인할 수 있습니다.

## 네트워크 세부 정보

| 설정               | 값                                                                                              |
| ---------------- | ---------------------------------------------------------------------------------------------- |
| 네트워크 이름          | Ostia DevNet                                                                                   |
| 체인 ID            | `770101` (16진수 `0xbc035`)                                                                      |
| 통화               | tROME, 소수점 이하 18자리. 가치는 없습니다.                                                                  |
| RPC              | `https://ostia.devnet.romeprotocol.xyz/rpc` (HTTP 전용, 최종 블록만 지원)                               |
| 블록 탐색기           | [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz)                         |
| Etherscan 호환 API | `https://ostia.devnet.romeprotocol.xyz/api`                                                    |
| REST API         | `https://ostia.devnet.romeprotocol.xyz/api/...`, OpenAPI 문서에 설명되어 있으며, 문서는 `/api/openapi.json` |
| 상태 및 정상 작동 여부    | `/api/status` 및 `/api/health` 블록 탐색기의 주소에서 확인할 수 있습니다.                                         |

가스 가격은 약 1 gwei이며, 블록당 최대 60,000,000 가스를 사용할 수 있습니다. 단일 트랜잭션의 가스 사용량은 최대 16,777,216(2^24)으로, Osaka 포크에서 설정한 한도입니다. block.prevrandao `block.prevrandao` 값이 0이고 blob 트랜잭션을 지원하지 않는 등 Ethereum과 다른 점도 있습니다. 자세한 내용은 [Ethereum과의 차이점](https://docs.rome.builders/ko/canton-zk-evm/evm-differences.md).

## 지갑에 추가하기

MetaMask 또는 다른 지갑에서 다음 값을 사용해 사용자 지정 네트워크를 추가하세요.

| 필드         | 값                                           |
| ---------- | ------------------------------------------- |
| 네트워크 이름    | Ostia DevNet                                |
| 새 RPC URL  | `https://ostia.devnet.romeprotocol.xyz/rpc` |
| 체인 ID      | `770101`                                    |
| 통화 기호      | `tROME`                                     |
| 블록 탐색기 URL | `https://ostia.devnet.romeprotocol.xyz`     |

블록 탐색기에서 대신 추가할 수도 있습니다. 블록 탐색기의 [API 페이지](https://ostia.devnet.romeprotocol.xyz/docs/api) 를 열고 네트워크를 지갑에 추가하는 버튼을 누르세요.

## tROME 받기

누구나 하루에 1 tROME을 받을 수 있습니다. 빌더는 빌더 보조금을 통해 7일에 한 번 100 tROME을 받을 수 있습니다. 다음을 엽니다. [수도꼭지](https://ostia.devnet.romeprotocol.xyz/faucet)에 주소를 붙여넣고 요청하세요. 터미널에서도 요청할 수 있습니다.

```sh
curl -X POST https://ostia.devnet.romeprotocol.xyz/api/faucet \
  -H 'content-type: application/json' \
  -d '{"address":"0xYourAddress"}'
```

요청이 접수되면 `202` 다음 형식의 응답이 `ticket`반환됩니다. 상태가 `GET /api/faucet/ticket/<ticket>` 가 될 때까지 요청하세요. `final` (또는 `failed`). 상태는 `queued` 에서 `sent` 에서 `final`로 바뀝니다. 지갑 주소를 `0xYourAddress`대신 사용하세요. 수도꼭지의 한도는 다음과 같습니다.

* 주소당 24시간마다 1 tROME;
* IP 주소당 10분마다 요청 1회;
* 모든 사용자에게 시간당 최대 5,000회 지급.

지급은 최대 100건씩 묶음으로 전송됩니다. 전송된 후 Canton에서 해당 블록이 최종 확정되면 지급이 완료되며, 보통 10\~30초가 걸립니다. 현재 가스 가격 기준으로 1 tROME이면 일반적인 트랜잭션을 수천 건 처리할 수 있습니다. 수도꼭지의 한도는 [익스플로러 README의 수도꼭지 섹션](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet).

### 빌더 보조금

GitHub로 로그인하는 빌더는 1 tROME 대신 100 tROME을 받습니다. 수도꼭지 페이지에서 주소를 입력한 다음 "Ostia에서 개발 중이신가요? GitHub로 로그인하고 100 tROME을 받으세요."라는 문구에서 "GitHub로 로그인"을 선택하세요. 지갑을 연결했고 아직 해당 지갑에 tROME이 없는 경우 브리지 페이지의 "테스트용 tROME 받기"에서도 같은 절차를 이용할 수 있습니다. 그렇지 않으면 수도꼭지 페이지를 이용하세요. GitHub 로그인이 끝나면 수도꼭지 페이지로 돌아오며, 다른 요청과 마찬가지로 보조금이 최종 확정될 때까지 진행 상황을 확인할 수 있습니다. 이 페이지는 GitHub에 어떤 권한도 요청하지 않으며 계정 번호와 계정 생성 날짜만 읽습니다.

* GitHub 계정은 생성된 지 최소 30일이 지나야 합니다.
* GitHub 계정당 보조금 1회, 주소당 7일마다 1회입니다.
* 모든 사용자에게 하루 최대 200건의 보조금이 지급됩니다.

GitHub 계정 유무와 관계없이 누구나 하루에 1 tROME을 받을 수 있습니다. 수도꼭지의 `GET /api/faucet` 응답에는 보조금이 활성화되어 있는지와 보조금 액수 및 한도가 표시됩니다. 규칙은 [익스플로러 README의 빌더 보조금](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-builder-grant) 섹션에 있습니다.

### 테스트용 Canton Coin

2026-11-17부터 브리지 페이지에서 Canton Coin을 받을 수 있는 수도꼭지가 제공되지 않습니다(기존 수도꼭지는 폐지된 브리지 계정에만 지급했습니다). 본인의 Canton 지갑에서 테스트용 Canton Coin을 받으세요.

## 제한 사항

다음 주소의 RPC는 `/rpc` 체인으로 요청을 전달하며, 다음과 같은 차이가 있습니다.

* 다음 20개 메서드에 응답합니다. `eth_chainId`, `net_version`, `web3_clientVersion`, `eth_syncing`, `eth_blockNumber`, `eth_getBalance`, `eth_getCode`, `eth_getStorageAt`, `eth_getTransactionCount`, `eth_call`, `eth_estimateGas`, `eth_gasPrice`, `eth_maxPriorityFeePerGas`, `eth_feeHistory`, `eth_getBlockByNumber`, `eth_getBlockByHash`, `eth_getTransactionByHash`, `eth_getTransactionReceipt`, `eth_getLogs` 및 `eth_sendRawTransaction`. 다른 메서드는 응답하지 않습니다 `-32601`.
* WebSocket은 지원하지 않으며, `eth_newFilter` 또는 `eth_subscribe`도 지원하지 않습니다. 이벤트를 추적하려면 다음을 폴링하세요. `eth_getLogs`.
* Canton에서 최종 확정된 블록만 표시합니다. `latest`, `safe`, `pending` 및 `finalized` 모두 최신 최종 확정 블록을 의미합니다(단, `eth_getTransactionCount` 의 경우는 예외입니다. 이는 대기 중인 트랜잭션을 세어 지갑이 다음 nonce를 선택하도록 합니다). 블록이 최종 확정되면 영수증이 표시되며, 약 10\~30초가 걸립니다. `pending`로 대기 중인 트랜잭션 수를 계산하여 지갑이 다음 nonce를 선택하도록 하는 경우는 예외입니다). 영수증은 해당 블록이 최종 확정된 후 표시되며, 약 10\~30초가 걸립니다.
* 각 클라이언트는 분당 300회 호출할 수 있습니다. 배치 요청은 포함된 각 호출을 개별적으로 계산하며, 최대 20개 호출까지 포함할 수 있습니다. 요청 본문은 최대 256 KiB입니다.
* 계정의 다음 nonce보다 앞선 nonce를 가진 트랜잭션은 nonce 공백으로 거부됩니다. 누락된 트랜잭션을 먼저 전송하세요.
* 가스당 최대 수수료가 현재 기본 수수료보다 낮은 트랜잭션은 거부됩니다. 지갑과 도구에서 이를 자동으로 설정합니다.

익스플로러 API에는 별도의 제한이 있으며, 클라이언트별로 적용되고 키는 필요하지 않습니다.

| API                       | 제한                                                                                                                                              |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| REST API (`/api/...`)     | 초당 20회 요청, 최대 60회까지 버스트 허용. 제한을 초과한 클라이언트에는 `429` 헤더가 포함된 `Retry-After`.                                                                        |
| Etherscan 호환 API (`/api`) | 초당 10회, 분당 600회 요청. 제한을 초과한 클라이언트에는 `Max rate limit reached`가 반환됩니다(Etherscan의 응답과 동일).                                                         |
| 컨트랙트 검증                   | 시간당 30회입니다. 약 300 KB보다 큰 요청은 `413` (참고: [Ostia에서 구축하기](https://docs.rome.builders/ko/canton-zk-evm/build-on-ostia.md#verify-a-large-contract)). |

다음  [explorer README](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-public-rpc) 에는 비용이 큰 호출의 전역 상한을 포함한 RPC 규칙이 모두 설명되어 있습니다.

## 트랜잭션이 없는 체인은 1분마다 블록을 생성합니다

Ostia는 대기 중인 트랜잭션이 생기면 즉시 블록을 생성합니다. 60초 동안 블록이 생성되지 않으면 하트비트 역할을 하는 빈 블록을 생성합니다. 유휴 상태의 체인에서는 빌더가 이전 커밋을 기록한 지 60초 후에 해당 블록의 생성을 시작하며, 증명과 정산에 추가 시간이 걸립니다. 따라서 정상적인 유휴 체인에서는 새 블록이 생성되지 않는 시간이 길어도 몇 분을 넘지 않습니다. 문제가 발생하면 다음 블록이 늦게 생성될 수 있습니다. 2026-10-25 오전 이전에는 하트비트가 없어 유휴 체인에서 몇 시간 동안 블록이 생성되지 않을 수 있었습니다. 그날 07:53\~08:49 UTC 사이 트랜잭션이 없는 구간에서는 빈 블록이 약 75초 간격으로 생성되었습니다. 1분을 기다린 후 빈 블록을 증명하고 커밋하는 데 시간이 걸렸기 때문입니다. 트랜잭션은 하트비트를 기다리지 않고 이전과 마찬가지로 다음에 생성되는 블록에 포함됩니다.

블록에는 트랜잭션이 사용하는 가스를 기준으로 가스 상한 60,000,000과 원시 바이트 상한(DevNet에서는 393,216)을 넘지 않는 만큼의 트랜잭션이 포함됩니다. 가스 상한 내에서는 일반 전송 약 2,857건을 처리할 수 있습니다. (2026-10-27까지 가스 상한은 30,000,000이었으며, 일반 전송 1,428건을 처리할 수 있었습니다. 바이트 상한은 2026-10-25부터 196,608이었습니다.  [측정 결과](https://docs.rome.builders/ko/canton-zk-evm/measurements.md) 의 처리량 수치는 가스 상한이 30,000,000이고 바이트 상한이 65,536\~196,608인 조건에서 측정되었습니다.)

## DevNet의 Canton 자산

2026-10-29부터 ERC-20 토큰을 Canton에서 트윈으로 보유할 수 있으며, Canton Coin을 Ostia로 가져왔다가 다시 돌려보낼 수 있습니다. ERC-20을 볼트에 입금하면 지정한 Canton 당사자가 동일한 양의 트윈을 보유하게 됩니다. 이 트윈은 instrument ID가  `erc20:<token address>`인 CIP-0056 토큰입니다. 환매하면 트윈이 소각되고 볼트에서 ERC-20이 반환됩니다. Canton Coin의 경우 당사자가 게이트웨이를 통해 입금하고 Ostia에서 CC 토큰을 수령합니다. CC를 소각하면 Canton Coin이 반환됩니다. [입금, 출금 및 결제](https://docs.rome.builders/ko/canton-zk-evm/deposits-withdrawals-payments.md) 에서 각 과정을 설명합니다.

| 항목                                                                                                                                                    | Ostia DevNet 주소                              |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| 게이트웨이: 다음을 호출하는 컨트랙트:  `pay`, `withdraw` 및  `claim` (참고:  [게이트웨이 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md)) | `0xa7E0000000000000000000000000000000000000` |
| 볼트                                                                                                                                                    | `0x69f13a94f986021f1a7650eb611bf9b717aa495a` |
| TKA: 트윈이 있는 ERC-20 토큰(소수점 이하 18자리)                                                                                                                    | `0xf4b69022b3e6501101600743f17fbe0659dd1af8` |
| WtROME: 래핑된 tROME으로, 두 번째 트윈(소수점 이하 18자리)                                                                                                             | `0xc221fc4af51caa9d198e70e3cb3b8f3d9d2adc64` |
| CC: Ostia의 Canton Coin(소수점 이하 10자리, 이전 기록에서는 wCC로 표기)                                                                                                 | `0x4db3dea7c13116961fd3e438542ccfcca61a7547` |

익스플로러의  [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins)  페이지에는 각 트윈의 공급량과 볼트 보유량이 나란히 표시됩니다. 트윈 레지스트리 서비스는 다음 주소로 요청에 응답합니다:  `https://ostia.devnet.romeprotocol.xyz/twin-registry`; 이 서비스는 키를 보유하지 않으며 Canton에 아무것도 기록하지 않습니다. 전체 경로를 사용해 요청하세요. 경로만 지정한  `/twin-registry/` 는 다음을 반환합니다.  `404`. `GET /twin-registry/healthz` 는 트윈과 볼트의 수를 반환하고,  `GET /twin-registry/twin/v1/twins` 는 각 트윈의 토큰과 instrument ID, 그리고 볼트를 반환합니다.

잠금이나 환매의 Canton 측 처리에는 서명할 Canton 당사자가 필요합니다. 익스플로러의 브리지 페이지에서는 기존 Canton 지갑을 사용해 자산을 이동할 수 있습니다. 다음을 참조하세요:  [브리지](https://docs.rome.builders/ko/canton-zk-evm/bridge.md). 익스플로러의  [외부 호출](https://docs.rome.builders/ko/canton-zk-evm/explorer.md#external-calls) 보기에는 각 블록이 Canton에서 커밋되는 과정이 표시됩니다.

## DevNet의 Canton

두 참여자가 있는 Rome의 DevNet 검증자는 2026-11-07부터 Canton 3.7.2와 함께 Splice 0.10.1을 실행하고 있습니다. DevNet의 동기화 장치는 2026-11-18부터 프로토콜 버전 37을 실행하고 있습니다. Ostia의 테스트는 프로토콜 버전 36과 37에서 실행됩니다.

## 일시 중지 및 유지보수

DevNet은 때때로 일시 중지되며, 일부 중지는 미리 계획됩니다. 일시 중지의 양상은 원인에 따라 두 가지로 나뉩니다.

* 머신이 **재시작되는 동안에는** RPC에 연결할 수 없으며 서버 오류(프런트 프록시의 5xx)가 반환됩니다.
* 반면 **검증자 또는 동기화 장치가 일시 중지되면** RPC는 계속 응답하고 트랜잭션을 수락하지만 블록이 커밋되지 않습니다. 따라서 다음 엔드포인트가 `/api/health` 다시 `ok` 를 반환할 때까지 새 최종 블록이나 영수증이 나오지 않습니다.

Ostia가 일시 중지 전에 수락한 트랜잭션은 서명된 바이트와 함께 보관되며, 중지가 끝난 후 최대 한 시간 동안 다시 전송됩니다. 따라서 재전송하기 전에 `/api/health` 가 `ok` 를 반환할 때까지 기다리세요.

* **몇 분간 지속되는 재시작.** Ostia의 머신은 예고 없이 재시작될 수 있습니다. 2026-11-04에는 세 차례 재시작되었으며, 각각 약 7분 만에 자동으로 복구되었습니다.
* **검증자 업그레이드.** Rome의 DevNet 검증자는 수시로 업그레이드되며, 업그레이드 중에는 Ostia의 블록 커밋이 중단됩니다. 2026-11-04의 업그레이드는 15분간 진행될 예정이었습니다.
* **2026-11-16: Rome의 DevNet 검증자 액세스 설정 변경(09:00\~10:30 UTC) 및 증명 시스템을 ZisK 1.4.0-alpha로 업그레이드(13:31 UTC).** 각 작업 중 Ostia가 일시 중지되었습니다. 두 작업 모두 완료되었으며, 각 중지가 끝난 후 트랜잭션과 브리지가 다시 작동했습니다.
* **2026-11-18: DevNet 동기화 장치를 프로토콜 버전 37로 업그레이드(14:00 UTC).** Ostia는 업그레이드 중에도 계속 작동했으며, 최종 블록 사이의 가장 긴 간격은 72초였습니다.
* **2026-11-21, 12:00\~16:00 UTC:** Ostia가 Canton TestNet으로 이전합니다. 이전 중에는 블록 생성이 일시 중지되며, tROME, 토큰 및 컨트랙트는 체인과 함께 이전됩니다. 새 주소: ostia.testnet.romeprotocol.xyz. Ostia의 Canton Coin과 기타 Canton 기반 토큰은 DevNet에 남으며 이전되지 않습니다.

이러한 일정과 변경 사항은 여기와 [상태 및 로드맵](https://docs.rome.builders/ko/canton-zk-evm/status.md#upcoming-maintenance) 페이지, 그리고 Rome [Discord에 게시합니다.](https://discord.gg/vZ9rnCdNSB).

## Canton 트래픽: 비용 부담 주체

모든 Canton 트랜잭션은 트래픽을 사용합니다. 트랜잭션을 제출하는 참여자가 그 비용을 부담하며, 확인하는 각 참여자는 자신이 보내는 확인에 대한 비용을 부담합니다. DevNet에서는 두 역할 모두 Rome의 참여자가 맡습니다. 이 참여자는 각 블록의 `Advance` 와 Rome 자체 당사자들이 실행하는 Canton 단계들을 제출하고 그 비용을 부담하며, Ostia의 블록을 확인하는 유일한 참여자입니다. 현재 사용자는 Canton 트래픽 비용을 부담하지 않습니다. 사용자가 부담하는 비용은 Ostia의 가스 비용인 tROME뿐이며, tROME에는 가치가 없습니다.

블록 하나에는 약 8.4 KB의 트래픽이 들며, 여기에 포함된 트랜잭션마다 약 100바이트가 추가됩니다(2026-10-24에 한 시간 동안 측정한 결과, 블록당 중앙값은 15.7 KB였습니다. [측정값](https://docs.rome.builders/ko/canton-zk-evm/measurements.md#what-a-block-costs-on-canton) 참조). 하루 약 2,200개 블록을 기준으로 하면 하루에 대략 17\~35 MB입니다. Rome은 계정별, 일별로 브리지의 Canton 트래픽을 제한합니다. MB당 가격은 Canton 네트워크가 정하므로 이 페이지에 명시하지 않으며, DevNet 이외의 네트워크에서 트래픽 비용을 어떻게 부담할지는 아직 결정되지 않았습니다.

## DevNet이 초기화될 수 있습니다

Ostia DevNet은 테스트 네트워크입니다. 초기화될 수 있으며, 초기화되면 동일한 체인 ID인 770101을 사용하는 새 체인이 시작됩니다. 다시 만들 수 없는 것은 보관하지 마세요.

체인 ID가 그대로 유지되므로 이전 체인용으로 서명된 모든 트랜잭션은 새 체인에서도 유효합니다. 누구나 nonce 0, 1, 2 등의 순서로 이전에 서명된 트랜잭션을 다시 전송하여, 새 체인에서 이전 배포와 승인, 그리고 faucet의 공개 지급을 반복할 수 있습니다. 초기화 전후로 중요한 키를 재사용하지 말고, 초기화 후에는 새 배포자 주소를 사용하세요. 도구에 저장된 상태도 체인 ID를 기준으로 관리되므로 오래된 상태가 됩니다. Hardhat Ignition의 `deployments/chain-770101`, Foundry의 `broadcast/<script>/770101`, 그리고 지갑에 저장된 해당 네트워크의 활동 내역과 nonce를 삭제하세요(MetaMask에서는 설정, 고급, 활동 탭 데이터 지우기). 가능하면 다음 항목에 나열된 곳을 통해 초기화를 미리 공지합니다. [일시 중지 및 유지보수](#pauses-and-maintenance).

DevNet에서 증명되는 것과 증명되지 않는 것은 다음에서 확인할 수 있습니다. [입증된 것과 입증되지 않은 것](https://docs.rome.builders/ko/canton-zk-evm/what-is-proven.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/devnet.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.
