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

# 익스플로러

라이브 Ostia DevNet 탐색기, 파우셋, API, 그리고 브라우저에서의 증명 확인에 대한 안내입니다.

Ostia 탐색기는 다음 주소에서 이용할 수 있습니다. [ostia.devnet.romeprotocol.xyz](https://ostia.devnet.romeprotocol.xyz). reth의 EVM 데이터와 각 블록의 Canton 기록을 결합하며, 탐색기는 리더 파티로서 이 기록을 읽습니다. 블록이나 트랜잭션을 찾고, 브라우저에서 증명을 확인하고, 컨트랙트를 검증하고, tROME을 받거나, API를 통해 같은 데이터를 읽어 보세요.

이 페이지에서는 릴리스 `v0.1.0` 을 설명하며, 별도로 명시된 경우에는 현재 DevNet에서 실행 중인 내용도 안내합니다. [상태](https://docs.rome.builders/ko/canton-zk-evm/status.md) 에는 DevNet에서 실행 중인 커밋이 표시됩니다. 전체 내용은 [탐색기 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md).

탐색기는 블록 기록이 Canton에 올라간 경우에만 해당 블록을 최종 확정으로 표시합니다. 그전까지는 reth에서 가져온 블록을 증명 중으로 표시하며, 방금 보낸 트랜잭션은 대기 중으로 표시됩니다. 대기 중인 트랜잭션이 없으면 빌더는 1분에 한 번 빈 블록을 생성하므로, 한산한 체인에서도 최신 블록은 몇 분 이상 오래되지 않습니다. 모든 페이지의 시간은 UTC 기준입니다.

## 페이지 둘러보기

| 페이지   | 이 페이지에서 할 수 있는 작업                                                                                                                                                                                       |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 홈     | 블록, 트랜잭션, 주소 또는 Canton 업데이트 ID로 검색합니다. 최신 최종 확정 블록, 증명 중인 블록, 최종 확정까지 걸린 시간, 증명 시간 및 최신 블록을 확인할 수 있습니다. 상태 표시줄에는 EVM 노드, Canton, 프로듀서, 프로버, 파우셋 및 검증기의 상태가 표시됩니다. Canton 커밋 시간 타일을 누르면 외부 호출 페이지가 열립니다. |
| 블록    | 최종 확정된 블록을 나열하고, 트랜잭션이 있는 블록만 필터링하고, CSV를 다운로드하거나 블록 하나를 엽니다.                                                                                                                                           |
| 트랜잭션  | 트랜잭션을 나열하고, 아직 최종 확정되지 않은 트랜잭션, 실패한 트랜잭션 또는 컨트랙트 호출로 필터링합니다. 트랜잭션 페이지에는 결과, 블록, Canton 업데이트, 수수료, 디코딩된 입력 및 네 단계의 최종 확정 과정을 보여 주는 타임라인이 표시됩니다.                                                          |
| 컨트랙트  | 검증된 컨트랙트와 각 컨트랙트의 사용 빈도를 확인합니다. 컨트랙트 페이지에는 검증된 소스, ABI, 이벤트, 읽기 및 쓰기 호출이 표시됩니다. 쓰기 호출은 지갑을 통해 실행됩니다.                                                                                                    |
| 토큰    | 보유자 및 전송 내역과 함께 ERC-20, ERC-721 및 ERC-1155 토큰을 둘러봅니다. 탭에서 wTKB 및 CC와 같이 Canton에서 가져온 토큰을 확인할 수 있습니다.                                                                                                    |
| 외부 호출 | 각 블록이 Canton에 커밋된 내역을 블록별 한 행으로 확인할 수 있습니다. 상태, 정산 시간 및 시도 횟수가 표시됩니다. 헤더의 "외부 호출" 링크를 누르면 이 페이지가 열립니다. 자세한 내용은 [외부 호출](#external-calls).                                                                |
| 통계    | 최종 확정까지 걸린 시간, 증명 시간, Canton 커밋 시간, 초당 트랜잭션 수 및 성공률을 1시간, 6시간, 24시간, 7일 또는 30일 기준으로 확인합니다. Canton 자산 카드에는 각 자산의 공급량과 금고 및 게이트웨이가 보유한 수량이 표시됩니다. 외부 호출 카드에서는 Canton에 대한 커밋이 어떻게 진행되고 있는지 확인할 수 있습니다.     |
| 트윈    | 양방향 Canton 자산은 [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins)에서 확인할 수 있습니다. 각 트윈의 공급량과 금고 잔액, 최신 잠금 및 상환 내역이 표시됩니다.                                                                            |
| 스왑    | Canton 거래소가 EVM과 수행한 스왑을 [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)에서 확인하고, 결제 및 청구 내역이 포함된 스왑을 열어 볼 수 있습니다.                                                                               |
| 브리지   | 지갑을 연결해 테스트용 tROME을 받고, 이미 사용 중인 Canton 지갑으로 Ostia와 Canton 간에 토큰을 이동합니다(지갑별로 순차 활성화 중이며, 활성화 전에는 버튼에 "출시 예정"이라고 표시됩니다). 자세한 내용은 [브리지](https://docs.rome.builders/ko/canton-zk-evm/bridge.md).           |
| 파우셋   | tROME을 요청하거나, GitHub로 로그인해 100 tROME 빌더 보조금을 받고, 요청이 최종 확정될 때까지 진행 상황을 확인합니다.                                                                                                                           |
| API   | OpenAPI 문서에서 가져온 API 참조 문서를 확인합니다. 버튼을 누르면 Ostia DevNet이 지갑에 추가됩니다.                                                                                                                                     |

홈을 제외한 모든 페이지에는 헤더에 검색창이 있습니다. 홈에는 자체 검색창이 있습니다. `/` 키를 누르면 검색창에 포커스됩니다. 블록, 트랜잭션, 주소의 트랜잭션 및 전송 내역과 토큰의 전송 내역을 CSV로 다운로드할 수 있습니다. 페이지는 실시간 스트림을 따라가므로 새로고침하지 않아도 새 블록이 표시됩니다. 주소 및 게이트웨이 레그 페이지는 링크를 통해 열 수 있고, 주소 페이지는 검색으로도 열 수 있습니다. 헤더에는 이 페이지로 이동하는 항목이 없습니다.

## 블록 읽기

블록 페이지에서는 EVM 데이터와 함께 Canton 측 데이터, 즉 업데이트 ID, 기록 시간, 기록에 서명한 운영자 및 확인자를 보여 줍니다. reth의 블록 해시, 기록의 해시 및 기록된 헤더의 해시를 비교해 세 값이 일치하는지 표시합니다. 또한 증명에서 읽은 프로그램 키, ZisK 릴리스 및 블록 해시를 탐색기의 예상 값과 나란히 표시합니다. 일치하지 않는 값은 빨간색으로 표시됩니다.

네 개의 타일에는 블록 정보가 수치로 표시됩니다. 트랜잭션 수, 증명 시간, Canton 커밋(블록 제출부터 Canton에 기록될 때까지 걸린 시간), 블록 생성 시점부터 최종 확정될 때까지 걸린 시간입니다. 홈과 통계 페이지의 Canton 커밋 카드는 제출 시점부터 빌더가 Canton의 응답을 받는 시점까지를 측정하므로 이 타일보다 값이 높게 표시됩니다. "이 블록이 최종 확정된 과정" 패널에는 단계별 소요 시간이 나열됩니다.

증명 중인 블록은 아직 Canton에 기록되지 않은 상태입니다. 페이지에 이 상태가 표시되며 블록이 최종 확정될 때까지 새로고침됩니다. 트랜잭션은 대기 중이거나 증명 중이거나 최종 확정된 상태일 수 있습니다. 블록 페이지에는 게이트웨이 레그가 EVM에 기록된 대로 나열됩니다. `BlockRecord` Canton에서 각 레그가 어떻게 정산되었는지는 포함하지 않으므로 탐색기에서 이를 표시할 수 없습니다. 자세한 내용은 [레그 및 커스터디](#legs-and-custody) 에서 DevNet에서 운영 중인 레그를 확인하세요.

## 레그 및 커스터디

게이트웨이의 레그는 테스트 참여자와 함께 Rome이 운영하는 DevNet에서 활성화되어 있으므로(참조: [입금, 출금 및 결제](https://docs.rome.builders/ko/canton-zk-evm/deposits-withdrawals-payments.md)) 이제 이 페이지에 콘텐츠가 표시됩니다. 아직 헤더에는 해당 페이지로 연결되는 항목이 없습니다. 다음 주소를 직접 열거나 [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) 블록에서 레그를 따라가세요.

* **목록** 의 `/legs` 에는 모든 레그의 종류(입금, 결제 또는 출금), 블록, 토큰, 계정 및 금액이 표시됩니다. 레그를 열면 해당 레그의 페이지인 `/leg/<id>`로 이동합니다. 출금 항목에는 대금을 받은 Canton 파티가 표시됩니다. 2026-10-25 11:54 UTC 기준으로 해당 날짜의 두 차례 실행에서 발생한 레그 6개가 목록에 있었습니다(블록 780, 783, 784, 1465, 1471, 1473).
* **API** 에서도 같은 데이터를 다음 주소로 제공합니다. `/api/legs`, `/api/legs/<id>` 및 `/api/blocks/<number>/legs`.
* **래핑된 토큰** wTKB는 `0x294d3049874526910a69f6b61da14d10a8b1b3af`에 있으며, 다른 ERC-20과 마찬가지로 토큰 페이지에서 확인할 수 있습니다(소수점 10자리). 블록 1473에서 공급량은 12 wTKB였으며, Rome의 실행을 통해 게이트웨이가 Canton에서 12 TKB를 보유하고 있음을 확인했습니다.
* **공급량 대비 커스터디.** Canton 기반 토큰의 페이지에는 "Canton에서 담보됨" 카드가 표시됩니다. 여기에는 같은 블록에서 읽은 게이트웨이의 Canton 보유량과 래핑된 토큰의 공급량이 나란히 표시되며, 같은 수치는 `GET /api/tokens/<address>` 의 `canton` 객체에도 포함됩니다. 개별 보유 내역은 표시하지 않고 총액만 표시합니다. DevNet에서는 2026-10-25 12:27 UTC부터 커스터디를 조회할 수 있습니다. 같은 날 12:52 UTC 기준으로 wTKB의 커스터디는 두 건의 보유 내역에 걸쳐 총 12 TKB였으며, 래핑된 공급량은 12 wTKB였습니다.

## 트윈 및 Canton 자산

탐색기에는 양방향 Canton 자산이 표시됩니다(참조: [입금, 출금 및 결제](https://docs.rome.builders/ko/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens)). 다음 주소를 여세요. [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins). 여기에는 다음이 표시됩니다.

* **레지스트리.** 체인 기록에 등록된 볼트와 각 볼트의 코드 해시, 그리고 각 볼트가 고정하는 트윈과 소수점 자릿수입니다.
* **트윈별 카드.** 같은 블록에서 읽은 Canton 공급량과 볼트 보유량, 집계 기준 블록, 잠금 및 상환 횟수가 표시됩니다. 잠금 및 상환이 발생할 때마다 두 수치는 일치합니다.
* **공급량 대비 커스터디** 는 wTKB 및 CC와 같은 Canton 토큰에 대해, 게이트웨이의 Canton 보유량과 래핑된 공급량을 나란히 표시합니다.
* **최근 잠금 및 상환.** 각 항목에서 해당 레그, 트랜잭션, 블록 및 Canton 업데이트로 이동할 수 있습니다.
* **레지스트리 서비스.** 트윈 레지스트리 서비스의 상태 확인 링크가 포함된 행입니다.

통계 페이지의 Canton 자산 카드에도 같은 공급량과 볼트 및 게이트웨이의 보유량이 표시되며, `GET /api/twins` 는 전체 페이지 데이터를 JSON으로 제공합니다. 개별 보유 내역은 표시하지 않고 총액만 표시합니다.

## 외부 호출

열기 **외부 호출** 헤더의 [`/canton`](https://ostia.devnet.romeprotocol.xyz/canton). Ostia는 각 블록을 하나의 Canton 트랜잭션으로 커밋합니다. 확인 참여자의 외부 호출은 해당 트랜잭션 안에서 블록 증명을 검사합니다. DevNet에서는 Rome이 확인 참여자입니다. 이 페이지에서는 각 커밋이 어떻게 처리되었는지 확인할 수 있습니다.

**헤더** 에는 모든 블록의 다음 수치가 표시됩니다.

* 커밋된 블록 수
* 성공률: 시도한 횟수 중 성공한 커밋의 비율입니다. 2026-11-09 기준 전체 블록에서 99.99%입니다.
* 정산 시간: 최근 24시간 또는 최근 7일의 평균 및 p95입니다(2026-11-09 기준 최근 24시간은 각각 약 9.1초와 10.7초).
* Canton이 거부한 커밋 수와 재시도 후 커밋된 블록 수
* 종류별로 정산된 레그 수

**목록** 에는 블록마다 한 행이 표시됩니다. 각 행에는 다음 정보가 포함됩니다.

* Canton 업데이트와 해당 업데이트에 포함된 EVM 블록, 그리고 정산된 EVM 트랜잭션 수
* 상태: 첫 번째 시도에서 커밋되었는지, 아니면 추가 시도 후 커밋되었는지와 Canton이 거부한 횟수
* 체인에 있는 `Advance` 계약의 선택 항목인 `ZkChain` ;
* 블록이 정산한 레그(종류별)
* 정산 시간(블록 증명 시작부터 Canton 기록 시각까지)과 기록 시각

모든 블록을 표시하거나, 첫 번째 시도에서 커밋된 블록, 재시도된 블록, Canton이 한 번 이상 거부한 블록 또는 레그를 정산한 블록만 표시할 수 있습니다. 목록은 최신순이나 오래된 순으로 정렬할 수 있습니다. **CSV** 를 선택하면 현재 열어 둔 뷰의 첫 1,000개 행을 현재 정렬 순서대로 다운로드합니다. 다음 `GET /api/canton/updates?format=csv&filter=<all|first|retried|refused|legs>&order=<desc|asc>` 요청도 동일한 파일을 반환합니다.

**업데이트 하나** 를 열면 타임라인(블록 생성, 증명 시작, 증명 완료, Canton에 제출, Canton에서 커밋), 커밋에 성공한 시도까지의 모든 커밋 시도, 증명 검사 및 블록이 정산한 레그가 표시됩니다. 증명과 고정된 값을 비교한 익스플로러 자체의 결과도 검사 결과 옆에 표시됩니다. 정보는 Canton 기록과 빌더 자체 로그(페이지에서 이 정보를 "producer log"로 표시)에서 가져옵니다. 로그에 없는 블록은 Canton에 기록된 정보만 표시하고 나머지는 생략합니다.

주요 수치는 **통계** 페이지의 ‘외부 호출’ 카드에 표시되며, `GET /api/canton/stats` 요청으로 JSON 형식의 데이터를 받을 수 있습니다.

## 브라우저에서 증명 확인하기

증명에서 값을 읽는 것만으로는 증명이 검증되지 않습니다. Verify를 누르면 사이드카의 `verify` 함수를 WebAssembly 빌드로 다운로드하여 기록된 증명, 헤더 및 트랜잭션에 대해 실행합니다.

이 검사는 고정된 프로그램 키와 ZisK 릴리스를 사용해 PLONK 증명을 검증합니다. 헤더의 해시가 증명된 블록 해시와 일치하는지, 트랜잭션이 헤더의 트랜잭션 루트와 일치하는지 확인합니다. 또한 블록 해시가 해당 블록에 대해 reth가 계산한 해시와 일치해야 합니다.

예상 핀 값은 익스플로러의 상태 응답에서 가져옵니다. Verify는 사이드카의 블록 검사를 실행하지만 별도의 `legs` 검사는 실행하지 않습니다. 블록 증명 중에는 버튼이 비활성화됩니다. 검사 후 패널에 결과, 소요 시간 및 모듈 다운로드 크기가 표시됩니다. 소요 시간에는 다운로드 시간이 포함되지 않습니다. 자세한 내용은 [브라우저 검증기 README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/explorer/verify/README.md).

## tROME 수도꼭지 사용하기

수도꼭지에서는 누구나 요청할 때마다 tROME 1개를 받을 수 있습니다. tROME은 Ostia DevNet의 테스트 코인이며 가치가 없습니다. Faucet 페이지를 열거나 다음 요청을 보내세요. `POST /api/faucet`제한은 다음과 같습니다.

* 주소당 24시간에 한 번 요청 가능
* IP 주소당 10분에 한 번 요청 가능
* 모든 클라이언트를 합해 시간당 5,000건의 지급이 가능합니다.

요청은 즉시 대기열에 들어가고 티켓으로 응답됩니다. Faucet은 한 번에 최대 100건씩 대기열을 처리하며, 해당 블록이 최종 확정되면 지급을 받을 수 있습니다. `GET /api/faucet/ticket/<id>` 에서 요청이 어디까지 처리되었는지 확인할 수 있습니다. 한도는 데이터베이스에 저장되므로 재시작해도 초기화되지 않습니다. 자세한 내용은 [Faucet 섹션](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#the-faucet) 을 참조하세요.

**빌더 보조금.** GitHub로 로그인한 빌더는 1 tROME 대신 100 tROME을 받습니다. Faucet 페이지에 주소를 입력한 다음, "Ostia에서 빌드 중이신가요? GitHub로 로그인하면 100 tROME을 받을 수 있습니다." 문구 옆에서 "GitHub로 로그인"을 선택하세요. GitHub에서 페이지로 돌아오면 보조금이 최종 확정될 때까지 페이지에서 진행 상황을 확인할 수 있습니다. GitHub 계정은 만든 지 30일 이상이어야 합니다. 각 GitHub 계정과 각 주소는 7일마다 보조금을 한 번씩 받을 수 있으며, Faucet은 모든 사용자에게 하루 최대 200건의 보조금을 지급합니다. 페이지는 GitHub에 어떤 권한도 요청하지 않습니다. [Ostia DevNet](https://docs.rome.builders/ko/canton-zk-evm/devnet.md#the-builder-grant) 에 절차와 한도가 안내되어 있습니다.

## API 사용

세 API 모두 키 없이 공개되어 있습니다. 한도는 클라이언트별로 적용됩니다.

| API                             | 주소         | 한도                     |
| ------------------------------- | ---------- | ---------------------- |
| JSON-RPC, 최종 확정 블록만 지원, HTTP 전용 | `/rpc`     | 분당 300회 호출, 배치당 최대 20건 |
| REST, 설명은 `/api/openapi.json`   | `/api/...` | 초당 20건 요청, 순간 최대 60건   |
| Etherscan 호환                    | `/api`     | 초당 10건, 분당 600건 요청     |

RPC는 WebSocket과 필터를 지원하지 않으므로 `eth_getLogs`. `GET /api/stream` 은 페이지에서 사용하는 실시간 스트림입니다. `GET /api/status` 는 체인, 고정된 프로그램 키, 각 구성 요소의 상태를 보고합니다.

컨트랙트 소스를 검증하려면 `forge verify-contract` 를 Etherscan 검증자와 함께 사용하세요.

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

배포 시 사용한 것과 동일한 컴파일러 버전, 옵티마이저 설정, EVM 버전을 사용하세요. 시간당 30건까지 검증을 요청할 수 있습니다. 소스 파일이 많은 컨트랙트는 forge가 입력을 URL 인코딩 형식으로 전송하고 익스플로러의 프록시가 요청당 약 300KB를 처리하므로 HTTP 413 오류가 발생할 수 있습니다. 자세한 내용은 [대형 컨트랙트 검증](https://docs.rome.builders/ko/canton-zk-evm/build-on-ostia.md#verify-a-large-contract). [Ostia에서 빌드하기](https://docs.rome.builders/ko/canton-zk-evm/build-on-ostia.md) 에서 배포 방법을 다룹니다. 한도는 익스플로러 README에 나와 있습니다. [요청 한도](https://github.com/rome-protocol/canton-zk-evm/blob/main/explorer/README.md#rate-limits) 은 익스플로러 README에 나와 있습니다.

## 리더 파티가 볼 수 있는 정보

익스플로러는 읽기 전용 토큰을 사용해 리더 파티로 Canton을 읽습니다. 해당 파티는 블록 기록만 관찰하며, Ostia의 Daml 패키지에 있는 그 밖의 정보는 볼 수 없습니다. 각 기록의 번호, 해시, 부모 해시, 헤더, 트랜잭션 및 증명, 업데이트 ID와 기록 시각, 두 서명자를 볼 수 있습니다. 예치 요청, 출금 승인 또는 결제 조건은 볼 수 없으므로 이러한 정보는 익스플로러에 표시되지 않습니다.

게이트웨이 보유량은 게이트웨이 파티로 데이터를 읽는 별도의 읽기 전용 클라이언트에서 가져옵니다. 총계가 표시됩니다. 여기에는 "Canton에서 담보된 자산" 카드, `/twins` 페이지, Stats의 Canton 자산 카드가 포함됩니다. `GET /api/twins`. 또한 거래소 거래 내역과 자금이 조달된 청구 내역도 읽습니다. 이 내역은 `/swaps` 및 `GET /api/swaps`에서 확인할 수 있습니다. 결제, 청구 및 이에 대한 Canton 업데이트는 유지하고, 거래소와 판매자의 Canton 당사자는 제외합니다.

독자가 적용하는 제한은 익스플로러 자체의 제한입니다. Ostia 당사자를 호스팅하는 참가자의 운영자는 그곳의 모든 정보를 여전히 볼 수 있습니다. DevNet에서는 해당 운영자가 Rome이며, 자체 Canton DevNet 검증자로 참가자를 운영합니다. [신뢰 모델 및 제한 사항](https://docs.rome.builders/ko/canton-zk-evm/trust-model.md) 는 이것이 무엇을 의미하는지 설명합니다. Verify는 이 익스플로러가 제공하는 데이터를 사용해 브라우저에서 사이드카 검사를 실행합니다.

데이터베이스를 포함해 자체 익스플로러를 실행하는 방법은 다음을 참조하세요. [자체 Ostia 실행](https://docs.rome.builders/ko/canton-zk-evm/run-it-locally.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/explorer.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.
