For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Перейти к содержимому

Депозиты, выводы и платежи

Как шлюз связывает депозиты, вывод средств и платежи в EVM с их соответствующими операциями в Canton, а также как двойники ERC-20 и Canton Coin перемещаются в обоих направлениях.

Gateway — это EVM-контракт, включённый в генезис цепочки. Он записывает, какие действия блок должен выполнить в Canton. Каждый запрос — это операция (leg). Доказательство блока фиксирует состояние gateway, включая хеш операций в порядке их записи.

В Ostia DevNet доступны депозиты, выводы и платежи; сетью управляет Rome с тестовыми участниками. Впервые они были запущены в локальной демонстрации 2026-10-05. 2026-10-25 тестовый токен Canton TKB (эталонный тестовый токен, поставляемый Splice) был зарегистрирован в gateway, а его обёрнутая форма, wTKB, существует в Ostia по адресу 0x294d3049874526910a69f6b61da14d10a8b1b3af. С 2026-11-08 вы можете самостоятельно вносить и выводить Canton Coin на странице Мост в обозревателе; см. Работает в DevNet ниже.

С 2026-10-29 gateway также поддерживает двусторонний перевод активов Canton: токен ERC-20 может иметь двойник в Canton, а Canton Coin можно переводить в Ostia и обратно. См. Двойники токенов ERC-20 в Canton и Canton Coin.

Большинство ссылок на этой странице ведут на выпуск v0.1.0; ссылка на README gateway ведёт в основную ветку. Сейчас в DevNet работает код из основной ветки репозитория с пакетом Daml 0.5.0, а операции подчиняются тем же правилам. В разделе «Статус» указан коммит. О том, что можно создавать на основе операций, см. Разработка с Canton. Ознакомьтесь с полным текстом README gateway и интерфейсом Daml.

Операция

Вызов gateway

Действие в EVM

Действие в Canton в Advance

Депозит

claim(id, token, amount)

Выпустить обёрнутые токены на адрес вызывающего.

Выполнить распределение средств вкладчика в пользу gateway.

Вывод

withdraw(token, amount, party)

Сжечь обёрнутые токены вызывающего.

Перевести токен Canton из хранилища gateway указанному участнику.

Платёж

pay(id, token, to, amount)

Перевести токен ERC-20 от плательщика получателю.

Выполнить распределение средств, указанное в согласованных условиях платежа.

Работает в DevNet

На DevNet дважды провели депозит, платёж и вывод — 2026-10-25:

Запуск
Депозит
Платёж
Вывод

Первый: с 08:08 до 08:10 UTC

Блок 780: поступило 10 TKB, выпущено 10 wTKB.

Блок 783: V заплатил U 1 WtROME (обёрнутый tROME, токен ERC-20 в Ostia) в обмен на распределение 10 TKB от U в пользу V.

Блок 784: сожжено 4 wTKB, U выплачено 4 TKB.

Второй: с 11:31 до 11:34 UTC, с пакетом Daml 0.2.0

Блок 1465.

Блок 1471.

Блок 1473.

Каждая операция выполнялась в отдельном блоке. В каждом блоке запись операции и изменение баланса составляли одно обновление Canton. После второго запуска предложение wTKB составляло 12 — это значение может проверить любой пользователь в Ostia. Во время запуска Rome проверила, что шлюз на Canton хранит 12 TKB, то есть столько же, сколько составляет предложение. С 2026-10-25 эта информация также отображается в обозревателе: на странице токена wTKB есть карточка «Обеспечение на Canton», где указано, что на хранении находится 12 TKB при предложении в 12 wTKB.

U и V — тестовые стороны, созданные Rome и работающие на её участнике; все шаги выполняла Rome. Операции можно просмотреть в обозревателе: откройте /legs для просмотра списка или страницу блока, чтобы увидеть входящие в него операции. В операции вывода указывается сторона Canton, которой были переведены средства. wTKB — обычный токен ERC-20 с 10 десятичными знаками, поэтому его предложение и балансы отображаются так же, как у любого другого токена (см. раздел Обозреватель).

Rome выполняет пополнение, платёж и вывод каждые 10 минут, а проверка их работоспособности проводится каждые 30 секунд.

Чтобы самостоятельно вносить и выводить Canton Coin, подключите кошелёк Canton на странице обозревателя «Мост» после включения этой функции для вашего кошелька. На странице моста также можно блокировать tROME и TKA для Canton (шлюз pay в хранилище). Остальные платежи и пополнения TKB на этой странице выполняются тестовыми сторонами Rome.

Внесение токена Canton

Отправитель выделяет токен Canton для шлюза, назначая исполнителем оператора. Отправитель подписывает DepositRequest с указанием идентификатора пополнения, адреса EVM, которому разрешено получить токены, и выделенной суммы. Идентификатор пополнения — это SHA-256 от deposit,<depositor's party id>,<label>, поэтому только отправитель может создать идентификатор на основе идентификатора собственной стороны.

С этого адреса EVM вызывается функция claim. Шлюз выпускает токены для вызывающей стороны и записывает операцию пополнения. Получателю нужны tROME для оплаты газа. Сборщик сопоставляет операцию с запросом, зарегистрированным токеном и выделенной суммой.

Advance исполняет выделение средств в хранилище шлюза и фиксирует блок, в котором были выпущены обёрнутые токены. У обёрнутого токена 10 десятичных знаков, как и у сумм Canton. Преобразование между двумя суммами выполняется точно, без округления.

Вывод на сторону Canton

Держатель вызывает withdraw и указывает обёрнутый токен, сумму и полный идентификатор стороны Canton. Шлюз сжигает обёрнутые токены и записывает получателя в операцию.

