> 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/deposits-withdrawals-payments.md).

# Nạp tiền, rút tiền và thanh toán

Cách cổng liên kết các khoản nạp, rút và thanh toán EVM với phần tương ứng trên Canton của chúng, và cách các bản sao ERC-20 cùng Canton Coin di chuyển theo cả hai chiều.

Gateway là một hợp đồng EVM được đưa vào genesis của chuỗi. Nó ghi lại những việc Canton cần thực hiện cho một block. Mỗi yêu cầu là một leg. Bằng chứng của block cam kết trạng thái của gateway, bao gồm hàm băm của các leg theo thứ tự chúng được ghi lại.

Nạp, rút và thanh toán đang hoạt động trên Ostia DevNet, do Rome vận hành cùng các bên thử nghiệm. Chúng được chạy lần đầu trong bản demo cục bộ ngày 2026-10-05. Ngày 2026-10-25, một token thử nghiệm của Canton, TKB (token thử nghiệm tham chiếu do Splice cung cấp), được đăng ký với gateway; dạng bọc của token này, wTKB, tồn tại trên Ostia tại `0x294d3049874526910a69f6b61da14d10a8b1b3af`. Kể từ 2026-11-08, bạn có thể tự nạp và rút Canton Coin từ trang [Bridge](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) của trình khám phá; xem [Đang hoạt động trên DevNet](#live-on-devnet) bên dưới.

Kể từ 2026-10-29, gateway cũng hỗ trợ tài sản Canton hai chiều: ERC-20 có thể có một bản thể song sinh trên Canton, còn Canton Coin có thể chuyển sang Ostia rồi quay trở lại. Xem [Bản thể song sinh trên Canton của token ERC-20](#canton-twins-of-erc-20-tokens) và [Canton Coin](#canton-coin).

Hầu hết liên kết trên trang này trỏ đến bản phát hành `v0.1.0`; liên kết đến README của gateway trỏ đến nhánh main. DevNet hiện chạy mã từ nhánh main của kho lưu trữ, với gói Daml 0.5.0; các leg tuân theo cùng quy tắc. [Trạng thái](https://docs.rome.builders/vi/canton-zk-evm/status.md) cho biết commit. Để biết bạn có thể xây dựng những gì trên các leg, xem [Xây dựng với Canton](https://docs.rome.builders/vi/canton-zk-evm/build-with-canton.md). Đọc toàn bộ [README của gateway](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md) và [giao diện Daml](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md).

| Leg        | Lệnh gọi gateway                 | Thao tác EVM                                      | Thao tác Canton trong `Advance`                                                |
| ---------- | -------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------ |
| Nạp tiền   | `claim(id, token, amount)`       | Đúc token bọc cho bên gọi.                        | Thực hiện phân bổ của bên nạp tiền cho gateway.                                |
| Rút tiền   | `withdraw(token, amount, party)` | Đốt token bọc của bên gọi.                        | Chuyển token Canton từ tài sản lưu ký của gateway cho bên được chỉ định.       |
| Thanh toán | `pay(id, token, to, amount)`     | Chuyển ERC-20 từ bên trả tiền sang bên nhận tiền. | Thực hiện phân bổ được chỉ định trong các điều khoản thanh toán đã thống nhất. |

## Đang hoạt động trên DevNet

Một giao dịch nạp, một giao dịch thanh toán và một giao dịch rút đã được chạy hai lần trên DevNet vào ngày 2026-10-25:

| Lần chạy                                                | Nạp tiền                             | Thanh toán                                                                                                      | Rút tiền                                |
| ------------------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Lần đầu, từ 08:08 đến 08:10 UTC                         | Block 780: nạp 10 TKB, nhận 10 wTKB. | Block 783: V trả cho U 1 WtROME (tROME dạng bọc, một ERC-20 trên Ostia) để đổi lấy việc U phân bổ 10 TKB cho V. | Block 784: đốt 4 wTKB, trả 4 TKB cho U. |
| Lần thứ hai, từ 11:31 đến 11:34 UTC, với gói Daml 0.2.0 | Block 1465.                          | Block 1471.                                                                                                     | Block 1473.                             |

Mỗi leg nằm trong một block riêng. Trong mỗi block, bản ghi leg và thay đổi đối với số dư nắm giữ được thực hiện trong cùng một bản cập nhật Canton. Sau lần chạy thứ hai, nguồn cung wTKB là 12; bất kỳ ai cũng có thể đọc thông tin này trên Ostia. Lần chạy của Rome xác nhận rằng khi đó gateway nắm giữ 12 TKB trên Canton, bằng với nguồn cung ấy. Kể từ 2026-10-25, trình khám phá cũng hiển thị thông tin này: trang token wTKB có thẻ "Được bảo chứng trên Canton", cho biết lượng lưu ký là 12 TKB bên cạnh nguồn cung 12 wTKB.

U và V là các bên thử nghiệm do Rome tạo và vận hành trên participant của mình; Rome đã thực hiện mọi bước. Bạn có thể theo dõi các leg trên trình khám phá: mở [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) để xem danh sách, hoặc mở trang của một block để xem các leg trong block đó. Một giao dịch rút tiền nêu rõ bên Canton được thanh toán. wTKB là token ERC-20 thông thường có 10 chữ số thập phân, vì vậy nguồn cung và số dư của nó được hiển thị như của mọi token khác (xem [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#legs-and-custody)).

Rome thực hiện một giao dịch nạp tiền, một khoản thanh toán và một giao dịch rút tiền mỗi 10 phút; tình trạng hoạt động của chúng được kiểm tra mỗi 30 giây.

Để tự nạp và rút Canton Coin, hãy kết nối ví Canton của bạn trên trang [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) của trình khám phá, sau khi tính năng này được bật cho ví của bạn. Trang Cầu nối cũng khóa tROME và TKA cho Canton (gateway `pay` vào vault). Các khoản thanh toán khác và giao dịch nạp TKB trên trang này do các bên thử nghiệm của Rome thực hiện.

## Nạp một token Canton

Bên nạp phân bổ một token Canton cho gateway, với operator làm bên thực thi. Bên nạp ký `DepositRequest` có ghi mã định danh khoản nạp, địa chỉ EVM được phép nhận và allocation. Mã định danh khoản nạp là giá trị SHA-256 của `deposit,<depositor's party id>,<label>`, vì vậy chỉ bên nạp mới có thể tạo mã định danh từ party của chính mình.

Địa chỉ EVM đó gọi `claim`. Gateway mint token cho bên gọi và ghi lại leg nạp tiền. Bên nhận cần có tROME để trả phí gas. Builder đối chiếu leg với yêu cầu, token đã đăng ký và allocation.

`Advance` thực thi allocation vào phần lưu ký của gateway và commit block đã mint các token được bọc. Token được bọc có 10 chữ số thập phân, tương ứng với số lượng trên Canton. Việc chuyển đổi giữa hai số lượng là chính xác, không làm tròn.

## Rút tiền về một bên Canton

Bên nắm giữ gọi `withdraw` với token được bọc, số lượng và party id Canton đầy đủ. Gateway burn các token được bọc và ghi lại bên nhận trong leg.

Bên nhận phải ký `WithdrawalAcceptance`. Chữ ký này có hiệu lực cho đến khi được lưu trữ. Builder cũng cần có đủ số dư nắm giữ đã mở khóa của công cụ đã đăng ký tại gateway. Nếu không đáp ứng các điều kiện này, giao dịch sẽ không được đưa vào.

`Advance` thanh toán cho bên nhận thông qua transfer factory của token registry. Giao dịch chuyển token trên Canton và block chứa thao tác burn được commit cùng nhau. Builder đưa vào mỗi block tối đa một giao dịch rút tiền cho mỗi công cụ, như mô tả trong [README của builder](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## Gắn khoản thanh toán với một allocation

Bên trả tiền trên Canton phân bổ một token Canton cho bên nhận tiền trên Canton. Hai bên ký `DvpTerms` có ghi allocation, mã định danh khoản thanh toán, token EVM, bên nhận trên EVM và số lượng. Mã định danh khoản thanh toán là giá trị SHA-256 của văn bản UTF-8 `<Canton payer's party id>,<Canton payee's party id>,<label>`, được biểu diễn bằng hex chữ thường. Các điều khoản sẽ từ chối mọi mã định danh khác.

Bên trả tiền trên EVM cấp quyền cho gateway rồi gọi `pay` với mã định danh, token, bên nhận và số lượng đã thỏa thuận. Gateway chuyển ERC-20 từ bên trả tiền đó đến bên nhận trên EVM và ghi lại leg thanh toán. Trong bản demo, bên trả tiền do bên nhận trên Canton kiểm soát; giao thức không yêu cầu mối quan hệ này. `Advance` dùng các điều khoản đã ký để thực thi allocation từ bên trả tiền trên Canton đến bên nhận tiền trên Canton. Khoản thanh toán ERC-20 và khoản thanh toán trên Canton được commit cùng nhau, vì vậy không khoản nào có hiệu lực cuối cùng nếu thiếu khoản kia.

Một giao dịch chuyển ERC-20 thông thường không ghi lại leg. Ngay cả giao dịch chuyển cùng token đến cùng bên nhận trong cùng block cũng không thể thay thế `pay`. [Luồng thanh toán trong thiết kế](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#the-flows) giải thích cách ràng buộc này hoạt động.

## Các token ERC-20 tương ứng trên Canton

Token tương ứng là dạng Canton của một token ERC-20 tồn tại trên Ostia. Đây là token CIP-0056, tiêu chuẩn token của Canton, có mã định danh công cụ `erc20:<token address>`, và nó di chuyển theo tiêu chuẩn token thông qua giao dịch chuyển giữa các bên tham gia đã thẩm định ostia-twin, hiện nay nghĩa là các tài khoản của những bên tham gia Rome. Mỗi twin tương ứng một-một với ERC-20 mà vault nắm giữ. TKA và WtROME (tROME được bọc) có twin trên DevNet.

**Khóa.** Bạn chuyển ERC-20 vào vault bằng một gateway thông thường `pay`, đồng thời chỉ định bên Canton sẽ nắm giữ twin. Trước khi thanh toán, bạn cung cấp cho dịch vụ đăng ký twin bên nhận và một `ref` do bạn chọn; dịch vụ trả về mã khóa, là giá trị SHA-256 của `lock,<receiver>,<ref>`. Khối ghi nhận khoản thanh toán vào vault và, trong cùng một giao dịch Canton, đúc lượng twin tương ứng cho bên nhận. Sau đó, tổng nguồn cung twin bằng lượng token vault nắm giữ.

**Đổi.** Bên nắm giữ ký một yêu cầu đổi trên Canton, sau đó `release` được gọi trên vault với cùng `ref`. Vault chuyển ERC-20 đến địa chỉ EVM trong yêu cầu, đồng thời twin bị đốt trong cùng khối. Canton chỉ quyết toán lệnh giải ngân khi có yêu cầu đổi tương ứng.

Theo quy tắc của chuỗi, twin chỉ được đúc trong `Advance`, dựa trên bằng chứng về khoản thanh toán vào vault đã đăng ký; hiện nay, quản trị viên của twin—bên gateway—cũng có thể tự đúc và đốt. [Mô hình tin cậy và các giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.md#what-the-twins-trust) nêu rõ cơ sở của mô hình đó.

| Bước | Nơi thực hiện                                                     | Thao tác Canton trong `Advance` |
| ---- | ----------------------------------------------------------------- | ------------------------------- |
| Khóa | Một gateway `pay` vào vault.                                      | Đúc twin cho bên nhận.          |
| Đổi  | `release` trên vault, dựa trên yêu cầu có chữ ký của bên nắm giữ. | Đốt twin của bên nắm giữ.       |

Vào ngày 2026-10-29, một lệnh khóa 5 TKA cho một bên Canton được ghi vào khối 28389 và bên đó nắm giữ 5 twin. Bên này chuyển 2 twin cho một bên thứ hai trên Canton, và lệnh đổi 2 twin đó được ghi vào khối 28392. Sau đó, tổng nguồn cung twin và số dư của vault đều là 3. Trang [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) trên trình khám phá hiển thị tổng nguồn cung của từng twin bên cạnh số dư của vault (xem [Trình khám phá](https://docs.rome.builders/vi/canton-zk-evm/explorer.md#twins-and-canton-assets)).

Chỉ có thể tạo lệnh khóa cho bên nhận đã chấp thuận nhận twin. Một bên ký xác nhận chấp thuận một lần, và builder chỉ tạo lệnh khóa cho bên đã chấp thuận. Khi kết nối ví Canton trên trang [Cầu nối](https://docs.rome.builders/vi/canton-zk-evm/bridge.md) , bạn ký xác nhận chấp thuận đó trong bước tự nguyện tham gia; nhờ vậy, bạn có thể tự thực hiện toàn bộ quy trình với một bên của mình.

## Canton Coin

Canton Coin được đưa lên Ostia qua cùng quy trình nạp gateway như mọi token Canton khác. Token bọc CC (`0x4db3dea7c13116961fd3e438542ccfcca61a7547`, 10 chữ số thập phân; các bản ghi trước đây gọi token này là wCC) được đăng ký với factory do scan proxy của validator chỉ định. Một bên phân bổ Canton Coin cho gateway rồi ký yêu cầu nạp có nhãn; bên nhận nhận CC trên Ostia, và khi rút, Canton Coin được chuyển trả lại. Canton Coin cần thêm một đầu vào là ngữ cảnh lựa chọn do scan proxy cung cấp; builder lấy dữ liệu này trước khi xác minh khối.

Vào ngày 2026-10-29, một bên nạp 5 Canton Coin qua khối 28473, khiến số dư của bên đó là 15, gateway nắm giữ 5 và tổng nguồn cung CC là 5. Lệnh rút trong khối 28474 đưa cả ba giá trị về mức ban đầu: 20, 0 và 0. DevNet không tính phí cho các giao dịch chuyển này.

## Bằng chứng ràng buộc những gì

Mỗi lượt ghi lại loại, mã định danh, token, tài khoản, số lượng và bên Canton nếu có. Gateway băm các lượt theo thứ tự. `Advance` kiểm tra xem các lượt đính kèm có tạo ra giá trị băm trong trạng thái gateway đã được chứng minh hay không. Giao dịch sẽ thất bại nếu thiếu, thừa, sai thứ tự hoặc bị thay đổi bất kỳ lượt nào. Việc kiểm tra cũng áp dụng cho các khối không có lượt nào.

Việc chứng minh khối không giữ chỗ phân bổ Canton của khối đó. Người gửi vẫn có thể lấy lại phần phân bổ trước khi quyết toán. Nếu việc đó xảy ra sau khi chứng minh, Canton sẽ từ chối `Advance` và reth quay về khối đã được xác nhận gần nhất. Không thể gửi lại khối đã được chứng minh đó khi đã bỏ phần leg của nó. Bản dựng tiếp theo sẽ không bao gồm khoản thanh toán, như được minh họa trong [lần chạy 4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## Giới hạn về token và lưu ký

Ai nắm giữ token Canton và những hành vi nào của token không được cổng hỗ trợ được trình bày trong [Mô hình tin cậy và các giới hạn](https://docs.rome.builders/vi/canton-zk-evm/trust-model.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/vi/canton-zk-evm/deposits-withdrawals-payments.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.
