> 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/build-with-canton.md).

# Xây dựng với Canton

Những gì bạn có thể nhắm tới trên Ostia ngoài các hợp đồng EVM thuần túy, các thành phần Canton mà bạn có thể xây dựng với chúng, và những gì bạn có thể tự làm trên DevNet hôm nay và những gì Rome vận hành.

Ostia chạy các hợp đồng EVM thông thường, đồng thời kết nối với Canton. Các yêu cầu gửi đến Canton trong một block được gọi là các leg và được commit trong cùng một giao dịch Canton với block đó. Trang này liệt kê những gì bạn có thể nhắm đến, các thành phần phía sau mỗi mục tiêu và hiện nay ai có thể thực hiện việc đó trên DevNet.

Mã nguồn của mọi thành phần đều có trong kho lưu trữ mở, [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm), theo Giấy phép Apache 2.0.

| Mục tiêu                                                                     | Là gì                                                                           | Hiện có thể làm gì trên DevNet                                                                                                                                                                                             |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Hợp đồng EVM](#evm-contracts)                                               | Ứng dụng Solidity, được triển khai bằng các công cụ bạn dùng trên Ethereum.     | Bạn tự thực hiện.                                                                                                                                                                                                          |
| [Canton Coin trong hợp đồng của bạn](#canton-coin-in-your-contracts)         | Canton Coin dưới dạng CC ERC-20.                                                | Bạn tự thực hiện, với [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md).                                                                                                                                     |
| [Một token EVM trên Canton dưới dạng bản song sinh](#erc-20-twins-on-canton) | Một ERC-20 có bản song sinh là token CIP-0056.                                  | Rome vận hành tính năng này với WtROME (từ tROME) và TKA. Khi ví được kích hoạt, Bridge sẽ chuyển chúng cho ví Canton. Hiện chưa có ví Canton bên ngoài nào nắm giữ token song sinh. Rome đăng ký các token song sinh mới. |
| [Thanh toán với các bên Canton](#payments-with-canton-parties)               | Khoản thanh toán ERC-20 thực hiện một lệnh phân bổ Canton trong cùng giao dịch. | Rome vận hành tính năng này với các bên thử nghiệm; bạn không thể tự chạy tính năng này trên DevNet.                                                                                                                       |
| [Một sàn giao dịch Canton](#a-canton-venue)                                  | Ứng dụng Daml hoán đổi token Canton lấy ERC-20.                                 | Rome vận hành sàn giao dịch; sàn đã chạy một lần. Bạn không thể vận hành sàn trên DevNet.                                                                                                                                  |
| [Mạng riêng của bạn](#your-own-network)                                      | Toàn bộ ngăn xếp trên mạng Canton cục bộ.                                       | Bạn tự thực hiện tất cả.                                                                                                                                                                                                   |

## Hợp đồng EVM

Triển khai bằng Foundry hoặc Hardhat, xác minh mã nguồn trong trình khám phá và kết nối bằng viem hoặc ethers. [Xây dựng trên Ostia](https://docs.rome.builders/vi/canton-zk-evm/build-on-ostia.md) có hướng dẫn từng bước và [Ostia DevNet](https://docs.rome.builders/vi/canton-zk-evm/devnet.md#limits) nêu rõ các giới hạn. ERC-20, ERC-721, ERC-1155, token được cấp quyền ERC-3643, Uniswap V2 và các hợp đồng kiểm tra bằng chứng TACEO Merces đều đã chạy trên Ostia. Một ứng dụng sử dụng dữ liệu giá RedStone đã được triển khai và xác minh.

## Canton Coin trong hợp đồng của bạn

Canton Coin trên Ostia là ERC-20 thông thường có 10 chữ số thập phân, tại `0x4db3dea7c13116961fd3e438542ccfcca61a7547`. Bất kỳ hợp đồng nào cũng có thể nắm giữ và chuyển token này. Tài sản lưu ký trên Canton của gateway bảo chứng token theo tỷ lệ một-một, và trình khám phá hiển thị cả hai cạnh nhau trên [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) và trong `GET /api/twins`.

Bạn nhận CC bằng cách nạp Canton Coin trên trang [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) và nhận lại Canton Coin bằng cách rút token. Trang này cấp 20 Canton Coin thử nghiệm mỗi ngày.

## Token ERC-20 song sinh trên Canton

Bạn nạp ERC-20 vào kho lưu ký và một bên Canton nắm giữ lượng tương đương của token song sinh. Token song sinh là token CIP-0056 có mã định danh công cụ `erc20:<token address>`. Khi quy đổi, token song sinh bị đốt và ERC-20 được gửi lại đến một địa chỉ Ostia.

**Ai đang nắm giữ token song sinh hiện nay.** Token song sinh triển khai CIP-0056, nhưng điều đó không có nghĩa chúng sẽ xuất hiện trong mọi ví Canton. Một bên chỉ có thể nắm giữ token song sinh khi mọi validator lưu trữ token đó đã thẩm định `ostia-twin` phiên bản 0.1.0 và 0.2.0; bên nhận khóa cũng phải ký một lần `TwinAcceptance`. Hiện chỉ các bên do Rome vận hành đáp ứng điều kiện này. Chưa có ví Canton bên ngoài nào nắm giữ hoặc gửi token song sinh.

**Kết nối ví Canton của riêng bạn: đã được xây dựng, nhưng chưa bật.** Trang Bridge kết nối với ví Canton bạn đang có; tài khoản Bridge được tạo bằng chữ ký ví đã ngừng hoạt động vào ngày 2026-11-17. Tính năng kết nối được bật riêng cho từng ví, không có ngày ấn định. Việc này phụ thuộc vào ba yếu tố do nhà phát triển ví và các validator quyết định: họ xem xét gói Daml của bên thứ ba trước khi cho phép ví sử dụng; một số quy tắc của họ chặn tên gói bắt đầu bằng `canton-` (gói trên chuỗi của chúng tôi có tên là `canton-zk-evm`), và các validator lưu trữ các party của ví phải có các gói của Ostia. Cho đến lúc đó, ví Canton bên ngoài không thể thực hiện giao dịch nào trên Bridge. Trên DevNet, các token song sinh là TKA và WtROME, còn vault ở địa chỉ `0x69f13a94f986021f1a7650eb611bf9b717aa495a`.

Dịch vụ sổ đăng ký token song sinh phản hồi tại `https://ostia.devnet.romeprotocol.xyz/twin-registry` (ví dụ: `GET /twin-registry/healthz`). Dịch vụ này không lưu giữ khóa.

| Gọi                                                                             | Thông tin trả về                                                                                                                                                                            |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /healthz`                                                                  | Các token song sinh và vault.                                                                                                                                                               |
| `GET /twin/v1/twins`                                                            | Token, mã định danh công cụ và các vault của từng token song sinh.                                                                                                                          |
| `GET /registry/...`                                                             | API registry của tiêu chuẩn token: siêu dữ liệu của token song sinh cùng các factory chuyển nhượng và phân bổ, để ví có validator đã thẩm định gói của token song sinh có thể gửi token đó. |
| `POST /twin/v1/lock-parts` với `{"receiver": <Canton party id>, "ref": <text>}` | Mã khóa và các vault đã đăng ký để bên trả tiền sử dụng khi khóa.                                                                                                                           |

Bên nhận của một lệnh khóa ký `TwinAcceptance` một lần. Nếu không có chữ ký này, registry trả về mã 409 và trình tạo loại lệnh khóa khỏi block trước khi chứng minh, nên ERC-20 vẫn thuộc về bên trả tiền. Ví Canton mà bạn kết nối với trang Bridge ký chấp thuận trong quá trình chọn tham gia. Bên trả tiền tự kiểm tra mã khóa, giá trị SHA-256 của `lock,<receiver>,<ref>`, và lấy địa chỉ vault từ một nguồn đáng tin cậy.

Bạn có thể kiểm tra xem vault có phải là bản dựng đã được thẩm định hay không. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` cho kết quả `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`, đây cũng là hàm băm mã mà `GET /api/twins` trả về.

Hiện tại, trên DevNet chỉ Rome đăng ký token song sinh và vault. Để đề nghị tạo token song sinh từ ERC-20 của riêng bạn, hãy mở issue trong [kho lưu trữ](https://github.com/rome-protocol/canton-zk-evm/issues) hoặc hỏi trong [Discord](https://discord.gg/vZ9rnCdNSB)của Rome; Rome sẽ xem xét từng trường hợp.

## Thanh toán với các bên Canton

Bên trả tiền trên EVM gọi `pay`. Bên trả tiền và bên nhận trên Canton đã ký `DvpTerms` để chỉ rõ giao dịch phân bổ, mã thanh toán, token EVM, bên nhận trên EVM và số tiền. Trong một giao dịch Canton, block được cam kết và việc phân bổ được thực thi, vì vậy không bên nào được xem là hoàn tất nếu thiếu bên kia. Việc này đã chạy trên DevNet trong các block 783 và 1471. [Các quy tắc về nạp tiền, rút tiền và thanh toán](https://docs.rome.builders/vi/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) được trình bày tại đây.

Trên DevNet, các party thử nghiệm của Rome thực hiện những khoản thanh toán này. Trang Bridge không thực hiện chúng: trang này xử lý bốn bước chuyển giao của bridge. Để thực hiện các khoản thanh toán gắn với một giao dịch phân bổ giữa các party Canton của riêng bạn, hãy chạy mạng của riêng bạn (bên dưới).

## Một sàn giao dịch Canton

Venue là một ứng dụng Daml thực hiện giao dịch giữa người bán trên Canton và người mua trên EVM. Các thành phần:

* `otc-venue` 0.1.0, trong [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc), chứa `TradeOffer` và `Trade`. Gói này chỉ phụ thuộc vào tiêu chuẩn token, CIP-0056, và không chỉ định chuỗi, nên bất kỳ venue nào cũng có thể sử dụng. Giao diện `Trade` hiển thị cho người bán yêu cầu phân bổ trong một ví tiêu chuẩn.
* Gói Daml của chuỗi (phiên bản 0.4.0 trở lên, ghim phiên bản 0.5.0) chứa `VenueTrade` và `FundedClaim`. Venue và người bán ký `VenueTrade` cho mỗi giao dịch.
* Người mua thanh toán qua gateway. Việc phân bổ của người bán được thực thi trong cùng một giao dịch Canton với khoản thanh toán, sau đó người mua nhận token bọc bằng một `FundedClaim`.

Sự kiện này diễn ra trên DevNet vào ngày 2026-10-27 lúc 15:55 UTC: token Canton TKB được đổi lấy TKA ERC-20. Khoản thanh toán của người mua nằm trong khối 16816, trong một bản cập nhật Canton, còn yêu cầu nhận token của người mua nằm trong khối 16823. Một khoản thanh toán thấp hơn số tiền giao dịch đã bị loại khỏi khối 16834 và không chuyển được gì. Trình khám phá liệt kê các giao dịch hoán đổi tại [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps), còn `GET /api/swaps` trả về các giao dịch đó.

Trên DevNet, builder được khởi chạy bằng party của venue, vì vậy Rome bổ sung một venue. Các lệnh chạy giao dịch hoán đổi nằm trong bản demo của kho mã nguồn, dùng cho mạng cục bộ hoặc môi trường bạn tự chạy. Bước để người bán đề xuất giao dịch được lên kế hoạch trước khi triển khai mainnet.

## Mạng riêng của bạn

[Tự chạy Ostia](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md) khởi chạy một mạng Canton cục bộ và toàn bộ stack: chuỗi, prover hoặc thành phần thay thế, gateway và trình khám phá. Trên đó, bạn tự chạy mọi thành phần nêu trên, ngoại trừ Canton Coin, vốn cần một validator của Canton Network; để chạy Canton Coin, hãy chạy Ostia trên participant của validator riêng (xem [Tự chạy Ostia](https://docs.rome.builders/vi/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)). Bạn sử dụng các party và venue của riêng mình.

Ứng dụng Daml chỉ thấy các leg mà nó ký. Mọi người đều có thể đọc mọi leg thông qua `GET /api/legs` trên trình khám phá.

## Tiếp theo nên xem gì

* [Trường hợp sử dụng](https://docs.rome.builders/vi/canton-zk-evm/use-cases.md): những gì các thành phần này cho phép thực hiện ngay hôm nay.
* [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md): trang web trên trình duyệt dành cho bốn thao tác và gửi tài sản trên Canton.
* [Cách thức hoạt động](https://docs.rome.builders/vi/canton-zk-evm/how-it-works.md): một khối từ giao dịch đến khi Canton xác nhậ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/build-with-canton.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.
