> 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/start-here.md).

# Bắt đầu ở đây

Một điểm khởi đầu cho mỗi người đọc Ostia, với các công cụ bạn sử dụng và nơi cần xem, dù bạn xây dựng ứng dụng, xác thực trên Canton, chạy một prover, kiểm toán hay tự vận hành Ostia của riêng mình.

| Tôi muốn                                                                    | Bắt đầu tại đây                                                                                                                                                           |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Triển khai ứng dụng                                                         | [Nhà phát triển ứng dụng](#app-builders)                                                                                                                                  |
| Xem bạn có thể xây dựng những gì với Canton và những gì đã chạy trên DevNet | [Xây dựng với Canton](https://docs.rome.builders/vi/canton-zk-evm/build-with-canton.md) và [Trường hợp sử dụng](https://docs.rome.builders/vi/canton-zk-evm/use-cases.md) |
| Nhận ví và tiền thử nghiệm                                                  | [Người dùng](#users)                                                                                                                                                      |
| Nhận 100 tROME với vai trò nhà phát triển                                   | [Khoản tài trợ dành cho nhà phát triển](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#the-builder-grant)                                                          |
| Chuyển token giữa Ostia và Canton bằng ví trình duyệt                       | [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md)                                                                                                          |
| Xem cách mỗi khối được xác nhận trên Canton                                 | [Lời gọi bên ngoài](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#external-calls)                                                                               |
| Tìm hiểu cách hoạt động của các bản sao ERC-20 và Canton Coin               | [Tài sản Canton hai chiều](#two-way-canton-assets)                                                                                                                        |
| Chạy Ostia trên một nút tham gia Canton hoặc xem ai xác nhận các khối       | [Trình xác thực Canton và đơn vị vận hành nút tham gia](#canton-validators-and-participant-operators)                                                                     |
| Chạy trình chứng minh                                                       | [Đơn vị vận hành trình chứng minh](#prover-operators)                                                                                                                     |
| Xem bằng chứng khắc phục được điều gì và không khắc phục được điều gì       | [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md)                                                                                 |
| Kiểm tra mã nguồn                                                           | [Kiểm toán viên và nhà nghiên cứu](#auditors-and-researchers)                                                                                                             |
| Tự chạy Ostia                                                               | [Tự chạy Ostia](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md)                                                                                            |

Toàn bộ mã nguồn nằm trong một kho lưu trữ công khai, [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm), theo Giấy phép Apache 2.0. Các liên kết mã nguồn trên trang này trỏ đến nhánh chính; [Trạng thái](https://docs.rome.builders/vi/canton-zk-evm/status.md) cho biết commit mà DevNet đang chạy. Các ứng dụng nằm trong [`apps/accounts`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/accounts), [`apps/twin`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin) (cùng với [dịch vụ registry](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/twin/registry)) và [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc). Bản phát hành [v0.1.0](https://github.com/rome-protocol/canton-zk-evm/releases/tag/v0.1.0) là thẻ phiên bản đầu tiên, được tạo trước khi có các ứng dụng.

## Nhà phát triển ứng dụng

Ostia chạy các hợp đồng EVM qua HTTP JSON-RPC trên Canton DevNet. Hệ thống chưa được kiểm toán, tiền thử nghiệm không có giá trị và DevNet có thể được đặt lại. Rome vận hành trình tạo khối, trình chứng minh và nút tham gia duy nhất xác nhận khối. Một số hành vi khác với Ethereum; trước tiên hãy đọc [Các điểm khác biệt so với Ethereum](https://docs.rome.builders/vi/canton-zk-evm/evm-differences.md)  . Các hợp đồng được xây dựng cho Osaka hoặc phiên bản cũ hơn đều chạy được ở đây (`london` là mục tiêu an toàn), với các bước triển khai giống như trên Ethereum. Hãy kiểm tra [giới hạn RPC](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#limits) trước khi kết nối ứng dụng hiện có.

**Công cụ bạn cần**

* Foundry 1.8: `forge create` để triển khai, và `forge verify-contract` với API tương thích Etherscan của trình khám phá.
* Hardhat 2 để triển khai.
* ethers để đọc và gửi giao dịch. Bộ công cụ tải hỗn hợp (`load/mixed`) sử dụng nó. [Build trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md#viem-and-ethers) cũng có cấu hình viem.
* Ví EVM được thiết lập bằng các giá trị mạng hoặc bằng nút trên trang API của trình khám phá.
* Các hợp đồng OpenZeppelin. Token ERC-20, ERC-721 và ERC-1155 được xây dựng trên đó đã hoạt động trên Ostia, cùng với token được cấp quyền ERC-3643 (T-REX) và Uniswap V2.
* Bộ công cụ tải cũng đã gửi các giao dịch chuyển riêng tư đến những hợp đồng Merces của TACEO. Các bằng chứng Groth16 được tạo trên máy khách và xác minh trên chuỗi. Không có mạng MPC nào hoạt động và không có giao dịch nào được quyết toán.

Cấu hình viem và các bước thiết lập ví đã được ghi lại, nhưng chưa được kiểm thử từ đầu đến cuối tại đây. Các công cụ EVM khác chưa được thử nghiệm. RPC không hỗ trợ WebSocket, không có `eth_newFilter` và không có `eth_subscribe`, vì vậy hãy thăm dò `eth_getLogs`. Biên nhận xuất hiện khi khối được xác nhận cuối cùng trên Canton, thường mất khoảng 10 đến 30 giây.

**Nơi tìm hiểu**

* [Ostia DevNet](https://docs.rome.builders/vi/canton-zk-evm/devnet.md): chain ID, RPC, giá trị ví, giới hạn, thời gian tạm dừng và bảo trì.
* [Điểm khác biệt so với Ethereum](https://docs.rome.builders/vi/canton-zk-evm/evm-differences.md): PREVRANDAO, giao dịch blob, thời gian tạo khối và những điểm khác.
* [Build trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md): triển khai và xác minh bằng Foundry hoặc Hardhat, sau đó kết nối bằng viem hoặc ethers.
* [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md): các API, xác minh hợp đồng, vòi nhận token và trang External calls.
* [Khoản tài trợ cho nhà phát triển](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#the-builder-grant): 100 tROME dành cho nhà phát triển đăng nhập bằng GitHub.
* [Build với Canton](https://docs.rome.builders/vi/canton-zk-evm/build-with-canton.md): twin, Canton Coin, thanh toán giữa các bên Canton và một địa điểm giao dịch trên Canton.
* [Các trường hợp sử dụng](https://docs.rome.builders/vi/canton-zk-evm/use-cases.md): những gì đang hoạt động hiện nay trên DevNet hoặc trên mạng của riêng bạn.
* [Dùng thử Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md): hướng dẫn ngắn gọn trong kho mã nguồn.
* [load/mixed](https://github.com/rome-protocol/canton-zk-evm/tree/main/load/mixed): bộ công cụ triển khai tất cả những nội dung trên. Bộ này chứa các tập lệnh và hợp đồng do chúng tôi tự viết; các gói được nhập và một bước tải dữ liệu sẽ bổ sung phần còn lại.

## Người dùng

**Công cụ bạn cần**

* Ví đã thêm Ostia DevNet.
* Vòi nhận tiền thử nghiệm: mỗi địa chỉ nhận 1 tROME mỗi ngày; nhà phát triển đăng nhập bằng GitHub nhận 100 tROME. tROME không có giá trị.
* Trình khám phá để tìm giao dịch, kiểm tra khối và, trên trang [External calls](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#external-calls), theo dõi cách mỗi khối được xác nhận trên Canton.
* Trang [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) để chuyển token giữa Ostia và Canton, cũng như gửi token trên Canton bằng ví trình duyệt.

**Nơi tìm hiểu**

* [Ostia DevNet](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#add-it-to-a-wallet): thiết lập ví.
* [Nhận tROME](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#get-trome): vòi nhận token và [khoản tài trợ cho nhà phát triển](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#the-builder-grant).
* [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md): đọc một khối và kiểm tra bằng chứng trong trình duyệt.
* [Các lệnh gọi bên ngoài](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#external-calls): mỗi lần Canton commit một khối, cùng thời điểm xác nhận của khối đó.
* [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md): chuyển token giữa Ostia và Canton bằng ví Canton bạn đã có.
* [Cách hoạt động](https://docs.rome.builders/vi/canton-zk-evm/how-it-works.md#from-your-transaction-to-final-on-canton): ý nghĩa của trạng thái “cuối cùng”, từ giao dịch của bạn đến khi một khối Canton được commit.

## Tài sản Canton hai chiều

Kể từ ngày 2026-10-29, tài sản có thể chuyển theo cả hai chiều. Một token ERC-20 trên Ostia có thể có một bản sao tương ứng trên Canton: bạn gửi token vào vault, một tài khoản Canton nắm giữ lượng tương đương và khi quy đổi, token ERC-20 được trả lại. Canton Coin có thể chuyển sang Ostia dưới dạng token CC rồi chuyển ngược lại. Trang [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) của trình khám phá cho phép thực hiện các giao dịch này bằng ví trình duyệt và ví Canton bạn đã có, bật riêng từng ví. Trước tiên, hãy lấy tROME thử nghiệm. Trình khám phá hiển thị nguồn cung của mỗi bản sao tương ứng với lượng token vault đang nắm giữ.

**Nơi tìm hiểu**

* [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md): trang Cầu nối, bốn giao dịch và thời gian được đo.
* [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): các luồng khóa và quy đổi, cùng Canton Coin.
* [Ostia DevNet](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#canton-assets-on-devnet): địa chỉ vault, các bản sao tương ứng và token CC, cùng dịch vụ đăng ký bản sao.
* [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#twins-and-canton-assets): trang `/twins` .
* [Xây dựng với Canton](https://docs.rome.builders/vi/canton-zk-evm/build-with-canton.md): các lệnh gọi của dịch vụ đăng ký bản sao, Canton Coin dưới dạng ERC-20, thanh toán và nền tảng giao dịch OTC.
* [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md#what-the-twins-trust): cơ sở bảo đảm của các bản sao tương ứng.
* [Dùng thử Ostia](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/TRY-OSTIA.md#canton-twins-and-canton-coin-on-devnet): hướng dẫn ngắn gọn trong kho mã nguồn.

## Trình xác thực Canton và đơn vị vận hành nút tham gia

Trên Ostia, Canton chỉ commit một khối sau khi sidecar bên cạnh một participant xác nhận đã kiểm tra khối đó. Trên DevNet, participant này thuộc về Rome. Sidecar chạy trình xác minh và kiểm tra bằng chứng, header cùng gốc giao dịch. Nếu kiểm tra thất bại, khối sẽ không được commit.

Trên DevNet, chỉ một participant — participant của chính Rome — lưu trữ mọi party của Ostia. Sidecar của participant này là bên xác nhận duy nhất. Hiện không có participant nào khác xác nhận các khối Ostia DevNet. Validator của Rome chạy Splice 0.10.1 với Canton 3.7.2. [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md#local-demo-vs-ostia-devnet) so sánh cấu hình chỉ có một bên xác nhận này với cấu hình có hai bên xác nhận của mạng cục bộ. Hiện nay, bạn có thể chạy Ostia của riêng mình trên một participant mà bạn đang vận hành, bằng chế độ participant hiện có.

**Công cụ bạn cần**

* Sidecar mà Canton gọi thông qua phần mở rộng external-call.
* Trình xác minh dùng để kiểm tra bằng chứng được bọc.
* Gói Daml lưu trữ chuỗi và các khối của chuỗi.
* Các tập lệnh thiết lập Ostia trên participant bạn đang vận hành.

**Nơi tìm hiểu**

* [sidecar/](https://github.com/rome-protocol/canton-zk-evm/tree/main/sidecar): dịch vụ mà Canton gọi.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): bước kiểm tra bằng chứng, viết bằng Rust thuần.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): gói Daml, bao gồm `Advance`.
* [network/README.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/network/README.md#running-on-an-existing-participant-the-canton-network): “Chạy trên participant hiện có”.
* [network/external/](https://github.com/rome-protocol/canton-zk-evm/tree/main/network/external): cấu hình participant, sidecar và các tập lệnh thiết lập.
* [Chạy Ostia của riêng bạn](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant): các bước tương tự trong tài liệu này.
* [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md#operator-confirmer-and-gateway-authority): những gì operator và bên xác nhận có thể thấy và thực hiện.

## Đơn vị vận hành trình chứng minh

Prover chuyển mỗi khối thành một bằng chứng để sidecar của bên xác nhận kiểm tra. Bạn chạy ZisK với một worker GPU. Prover DevNet là một NVIDIA RTX PRO 6000 Blackwell Server Edition (96 GB) trên máy có 48 vCPU. Trên DevNet, Rome chạy prover duy nhất đó. Các tập lệnh này dùng để chạy prover cho Ostia của riêng bạn.

**Công cụ bạn cần**

* `install.sh` để cài đặt bản ZisK đã ghim phiên bản cùng các khóa của bản đó.
* `start.sh` để khởi chạy bộ điều phối và worker GPU.
* `prove-one.sh` để tạo bằng chứng cho một đầu vào và xác minh kết quả.
* Guest là chương trình được tạo bằng chứng. Quá trình build của chương trình chạy trong một thư mục cố định, vì vậy bạn có thể kiểm tra xem bản build của mình có tạo ra programVK đã ghi nhận hay không.

**Nơi tìm hiểu**

* [prover/](https://github.com/rome-protocol/canton-zk-evm/tree/main/prover): các tập lệnh ở trên, cùng với `build-guest.sh`.
* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): guest và cách kiểm tra xem bản build của bạn có tạo ra programVK đã ghi nhận hay không.
* [Máy chủ prover Ostia](https://docs.rome.builders/vi/canton-zk-evm/prover-host.md): yêu cầu đối với máy chủ, cách build và chạy, cũng như cách tái tạo khóa guest.
* [Các phép đo](https://docs.rome.builders/vi/canton-zk-evm/measurements.md): thời gian tạo bằng chứng và phần cứng dùng để đo.

## Kiểm toán viên và nhà nghiên cứu

**Công cụ bạn cần**

* Các quy tắc chuỗi được biên dịch vào guest.
* Phần kiểm tra bằng chứng và mã tạo bằng chứng lưu trữ.
* Bản ghi chuỗi Daml và `Advance` lựa chọn.
* Hợp đồng gateway.

**Nơi tìm hiểu**

* [guest/](https://github.com/rome-protocol/canton-zk-evm/tree/main/guest): chương trình được tạo bằng chứng và các quy tắc mà chương trình thực thi.
* [verifier/](https://github.com/rome-protocol/canton-zk-evm/tree/main/verifier): phần kiểm tra bằng chứng được bao bọc.
* [mpt/](https://github.com/rome-protocol/canton-zk-evm/tree/main/mpt): các bằng chứng lưu trữ Merkle-Patricia.
* [daml/](https://github.com/rome-protocol/canton-zk-evm/tree/main/daml): bản ghi chuỗi và `Advance`.
* [gateway/](https://github.com/rome-protocol/canton-zk-evm/tree/main/gateway): hợp đồng EVM duy nhất cho Canton biết một khối cần những gì.
* [Mô hình tin cậy và giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md) và [Những gì được chứng minh và những gì không](https://docs.rome.builders/vi/canton-zk-evm/what-is-proven.md): nội dung được cố định bởi bằng chứng và bên nào kiểm tra nội dung nào.
* [docs/DESIGN.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/docs/DESIGN.md) và [SECURITY.md](https://github.com/rome-protocol/canton-zk-evm/blob/main/SECURITY.md): thiết kế và cách báo cáo riêng tư một vấn đề.

## Tự chạy Ostia

[Tự chạy Ostia](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md) trình bày về các bài kiểm thử, mạng Canton cục bộ có GPU và cách triển khai trên một nút tham gia Canton hiện có.


---

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