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

# Chạy một rollup

Đăng ký và chạy chuỗi Rome ZK EVM riêng của bạn trên devnet Solana với trình chạy rollup v0.3.0.

Các `./rollup` runner khởi chạy một chuỗi dựa trên các chương trình Solana devnet dùng chung của Rome. Bạn vận hành node của nó và trả chi phí Solana của nó. Bạn không tự triển khai các chương trình thanh toán. Việc đăng ký không cần cấp quyền, nhưng các root đã được chứng minh cần một khóa xác minh riêng cho chuỗi do Rome đăng ký.

Trang này sử dụng **v0.3.0**.  [hướng dẫn devnet đầy đủ](https://github.com/rome-protocol/solana-zk-evm/blob/v0.3.0/docs/RUN-ON-DEVNET.md) bao quát mọi thiết lập, lỗi và bước khôi phục.

## Trước khi bạn bắt đầu

Bạn cần một máy Linux x86-64 với bash 4 trở lên, Git, Docker Engine 28 trở lên kèm Compose, curl, jq, openssl, Solana CLI và Python 3.11 trở lên. Bạn cần một điểm cuối RPC của Solana devnet, một cặp khóa thanh toán Solana đã được nạp tiền, cũng là thẩm quyền chuỗi của bạn, và một khóa ký sequencer. Giữ cả hai tệp ở chế độ riêng tư và có thể đọc bởi người dùng vùng chứa 999. Hướng dẫn giải thích cách tạo chúng.

Dự trù khoảng **7 SOL trên devnet** cho tài khoản thanh toán. Việc đăng ký khóa 5 SOL; `./rollup check` kỳ vọng còn ít nhất 1 SOL để đăng bài và trả tiền thuê. Khoản ký quỹ sẽ được hoàn lại sau root cuối cùng đầu tiên hoặc sau mười root đã đăng. Nếu chuỗi bị thu hồi trước đó, khoản ký quỹ sẽ chuyển vào kho bạc. Chuỗi cũng cần một địa chỉ nhận phí EVM mà bạn kiểm soát.

Để quyết toán các root, bạn cần một máy chủ prover với một GPU NVIDIA có bộ nhớ hơn 30 GB. Một card 24 GB là quá nhỏ cho bước chứng minh cuối cùng. [Máy chủ prover](https://docs.rome.builders/vi/rome-zk-evm/prover-host.md) cung cấp ngân sách RAM và đĩa. Nút có thể chạy và đăng batch trước khi prover sẵn sàng, nhưng không có root nào của nó sẽ là cuối cùng.

## Khởi động nút

Sao chép bản phát hành và làm việc từ thư mục rollup của nó:

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

Thiết lập RPC Solana, vị trí trình ký và `ROME_ZK_TAG=v0.3.0` trên `.env`. Hãy giữ `PROGRAMS_JSON=programs.devnet.json`. Thiết lập `ROME_ZK_GUEST_TAG=v0.3.0` và `ZISK_RELEASE=1.3.1-alpha` cho lần build guest sau. Giữ RPC chỉ ràng buộc vào loopback cho lần chạy cục bộ đầu tiên. Để `PROVER` ở trạng thái chưa đặt cho đến khi guest và khóa của nó sẵn sàng.

Đặt `genesis.fee_recipient` trên `chain.toml` tới địa chỉ EVM của bạn. Đừng chọn chain ID. Thanh toán suy ra một ID từ người thanh toán và số lần đăng ký của nó; `init` đọc nó trước khi gửi bất cứ thứ gì. Khoảng một nửa số ID đều quá lớn đối với MetaMask. Nếu của bạn thuộc loại đó, `init` dừng với `ChainIdNotWalletSafe`; hãy tạo một khóa thanh toán mới, trỏ `PAYER_KEYPAIR_PATH` tới nó và chạy `init` lại.

Một chuỗi mới bắt đầu với số dư bằng không. Nếu bạn khai báo một số dư được hỗ trợ để có gas trước khi mở nạp tiền, hãy khóa cùng số lượng wSOL trong kho của chuỗi trước khi yêu cầu khóa xác minh.

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

`init` kết xuất cấu hình genesis và dịch vụ. `register --confirm` khóa khoản ký quỹ 5 SOL và tạo con trỏ batch. `khởi động` khởi động nút sequencer, batcher, derive và verifier. `kiểm tra` liệt kê bất kỳ dịch vụ nào còn thiếu, rồi so sánh chain ID, các head, tiến độ của batcher, inbox và các root. Chạy lại sau khi các batch có thời gian đóng; lần kiểm tra tiến độ batch đầu tiên của nó chỉ ghi nhận một mẫu.

Không có prover, sequencer phục vụ RPC, batcher đăng dữ liệu giao dịch lên inbox, và derive tái tạo lại chuỗi. Một batch trong inbox không phải là một root quyết toán cuối cùng. Ngay cả root genesis cũng phải chờ một bằng chứng.

## Chuyển từ các batch sang các root cuối cùng

Biên dịch guest cho genesis của chuỗi bạn:

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

Bản build sử dụng guest v0.3.0 và ZisK 1.3.1-alpha. Nó tạo ra chương trình guest của chuỗi và siêu dữ liệu khóa xác minh. Việc tính toán `programVK` cần các khóa chứng minh ZisK và khoảng 36 GB RAM. Việc đăng ký chuỗi không đăng ký khóa xác minh. Gửi [yêu cầu khóa xác minh](https://docs.rome.builders/vi/rome-zk-evm/verification-key.md) sau khi build xong. Rome kiểm tra genesis và guest của bạn, rồi đăng ký khóa với một slot kích hoạt.

Trên máy chủ prover, đặt `PROVER=on` và guest, siêu dữ liệu xác minh cùng các thiết lập ZisK được mô tả trong sổ tay vận hành đầy đủ. Sau khi khóa được kích hoạt:

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

Kiểm tra rằng `dịch vụ prover` và `khóa xác minh` đều đạt. Prover xử lý các batch trong inbox theo thứ tự. Mỗi bằng chứng hợp lệ sẽ đăng một root và root đó trở thành cuối cùng ngay khi giao dịch Solana của nó được ghi nhận.

## Tạo block đầu tiên

Không có số dư genesis được hỗ trợ, chuỗi không có gas cho giao dịch cho đến khi mở nạp tiền. Nạp tiền cần một root đã được chứng minh đầu tiên. Mặc định `empty_block_interval_secs = 0` để mặc chuỗi nhàn rỗi không có block, vì vậy hãy đặt nó thành `60` dưới `[profile]` trên `chain.toml` sau khi khóa đã được kích hoạt và prover đang chạy. Kết xuất và khởi động lại:

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

Khi root đầu tiên đã là cuối cùng, đặt lại khoảng thời gian về `0` và chạy lại `init` và `khởi động` trừ khi bạn muốn các block rỗng định kỳ. Bật chúng trong lúc chờ Rome đăng ký khóa sẽ tạo ra hàng đợi tồn đọng. Mỗi batch phải được chứng minh theo thứ tự.

Với khoảng thời gian block rỗng 60 giây và thời gian đóng batch 60 giây, chuỗi tạo ra khoảng một batch mỗi phút, tức khoảng 1.440 mỗi ngày. Trên devnet, một root đã được chứng minh tốn cho người thanh toán khoảng **0.003 SOL**: khoảng 0.002 SOL tiền thuê tài khoản chờ, 0.001 SOL phí quyết toán và thêm phí giao dịch. Nhịp đó vào khoảng 4.4 SOL mỗi ngày trước chi phí đăng bài vào inbox. Tiền thuê tài khoản chờ vẫn bị khóa với thiết lập mặc định. Khi tắt block rỗng, một chuỗi nhàn rỗi không niêm phong batch nào và không phát sinh chi phí đăng bài.

Để chấp nhận nạp tiền, trước tiên hãy tạo vault, kích hoạt cấu hình thoát sau thời gian trì hoãn của nó, và mở hàng đợi nạp tiền. Các lệnh đó và các bước kiểm tra nằm trong [Nạp tiền và rút tiền](https://docs.rome.builders/vi/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/vi/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.
