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

# Cantonで構築する

Ostiaで、通常のEVMコントラクトを超えて何を対象にできるのか、どのCantonの要素を使って構築できるのか、そして今日DevNet上で自力でできることと、Romeが提供するものはどれか。

Ostiaは通常のEVMコントラクトを実行し、Cantonにも接続します。ブロックからCantonへのリクエストは「レッグ」と呼ばれ、ブロックと同じ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/ja/canton-zk-evm/bridge.md).                                                          |
| [Canton上のEVMトークンとそのツイン](#erc-20-twins-on-canton)      | ツインを持つERC-20（CIP-0056トークン）。              | RomeではWtROME（tROME由来）とTKAを運用しています。ウォレットが利用可能になれば、Bridgeを使ってCantonウォレットへ移せます。現時点では、Rome以外の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/ja/canton-zk-evm/build-on-ostia.md) には手順が、 [Ostia DevNet](https://docs.rome.builders/ja/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を [Bridge](https://docs.rome.builders/ja/canton-zk-evm/bridge.md) ページに預け入れるとCCを受け取れ、引き出すとCanton Coinが戻ります。このページでは、1日にテスト用のCanton Coinを20枚受け取れます。

## Canton上のERC-20ツイン

ERC-20をボールトに預け入れると、Cantonパーティーが同額のツインを保有します。ツインはCIP-0056トークンで、instrument IDは `erc20:<token address>`です。償還するとツインがバーンされ、ERC-20がOstiaアドレスに返されます。

**現在ツインを保有している人** ツインはCIP-0056を実装していますが、それだけであらゆるCantonウォレットに表示されるわけではありません。ツインをホストするすべてのバリデーターが `ostia-twin` の0.1.0および0.2.0を承認していれば、パーティーはツインを保有できます。また、ロックを受け取るパーティーは、一度限りの `TwinAcceptance`への署名も必要です。現在これらの条件を満たすのは、Romeが運用するパーティーだけです。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`これは、 `GET /api/twins` が報告するコードハッシュと同じです。

現在、DevNetでツインとボールトを登録しているのはRomeだけです。独自のERC-20のツインを申請するには、 [リポジトリ](https://github.com/rome-protocol/canton-zk-evm/issues) でissueを作成するか、Romeの [Discord](https://discord.gg/vZ9rnCdNSB)で問い合わせてください。Romeが個別に判断します。

## Cantonパーティーとの決済

EVM側の支払人はゲートウェイの `pay`を呼び出します。Canton側の支払人と受取人は、割り当て、支払いID、EVMトークン、EVM側の受取人、金額を指定する `DvpTerms` に署名済みです。1つのCantonトランザクションでブロックがコミットされ、割り当てが実行されるため、どちらか一方だけが確定することはありません。DevNetではブロック783と1471で実行されました。 [入金、出金、支払い](https://docs.rome.builders/ja/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) にルールが記載されています。

DevNetでは、Romeのテスト用パーティがこれらの支払いを実行します。Bridgeページでは実行しません。Bridgeページが行うのは、4つのブリッジ操作です。自分のCantonパーティ間で割り当てに紐づく支払いを実行するには、自分のネットワークを起動してください（下記）。

## Canton上の取引所

Venueとは、Cantonの売り手とEVMの買い手の間で取引を実行するDamlアプリです。構成要素：

* `otc-venue` 0.1.0 の apps/otc には、 [`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 と交換されました。買い手の支払いは1つの Canton アップデート内でブロック 16816 に記録され、買い手の請求はブロック 16823 に記録されました。取引額に満たない支払いはブロック 16834 から除外され、何も移動しませんでした。エクスプローラーにはスワップが [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps)に一覧表示され、 `GET /api/swaps` で取得できます。

DevNet では、ビルダーはベニューのパーティを指定して起動するため、Rome がベニューを追加します。スワップを実行するコマンドは、ローカルネットワークまたは独自の実行環境向けのリポジトリのデモにあります。売り手が取引を提案するステップは、メインネット開始前に予定されています。

## 独自のネットワーク

[独自の Ostia を実行する](https://docs.rome.builders/ja/canton-zk-evm/run-it-locally.md) と、ローカルの Canton ネットワークと、チェーン、証明者またはその代替、ゲートウェイ、エクスプローラーを含むスタック全体が起動します。Canton Coin を除く上記のすべてのコンポーネントを自分で実行できます。Canton Coin には Canton Network のバリデーターが必要です。その場合は、自分のバリデーターの参加者上で Ostia を実行してください（ [独自の Ostia を実行する](https://docs.rome.builders/ja/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)を参照）。自分のパーティとベニューを使用します。

Daml アプリからは、自身が署名するレッグを確認できます。誰でもエクスプローラーの `GET /api/legs` を通じてすべてのレッグを参照できます。

## 次のステップ

* [ユースケース](https://docs.rome.builders/ja/canton-zk-evm/use-cases.md)：これらのコンポーネントによって、現在何が可能になるかを説明します。
* [ブリッジ](https://docs.rome.builders/ja/canton-zk-evm/bridge.md)：4つの操作と Canton での送金を行うためのブラウザページ。
* [仕組み](https://docs.rome.builders/ja/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/ja/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.
