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

# Создавайте с Canton

Что вы можете использовать в Ostia помимо обычных EVM-контрактов, какие компоненты Canton можно использовать для сборки и что вы можете сделать самостоятельно на DevNet уже сегодня, а что работает в Rome.

Ostia запускает обычные EVM-контракты и также взаимодействует с Canton. Запросы блока к Canton называются legs и фиксируются в той же транзакции Canton, что и сам блок. На этой странице перечислены доступные цели, компоненты каждой из них и те, кто может ими пользоваться в DevNet сегодня.

Код всех компонентов находится в открытом репозитории [rome-protocol/canton-zk-evm](https://github.com/rome-protocol/canton-zk-evm)под лицензией Apache License 2.0.

| Цель                                                              | Описание                                                                           | Доступно в DevNet сегодня                                                                                                                                                                                                         |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [EVM-контракты](#evm-contracts)                                   | Приложения на Solidity, развёрнутые с помощью привычных вам инструментов Ethereum. | Вы делаете это самостоятельно.                                                                                                                                                                                                    |
| [Canton Coin в ваших контрактах](#canton-coin-in-your-contracts)  | Canton Coin в виде CC ERC-20.                                                      | Вы делаете это самостоятельно с помощью [моста](https://docs.rome.builders/ru/canton-zk-evm/bridge.md).                                                                                                                           |
| [EVM-токен на Canton в виде двойника](#erc-20-twins-on-canton)    | ERC-20 с двойником — токеном CIP-0056.                                             | Rome использует его для WtROME (из tROME) и TKA. Когда кошельки будут подключены, мост будет перемещать эти токены для кошелька Canton. Пока ни один внешний кошелёк Canton не хранит двойники. Rome регистрирует новые двойники. |
| [Платежи с участием сторон Canton](#payments-with-canton-parties) | Платёж ERC-20, который выполняет распределение Canton в рамках той же транзакции.  | Rome выполняет такие платежи с тестовыми сторонами; в DevNet вы не можете запускать их самостоятельно.                                                                                                                            |
| [Торговая площадка Canton](#a-canton-venue)                       | Приложение Daml для обмена токена Canton на ERC-20.                                | Rome запустила площадку; она работала один раз. В DevNet вы не можете запускать торговую площадку.                                                                                                                                |
| [Ваша собственная сеть](#your-own-network)                        | Весь стек в локальной сети Canton.                                                 | Вы делаете всё самостоятельно.                                                                                                                                                                                                    |

## EVM-контракты

Разворачивайте контракты с Foundry или Hardhat, проверяйте исходный код в обозревателе и подключайтесь с помощью viem или ethers. [Разработка на Ostia](https://docs.rome.builders/ru/canton-zk-evm/build-on-ostia.md) содержит инструкции, а [Ostia DevNet](https://docs.rome.builders/ru/canton-zk-evm/devnet.md#limits) описывает ограничения. На Ostia запускались ERC-20, ERC-721, ERC-1155, токен с ограниченным доступом ERC-3643, Uniswap V2 и контракты для проверки доказательств TACEO Merces. Также был развёрнут и верифицирован потребитель цен RedStone.

## Canton Coin в ваших контрактах

Canton Coin в Ostia — это обычный ERC-20 с 10 десятичными знаками по адресу `0x4db3dea7c13116961fd3e438542ccfcca61a7547`. Любой контракт может хранить его и переводить. Хранение токенов мостом в Canton обеспечивает их покрытие один к одному; обозреватель показывает обе стороны рядом на странице [`/twins`](https://ostia.devnet.romeprotocol.xyz/twins) и в ответе `GET /api/twins`.

Получить CC можно, внеся Canton Coin на странице [моста](https://docs.rome.builders/ru/canton-zk-evm/bridge.md) , а получить Canton Coin обратно — сняв его. На странице ежедневно выдаётся 20 тестовых Canton Coin.

## Двойники ERC-20 в Canton

Вы вносите ERC-20 в хранилище, а сторона Canton получает такое же количество его двойника. Двойник — это токен CIP-0056 с идентификатором инструмента `erc20:<token address>`. При погашении двойник сжигается, а ERC-20 возвращается на адрес Ostia.

**Кто хранит двойники сейчас.** Двойники реализуют CIP-0056, но это не означает, что они отображаются в каждом кошельке Canton. Сторона может хранить двойник, только если каждый валидатор, на котором он размещён, проверил `ostia-twin` версий 0.1.0 и 0.2.0; кроме того, сторона, получающая блокировку, должна также подписать одноразовый `TwinAcceptance`. Сейчас этим требованиям соответствуют только стороны, обслуживаемые Rome. Ни один внешний кошелёк Canton пока не хранит и не отправляет двойники.

**Подключение собственного Canton-кошелька: реализовано, но пока не включено.** Страница Bridge подключает уже имеющийся у вас Canton-кошелёк. Учётная запись Bridge, создававшаяся с помощью подписи кошелька, выведена из эксплуатации 17.11.2026. Подключение включается отдельно для каждого кошелька, без установленной даты. Для этого необходимо выполнение трёх условий, которые определяют разработчики кошельков и валидаторы: они проверяют сторонний пакет 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`                                                          | Токен, идентификатор инструмента и хранилища каждого близнеца.                                                                                                                         |
| `GET /registry/...`                                                           | API реестра стандарта токена: метаданные близнеца, а также фабрики переводов и распределений, позволяющие кошельку, валидаторы которого проверили пакет близнеца, отправлять близнецы. |
| `POST /twin/v1/lock-parts` с `{"receiver": <Canton party id>, "ref": <text>}` | Идентификатор блокировки и зарегистрированные хранилища, которые плательщик использует при блокировке.                                                                                 |

Получатель блокировки один раз подписывает `TwinAcceptance` Без этой подписи реестр отвечает кодом 409, а сборщик исключает блокировку из блока до её подтверждения, поэтому ERC-20 остаётся у плательщика. Canton-кошелёк, подключаемый к странице Bridge, подписывает согласие в рамках процедуры подключения. Плательщик самостоятельно проверяет идентификатор блокировки, SHA-256-хеш строки `lock,<receiver>,<ref>`и получает адрес хранилища из источника, которому доверяет.

Можно проверить, что хранилище соответствует проверенной сборке. `cast keccak $(cast code 0x69f13a94f986021f1a7650eb611bf9b717aa495a --rpc-url $RPC)` выдаёт `0x2fbcf33083dd26a360690a0d8d24cd333997b3c7000d950aa5e564e01460d4da`. Это также хеш кода, который сообщает `GET /api/twins` .

В настоящее время только Rome регистрирует близнецов и хранилища в DevNet. Чтобы запросить близнеца для собственного ERC-20, создайте issue в [репозитории](https://github.com/rome-protocol/canton-zk-evm/issues) или обратитесь в [Discord](https://discord.gg/vZ9rnCdNSB)Rome; запросы рассматриваются индивидуально.

## Платежи с участием сторон Canton

Плательщик в EVM вызывает метод шлюза `pay`. Плательщик и получатель в Canton подписали `DvpTerms` с указанием распределения, идентификатора платежа, токена EVM, получателя в EVM и суммы. В одной транзакции Canton фиксируется блок и выполняется распределение, поэтому ни одно из этих действий не считается завершённым без другого. Это было выполнено в DevNet в блоках 783 и 1471. [Депозиты, вывод средств и платежи](https://docs.rome.builders/ru/canton-zk-evm/deposits-withdrawals-payments.md#tie-a-payment-to-one-allocation) описаны в правилах.

В DevNet тестовые стороны Rome выполняют эти платежи. Страница Bridge их не выполняет: она обеспечивает четыре операции моста. Чтобы выполнять платежи, связанные с распределением между вашими собственными сторонами Canton, запустите собственную сеть (см. ниже).

## Торговая площадка Canton

Торговая площадка — это приложение Daml, которое проводит сделку между продавцом в Canton и покупателем в EVM. Её компоненты:

* `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`.

Это работало в DevNet 2026-10-27 в 15:55 UTC: токен Canton TKB обменяли на ERC-20 TKA. Платёж покупателя включён в блок 16816 в рамках одного обновления Canton, а требование покупателя — в блок 16823. Платёж на сумму меньше указанной в сделке не попал в блок 16834 и не привёл к перемещению средств. Обозреватель показывает обмены по адресу [`/swaps`](https://ostia.devnet.romeprotocol.xyz/swaps), а `GET /api/swaps` возвращает их.

В DevNet сборщик запускается от имени участника площадки, поэтому Rome добавляет площадку. Команды для выполнения обмена приведены в демо-версии репозитория — для локальной сети или собственного запуска. Шаг, на котором продавец предлагает сделку, запланирован до запуска основной сети.

## Ваша собственная сеть

[Запустите собственный экземпляр Ostia](https://docs.rome.builders/ru/canton-zk-evm/run-it-locally.md) запускает локальную сеть Canton и весь стек: блокчейн, прувер или его замену, шлюз и обозреватель. В ней вы самостоятельно запускаете все перечисленные выше компоненты, кроме Canton Coin, для которого нужен валидатор Canton Network; чтобы использовать его, запустите Ostia на участнике своего валидатора (см. [Запустите собственный экземпляр Ostia](https://docs.rome.builders/ru/canton-zk-evm/run-it-locally.md#run-on-an-existing-participant)). Вы используете собственных участников и собственную площадку.

Приложение Daml видит только те части сделки, которые оно подписывает. Любой может просмотреть все части через `GET /api/legs` в обозревателе.

## Что дальше

* [Варианты использования](https://docs.rome.builders/ru/canton-zk-evm/use-cases.md): что эти компоненты позволяют делать уже сегодня.
* [Мост](https://docs.rome.builders/ru/canton-zk-evm/bridge.md): страница в браузере для четырёх операций и отправки средств в Canton.
* [Как это работает](https://docs.rome.builders/ru/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/ru/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.
