> 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/rome-zk-evm/run-a-rollup.md).

# 롤업 실행

v0.3.0 롤업 러너로 Solana devnet에서 자신만의 Rome ZK EVM 체인을 등록하고 실행하세요.

위의 `./rollup` runner는 Rome의 공유 Solana devnet 프로그램을 대상으로 하나의 체인을 시작합니다. 사용자가 해당 노드를 실행하고 Solana 비용을 부담합니다. 정산 프로그램은 직접 배포하지 않습니다. 등록은 허가 없이 가능하지만, 증명된 루트에는 Rome이 등록한 체인별 검증 키가 필요합니다.

이 페이지는 다음을 사용합니다 **v0.3.0**. 이 [전체 devnet 가이드](https://github.com/rome-protocol/solana-zk-evm/blob/v0.3.0/docs/RUN-ON-DEVNET.md) 모든 설정, 실패, 복구 단계를 다룹니다.

## 시작하기 전에

bash 4 이상, Git, Compose가 포함된 Docker Engine 28 이상, curl, jq, openssl, Solana CLI, Python 3.11 이상이 설치된 x86-64 Linux 머신을 사용하세요. Solana devnet RPC 엔드포인트, 자금이 충전된 Solana payer 키페어(이것은 체인 권한이기도 함), 그리고 sequencer 서명 키가 필요합니다. 두 파일은 모두 비공개로 유지하고 컨테이너 사용자 999가 읽을 수 있도록 하세요. 이 가이드에서 만드는 방법을 설명합니다.

대략 **devnet에서 7 SOL** payer용입니다. 등록 시 5 SOL이 잠깁니다. `./rollup check` 게시와 렌트에 최소 1 SOL이 남아 있어야 합니다. 예치금은 첫 번째 최종 루트 또는 10개의 게시된 루트 이후에 환불 가능해집니다. 그 전에 체인이 회수되면 예치금은 재무로 들어갑니다. 체인에는 사용자가 통제하는 EVM 수수료 수령 주소도 필요합니다.

루트를 정산하려면 30GB가 넘는 메모리를 가진 NVIDIA GPU 1개가 있는 prover 호스트가 필요합니다. 24GB 카드는 최종 증명 단계에 너무 작습니다. [Prover 호스트](https://docs.rome.builders/ko/rome-zk-evm/prover-host.md) RAM과 디스크 예산을 제공합니다. prover가 준비되기 전에도 노드는 실행되고 배치를 게시할 수 있지만, 그 루트는 모두 최종이 되지 않습니다.

## 노드 시작

릴리스를 복제하고 그 rollup 디렉터리에서 작업하세요:

```sh
git clone --branch v0.3.0 https://github.com/rome-protocol/solana-zk-evm.git
cd solana-zk-evm/deploy/rollup
cp .env.example .env
cp chain.toml.example chain.toml
```

Solana RPC, 서명자 위치 및 `ROME_ZK_TAG=v0.3.0` 을 `.env`. 유지하세요 `PROGRAMS_JSON=programs.devnet.json`. 설정하세요 `ROME_ZK_GUEST_TAG=v0.3.0` 그리고 `ZISK_RELEASE=1.3.1-alpha` 나중의 guest 빌드를 위해 사용합니다. 로컬 첫 실행에서는 RPC를 루프백에 바인딩해 두세요. 남겨 두세요 `PROVER` guest와 그 키가 준비될 때까지 설정하지 마세요.

설정하세요 `genesis.fee_recipient` 을 `chain.toml` 당신의 EVM 주소로 설정하세요. 체인 ID는 선택하지 마세요. 정산은 payer와 그 등록 횟수로부터 체인 ID를 도출합니다; `init` 아무것도 보내기 전에 그것을 읽습니다. 모든 ID의 절반 정도는 MetaMask에 너무 큽니다. 당신의 ID가 그런 경우라면, `init` 다음과 같이 중단됩니다 `ChainIdNotWalletSafe`; 새 payer 키를 만들고, `PAYER_KEYPAIR_PATH` 그것을 가리키고 실행하세요 `init` 다시.

새 체인은 잔액이 0에서 시작합니다. 예치금이 열리기 전에 가스를 확보하려고 backed된 잔액 하나를 선언했다면, 검증 키를 요청하기 전에 같은 양의 wrapped SOL을 체인의 금고에 잠그세요.

```sh
./rollup init
./rollup register --dry-run
./rollup register --confirm
./rollup up
./rollup check
```

`init` genesis와 서비스 구성을 렌더링합니다. `register --confirm` 5 SOL 예치금을 잠그고 배치 커서를 생성합니다. `up` sequencer, batcher, derive 및 verifier 노드를 시작합니다. `check` 누락된 서비스가 있으면 이름을 표시한 다음 체인 ID, heads, batcher의 진행 상황, inbox 및 roots를 비교합니다. 배치가 닫힐 시간이 지난 뒤 다시 실행하세요; 첫 번째 배치 진행 확인은 샘플만 기록합니다.

prover가 없으면 sequencer가 RPC를 제공하고, batcher가 거래 데이터를 inbox에 게시하며, derive가 체인을 재구성합니다. inbox 배치는 최종 정산 루트가 아닙니다. genesis root조차 증명을 기다립니다.

## 배치에서 최종 루트로 전환

체인 genesis용 guest를 빌드하세요:

```sh
./rollup guest-build
```

빌드는 v0.3.0 guest와 ZisK 1.3.1-alpha를 사용합니다. 체인의 guest 프로그램과 검증 키 메타데이터를 생성합니다. 계산하려면 `programVK` ZisK 증명 키와 약 36GB의 RAM이 필요합니다. 체인을 등록한다고 검증 키가 등록되는 것은 아닙니다. 다음을 보내세요 [검증 키 요청](https://docs.rome.builders/ko/rome-zk-evm/verification-key.md) 빌드 후에. Rome이 genesis와 guest를 검사한 뒤 활성화 슬롯과 함께 키를 등록합니다.

prover 호스트에서 다음을 설정하세요 `PROVER=on` 그리고 전체 runbook에 설명된 guest, 검증 메타데이터 및 ZisK 설정을 구성하세요. 키가 활성화된 후:

```sh
./rollup init
./rollup up
./rollup check
```

다음을 확인하세요 `서비스 prover` 그리고 `검증 키` 항목이 통과하는지. prover는 inbox 배치를 순서대로 처리합니다. 유효한 각 증명은 Solana 트랜잭션이 도착하는 즉시 최종이 되는 루트를 게시합니다.

## 첫 블록 만들기

backed된 genesis 잔액이 없으면 체인은 예치금이 열릴 때까지 트랜잭션용 가스가 없습니다. 예치금에는 첫 번째 증명된 루트가 필요합니다. 기본값 `empty_block_interval_secs = 0` 은 유휴 체인을 블록 없이 남겨 두므로, 이를 다음으로 설정하세요 `60` 아래로 `[profile]` 을 `chain.toml` 키가 활성화되고 prover가 실행 중인 뒤에. 렌더링하고 다시 시작하세요:

```sh
./rollup init
./rollup up
./rollup check
```

첫 번째 루트가 최종이 되면, 간격을 다시 다음으로 되돌리세요 `0` 그리고 다시 실행하세요 `init` 그리고 `up` 정기적인 빈 블록을 원하지 않는 한. Rome이 키를 등록하는 동안 이를 켜면 작업이 적체됩니다. 모든 배치는 순서대로 증명되어야 합니다.

60초 빈 블록 간격과 60초 배치 종료를 사용하면 체인은 분당 약 1개, 즉 하루 약 1,440개의 배치를 만듭니다. devnet에서 증명된 루트는 payer에게 대략 **0.003 SOL**: 대략 0.002 SOL의 pending-account rent, 0.001 SOL의 정산 수수료, 그리고 그 위에 트랜잭션 수수료가 듭니다. 그 속도라면 inbox 게시 비용을 제외하고 하루 약 4.4 SOL입니다. pending-account rent는 기본 설정에서 계속 잠깁니다. 빈 블록을 끄면 유휴 체인은 배치를 봉인하지 않으며 게시 비용도 내지 않습니다.

예치금을 받으려면 먼저 vault를 만들고, 지연 후 exit 구성을 활성화한 다음 예치 큐를 여세요. 해당 명령과 확인 절차는 다음에 있습니다 [예치와 출금](https://docs.rome.builders/ko/rome-zk-evm/deposits-and-withdrawals.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/rome-zk-evm/run-a-rollup.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.
