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

# 입금, 출금 및 결제

게이트웨이가 EVM 예치, 출금, 결제를 해당 Canton 측과 어떻게 연결하는지, 그리고 ERC-20 트윈과 Canton Coin이 양방향으로 어떻게 이동하는지.

게이트웨이는 체인의 제네시스에 포함된 EVM 컨트랙트입니다. 블록에서 Canton이 수행해야 하는 작업을 기록합니다. 각 요청은 하나의 레그입니다. 블록의 증명은 기록된 순서대로 레그의 해시를 포함해 게이트웨이 상태를 커밋합니다.

테스트 파티를 사용하는 Rome이 운영하는 Ostia DevNet에서 입금, 출금 및 결제를 사용할 수 있습니다. 이 기능은 2026-10-05 로컬 데모에서 처음 실행되었습니다. 2026-10-25에는 Canton 테스트 토큰인 TKB(Splice에서 제공하는 기준 테스트 토큰)가 게이트웨이에 등록되었으며, 이 토큰의 래핑된 형태인 wTKB는 Ostia의 `0x294d3049874526910a69f6b61da14d10a8b1b3af`에 있습니다. 2026-11-08부터는 익스플로러의 [브리지](https://docs.rome.builders/ko/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/ko/canton-zk-evm/status.md) 에는 커밋이 표시됩니다. 레그를 사용해 무엇을 만들 수 있는지 알아보려면 [Canton으로 빌드하기](https://docs.rome.builders/ko/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에서 입금, 결제, 출금을 두 차례 실행했습니다.

| 실행                                        | 입금                                     | 결제                                                                                         | 출금                                        |
| ----------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ | ----------------------------------------- |
| 첫 번째: 08:08\~08:10 UTC                    | 블록 780: TKB 10개가 들어오고 wTKB 10개가 나갔습니다. | 블록 783: V가 U에게 1 WtROME(Ostia의 ERC-20인 래핑된 tROME)를 지급하고, 그 대가로 U가 V에게 TKB 10개의 할당을 제공했습니다. | 블록 784: wTKB 4개를 소각하고 TKB 4개를 U에게 지급했습니다. |
| 두 번째: 11:31\~11:34 UTC, Daml 패키지 0.2.0 사용 | 블록 1465.                               | 블록 1471.                                                                                   | 블록 1473.                                  |

각 레그는 각각 별도의 블록에 포함되었습니다. 각 레그에서 블록 기록과 보유량 변경은 하나의 Canton 업데이트였습니다. 두 번째 실행 후 wTKB 공급량은 12였으며, 누구나 Ostia에서 확인할 수 있습니다. Rome의 실행에서는 당시 게이트웨이가 Canton에서 12 TKB를 보유하고 있는지 확인했으며, 이는 해당 공급량과 일치했습니다. 2026-10-25부터 익스플로러에도 이 정보가 표시됩니다. wTKB 토큰 페이지에는 공급량 12 wTKB와 함께 보관량 12 TKB가 표시된 "Backed on Canton" 카드가 있습니다.

U와 V는 Rome이 생성해 자체 참여자에서 실행하는 테스트 당사자이며, 모든 단계를 Rome이 실행했습니다. 익스플로러에서 레그를 확인할 수 있습니다. 다음을 여세요. [`/legs`](https://ostia.devnet.romeprotocol.xyz/legs) 목록을 보려면 이 경로를, 또는 해당 블록에 포함된 레그를 보려면 블록 페이지를 여세요. 출금에는 대금을 지급받은 Canton 당사자가 명시됩니다. wTKB는 소수점 자릿수가 10인 일반 ERC-20이므로, 공급량과 잔액을 다른 토큰과 마찬가지로 확인할 수 있습니다(참조: [익스플로러](https://docs.rome.builders/ko/canton-zk-evm/explorer.md#legs-and-custody)).

Rome은 10분마다 예치, 결제, 출금을 실행하고, 30초마다 상태를 모니터링합니다.

Canton Coin을 직접 예치하고 출금하려면 익스플로러의 [브리지](https://docs.rome.builders/ko/canton-zk-evm/bridge.md) 페이지에서 Canton 지갑을 연결하세요. 단, 지갑에서 기능이 활성화되어 있어야 합니다. 브리지 페이지에서는 Canton을 위해 tROME과 TKA도 잠급니다(게이트웨이가 볼트에 `pay` 합니다). 이 페이지의 다른 결제와 TKB 예치는 Rome의 테스트 당사자가 실행합니다.

## Canton 토큰 예치

예치자는 Canton 토큰을 게이트웨이에 할당하고 운영자를 실행자로 지정합니다. 예치자는 예치 ID, 클레임을 허용할 EVM 주소, 할당량을 지정하는 `DepositRequest` 에 서명합니다. 예치 ID는 다음 값의 SHA-256 해시입니다. `deposit,<depositor's party id>,<label>`. 따라서 예치자만 자신의 당사자 ID로 ID를 만들 수 있습니다.

해당 EVM 주소는 `claim`을 호출합니다. 게이트웨이는 호출자에게 토큰을 발행하고 예치 레그를 기록합니다. 수신자는 가스 비용을 낼 tROME이 필요합니다. 빌더는 레그를 요청, 등록된 토큰 및 할당량과 대조합니다.

`Advance` 는 할당을 실행해 게이트웨이 보관 상태로 옮기고, 래핑된 토큰을 발행한 블록을 커밋합니다. 래핑된 토큰은 Canton 수량과 일치하도록 소수점 자릿수가 10입니다. 두 수량 간 변환은 정확하며 반올림이 없습니다.

## Canton 당사자에게 출금

보유자는 래핑된 토큰, 수량, 전체 Canton 당사자 ID를 지정해 `withdraw` 를 호출합니다. 게이트웨이는 래핑된 토큰을 소각하고 레그에 수신자를 기록합니다.

수신자는 다음 항목에 서명해야 합니다. `WithdrawalAcceptance`. 이 항목은 아카이브될 때까지 활성 상태로 유지됩니다. 빌더에는 등록된 상품의 게이트웨이 보유량 중 잠금 해제된 수량도 충분해야 합니다. 이러한 조건이 충족되지 않으면 빌더는 트랜잭션을 제외합니다.

`Advance` 는 토큰 레지스트리의 전송 팩터리를 통해 수신자에게 지급합니다. Canton 전송과 소각이 포함된 블록은 함께 커밋됩니다. 빌더는 블록당 상품별 출금을 최대 하나만 포함합니다. 자세한 내용은 [빌더 README](https://github.com/rome-protocol/canton-zk-evm/blob/v0.1.0/builder/README.md).

## 결제를 특정 할당에 연결

Canton 지급자는 Canton 수취인에게 Canton 토큰을 할당합니다. 두 당사자는 할당, 결제 ID, EVM 토큰, EVM 수취인 및 수량을 지정하는 `DvpTerms` 에 서명합니다. 결제 ID는 다음 UTF-8 텍스트의 SHA-256 해시입니다. `<Canton payer's party id>,<Canton payee's party id>,<label>`. 소문자 16진수로 작성하며, 약관은 다른 ID를 허용하지 않습니다.

EVM 지급자는 게이트웨이를 승인하고 합의된 ID, 토큰, 수신자, 수량을 지정해 `pay` 를 호출합니다. 게이트웨이는 지급자의 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 트윈

트윈은 Ostia에 존재하는 ERC-20의 Canton 형태입니다. Canton 토큰 표준인 CIP-0056 토큰이며, 상품 ID는 다음과 같습니다. `erc20:<token address>`이며, 토큰 표준의 전송을 통해 당사자 간에 이동합니다. 이때 참여자들이 ostia-twin을 검증한 당사자여야 하며, 현재는 Rome 참여자의 계정을 의미합니다. 각 트윈은 볼트가 보유한 ERC-20 토큰과 일대일로 대응합니다. DevNet에서는 TKA와 WtROME(래핑된 tROME)에 트윈이 있습니다.

**잠금.** 일반 게이트웨이 `pay`를 사용해 ERC-20을 볼트에 지급하고, 트윈을 보유할 Canton 당사자를 지정합니다. 지급 전에 트윈 레지스트리 서비스에 수신자와 원하는 `ref` 를 알려주면 서비스가 잠금 ID를 반환합니다. 잠금 ID는 다음 값의 SHA-256 해시입니다. `lock,<receiver>,<ref>`. 블록은 지급액을 볼트에 반영하고, 같은 Canton 트랜잭션에서 동일한 수량의 트윈을 수신자에게 발행합니다. 그러면 트윈의 총공급량은 볼트가 보유한 수량과 같아집니다.

**상환.** 보유자가 Canton에서 상환 요청에 서명하면, 볼트에서 `release` 를 동일한 `ref`와 함께 호출합니다. 볼트는 요청에 지정된 EVM 주소로 ERC-20을 지급하고, 같은 블록에서 트윈을 소각합니다. Canton은 일치하는 상환 요청이 있을 때만 지급을 정산합니다.

체인의 규칙에 따라 트윈은 검증된 볼트 입금을 근거로 `Advance`에서만 발행됩니다. 다만 트윈의 관리자, 즉 게이트웨이 당사자는 현재 자체적으로도 트윈을 발행하고 소각할 수 있습니다. [신뢰 모델 및 한계](https://docs.rome.builders/ko/canton-zk-evm/trust-model.md#what-the-twins-trust) 에는 이 방식의 근거가 설명되어 있습니다.

| 단계 | 수행 위치                          | Canton 작업:  `Advance` |
| -- | ------------------------------ | --------------------- |
| 잠금 | 게이트웨이에서 볼트로 `pay` 를 호출합니다.     | 수신자에게 트윈을 발행합니다.      |
| 상환 | `보유자가 서명한 요청에 따라 볼트에서` release | 를 호출합니다.              |

보유자의 트윈을 소각합니다. [`2026-10-29에 Canton 당사자를 위한 TKA 5개 잠금이 블록 28389에 포함되었고, 해당 당사자는 트윈 5개를 보유하게 되었습니다. 이 당사자는 Canton의 두 번째 당사자에게 트윈 2개를 보냈으며, 해당 2개에 대한 상환이 블록 28392에 포함되었습니다. 이후 트윈의 총공급량과 볼트 잔액은 모두 3개였습니다. 익스플로러의`](https://ostia.devnet.romeprotocol.xyz/twins) /twins [페이지에는 각 트윈의 총공급량과 볼트 잔액이 함께 표시됩니다(참조:](https://docs.rome.builders/ko/canton-zk-evm/explorer.md#twins-and-canton-assets)).

익스플로러 [트윈 수령을 승인한 수신자에게만 잠금이 생성됩니다. 당사자는 트윈 수령에 동의한다고 한 번 서명하며, 빌더는 동의한 당사자에게만 잠금을 생성합니다. ](https://docs.rome.builders/ko/canton-zk-evm/bridge.md) 브리지 페이지에서 Canton 지갑을 연결하면 옵트인 과정에서 해당 동의에 서명하므로, 직접 소유한 당사자로 전체 과정을 실행할 수 있습니다.

## Canton Coin

Canton Coin은 다른 Canton 토큰과 마찬가지로 게이트웨이 입금을 통해 Ostia로 들어옵니다. 래핑된 토큰 CC(`0x4db3dea7c13116961fd3e438542ccfcca61a7547`, 소수점 10자리; 이전 기록에서는 wCC라고 부름)는 검증자의 스캔 프록시가 지정하는 팩토리에 등록되어 있습니다. 당사자는 Canton Coin을 게이트웨이에 할당하고 라벨이 지정된 입금 요청에 서명합니다. 수신자는 Ostia에서 CC를 청구하고, 출금 시 Canton Coin이 반환됩니다. Canton Coin에는 추가 입력값인 선택 컨텍스트가 필요합니다. 스캔 프록시가 이를 제공하며, 빌더는 블록을 검증하기 전에 이를 가져옵니다.

2026-10-29에 한 당사자가 블록 28473을 통해 Canton Coin 5개를 넣어, 당사자 보유량은 15개, 게이트웨이 보유량은 5개, CC 총공급량은 5개가 되었습니다. 블록 28474의 출금으로 세 값은 각각 20, 0, 0으로 돌아갔습니다. DevNet에서는 이러한 전송에 수수료가 부과되지 않았습니다.

## 증명이 보장하는 것

각 항목에는 유형, ID, 토큰, 계정, 수량과 해당하는 경우 Canton 당사자가 기록됩니다. 게이트웨이는 항목들을 순서대로 해시합니다. `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/ko/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/ko/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.
