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

# Cách nó hoạt động

Theo dõi một block Ostia từ reth qua quá trình chứng minh đến commit Canton của nó.

Trình dựng chạy liên tục. Khi có giao dịch đang chờ, nó tạo một khối, chứng minh khối đó rồi gửi lên Canton. Mặc định trong mã là mỗi lần chỉ có một khối đang được xử lý; DevNet chạy tối đa hai khối, với một bộ chứng minh GPU. Các khối vẫn được Canton xác nhận theo đúng thứ tự. Trên DevNet, nếu 60 giây không tạo khối nào, trình dựng sẽ tạo một khối rỗng (heartbeat; mặc định trong mã là tắt), nhờ đó ngay cả khi chuỗi im ắng vẫn có một khối được tạo khoảng mỗi phút. Canton quyết định mỗi khối có trở thành đầu chuỗi tiếp theo hay không. Một khối EVM và các thao tác Canton được ghi nhận trong khối đó được xác nhận trong cùng một giao dịch.

Trang này mô tả bản phát hành `v0.1.0` và, tại những chỗ được nêu rõ, những gì DevNet hiện đang chạy. [Trạng thái](https://docs.rome.builders/vi/canton-zk-evm/status.md) nêu commit mà DevNet đang chạy. Đọc toàn bộ [thiết kế](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md). Để theo dõi giao dịch của bạn qua các bước này, hãy chuyển đến [Từ giao dịch của bạn đến trạng thái cuối cùng trên Canton](#from-your-transaction-to-final-on-canton).

```mermaid
flowchart TD
    W["Giao dịch EVM"] --> Q["RPC công khai: chỉ hiển thị các khối đã hoàn tất"]
    Q --> R["reth tạo khối theo yêu cầu"]
    R --> B["Trình dựng đọc các thao tác của gateway và tìm các hợp đồng Canton tương ứng"]
    B -->|"Không thể tất toán một thao tác: loại giao dịch đó ra rồi dựng lại"| R
    B -->|"Tất cả thao tác đều có thể tất toán"| P["ZisK chứng minh khối"]
    P --> A["Advance: khối, bằng chứng và các thao tác trong cùng một giao dịch Canton"]
    A --> S["Lời gọi bên ngoài: các sidecar kiểm tra bằng chứng và trạng thái gateway"]
    S --> D["Daml kiểm tra đầu chuỗi và tất toán các thao tác"]
    D --> C["Canton xác nhận khối và các thao tác của khối cùng lúc"]
    C --> F["reth đánh dấu khối là đã hoàn tất"]
    F --> Q
    C --> X["Bộ lập chỉ mục của trình khám phá đọc bản ghi khối và đối chiếu với reth"]
```

## Dựng khối trên đầu chuỗi của Canton

Ví gửi giao dịch EVM đến RPC công khai, rồi RPC chuyển tiếp chúng đến reth. RPC chỉ hiển thị các khối đã hoàn tất trên Canton, vì vậy biên nhận chỉ xuất hiện khi khối đã hoàn tất. Trình khởi chạy được cung cấp tắt tính năng khám phá ngang hàng. reth tạo khối khi trình dựng yêu cầu.

Trước tiên, trình dựng đọc hợp đồng `ZkChain` đang hoạt động trên Canton. Nó đưa đầu chuỗi, khối an toàn và khối đã hoàn tất của reth về đầu chuỗi đã được xác nhận đó. Trình dựng chọn các giao dịch đang chờ theo giá, đồng thời giữ đúng thứ tự nonce của từng người gửi. Từ ngày 2026-10-25, nó lấp đầy khối dựa trên lượng gas mà các giao dịch sử dụng, do reth tính toán, chứ không dựa trên giới hạn gas mà chúng khai báo: ví thường khai báo mức cao gấp khoảng ba lần lượng gas thực dùng, và nếu tính theo giới hạn đã khai báo thì khối chỉ đạt khoảng một phần ba dung lượng có thể chứa. Khối kết thúc khi chạm mức trần gas. Trên DevNet, thông thường trình dựng cũng giới hạn tổng dữ liệu giao dịch thô mà nó cung cấp cho reth ở mức tối đa 393,216 byte, vì khối lượng công việc của participant tăng theo kích thước khối; tuy nhiên, giao dịch đầu tiên quá lớn vẫn được đưa vào để tránh phải chờ mãi. Trình dựng yêu cầu reth tạo khối với danh sách giao dịch tường minh đó.

Giao dịch EVM cần thực hiện một thao tác Canton sẽ gọi đến gateway. Gateway ghi lại một thao tác và gộp thao tác đó vào mã băm tích lũy của khối. Trình dựng đọc các sự kiện của gateway theo thứ tự log và tìm các hợp đồng Canton cần thiết cho từng thao tác.

Nếu một khoản phân bổ không còn tồn tại, người nhận chưa chấp nhận việc rút tiền hoặc thiếu một hợp đồng bắt buộc khác, trình dựng sẽ loại giao dịch đó cùng các giao dịch tiếp theo của cùng người gửi. Nó đưa reth trở về đầu chuỗi của Canton rồi dựng lại. Các kiểm tra này diễn ra trước khi chứng minh. Tệp [README của trình dựng](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md) liệt kê các bước kiểm tra cho từng thao tác.

## Chứng minh khối

Trình dựng lưu khối và witness thực thi của reth. Công cụ đầu vào kết hợp khối, witness và genesis để tạo đầu vào cho bộ chứng minh. ZisK chạy guest, chương trình này xác thực khối theo các quy tắc cố định của chuỗi.

Bộ chứng minh trả về một bằng chứng được bọc dài 1,344 byte, cam kết với mã băm của khối. Trình dựng gửi `Advance` kèm header, các giao dịch, bằng chứng, các thao tác và bằng chứng tài khoản cùng lưu trữ của gateway tại state root của khối.

## Kiểm tra và tất toán trong cùng một giao dịch

Mỗi participant xác nhận đều chạy một sidecar. Lời gọi bên ngoài của Canton gửi khối đến sidecar của participant đó để `verify`. Sidecar kiểm tra bằng chứng, khóa chương trình được ghim và phiên bản ZisK, mã băm của header và root của danh sách giao dịch.

Trên Ostia DevNet, Rome chạy participant duy nhất lưu trữ mọi party Ostia, nên sidecar duy nhất của Rome là bên xác nhận duy nhất và bằng chứng được kiểm tra bởi chính node của Rome. Bộ đồng bộ hóa của Canton sắp xếp các khối và không xem xét bằng chứng. Mạng demo cục bộ có hai participant xác nhận. [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md) giải thích những thay đổi đó.

Daml đối chiếu câu trả lời với `ZkChain`: khối cha phải là đầu chuỗi hiện tại, số khối phải là số kế tiếp, đồng thời giới hạn gas và lượng gas đã dùng phải nằm trong mức trần. Daml đối chiếu các câu trả lời của sidecar; bản thân Daml không xác minh bằng chứng không kiến thức.

Sau đó, Daml ghi một dòng cho từng thao tác dựa trên các hợp đồng Canton mà thao tác đó nêu tên. ID, burner và số lượng của một giao dịch rút tiền do trình dựng cung cấp; mã băm đã được chứng minh ràng buộc chúng với dữ liệu được ghi trong khối. Hàm `legs` của sidecar kiểm tra bằng chứng tài khoản và lưu trữ của gateway, băm các dòng theo thứ tự rồi so sánh kết quả với giá trị của gateway trong trạng thái đã được chứng minh. Khối không có thao tác nào cũng phải vượt qua cùng bước kiểm tra này với danh sách rỗng.

Daml tất toán các thao tác theo thứ tự và tạo `BlockRecord` và `ZkChain`. Canton ghi nhận các thay đổi này cùng nhau. Nếu một bước kiểm tra hoặc thanh toán thất bại, sẽ không có gì được ghi nhận. Việc tiêu thụ hợp đồng trạng thái duy nhất của chuỗi khiến Canton trở thành cơ quan quyết định thứ tự khối. Xem đầy đủ [giao diện Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md) và [các bước kiểm tra ở sidecar](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/sidecar/README.md).

## Vault và các token song sinh

Ngoài gateway đầu tiên, bản ghi chuỗi còn liệt kê các hợp đồng EVM mà chuỗi tin cậy—mỗi hợp đồng là một gateway hoặc vault—cùng với mã băm của mã nguồn hợp đồng. Một khối chứa các giao dịch của mọi gateway đã đăng ký, và Daml đối chiếu mã băm mã nguồn của từng gateway với bằng chứng tài khoản mà khối chứa. Vault không có giao dịch riêng: các thao tác khóa và giải phóng của vault là những khoản thanh toán qua gateway, còn Daml tin cậy địa chỉ của vault với vai trò bên nhận hoặc bên trả tiền. Bên xác nhận kiểm tra mã nguồn của vault trước khi chấp nhận mục đó. Mục mới được thêm vào theo cách thay đổi chương trình: nhà vận hành và gateway đề xuất mục đó, rồi bên xác nhận chấp thuận.

Vault là một hợp đồng nhỏ lưu giữ các token ERC-20 đứng sau các token song sinh trên Canton. Hợp đồng này không có chủ sở hữu, khóa hay cơ chế nâng cấp. Thao tác khóa là một giao dịch gateway thông thường `pay` với vault là bên nhận. Thao tác giải phóng là `release(ref, token, to, amount)`, theo đó vault thanh toán qua gateway dựa trên một mã định danh mà không loại thanh toán nào khác có thể dùng; Canton chỉ quyết toán giao dịch này khi có yêu cầu đổi token do người nắm giữ ký.

Token song sinh là token trên Canton đại diện cho một ERC-20, do bên gateway quản lý. Bản ghi chuỗi xác định rõ từng token song sinh: địa chỉ token, số chữ số thập phân và hợp đồng quy tắc dùng để phát hành, đốt và chuyển token. `Advance` chỉ phát hành token song sinh dựa trên một giao dịch khóa đã được bằng chứng xác thực, và chỉ đốt token đó khi có yêu cầu đổi đã ký.

Dịch vụ registry token song sinh hoạt động bên cạnh trình tạo. Trước khi thanh toán, bên trả tiền cho dịch vụ biết người nhận và một `ref` ; dịch vụ trả về mã ID giao dịch khóa, còn trình tạo đọc lại các thành phần tương tự để đính kèm giao dịch khóa vào khối. Dịch vụ cũng cung cấp API registry của tiêu chuẩn token cho các token song sinh, nhờ đó ví có các trình xác thực đã thẩm định gói token song sinh có thể gửi chúng. Dịch vụ không giữ khóa và không ghi dữ liệu lên Canton, còn `Advance` kiểm tra xem các thành phần có tạo ra mã ID đó hay không. Xem [Nạp tiền, rút tiền và thanh toán](https://docs.rome.builders/vi/canton-zk-evm/deposits-withdrawals-payments.md#canton-twins-of-erc-20-tokens) để biết các luồng xử lý.

## Khi Canton từ chối

Sau khi Canton ghi nhận khối, trình tạo đánh dấu khối đó là cuối cùng trong reth. Nếu Canton từ chối khối, trình tạo đưa reth trở lại khối cuối cùng mà Canton đã ghi nhận và trả các giao dịch trong khối bị từ chối về pool. Khối tiếp theo sẽ kiểm tra lại các giao dịch đó. Giao dịch thanh toán có phân bổ bị thu hồi sẽ bị loại. Nếu hai khối liên tiếp bị từ chối, trình tạo nghi ngờ giao dịch chung của chúng và tạm loại giao dịch đó trong một khoảng thời gian.

Nếu trình tạo mất phản hồi gửi lệnh, lệnh đó vẫn có thể được ghi nhận. Trước khi gửi, trình tạo ghi lại điểm cuối của sổ cái. Sau đó, trình tạo đọc kết quả hoàn tất riêng của lệnh kể từ thời điểm đó. Lệnh hoàn tất thành công được tính là đã ghi nhận. Lệnh thất bại được xem là bị từ chối.

Đầu chuỗi của Canton có thể xác nhận một lần ghi nhận, nhưng bản thân nó không bao giờ cho biết trạng thái “chưa được ghi nhận”. Nếu không có kết quả hoàn tất, trình tạo chỉ kết luận “chưa được ghi nhận” sau khi đã trôi qua 300 giây theo thời gian của Canton (`CZE_RESOLVE_SECONDS`). Cho đến lúc đó, trình tạo không tạo khối nào và giữ nguyên trạng thái reth. Các quy tắc khôi phục này được trình bày trong [README của trình tạo](https://github.com/rome-protocol/canton-zk-evm/blob/main/builder/README.md#what-one-run-does).

## Từ giao dịch của bạn đến trạng thái cuối cùng trên Canton

1. Bạn gửi giao dịch đến RPC công khai. Giao dịch chờ trong pool để được đưa vào khối tiếp theo.
2. Trình tạo tạo khối ngay khi có giao dịch đang chờ và còn chỗ trống (mặc định trong mã là mỗi lần chỉ có một khối đang được xử lý; DevNet chạy tối đa hai khối). Khi chuỗi hoạt động liên tục, khối mới nối tiếp khối trước sau mỗi 16,6 giây ở mức trung vị (trong 24 giờ tính đến 2026-10-25 01:34 UTC).
3. ZisK chứng minh khối. Trong giờ tải cao ngày 2026-10-24, thời gian chứng minh trung vị là 9,03 giây đối với các khối có từ 11 đến 100 giao dịch.
4. Bản ghi của khối cùng với bằng chứng được ghi nhận trên Canton. Chính lần ghi nhận đó khiến khối trở thành cuối cùng, và sau đó RPC công khai hiển thị biên nhận của bạn.

Trong cùng giờ đó, thời gian trung vị từ lúc RPC chấp nhận một giao dịch đến khi khối chứa giao dịch đó trở thành cuối cùng trên Canton là 19,5 giây; ở phân vị thứ 95 là 27,1 giây. Biên nhận mất nhiều thời gian hơn so với hầu hết các chuỗi, vì vậy các công cụ chờ biên nhận cần đặt thời gian chờ dài.

[Các phép đo](https://docs.rome.builders/vi/canton-zk-evm/measurements.md) định nghĩa từng khoảng thời gian và liệt kê các lần chạy. Trong trình khám phá, mở giao dịch của bạn rồi mở khối tương ứng để xem bản cập nhật trên Canton chứa bản ghi đó. [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md) cho biết cách thực hiện.


---

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