> 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/zh/canton-zk-evm/deposits-withdrawals-payments.md).

# 存款、取款和支付

网关如何将 EVM 存款、取款和支付与其在 Canton 侧的对应操作关联起来，以及 ERC-20 双生代币和 Canton Coin 如何双向流转。

网关是一个包含在链创世状态中的 EVM 合约。它记录区块需要 Canton 执行的操作。每个请求都是一条 leg。区块证明会对网关状态作出承诺，其中包括按记录顺序排列的各条 leg 的哈希。

存款、取款和支付功能已在 Ostia DevNet 上线，由 Rome 使用测试参与方运行。这些功能首次在 2026-10-05 的本地演示中运行。2026-10-25，Canton 测试代币 TKB（Splice 随附的参考测试代币）在网关注册，其封装形式 wTKB 已在 Ostia 上部署，地址为 `0x294d3049874526910a69f6b61da14d10a8b1b3af`。自 2026-11-08 起，你可以在浏览器的 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md) 页面自行存入和提取 Canton Coin；请参阅下文的 [DevNet 上线功能](#live-on-devnet) 。

自 2026-10-29 起，网关还支持双向 Canton 资产：ERC-20 可在 Canton 上对应一个孪生资产，而 Canton Coin 也可以转入 Ostia 并转回。请参阅 [Canton 上的 ERC-20 代币孪生资产](#canton-twins-of-erc-20-tokens) 和 [Canton Coin](#canton-coin).

本页大多数链接指向发布版本 `v0.1.0`；网关 README 链接则指向主分支。DevNet 目前运行的是仓库主分支中的代码，使用 Daml 软件包 0.5.0，各条 leg 遵循相同规则。 [状态](https://docs.rome.builders/zh/canton-zk-evm/status.md) 会注明提交版本。关于如何基于这些 leg 进行构建，请参阅 [使用 Canton 构建](https://docs.rome.builders/zh/canton-zk-evm/build-with-canton.md)。请阅读完整的 [网关 README](https://github.com/rome-protocol/canton-zk-evm/blob/main/gateway/README.md) 和 [Daml 接口](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/daml/README.md).

| Leg | 网关调用                             | EVM 操作              | 在 `Advance`               |
| --- | -------------------------------- | ------------------- | ------------------------- |
| 存款  | `claim(id, token, amount)`       | 向调用方铸造封装代币。         | 执行存款人的分配，将资产分配给网关。        |
| 取款  | `withdraw(token, amount, party)` | 销毁调用方的封装代币。         | 将网关托管的 Canton 代币支付给指定参与方。 |
| 支付  | `pay(id, token, to, amount)`     | 将 ERC-20 从付款方转给收款方。 | 执行双方约定的支付条款所指定的分配。        |

## DevNet 上线功能

2026-10-25，存款、支付和取款流程在 DevNet 上运行了两次：

| 运行                                         | 存款                           | 支付                                                                         | 取款                             |
| ------------------------------------------ | ---------------------------- | -------------------------------------------------------------------------- | ------------------------------ |
| 第一次：UTC 时间 08:08 至 08:10                   | 区块 780：存入 10 TKB，转出 10 wTKB。 | 区块 783：V 向 U 支付 1 WtROME（封装 tROME，即 Ostia 上的 ERC-20），以换取 U 将 10 TKB 分配给 V。 | 区块 784：销毁 4 wTKB，向 U 支付 4 TKB。 |
| 第二次：UTC 时间 11:31 至 11:34，使用 Daml 软件包 0.2.0 | 区块 1465。                     | 区块 1471。                                                                   | 区块 1473。                       |

每条链路各自位于一个区块中。在每个区块里，区块记录和持仓变更都属于同一次 Canton 更新。第二次运行后，wTKB 的供应量为 12，任何人都可以在 Ostia 上读取。Rome 的运行检查了网关当时在 Canton 上持有 12 TKB，与该供应量相等。从 2026-10-25 起，浏览器也会显示这一信息：wTKB 的代币页面上有一张“由 Canton 支持”卡片，其中显示托管的 12 TKB，以及供应量 12 wTKB。

U 和 V 是 Rome 创建并在自己的参与方上运行的测试方，所有步骤均由 Rome 执行。你可以在浏览器上查看这些链路：打开 [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) 查看列表，或打开某个区块页面查看其中包含的链路。提款会注明收款的 Canton 方。wTKB 是一种普通的 ERC-20，精度为 10 位小数，因此其供应量和余额的读取方式与其他代币相同（参见 [浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#legs-and-custody)).

Rome 每 10 分钟运行一次存款、付款和提款，每 30 秒监控一次其运行状况。

要自行存入和提取 Canton Coin，请在浏览器的 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md) 页面连接你的 Canton 钱包（在为你的钱包启用该功能后）。桥接页面还会为 Canton 锁定 tROME 和 TKA（网关 `pay` 存入金库）。此页面上的其他付款和 TKB 存款均由 Rome 的测试方执行。

## 存入 Canton 代币

存款方将 Canton 代币分配给网关，并指定运营方为执行方。存款方会签署一份 `DepositRequest` ，其中注明存款 ID、获准领取的 EVM 地址以及分配。存款 ID 是以下内容的 SHA-256 哈希： `deposit,<depositor's party id>,<label>`，因此只有存款方才能根据自己的 party ID 生成 ID。

该 EVM 地址调用 `claim`。网关会向调用者铸造代币并记录存款链路。接收方需要 tROME 支付燃料费。构建器会将该链路与请求、已注册的代币及分配相匹配。

`Advance` 会执行分配，将代币转入网关托管，并提交铸造了包装代币的区块。包装代币有 10 位小数，与 Canton 金额精度一致。两种金额之间可精确换算，不会产生舍入。

## 提取至 Canton 方

持有者使用包装代币、金额和完整 Canton party ID 调用 `withdraw` 。网关会销毁包装代币，并在链路中记录接收方。

接收方必须已签署 `WithdrawalAcceptance`。该签署在归档前一直有效。构建器还需要有足够的已注册资产未锁定网关持仓。如果不满足这些条件，构建器就不会纳入该交易。

`Advance` 会通过代币注册表的转账工厂向接收方付款。Canton 转账与包含销毁操作的区块会一同提交。如 [构建器 README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## 将付款绑定至一项分配

Canton 付款方将 Canton 代币分配给 Canton 收款方。双方共同签署 `DvpTerms` ，其中注明分配、付款 ID、EVM 代币、EVM 收款方和金额。付款 ID 是以下 UTF-8 文本的 SHA-256 哈希： `<Canton payer's party id>,<Canton payee's party id>,<label>`，并以小写十六进制形式表示。条款会拒绝任何其他 ID。

EVM 付款方授权网关后调用 `pay` ，并提供约定的 ID、代币、收款方和金额。网关会将 ERC-20 从该付款方转给 EVM 收款方，并记录付款链路。在演示中，付款方由 Canton 收款方控制；但协议并不要求这种关系。 `Advance` 会使用已签署的条款，将分配从 Canton 付款方执行至 Canton 收款方。ERC-20 付款与 Canton 付款会一同提交，因此任何一方都不能在另一方尚未完成时单独生效。

普通的 ERC-20 转账不会记录链路。即使在同一区块中向同一收款方转账相同代币，也不能替代 `pay`。 [设计中的付款流程](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/docs/DESIGN.md#the-flows) 对此绑定机制作了说明。

## ERC-20 代币在 Canton 上的孪生代币

孪生代币是 ERC-20 代币在 Canton 上的对应形式，而 ERC-20 代币运行于 Ostia。它是一种 CIP-0056 代币（Canton 代币标准），其资产 ID 为 `erc20:<token address>`，并通过代币标准规定的转账，在参与方已审核 ostia-twin 的各方之间流转。目前，这意味着罗马网络参与方的账户。每个 twin 都与金库持有的 ERC-20 代币一一对应。TKA 和 WtROME（封装的 tROME）在 DevNet 上都有对应的 twin。

**锁定。** 您通过普通的网关 `pay`将 ERC-20 代币存入金库，并指定应持有 twin 的 Canton party。存入前，您要向 twin 注册服务提供接收方和一个由您自行选择的 `ref` ；服务会返回锁定 ID，即 `lock,<receiver>,<ref>`的 SHA-256 哈希。该区块会将这笔存款记入金库，并在同一笔 Canton 交易中向接收方铸造等量的 twin。此后，twin 的供应量便与金库持有量相等。

**赎回。** 持有者在 Canton 上签署赎回请求，然后在金库上调用 `release` ，并使用相同的 `ref`。金库会将 ERC-20 代币支付到请求中指定的 EVM 地址，并在同一区块中销毁 twin。Canton 仅会根据匹配的赎回请求结算释放操作。

根据链的规则，只有在 `Advance`中，且有已注册金库的存款证明时，才会铸造 twin；目前，twin 的管理员——网关 party——也可以自行铸造和销毁 twin。 [信任模型与限制](https://docs.rome.builders/zh/canton-zk-evm/trust-model.md#what-the-twins-trust) 说明了其依据。

| 步骤 | 执行位置                          | 在 `Advance`  |
| -- | ----------------------------- | ------------ |
| 锁定 | 网关 `pay` 将代币存入金库。             | 向接收方铸造 twin。 |
| 赎回 | `release` 在金库上调用，并附上持有者签署的请求。 | 销毁持有者的 twin。 |

2026-10-29，一笔面向 Canton party 的 5 TKA 锁定操作被纳入区块 28389，该 party 持有了 5 个 twin。随后，该 party 将 2 个 twin 转给 Canton 上的另一个 party，这 2 个 twin 的赎回操作被纳入区块 28392。此后，twin 的供应量和金库余额均为 3。浏览器的 [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) 页面会并列显示每个 twin 的供应量和金库余额（参见 [浏览器](https://docs.rome.builders/zh/canton-zk-evm/explorer.md#twins-and-canton-assets)).

锁定操作只会针对已接受 twin 的接收方创建。party 通过签名声明接受 twin，构建器也只会为已接受 twin 的 party 创建锁定操作。在 [桥接](https://docs.rome.builders/zh/canton-zk-evm/bridge.md) 页面连接 Canton 钱包时，钱包会在选择加入过程中签署该接受声明，因此您可以使用自己的 party 完成整个流程。

## Canton Coin

Canton Coin 与其他 Canton 代币一样，通过同一网关存款流程进入 Ostia。封装代币 CC（`0x4db3dea7c13116961fd3e438542ccfcca61a7547`，10 位小数；早期记录中称为 wCC）已在验证器扫描代理指定的工厂中注册。某个 party 将 Canton Coin 分配给网关并签署带标签的存款请求，接收方随后在 Ostia 上领取 CC；提现时则会返还 Canton Coin。Canton Coin 还需要一个额外输入——由扫描代理提供的选择上下文；构建器会在验证区块前获取该上下文。

2026-10-29，某个 party 通过区块 28473 存入 5 个 Canton Coin，此后其持有量为 15，网关持有量为 5，CC 供应量为 5。区块 28474 中的提现操作将这三项数值全部恢复：分别为 20、0 和 0。DevNet 对这些转账不收取费用。

## 证明所确保的内容

每条腿都会记录其类型、ID、代币、账户、金额，以及（如适用）Canton party。网关会按顺序对各条腿进行哈希处理。 `Advance` 会检查所附的各条腿是否生成了已证明网关状态中的哈希值。缺少、增加、重排或更改任何一条腿都会导致交易失败。即使区块不包含任何腿，此检查仍会执行。

区块证明不会锁定 Canton 分配。发送方仍可在结算前收回该分配。如果在证明后发生这种情况，Canton 会拒绝 `Advance` 并且 reth 会回退到最后一个已提交区块。已证明的区块不能在移除其 leg 后再次提交。正如 [运行 4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## 代币与托管限制

Canton 代币由谁持有，以及网关不涵盖哪些代币行为，详见 [信任模型与限制](https://docs.rome.builders/zh/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/zh/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.