Получатель должен подписать WithdrawalAcceptance. Подпись остаётся действительной, пока её не архивируют. Кроме того, сборщику необходим достаточный объём незаблокированных средств шлюза в зарегистрированном инструменте. Если эти условия не соблюдены, сборщик исключает транзакцию.

Advance переводит средства получателю через фабрику переводов реестра токенов. Перевод Canton и блок, содержащий сжигание токенов, фиксируются вместе. Сборщик включает не более одного вывода одного инструмента в блок, как описано в файле README сборщика.

Связать платёж с одним выделением средств

Плательщик Canton выделяет токен Canton получателю платежа Canton. Оба подписывают DvpTerms с указанием выделения средств, идентификатора платежа, токена EVM, получателя в EVM и суммы. Идентификатор платежа — это SHA-256 от текста в кодировке UTF-8 <Canton payer's party id>,<Canton payee's party id>,<label>, записанного в шестнадцатеричном формате нижнего регистра. Условия отклоняют любой другой идентификатор.

Плательщик EVM разрешает шлюзу использовать токены и вызывает pay с согласованными идентификатором, токеном, получателем и суммой. Шлюз переводит ERC-20 от плательщика к получателю в EVM и записывает операцию платежа. В демонстрации плательщиком управлял получатель платежа Canton, однако протокол не требует такой связи. Advance использует подписанные условия для исполнения выделения средств от плательщика Canton получателю Canton. Платёж ERC-20 и платёж Canton фиксируются вместе, поэтому ни один из них не становится окончательным без другого.

Обычный перевод ERC-20 не записывает операцию. Даже перевод того же токена тому же получателю в том же блоке не может заменить вызов payФункция платёжного процесса в архитектуре объясняет, как обеспечивается эта связь.

Токены ERC-20 и их аналоги в Canton

Аналог — это форма токена ERC-20, существующая в Canton, тогда как сам ERC-20 работает в Ostia. Это токен CIP-0056, соответствующий стандарту токенов Canton, с идентификатором инструмента erc20:<token address>, и он перемещается между сторонами посредством перевода, предусмотренного стандартом токена, если их участники одобрили ostia-twin. Сейчас это означает, что учётные записи должны принадлежать участникам Rome. Каждому twin соответствует один ERC-20, хранящийся в хранилище. У TKA и WtROME (обёрнутого tROME) есть twin в DevNet.

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

Погашение. Владелец подписывает запрос на погашение в Canton, после чего для хранилища вызывается release с тем же параметром ref. Хранилище переводит ERC-20 на EVM-адрес, указанный в запросе, а twin сжигается в том же блоке. Canton проводит погашение только при наличии соответствующего запроса на погашение.

По правилам сети twin выпускается только в ходе Advance, при наличии подтверждённого перевода в зарегистрированное хранилище; администратор twin — сторона шлюза — также может самостоятельно выпускать и сжигать токены. Модель доверия и ограничения описывает, на чём всё это основано.

Этап

Где происходит

Действие в Canton в Advance

Блокировка

Шлюз выполняет pay для хранилища.

Выпустить twin для получателя.

Погашение

release для хранилища на основании подписанного владельцем запроса.

Сжечь twin владельца.

29.10.2026 блокировка 5 TKA для стороны Canton попала в блок 28389, после чего у стороны было 5 twin. Она отправила 2 twin другой стороне Canton, а погашение этих 2 токенов попало в блок 28392. После этого предложение twin и баланс хранилища составляли по 3. На странице обозревателя /twins предложение каждого twin отображается рядом с балансом хранилища (см. Обозреватель).

Блокировка создаётся только для получателя, принявшего twin. Сторона однократно подписывает согласие на получение twin, и конструктор создаёт блокировку только для такой стороны. При подключении кошелька Canton на странице Мост это согласие подписывается в рамках процедуры подключения, поэтому весь цикл можно выполнить со своей стороной.

Canton Coin

Canton Coin поступает в Ostia через тот же шлюзовой депозит, что и любой токен Canton. Обёрнутый токен CC (0x4db3dea7c13116961fd3e438542ccfcca61a7547, 10 десятичных знаков; в более ранних записях он обозначен как wCC) зарегистрирован в фабрике, указанной сканирующим прокси валидатора. Сторона выделяет Canton Coin шлюзу и подписывает помеченный запрос на депозит, получатель получает CC в Ostia, а при выводе Canton Coin возвращается. Для Canton Coin требуется дополнительный входной параметр — контекст выбора, предоставляемый сканирующим прокси. Конструктор получает его до подтверждения блока.

29.10.2026 сторона внесла 5 Canton Coin через блок 28473, в результате чего у неё стало 15, у шлюза — 5, а предложение CC составило 5. Вывод в блоке 28474 вернул все три значения к исходным: 20, 0 и 0. В DevNet комиссия за эти переводы не взималась.

Что фиксирует доказательство

Для каждого этапа фиксируются его тип, идентификатор, токен, учётная запись, сумма и, если применимо, сторона Canton. Шлюз хеширует этапы в заданном порядке. Advance проверяет, что приложенные этапы дают хеш, указанный в подтверждённом состоянии шлюза. Если этап отсутствует, добавлен, переставлен или изменён, транзакция завершается ошибкой. Проверка также охватывает блоки без этапов.

Подтверждение блока не резервирует выделенные в Canton средства. Отправитель всё ещё может отозвать их до завершения расчётов. Если это происходит после подтверждения, Canton отклоняет Advance и reth возвращается к последнему зафиксированному блоку. Тот же подтверждённый блок нельзя отправить повторно без удалённой из него транзакции. При следующей сборке платёж не учитывается, как показано в запуске 4.

Ограничения токенов и хранения

В разделе Модель доверия и ограничения.

Последнее обновление

Это было полезно?