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

# Canton으로 구축하기

일반적인 EVM 계약을 넘어 Ostia에서 무엇을 대상으로 할 수 있는지, 어떤 Canton 구성 요소로 빌드할 수 있는지, 그리고 오늘 DevNet에서 혼자 할 수 있는 것과 Rome가 실행하는 것을 다룹니다.

Ostia는 일반적인 EVM 컨트랙트를 실행하며 Canton에도 연결됩니다. Canton으로 보내는 블록 요청은 레그(leg)이며, 블록과 동일한 Canton 트랜잭션에서 커밋됩니다. 이 페이지에서는 대상으로 삼을 수 있는 항목과 각 항목을 구성하는 요소, 그리고 현재 DevNet에서 누가 이를 사용할 수 있는지 설명합니다.

각 요소의 코드는 공개 저장소에 있으며, [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm)Apache License 2.0에 따라 제공됩니다.

| 대상                                                      | 설명                                       | 현재 DevNet에서                                                                                                                                 |
| ------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [EVM 컨트랙트](#evm-contracts)                              | Ethereum에서 사용하는 도구로 배포하는 Solidity 앱입니다.  | 직접 할 수 있습니다.                                                                                                                                |
| [컨트랙트에서 Canton Coin 사용](#canton-coin-in-your-contracts) | CC ERC-20 형태의 Canton Coin입니다.            | 직접 할 수 있으며, [Bridge](https://docs.rome.builders/ko/canton-zk-evm/bridge.md).                                                                |
| [Canton에서 트윈으로 제공되는 EVM 토큰](#erc-20-twins-on-canton)    | 트윈(CIP-0056 토큰)이 있는 ERC-20입니다.           | Rome은 WtROME(tROME에서 생성)과 TKA로 이를 운영합니다. 지갑 기능이 활성화되면 Bridge를 통해 Canton 지갑으로 토큰을 이동할 수 있습니다. 아직 외부 Canton 지갑에는 트윈이 없습니다. 새 트윈은 Rome이 등록합니다. |
| [Canton 파티와 결제](#payments-with-canton-parties)          | 동일한 트랜잭션에서 Canton 할당을 실행하는 ERC-20 결제입니다. | Rome은 테스트 파티를 사용해 이를 운영하며, DevNet에서 직접 실행할 수는 없습니다.                                                                                         |
| [Canton 거래소](#a-canton-venue)                           | Canton 토큰을 ERC-20으로 교환하는 Daml 앱입니다.      | Rome이 거래소를 운영하며, 지금까지 한 차례 실행했습니다. DevNet에서는 직접 거래소를 운영할 수 없습니다.                                                                            |
| [나만의 네트워크](#your-own-network)                           | 로컬 Canton 네트워크에서 전체 스택을 실행합니다.           | 모든 작업을 직접 수행합니다.                                                                                                                            |

## EVM 컨트랙트

Foundry 또는 Hardhat으로 배포하고, 익스플로러에서 소스 코드를 검증한 뒤 viem 또는 ethers로 연결할 수 있습니다. [Ostia에서 빌드하기](https://docs.rome.builders/ko/canton-zk-evm/build-on-ostia.md) 에는 단계별 안내가 있고, [Ostia DevNet](https://docs.rome.builders/ko/canton-zk-evm/devnet.md#limits) 에는 제한 사항이 정리되어 있습니다. ERC-20, ERC-721, ERC-1155, 권한형 ERC-3643 토큰, Uniswap V2, TACEO Merces 증명을 확인하는 컨트랙트가 모두 Ostia에서 실행되었습니다. RedStone 가격 피드 컨슈머도 배포 및 검증되었습니다.

## 컨트랙트에서 Canton Coin 사용

Ostia의 Canton Coin은 소수점 10자리의 일반 ERC-20이며, 주소는 `0x4db3dea7c13116961fd3e438542ccfcca61a7547`입니다. 어떤 컨트랙트든 이 토큰을 보유하고 전송할 수 있습니다. Canton에 있는 게이트웨이의 보관분이 이를 1:1로 뒷받침하며, 익스플로러에서 양쪽 토큰을 나란히 확인할 수 있습니다: [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) 및 `GET /api/twins`.

Canton Coin을 예치하면 CC를 받을 수 있습니다. 예치는 [Bridge](https://docs.rome.builders/ko/canton-zk-evm/bridge.md) 페이지에서 하고, 출금하면 Canton Coin을 돌려받습니다. 페이지에서는 하루에 테스트용 Canton Coin 20개를 제공합니다.

## Canton의 ERC-20 트윈

ERC-20을 볼트에 예치하면 Canton 파티가 동일한 수량의 트윈을 보유합니다. 트윈은 CIP-0056 토큰이며, 인스트루먼트 ID는 `erc20:<token address>`입니다. 상환 시 트윈을 소각하고 ERC-20을 Ostia 주소로 돌려보냅니다.

**현재 트윈을 보유한 주체** 트윈은 CIP-0056을 구현하지만, 그렇다고 모든 Canton 지갑에 표시되는 것은 아닙니다. 파티가 트윈을 보유하려면 해당 파티를 호스팅하는 모든 검증자가 다음을 검증해야 합니다: `ostia-twin` 버전 0.1.0과 0.2.0. 또한 잠금을 받는 파티는 1회성 `TwinAcceptance`에도 서명해야 합니다. 현재 이 조건을 충족하는 것은 Rome이 운영하는 파티뿐입니다. 아직 외부 Canton 지갑은 트윈을 보유하거나 전송할 수 없습니다.

**자체 Canton 지갑 연결: 구현은 완료됐지만 아직 활성화되지는 않았습니다.** Bridge 페이지는 이미 보유한 Canton 지갑을 연결합니다. 지갑 서명으로 만든 Bridge 계정은 2026-11-17에 폐기되었습니다. 연결 기능은 정해진 날짜 없이 지갑별로 활성화됩니다. 지갑 제작자와 검증자가 결정하는 세 가지 사항에 달려 있습니다. 지갑에서 허용하기 전에 제3자 Daml 패키지를 검토해야 하고, 일부 규칙은 이름이 다음으로 시작하는 패키지를 차단합니다. `canton-` (당사의 체인 패키지 이름은 `canton-zk-evm`입니다). 또한 지갑의 파티를 호스팅하는 검증자가 Ostia 패키지를 보유해야 합니다. 그때까지 외부 Canton 지갑은 Bridge에서 거래를 실행할 수 없습니다. DevNet에서는 트윈이 TKA와 WtROME이고, 볼트 주소는 다음과 같습니다. `0x69f13a94f986021f1a7650eb611bf9b717aa495a`.

트윈 레지스트리 서비스는 다음 주소에서 응답합니다. `https://ostia.devnet.romeprotocol.xyz/twin-registry` (예: `GET /twin-registry/healthz`). 이 서비스에는 키가 저장되지 않습니다.

| 호출                                                                               | 제공 정보                                                                                        |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `GET /healthz`                                                                   | 트윈과 볼트 목록입니다.                                                                                |
| `GET /twin/v1/twins`                                                             | 각 트윈의 토큰, 인스트루먼트 ID, 볼트입니다.                                                                  |
| `GET /registry/...`                                                              | 토큰 표준의 레지스트리 API입니다. 트윈의 메타데이터와 전송 및 할당 팩토리를 제공합니다. 따라서 검증자가 트윈 패키지를 검토한 지갑은 트윈을 전송할 수 있습니다. |
| `POST /twin/v1/lock-parts` 와 함께 `{"receiver": <Canton party id>, "ref": <text>}` | 지급자가 잠금에 사용할 잠금 ID와 등록된 볼트입니다.                                                               |

잠금 수신자는 한 번 `TwinAcceptance` 에 서명합니다. 이 서명이 없으면 레지스트리는 409를 반환하고, 빌더는 증명 전에 해당 잠금을 블록에서 제외하므로 ERC-20은 지급자에게 남습니다. Bridge 페이지에 연결하는 Canton 지갑은 선택 동의 절차에서 수락에 서명합니다. 지급자는 잠금 ID 자체와 `lock,<receiver>,<ref>`의 SHA-256 해시를 확인하고, 신뢰하는 출처에서 볼트 주소를 가져옵니다.

볼트가 검토된 빌드인지 확인할 수 있습니다. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` 를 실행하면 다음 값이 반환됩니다. `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`. 이 값은 다음 API가 보고하는 코드 해시와도 같습니다. `GET /api/twins` .

현재 DevNet에서 트윈과 볼트를 등록하는 곳은 Rome뿐입니다. 자체 ERC-20의 트윈을 요청하려면 [저장소](https://github.com/rome-protocol/canton-zk-evm/issues) 에서 이슈를 열거나 Rome [Discord](https://discord.gg/vZ9rnCdNSB)에서 문의하세요. Rome은 건별로 결정합니다.

## Canton 파티와 결제

EVM 지급자가 게이트웨이의 `pay`를 호출합니다. Canton의 지급자와 수취인은 할당, 지급 ID, EVM 토큰, EVM 수취인 및 금액을 지정하는 `DvpTerms` 에 서명했습니다. 하나의 Canton 트랜잭션에서 블록이 커밋되고 할당이 실행되므로, 어느 한쪽만으로는 최종 확정되지 않습니다. DevNet의 783번 및 1471번 블록에서 실행되었습니다. [입금, 출금 및 지급](https://docs.rome.builders/ko/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) 에 규칙이 설명되어 있습니다.

DevNet에서는 Rome의 테스트 파티가 이러한 지급을 실행합니다. Bridge 페이지는 지급을 실행하지 않고 네 가지 브리지 이동을 처리합니다. 자체 Canton 파티 간 할당에 연동된 지급을 실행하려면 자체 네트워크를 실행하세요(아래 참조).

## Canton 거래소

베뉴는 Canton 판매자와 EVM 구매자 간의 거래를 실행하는 Daml 앱입니다. 구성 요소:

* `otc-venue` 0.1.0은  [`apps/otc`](https://github.com/rome-protocol/canton-zk-evm/tree/main/apps/otc)에 있으며,  `TradeOffer` 와  `Trade`를 보유합니다. 토큰 표준인 CIP-0056에만 의존하고 체인을 지정하지 않으므로 어느 거래소나 사용할 수 있습니다.  `Trade` 는 표준 지갑에서 판매자에게 할당 요청을 표시합니다.
* 체인의 Daml 패키지(0.4.0 이상, 0.5.0으로 고정)는  `VenueTrade` 와  `FundedClaim`를 보유합니다. 거래소와 판매자는 각 거래에 대해  `VenueTrade` 에 서명합니다.
* 구매자는 게이트웨이를 통해 결제합니다. 판매자의 할당은 결제와 동일한 Canton 트랜잭션에서 실행되고, 이후 구매자는  `FundedClaim`.

을 사용해 래핑된 토큰을 청구합니다. 2026-10-27 15:55 UTC에 DevNet에서 실행되었습니다. Canton 토큰 TKB가 ERC-20 TKA로 교환되었습니다. 구매자의 결제는 단일 Canton 업데이트에 포함되어 블록 16816에 기록되고, 구매자의 청구는 블록 16823에 기록됩니다. 거래 금액보다 적은 결제는 블록 16834에서 제외되어 아무것도 이동시키지 않았습니다. 탐색기에는 스왑이  [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)에 나열되며,  `GET /api/swaps` 를 호출하면 스왑 목록이 반환됩니다.

DevNet에서는 거래소의 파티를 사용해 빌더를 시작하므로 Rome에 거래소가 추가됩니다. 스왑 실행 명령은 로컬 네트워크나 직접 실행하는 환경을 위한 저장소 데모에 있습니다. 판매자가 거래를 제안하는 단계는 메인넷 출시 전에 계획되어 있습니다.

## 나만의 네트워크

[직접 Ostia 실행하기](https://docs.rome.builders/ko/canton-zk-evm/run-it-locally.md) 는 로컬 Canton 네트워크와 전체 스택, 즉 체인, 증명기 또는 대체 구성 요소, 게이트웨이, 탐색기를 시작합니다. 이를 통해 Canton Coin을 제외한 위의 모든 구성 요소를 직접 실행할 수 있습니다. Canton Coin에는 Canton Network 검증자가 필요하므로, 이 경우에는 자체 검증자의 participant에서 Ostia를 실행하세요(자세한 내용은  [직접 Ostia 실행하기](https://docs.rome.builders/ko/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant) 참조). 자체 파티와 자체 거래소를 사용합니다.

Daml 앱은 자신이 서명한 거래 단계를 확인할 수 있습니다. 누구나 탐색기에서  `GET /api/legs` 를 통해 모든 거래 단계를 읽을 수 있습니다.

## 다음 단계

* [사용 사례](https://docs.rome.builders/ko/canton-zk-evm/use-cases.md): 이 구성 요소들로 현재 가능한 작업입니다.
* [브리지](https://docs.rome.builders/ko/canton-zk-evm/bridge.md): 네 가지 동작을 수행하고 Canton에서 전송하는 브라우저 페이지입니다.
* [작동 방식](https://docs.rome.builders/ko/canton-zk-evm/how-it-works.md): 트랜잭션부터 Canton 커밋까지의 블록 처리 과정.


---

# 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/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.
