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

# Cara kerjanya

Ikuti satu blok Ostia dari reth melalui proses pembuktian hingga commit Canton-nya.

Builder berjalan terus-menerus. Builder memotong sebuah blok setiap kali ada transaksi yang menunggu, membuktikannya, lalu mengirimkannya ke Canton. Secara default, kode hanya memproses satu blok dalam satu waktu, sedangkan DevNet memproses hingga dua blok, dengan satu prover GPU. Blok tetap di-commit di Canton secara berurutan. Di DevNet, jika tidak ada blok yang dibuat selama 60 detik, builder memotong blok kosong sebagai heartbeat (secara default fitur ini nonaktif), sehingga chain yang sepi pun tetap membuat blok kira-kira sekali semenit. Canton menentukan apakah setiap blok menjadi head chain berikutnya. Sebuah blok EVM dan langkah-langkah Canton yang dicatatnya di-commit dalam transaksi yang sama.

Halaman ini menjelaskan rilis `v0.1.0` dan, jika disebutkan, apa yang saat ini dijalankan DevNet. [Status](https://docs.rome.builders/id/canton-zk-evm/status.md) menyebutkan commit yang dijalankan DevNet. Baca [desain](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md). Untuk mengikuti transaksi Anda sendiri melalui langkah-langkah ini, buka [Dari transaksi Anda hingga final di Canton](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["Transaksi EVM"] --> Q["RPC publik: hanya menampilkan blok final"]
    Q --> R["reth membangun sesuai permintaan"]
    R --> B["Builder membaca langkah gateway dan mencari kontrak Cantonnya"]
    B -->|"Sebuah langkah tidak dapat diselesaikan: keluarkan transaksinya dan bangun ulang"| R
    B -->|"Semua langkah dapat diselesaikan"| P["ZisK membuktikan blok"]
    P --> A["Advance: blok, bukti, dan langkah dalam satu transaksi Canton"]
    A --> S["Panggilan eksternal: sidecar memeriksa bukti dan status gateway"]
    S --> D["Daml memeriksa head dan menyelesaikan langkah-langkah"]
    D --> C["Canton meng-commit blok dan langkah-langkahnya secara bersamaan"]
    C --> F["reth menandai blok sebagai final"]
    F --> Q
    C --> X["Pengindeks explorer membaca catatan blok dan mencocokkannya dengan reth"]
```

## Membangun berdasarkan head Canton

Dompet mengirim transaksi EVM ke RPC publik, yang meneruskannya ke reth. RPC hanya menampilkan blok yang sudah final di Canton, sehingga tanda terima muncul setelah blok final. Peluncur yang disediakan menonaktifkan penemuan peer. reth membuat blok saat diminta oleh builder.

Pertama-tama, builder membaca kontrak `ZkChain` aktif di Canton. Builder memindahkan head, blok aman, dan blok final reth ke head yang telah di-commit tersebut. Builder memilih transaksi tertunda berdasarkan harga, dengan tetap mempertahankan urutan nonce setiap pengirim. Sejak 2026-10-25, builder mengisi blok berdasarkan gas yang digunakan transaksi—yang dihitung oleh reth—bukan berdasarkan batas gas yang dinyatakan: dompet sering menyatakan jumlah sekitar tiga kali gas yang digunakan, dan jika batas yang dinyatakan itu yang dihitung, blok akan berhenti terisi saat baru mencapai sekitar sepertiga kapasitasnya. Blok berakhir saat mencapai batas gas. Di DevNet, biasanya builder juga membatasi transaksi mentah yang ditawarkan kepada reth hingga 393,216 byte, karena beban kerja peserta untuk sebuah blok bertambah seiring ukurannya; namun, builder tetap menawarkan transaksi pertama yang terlalu besar agar transaksi itu tidak menunggu selamanya. Builder meminta reth membangun blok dengan daftar transaksi yang ditentukan secara eksplisit tersebut.

Transaksi EVM yang memerlukan tindakan Canton memanggil gateway. Gateway mencatat sebuah langkah dan menggabungkannya ke dalam hash berjalan untuk blok tersebut. Builder membaca peristiwa gateway sesuai urutan log dan mencari kontrak Canton yang diperlukan oleh setiap langkah.

Jika alokasi sudah tidak ada, penerima belum menerima penarikan, atau kontrak lain yang diperlukan tidak tersedia, builder tidak menyertakan transaksi tersebut maupun transaksi berikutnya dari pengirim yang sama. Builder mengembalikan reth ke head Canton lalu membangun ulang. Pemeriksaan ini dilakukan sebelum pembuktian. README [builder](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) mencantumkan pemeriksaan untuk setiap langkah.

## Membuktikan blok

Builder menyimpan blok dan witness eksekusi reth. Alat input menggabungkan blok, witness, dan genesis menjadi input prover. ZisK menjalankan guest, yang memvalidasi blok berdasarkan aturan tetap chain.

Prover menghasilkan bukti terbungkus berukuran 1,344 byte yang mengikat hash blok. Builder mengirimkan `Advance` beserta header, transaksi, bukti, langkah-langkah, serta bukti akun dan penyimpanan gateway pada root state blok.

## Memeriksa dan menyelesaikan dalam satu transaksi

Setiap peserta pengonfirmasi menjalankan sidecar. Panggilan eksternal Canton mengirimkan blok ke sidecar peserta tersebut untuk `verify`. Sidecar memeriksa bukti, kunci program yang dipatok dan rilis ZisK, hash header, serta root daftar transaksi.

Di Ostia DevNet, Rome menjalankan satu-satunya peserta yang meng-host semua party Ostia, sehingga sidecar-nya adalah satu-satunya pengonfirmasi dan bukti diperiksa oleh node Rome sendiri. Sinkroniser Canton mengurutkan blok dan tidak melihat buktinya. Jaringan demo lokal memiliki dua peserta pengonfirmasi. [Model kepercayaan dan batasan](https://docs.rome.builders/id/canton-zk-evm/trust-model.md) menjelaskan perubahan yang ditimbulkannya.

Daml mencocokkan jawaban dengan `ZkChain`: parent harus merupakan head saat ini, nomor harus merupakan nomor berikutnya, dan batas gas serta gas yang digunakan harus berada dalam batas maksimum. Daml membandingkan jawaban sidecar; Daml tidak memverifikasi bukti zero-knowledge itu sendiri.

Daml kemudian menulis satu baris untuk setiap langkah berdasarkan kontrak Canton yang disebutkannya. ID, burner, dan jumlah penarikan berasal dari builder; hash yang dibuktikan mengikatnya pada catatan blok. Fungsi `legs` milik sidecar memeriksa bukti akun dan penyimpanan gateway, meng-hash baris-baris tersebut sesuai urutan, lalu membandingkan hasilnya dengan nilai gateway dalam state yang dibuktikan. Blok tanpa langkah harus lolos pemeriksaan yang sama dengan daftar kosong.

Daml menyelesaikan langkah-langkah secara berurutan dan membuat `BlockRecord` dan `ZkChain`. Canton mengomit perubahan ini secara bersamaan. Jika pemeriksaan atau penyelesaian gagal, tidak ada yang dikomit. Penggunaan kontrak status tunggal chain menjadikan Canton otoritas atas urutan blok. Lihat [antarmuka Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) dan [pemeriksaan sidecar](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## Vault dan kembarannya

Selain gateway pertama, catatan chain mencantumkan kontrak EVM yang dipercayainya, masing-masing berupa gateway atau vault, beserta hash kodenya. Sebuah blok memuat kaki transaksi dari setiap gateway terdaftar, dan Daml memeriksa hash kode setiap gateway terhadap bukti akun yang dibawa blok tersebut. Vault tidak memiliki kaki transaksi sendiri: penguncian dan pelepasannya adalah pembayaran gateway, dan Daml memercayai alamatnya sebagai penerima atau pembayar transaksi tersebut. Konfirmator memeriksa kode vault sebelum menerima entri. Entri baru ditambahkan seperti program diubah: operator dan gateway mengusulkannya, lalu konfirmator menerimanya.

Vault adalah kontrak kecil yang menyimpan token ERC-20 di balik kembaran Canton. Vault tidak memiliki pemilik, kunci, ataupun mekanisme peningkatan. Penguncian adalah `pay` gateway biasa dengan vault sebagai penerimanya. Pelepasan dilakukan dengan `release(ref, token, to, amount)`, yang dibayarkan vault melalui gateway menggunakan ID yang tidak dapat dimiliki jenis pembayaran lain, dan Canton hanya menyelesaikannya berdasarkan permintaan penukaran yang ditandatangani pemegangnya.

Kembaran adalah token Canton untuk satu ERC-20, yang dikelola oleh pihak gateway. Catatan chain menetapkan setiap kembaran: alamat token, jumlah desimalnya, dan kontrak aturan yang mencetak, membakar, serta mentransfernya. `Advance` mencetak kembaran hanya berdasarkan penguncian yang telah ditetapkan oleh bukti, dan membakarnya hanya berdasarkan permintaan penukaran yang ditandatangani.

Layanan registri kembaran berada di samping builder. Sebelum membayar, pembayar memberi tahu layanan tersebut tentang penerima dan sebuah `ref` ; layanan itu membalas dengan ID penguncian, lalu builder membaca bagian yang sama untuk melampirkan penguncian ke blok. Layanan ini juga menyediakan API registri standar token untuk kembaran, sehingga dompet yang validatornya telah memeriksa paket kembaran dapat mengirimkannya. Layanan ini tidak menyimpan kunci dan tidak menulis apa pun ke Canton, dan `Advance` memeriksa apakah bagian-bagian tersebut menghasilkan ID itu. Lihat [Setoran, penarikan, dan pembayaran](https://docs.rome.builders/id/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) untuk alur-alurnya.

## Saat Canton menolak

Setelah Canton mengomit blok, builder menandainya sebagai final di reth. Jika Canton menolaknya, builder mengembalikan reth ke blok terakhir yang dikomit Canton dan mengirim transaksi dari blok yang ditolak kembali ke pool. Blok berikutnya memeriksa kembali kaki transaksinya. Pembayaran yang alokasinya telah ditarik kembali tidak disertakan. Setelah dua blok berturut-turut ditolak, builder mencurigai transaksi yang sama-sama ada pada kedua blok tersebut dan tidak menyertakannya selama masa jeda.

Jika builder kehilangan balasan pengiriman, perintah tersebut mungkin tetap dikomit. Sebelum mengirimkannya, builder mencatat posisi akhir ledger. Kemudian builder membaca penyelesaian perintah itu sendiri sejak posisi tersebut. Penyelesaian yang berhasil dianggap sebagai commit. Penyelesaian yang gagal dianggap sebagai penolakan.

Head Canton dapat mengonfirmasi commit, tetapi tidak pernah dengan sendirinya menunjukkan "tidak dikomit". Jika tidak ada penyelesaian, builder baru memutuskan "tidak dikomit" setelah 300 detik waktu Canton berlalu (`CZE_RESOLVE_SECONDS`). Sampai saat itu, builder tidak membuat apa pun dan membiarkan reth tetap di posisinya. Aturan pemulihan ini dijelaskan dalam [README builder](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## Dari transaksi Anda hingga final di Canton

1. Anda mengirim transaksi ke RPC publik. Transaksi itu menunggu di pool hingga blok berikutnya.
2. Builder membentuk blok segera setelah ada transaksi yang menunggu dan tempat tersedia (default dalam kode adalah satu blok dalam penerbangan; DevNet menjalankan hingga dua). Saat chain sibuk, blok baru menyusul blok sebelumnya setiap 16,6 detik secara median (24 jam hingga 2026-10-25 01:34 UTC).
3. ZisK membuktikan blok tersebut. Dalam beban selama satu jam pada 2026-10-24, median waktu pembuktian adalah 9,03 detik untuk blok yang berisi 11 hingga 100 transaksi.
4. Catatan blok beserta buktinya dikomit di Canton. Commit itulah yang membuat blok menjadi final, dan RPC publik kemudian menampilkan tanda terima Anda.

Pada jam yang sama, median waktu dari saat RPC menerima transaksi hingga bloknya menjadi final di Canton adalah 19,5 detik, dan 27,1 detik pada persentil ke-95. Tanda terima membutuhkan waktu lebih lama daripada di sebagian besar chain, jadi alat yang menunggunya memerlukan batas waktu yang panjang.

[Pengukuran](https://docs.rome.builders/id/canton-zk-evm/measurements.md) menjelaskan setiap interval dan mencantumkan proses pengujiannya. Di penjelajah, buka transaksi Anda, lalu bloknya, untuk melihat pembaruan Canton yang menyimpan catatan tersebut. [Penjelajah](https://docs.rome.builders/id/canton-zk-evm/explorer.md) menunjukkan caranya.


---

# 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/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.
