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

# Jalankan sebuah rollup

Daftarkan dan jalankan chain Rome ZK EVM milik Anda sendiri di Solana devnet dengan rollup runner v0.3.0.

README `./rollup` runner memulai satu chain terhadap program devnet Solana bersama Rome. Anda menjalankan nodenya dan membayar biaya Solana-nya. Anda tidak mendeploy sendiri program settlement. Pendaftaran tidak memerlukan izin, tetapi root yang terbukti memerlukan kunci verifikasi khusus chain yang didaftarkan oleh Rome.

Halaman ini menggunakan **v0.3.0**Itu [panduan devnet lengkap](https://github.com/rome-protocol/solana-zk-evm/blob/v0.3.0/docs/RUN-ON-DEVNET.md) mencakup setiap pengaturan, kegagalan, dan langkah pemulihan.

## Sebelum Anda mulai

Gunakan mesin Linux x86-64 dengan bash 4 atau yang lebih baru, Git, Docker Engine 28 atau yang lebih baru dengan Compose, curl, jq, openssl, Solana CLI, dan Python 3.11 atau yang lebih baru. Anda memerlukan endpoint RPC Solana devnet, keypair pembayar Solana yang didanai, yang juga merupakan otoritas chain Anda, dan kunci penandatangan sequencer. Simpan kedua file tetap privat dan dapat dibaca oleh pengguna container 999. Panduan ini menjelaskan cara membuatnya.

Anggarkan sekitar **7 SOL di devnet** untuk pembayar. Pendaftaran mengunci 5 SOL; `./rollup check` mengharapkan setidaknya 1 SOL tersisa untuk posting dan sewa. Setoran menjadi dapat dikembalikan setelah root final pertama atau sepuluh root yang diposting. Jika chain diambil kembali sebelum itu, setoran masuk ke treasury. Chain juga membutuhkan alamat penerima biaya EVM yang Anda kendalikan.

Untuk menyelesaikan root, Anda memerlukan host prover dengan satu GPU NVIDIA dengan memori lebih dari 30 GB. Kartu 24 GB terlalu kecil untuk langkah pembuktian akhir. [Host prover](https://docs.rome.builders/id/rome-zk-evm/prover-host.md) memberikan anggaran RAM dan disk. Node dapat berjalan dan mempublikasikan batch sebelum prover siap, tetapi tidak ada root-nya yang akan menjadi final.

## Mulai node

Klon rilisnya dan bekerja dari direktori rollup-nya:

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

Setel RPC Solana, lokasi penandatangan, dan `ROME_ZK_TAG=v0.3.0` di `.env`. Simpan `PROGRAMS_JSON=programs.devnet.json`. Setel `ROME_ZK_GUEST_TAG=v0.3.0` dan `ZISK_RELEASE=1.3.1-alpha` untuk build guest nanti. Ikat RPC ke loopback untuk percobaan lokal pertama. Biarkan `PROVER` tidak disetel sampai guest dan kuncinya siap.

Setel `genesis.fee_recipient` di `chain.toml` ke alamat EVM Anda. Jangan pilih chain ID. Settlement menurunkannya dari pembayar dan jumlah pendaftarannya; `init` membacanya sebelum mengirim apa pun. Sekitar setengah dari semua ID terlalu besar untuk MetaMask. Jika milik Anda termasuk, `init` berhenti dengan `ChainIdNotWalletSafe`; buat kunci pembayar baru, arahkan `PAYER_KEYPAIR_PATH` ke sana dan jalankan `init` lagi.

Chain baru dimulai dengan saldo nol. Jika Anda mendeklarasikan satu saldo yang didukung untuk mendapatkan gas sebelum deposit dibuka, kunci jumlah wrapped SOL yang sama di vault chain sebelum meminta kunci verifikasi.

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

`init` merender genesis dan konfigurasi layanan. `register --confirm` mengunci deposit 5 SOL dan membuat kursor batch. `up` memulai node sequencer, batcher, derive, dan verifier. `check` menyebut layanan apa pun yang hilang, lalu membandingkan chain ID, head, progres batcher, inbox, dan root. Jalankan lagi setelah batch sempat tertutup; pemeriksaan progres batch pertama hanya mencatat sampel.

Tanpa prover, sequencer melayani RPC, batcher memposting data transaksi ke inbox, dan derive merekonstruksi chain. Batch inbox bukan root settlement final. Bahkan root genesis pun menunggu bukti.

## Berpindah dari batch ke root final

Bangun guest untuk genesis chain Anda:

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

Build ini menggunakan guest v0.3.0 dan ZisK 1.3.1-alpha. Ini menghasilkan program guest chain dan metadata kunci verifikasi. Menghitung `programVK` memerlukan kunci pembuktian ZisK dan sekitar 36 GB RAM. Mendaftarkan chain tidak mendaftarkan kunci verifikasi. Kirim [permintaan kunci verifikasi](https://docs.rome.builders/id/rome-zk-evm/verification-key.md) setelah build. Rome memeriksa genesis dan guest Anda, lalu mendaftarkan kunci dengan slot aktivasi.

Di host prover, setel `PROVER=on` dan guest, metadata verifikasi, serta pengaturan ZisK yang dijelaskan dalam runbook lengkap. Setelah kunci aktif:

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

Periksa bahwa the `layanan prover` dan `kunci verifikasi` item lolos. Prover memproses batch inbox secara berurutan. Setiap bukti yang valid memposting root yang final segera setelah transaksi Solana-nya masuk.

## Buat blok pertama

Tanpa saldo genesis yang didukung, chain tidak memiliki gas untuk transaksi sampai deposit dibuka. Deposit memerlukan root yang pertama kali terbukti. Default `empty_block_interval_secs = 0` membiarkan chain yang idle tanpa blok, jadi setel ke `60` di bawah `[profile]` di `chain.toml` setelah kunci aktif dan prover berjalan. Render dan mulai ulang:

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

Setelah root pertama final, setel interval kembali ke `0` dan jalankan ulang `init` dan `up` kecuali Anda menginginkan blok kosong secara teratur. Menyalakannya saat menunggu Rome mendaftarkan kunci akan menciptakan antrean tertunda. Setiap batch harus dibuktikan secara berurutan.

Dengan interval blok kosong 60 detik dan penutupan batch 60 detik, chain membuat sekitar satu batch per menit, atau sekitar 1.440 per hari. Di devnet, root yang terbukti menghabiskan biaya pembayar sekitar **0.003 SOL**: sekitar 0.002 SOL dalam sewa akun tertunda, biaya settlement 0.001 SOL, dan ditambah biaya transaksi. Ritme itu sekitar 4.4 SOL per hari sebelum biaya posting inbox. Sewa akun tertunda tetap terkunci dengan pengaturan default. Dengan blok kosong dimatikan, chain yang idle tidak menutup batch apa pun dan tidak membayar biaya posting.

Untuk menerima deposit, berikutnya buat vault, aktifkan konfigurasi keluar setelah penundaannya, dan buka antrean deposit. Perintah-perintah itu dan pemeriksaannya ada di [Deposit dan penarikan](https://docs.rome.builders/id/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/id/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.
