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

# 入金、出金、および支払い

ゲートウェイが、EVMの入金・出金・支払いをそれぞれのCanton側の処理に結び付ける仕組みと、ERC-20の双子トークンおよびCanton Coinが双方向に移動する仕組み。

ゲートウェイは、チェーンのジェネシスに含まれるEVMコントラクトです。ブロックがCantonに実行させる処理を記録します。各リクエストは1つのレッグです。ブロックの証明は、記録された順序でのレッグのハッシュを含むゲートウェイの状態をコミットします。

入金、出金、支払いは、テスト用パーティーとともにRomeが運用するOstia DevNetで稼働しています。これらは2026-10-05のローカルデモで初めて実行されました。2026-10-25には、CantonのテストトークンであるTKB（Spliceが同梱する標準テストトークン）がゲートウェイに登録され、そのラップトークンwTKBがOstia上に存在します。 `0x294d3049874526910a69f6b61da14d10a8b1b3af`2026-11-08以降、エクスプローラーの [ブリッジ](https://docs.rome.builders/ja/canton-zk-evm/bridge.md) ページから、Canton Coinを自分で入金・出金できます。詳しくは以下の [DevNetで稼働中](#live-on-devnet) をご覧ください。

2026-10-29以降、ゲートウェイではCanton資産の双方向移転も可能です。ERC-20をCanton上のツインとして扱うことができ、Canton CoinをOstiaに移して戻すこともできます。詳しくは、 [ERC-20トークンのCantonツイン](#canton-twins-of-erc-20-tokens) と [Canton Coin](#canton-coin).

このページのリンクのほとんどはリリース版 `v0.1.0`を参照しています。ゲートウェイのREADMEへのリンクはmainブランチを参照しています。DevNetでは現在、リポジトリのmainブランチのコードがDamlパッケージ0.5.0とともに稼働しており、レッグにも同じルールが適用されます。 [ステータス](https://docs.rome.builders/ja/canton-zk-evm/status.md) にはコミットが記載されています。レッグを使って構築できるものについては、 [Cantonで構築する](https://docs.rome.builders/ja/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).

| レッグ | ゲートウェイ呼び出し                       | EVMでの処理                | でのCanton処理 `Advance`                     |
| --- | -------------------------------- | ---------------------- | ---------------------------------------- |
| 入金  | `claim(id, token, amount)`       | 呼び出し元にラップトークンをミントします。  | 入金者のゲートウェイへの割り当てを実行します。                  |
| 出金  | `withdraw(token, amount, party)` | 呼び出し元のラップトークンをバーンします。  | ゲートウェイが保管するCantonトークンを、指定されたパーティーに支払います。 |
| 支払い | `pay(id, token, to, amount)`     | ERC-20を支払人から受取人に送金します。 | 合意済みの支払い条件で指定された割り当てを実行します。              |

## DevNetで稼働中

2026-10-25に、DevNetで入金、支払い、出金が2回実行されました。

| 実行                                    | 入金                             | 支払い                                                                         | 出金                               |
| ------------------------------------- | ------------------------------ | --------------------------------------------------------------------------- | -------------------------------- |
| 1回目、08:08～08:10 UTC                   | ブロック780：10 TKBを入金し、10 wTKBを出金。 | ブロック783：VがUに1 WtROME（ラップされたtROME。Ostia上のERC-20）を支払い、その対価としてUがVに10 TKBを割り当て。 | ブロック784：4 wTKBをバーンし、4 TKBをUに支払い。 |
| 2回目、11:31～11:34 UTC、Damlパッケージ0.2.0で実行 | ブロック1465。                      | ブロック1471。                                                                   | ブロック1473。                        |

各レッグはそれぞれ独立したブロックに含まれていました。どちらのブロックでも、ブロック記録と保有残高の変更は1つのCanton更新として行われました。2回目の実行後、wTKBの供給量は12となり、誰でもOstia上で確認できます。Romeの実行では、ゲートウェイがCanton上で12 TKBを保有していることも確認しました。これは供給量と一致します。2026-10-25以降、エクスプローラーでもこの内容を確認できます。wTKBのトークンページには「Backed on Canton」カードが表示され、供給量12 wTKBに対して、カストディ残高として12 TKBが示されます。

UとVは、Romeが作成して自身の参加者上で実行するテスト用パーティで、すべての手順をRomeが実行しました。エクスプローラーで各レッグを確認できます。一覧を見るには [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) を開くか、ブロックのページを開くと、そのブロックに含まれるレッグを確認できます。出金には、送金先のCantonパーティが記録されます。wTKBは小数桁数が10の通常のERC-20なので、供給量や残高はほかのトークンと同じように確認できます（ [エクスプローラー](https://docs.rome.builders/ja/canton-zk-evm/explorer.md#legs-and-custody)).

Romeは10分ごとに入金、支払い、出金を実行し、その状態を30秒ごとに監視しています。

Canton Coinを自分で入金・出金するには、ウォレットで利用可能になった後、エクスプローラーの [ブリッジ](https://docs.rome.builders/ja/canton-zk-evm/bridge.md) ページでCantonウォレットを接続してください。ブリッジページでは、Canton向けにtROMEとTKAをロックすることもできます（ゲートウェイがボールトに `pay` ）。このページにあるその他の支払いとTKBの入金は、Romeのテスト用パーティが実行します。

## Cantonトークンを入金する

入金者は、オペレーターを実行者として、Cantonトークンをゲートウェイに割り当てます。入金者は、入金ID、請求を許可されたEVMアドレス、割り当てを指定する `DepositRequest` に署名します。入金IDは、 `deposit,<depositor's party id>,<label>`のSHA-256ハッシュです。そのため、入金者は自身のパーティからのみIDを生成できます。

そのEVMアドレスから `claim`を呼び出します。ゲートウェイは呼び出し元にトークンをミントし、入金レッグを記録します。受取人にはガス代としてtROMEが必要です。ビルダーはレッグをリクエスト、登録済みトークン、割り当てと照合します。

`Advance` は割り当てを実行してゲートウェイのカストディに移し、ラップ済みトークンをミントしたブロックをコミットします。ラップ済みトークンの小数桁数は10で、Cantonの金額と一致します。両者の金額は端数処理なしで正確に換算されます。

## Cantonパーティに出金する

保有者はラップ済みトークン、金額、CantonパーティIDの完全な値を指定して `withdraw` を呼び出します。ゲートウェイはラップ済みトークンをバーンし、レッグに受取人を記録します。

受取人は `WithdrawalAcceptance`に署名している必要があります。これはアーカイブされるまで有効です。また、ビルダーには、登録済みのインストゥルメントについて、ロック解除済みのゲートウェイ保有残高が十分に必要です。これらの条件が満たされない場合、ビルダーはトランザクションを含めません。

`Advance` は、トークンレジストリの転送ファクトリーを通じて受取人に支払います。Cantonでの転送とバーンを含むブロックは、同時にコミットされます。ビルダーは1つのブロックにつき、同一インストゥルメントの出金を最大1件まで含めます。詳しくは [ビルダーのREADME](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## 支払いを1つの割り当てに紐付ける

Cantonの支払人は、CantonトークンをCantonの受取人に割り当てます。両者は、割り当て、支払いID、EVMトークン、EVM受取人、金額を指定する `DvpTerms` に署名します。支払いIDは、UTF-8テキスト `<Canton payer's party id>,<Canton payee's party id>,<label>`のSHA-256ハッシュを小文字の16進数で表したものです。規約では、これ以外のIDは拒否されます。

EVMの支払人はゲートウェイを承認し、合意したID、トークン、受取人、金額を指定して `pay` を呼び出します。ゲートウェイはその支払人からEVMの受取人にERC-20を移転し、支払いレッグを記録します。デモでは支払人は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ツイン

ツインとは、Ostia上にあるERC-20をCanton形式で表したものです。これはCantonトークン標準であるCIP-0056トークンで、インストゥルメントIDは `erc20:<token address>`。また、トークン規格の transfer によって、参加者が ostia-twin を承認済みの当事者間で移動します。現在、これは Rome の参加者のアカウントを意味します。各 twin は、Vault が保有する ERC-20 と 1 対 1 で対応します。TKA と WtROME（ラップされた tROME）には DevNet 上に twin があります。

**ロック。** 通常のゲートウェイ `pay`を使って ERC-20 を Vault に払い込み、twin を保有する Canton party を指定します。支払いの前に、受取人と任意の `ref` を twin registry service に伝えます。サービスはロック ID を返します。これは `lock,<receiver>,<ref>`の SHA-256 です。ブロックによって支払いが Vault に記録され、同じ Canton トランザクション内で同額の twin が受取人に発行されます。これにより、twin の供給量は Vault の保有量と一致します。

**償還。** 保有者は Canton 上で償還リクエストに署名し、その後 `release` が、同じ `ref`を指定して Vault 上で呼び出されます。Vault はリクエスト内の EVM アドレスに ERC-20 を支払い、同じブロック内で twin が焼却されます。Canton は、一致する償還リクエストがある場合にのみ release を確定します。

チェーンのルールでは、twin は、登録済みの Vault への支払いが証明された場合に限り `Advance`内で発行されます。ただし現在は、ゲートウェイ party である twin の管理者も独自に発行・焼却できます。 [信頼モデルと制限](https://docs.rome.builders/ja/canton-zk-evm/trust-model.md#what-the-twins-trust) では、その前提を説明しています。

| 手順  | 実行場所                                 | でのCanton処理 `Advance` |
| --- | ------------------------------------ | -------------------- |
| ロック | ゲートウェイから Vault へ `pay` を実行。          | 受取人に twin を発行。       |
| 償還  | `保有者の署名済みリクエストに対して、Vault 上で` release | を実行。                 |

2026-10-29、Canton party 向けの 5 TKA のロックがブロック 28389 に記録され、その party は twin を 5 保有しました。その party は Canton 上の別の party に twin を 2 送信し、その 2 の償還がブロック 28392 に記録されました。その後、twin の供給量と Vault の残高はいずれも 3 になりました。エクスプローラーの [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) ページでは、各 twin の供給量と Vault の残高を並べて表示します（ [エクスプローラー](https://docs.rome.builders/ja/canton-zk-evm/explorer.md#twins-and-canton-assets)).

ロックの受取人になれるのは、twin の受け入れに同意した party のみです。party は一度だけ受け入れに署名し、builder は同意済みの party に対してのみロックを作成します。 [ブリッジ](https://docs.rome.builders/ja/canton-zk-evm/bridge.md) ページで Canton ウォレットを接続すると、オプトイン時にその受け入れに署名するため、自分自身の party で一連の処理をすべて実行できます。

## Canton Coin

Canton Coin は、他の Canton トークンと同じゲートウェイ入金を通じて Ostia に取り込まれます。ラップトークン CC（`0x4db3dea7c13116961fd3e438542ccfcca61a7547`、小数桁数 10。以前の記録では wCC と表記）は、バリデーターの scan proxy が指定する factory に登録されています。party は Canton Coin をゲートウェイに割り当て、ラベル付きの入金リクエストに署名します。受取人は Ostia 上で CC を請求し、出金時に Canton Coin が返却されます。Canton Coin には追加の入力として choice context が必要です。これは scan proxy が提供し、builder はブロックを証明する前に取得します。

2026-10-29、ある party がブロック 28473 を通じて Canton Coin を 5 入金した結果、その party の保有量は 15、ゲートウェイの保有量は 5、CC の供給量は 5 になりました。ブロック 28474 での出金により、3 つの値はそれぞれ 20、0、0 に戻りました。DevNet では、これらの送金に手数料はかかりませんでした。

## 証明によって保証されること

各レッグには、種類、ID、トークン、アカウント、数量、および該当する場合は Canton party が記録されます。ゲートウェイはレッグを順番どおりにハッシュ化します。 `Advance` は、添付されたレッグから得られるハッシュが、証明済みのゲートウェイ状態にあるハッシュと一致することを確認します。レッグが欠落している、余分にある、順序が違う、または変更されている場合、トランザクションは失敗します。このチェックは、レッグがないブロックも対象とします。

ブロックを証明しても、Canton 上の割り当ては予約されません。送信者は決済前に割り当てを取り戻すことができます。証明後にこれが起きた場合、Canton は `Advance` rethは最後にコミットされたブロックに戻ります。同じ証明済みブロックは、そのレッグを削除した状態では再送信できません。次のビルドでは支払いが除外されます。これは [実行4](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/demo/README.md#results).

## トークンとカストディの制限

Cantonトークンの保有者と、ゲートウェイが対応していないトークンの動作については、 [信頼モデルと制限](https://docs.rome.builders/ja/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/ja/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.
