> 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/how-it-works.md).

# 작동 방식

reth에서 증명 과정을 거쳐 Canton 커밋까지 하나의 Ostia 블록을 따라가 보세요.

빌더는 항상 실행됩니다. 트랜잭션이 대기 중이면 블록을 만들고, 이를 증명한 뒤 Canton에 제출합니다. 코드의 기본 설정은 한 번에 하나의 블록만 처리하는 것이며, DevNet에서는 GPU 증명기 하나로 최대 두 개까지 처리합니다. 블록은 Canton에서 여전히 순서대로 커밋됩니다. DevNet에서는 60초 동안 블록이 만들어지지 않으면 빌더가 빈 블록, 즉 하트비트를 만듭니다(코드의 기본 설정은 꺼짐). 따라서 체인이 한산해도 대략 1분마다 블록이 만들어집니다. 각 블록이 체인의 다음 헤드가 될지는 Canton이 결정합니다. EVM 블록과 그 블록에 기록된 Canton 작업은 동일한 트랜잭션에서 커밋됩니다.

이 페이지에서는 릴리스 `v0.1.0` 에 대해 설명하며, 별도로 명시한 경우에는 현재 DevNet에서 실행 중인 내용도 설명합니다. [상태](https://docs.rome.builders/ko/canton-zk-evm/status.md) 에는 DevNet에서 실행 중인 커밋이 명시되어 있습니다. 전체 [설계](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md)를 읽어 보세요. 이 단계를 거치는 자신의 트랜잭션을 추적하려면 [트랜잭션부터 Canton에서의 최종 확정까지](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["EVM 트랜잭션"] --> Q["공개 RPC: 최종 확정 블록만 표시"]
    Q --> R["reth가 요청에 따라 빌드"]
    R --> B["빌더가 게이트웨이 작업을 읽고 해당 Canton 컨트랙트를 찾음"]
    B -->|"작업을 정산할 수 없음: 해당 트랜잭션을 제외하고 다시 빌드"| R
    B -->|"모든 작업을 정산할 수 있음"| P["ZisK가 블록을 증명"]
    P --> A["Advance: 블록, 증명, 작업을 하나의 Canton 트랜잭션으로 처리"]
    A --> S["외부 호출: 사이드카가 증명과 게이트웨이 상태를 확인"]
    S --> D["Daml이 헤드를 확인하고 작업을 정산"]
    D --> C["Canton이 블록과 해당 작업을 함께 커밋"]
    C --> F["reth가 블록을 최종 확정으로 표시"]
    F --> Q
    C --> X["익스플로러 인덱서가 블록 레코드를 읽고 reth와 대조"]
```

## Canton의 헤드를 기준으로 빌드

지갑은 EVM 트랜잭션을 공개 RPC로 전송하고, RPC는 이를 reth로 전달합니다. RPC에는 Canton에서 최종 확정된 블록만 표시되므로, 블록이 최종 확정되면 영수증이 나타납니다. 제공된 실행기는 피어 검색을 끈 상태로 유지합니다. reth는 빌더가 요청하면 블록을 만듭니다.

빌더는 먼저 Canton의 활성 `ZkChain` 컨트랙트를 읽습니다. 그런 다음 reth의 헤드, 세이프 블록, 최종 확정 블록을 해당 컨트랙트에서 커밋된 헤드로 이동합니다. 빌더는 가격순으로 대기 중인 트랜잭션을 선택하면서 각 발신자의 nonce 순서를 유지합니다. 2026-10-25부터는 트랜잭션이 선언한 가스 한도가 아니라 실제 사용한 가스량을 기준으로 블록을 채웁니다. 사용 가스량은 reth가 계산합니다. 지갑은 실제 사용량의 약 세 배를 선언하는 경우가 많으며, 선언된 한도를 기준으로 계산하면 블록에 들어갈 수 있는 양의 약 3분의 1에서 블록이 가득 차게 됩니다. 블록은 가스 상한에 도달하면 끝납니다. 또한 빌더는 일반적으로 DevNet에서 reth에 제공하는 트랜잭션의 원시 바이트 크기를 393,216바이트 이하로 제한합니다. 참가자가 블록을 처리하는 데 드는 작업량은 블록 크기에 따라 늘어나기 때문입니다. 다만 크기를 초과하는 첫 번째 트랜잭션은 계속 제공하므로 무기한 대기하지 않습니다. 빌더는 이 명시적인 트랜잭션 목록으로 블록을 만들도록 reth에 요청합니다.

Canton 작업이 필요한 EVM 트랜잭션은 게이트웨이를 호출합니다. 게이트웨이는 작업을 기록하고 블록에 대한 누적 해시에 반영합니다. 빌더는 로그 순서대로 게이트웨이 이벤트를 읽고 각 작업에 필요한 Canton 컨트랙트를 찾습니다.

할당이 사라졌거나, 수신자가 출금을 수락하지 않았거나, 필요한 다른 컨트랙트가 없으면 빌더는 해당 트랜잭션과 그 발신자의 이후 트랜잭션을 제외합니다. reth를 Canton의 헤드로 되돌린 뒤 다시 빌드합니다. 이러한 검사는 증명 전에 수행됩니다.  [빌더 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) 에는 각 작업에 대한 검사 항목이 나와 있습니다.

## 블록 증명

빌더는 블록과 reth의 실행 증인을 저장합니다. 입력 도구는 블록, 증인, 제네시스를 결합해 증명기 입력을 만듭니다. ZisK는 게스트를 실행하며, 게스트는 체인의 고정된 규칙에 따라 블록을 검증합니다.

증명기는 블록 해시에 커밋하는 1,344바이트의 래핑된 증명을 반환합니다. 빌더는 `Advance` 를 헤더, 트랜잭션, 증명, 작업, 그리고 블록 상태 루트에 대한 게이트웨이의 계정 및 스토리지 증명과 함께 제출합니다.

## 하나의 트랜잭션에서 확인 및 정산

각 확인 참여자는 사이드카를 실행합니다. Canton의 외부 호출은 블록을 해당 참여자의 사이드카로 보내 `verify`를 실행하게 합니다. 사이드카는 증명, 고정된 프로그램 키와 ZisK 릴리스, 헤시의 해시, 트랜잭션 목록의 루트를 확인합니다.

Ostia DevNet에서는 모든 Ostia 파티를 호스팅하는 단일 참여자를 Rome이 운영하므로, 해당 참여자의 사이드카 하나만 확인 작업을 수행하고 증명은 Rome 자체 노드에서 검사됩니다. Canton의 동기화기는 블록 순서를 정하며 증명을 확인하지 않습니다. 로컬 데모 네트워크에는 확인 참여자가 두 명 있습니다. [신뢰 모델 및 한계](https://docs.rome.builders/ko/canton-zk-evm/trust-model.md) 에는 이로 인해 달라지는 점이 설명되어 있습니다.

Daml은 응답을 `ZkChain`에 대조해 확인합니다. 부모 블록은 현재 헤드여야 하고, 블록 번호는 다음 번호여야 하며, 가스 한도와 사용량은 상한 이내여야 합니다. Daml은 사이드카의 응답을 비교할 뿐, 영지식 증명 자체를 검증하지는 않습니다.

그런 다음 Daml은 각 작업에 대해 해당 작업이 지정하는 Canton 컨트랙트에서 한 줄씩 기록합니다. 출금의 ID, 소각자, 금액은 빌더가 제공하며, 증명된 해시는 이 값들을 블록에 기록된 내용과 연결합니다. 사이드카의 `legs` 함수는 게이트웨이의 계정 및 스토리지 증명을 확인하고, 해당 줄들을 순서대로 해싱한 뒤 결과를 증명된 상태에서의 게이트웨이 값과 비교합니다. 작업이 없는 블록도 빈 목록으로 동일한 검사를 통과해야 합니다.

Daml은 작업을 순서대로 정산하고 다음을 생성합니다. `BlockRecord` 그리고 다음 `ZkChain`. Canton은 이러한 변경 사항을 함께 커밋합니다. 검사나 정산에 실패하면 아무것도 커밋되지 않습니다. 체인의 단일 상태 계약을 소비함으로써 Canton은 블록 순서의 권위자가 됩니다. 전체 내용은 [Daml 인터페이스](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) 및 [사이드카 검사](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## 볼트와 트윈

첫 번째 게이트웨이 외에도 체인 기록에는 신뢰하는 EVM 계약이 나열됩니다. 각 계약은 게이트웨이나 볼트이며 코드 해시가 함께 기록됩니다. 블록에는 등록된 모든 게이트웨이의 레그가 포함되고, Daml은 블록에 포함된 계정 증명을 통해 각 게이트웨이의 코드 해시를 확인합니다. 볼트에는 자체 레그가 없습니다. 볼트의 잠금과 해제는 게이트웨이 결제이며, Daml은 볼트 주소를 해당 결제의 수취인이나 지급인으로 신뢰합니다. 확정자는 항목을 수락하기 전에 볼트의 코드를 확인합니다. 새 항목은 프로그램 변경과 같은 방식으로 추가됩니다. 운영자와 게이트웨이가 제안하고 확정자가 승인합니다.

볼트는 Canton 트윈을 뒷받침하는 ERC-20 토큰을 보관하는 소규모 계약입니다. 소유자도 키도 업그레이드도 없습니다. 잠금은 수취인이 볼트인 일반 게이트웨이 `pay` 입니다. 해제는 `release(ref, token, to, amount)`이며, 볼트는 다른 유형의 결제에는 사용할 수 없는 ID를 기준으로 게이트웨이를 통해 지급합니다. Canton은 보유자가 서명한 상환 요청과 일치하는 경우에만 이를 정산합니다.

트윈은 게이트웨이 당사자가 관리하는, 하나의 ERC-20에 대응하는 Canton 토큰입니다. 체인 기록에는 각 트윈의 토큰 주소, 소수 자릿수, 그리고 토큰을 발행·소각·전송하는 규칙 계약이 고정되어 있습니다. `Advance` 는 증명에 고정된 잠금에 대해서만 트윈을 발행하고, 서명된 상환 요청에 대해서만 소각합니다.

트윈 레지스트리 서비스는 빌더 옆에서 실행됩니다. 지급인은 결제 전에 수신자와 `ref` 를 알려주고, 서비스는 잠금 ID로 응답합니다. 빌더는 같은 항목을 읽어 블록에 잠금을 연결합니다. 또한 트윈용 토큰 표준 레지스트리 API를 제공하므로, 검증자가 트윈 패키지를 검증한 지갑은 트윈을 전송할 수 있습니다. 이 서비스는 키를 보유하지 않고 Canton에 아무것도 기록하지 않으며, `Advance` 는 해당 항목으로부터 ID가 산출되는지 확인합니다. 흐름은 [입금, 출금 및 결제](https://docs.rome.builders/ko/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) 를 참조하세요.

## Canton이 거부하는 경우

Canton이 블록을 커밋한 후 빌더는 reth에서 해당 블록을 최종 상태로 표시합니다. Canton이 블록을 거부하면 빌더는 reth를 Canton의 마지막 커밋 블록으로 되돌리고, 거부된 블록의 트랜잭션을 풀로 돌려보냅니다. 다음 블록에서 해당 트랜잭션의 레그를 다시 확인합니다. 할당이 취소된 결제는 제외됩니다. 블록이 연속 두 번 거부되면 빌더는 두 블록에 공통으로 포함된 트랜잭션을 의심하고, 일정 시간 동안 제외합니다.

빌더가 제출 응답을 받지 못하더라도 명령은 커밋되었을 수 있습니다. 제출하기 전에 빌더는 원장의 끝 위치를 기록합니다. 그런 다음 그 위치부터 해당 명령 자체의 완료 결과를 읽습니다. 성공한 완료는 커밋으로 간주하고, 실패한 완료는 거부로 처리합니다.

Canton의 헤드로 커밋 여부를 확인할 수는 있지만, 헤드만으로는 "커밋되지 않음"을 알 수 없습니다. 완료 결과가 없으면 빌더는 Canton 시간으로 300초가 지난 뒤에만 "커밋되지 않음"으로 판단합니다(`CZE_RESOLVE_SECONDS`). 그때까지 빌더는 아무것도 생성하지 않고 reth를 현재 위치에 둡니다. 이러한 복구 규칙은 [빌더 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## 트랜잭션 전송부터 Canton에서 최종 확정되기까지

1. 공개 RPC로 트랜잭션을 전송합니다. 트랜잭션은 다음 블록이 생성될 때까지 풀에서 대기합니다.
2. 트랜잭션이 대기 중이고 자리가 있으면 빌더는 즉시 블록을 생성합니다(코드의 기본값은 처리 중인 블록 1개이며, DevNet에서는 최대 2개를 처리합니다). 체인이 바쁜 동안 새 블록은 이전 블록에 이어 중앙값 기준 16.6초마다 생성되었습니다(2026-10-25 01:34 UTC까지 24시간 기준).
3. ZisK가 블록을 증명합니다. 2026-10-24의 1시간 동안, 트랜잭션 11\~100개로 구성된 블록의 증명 시간 중앙값은 9.03초였습니다.
4. 증명과 함께 블록 기록이 Canton에 커밋됩니다. 이 커밋으로 블록이 최종 확정되고, 그 다음 공개 RPC에 영수증이 표시됩니다.

같은 시간 동안 RPC가 트랜잭션을 수락한 때부터 해당 블록이 Canton에서 최종 확정될 때까지 걸린 시간은 중앙값 19.5초, 95백분위수 27.1초였습니다. 영수증을 받는 데 대부분의 체인보다 오래 걸리므로, 영수증을 기다리는 도구에는 긴 타임아웃을 설정해야 합니다.

[측정](https://docs.rome.builders/ko/canton-zk-evm/measurements.md) 에서는 각 구간을 정의하고 실행 결과를 나열합니다. 익스플로러에서 트랜잭션을 연 다음 해당 블록을 열어 기록을 담고 있는 Canton 업데이트를 확인하세요. [익스플로러](https://docs.rome.builders/ko/canton-zk-evm/explorer.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/how-it-works.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.
