Кальтер / Блог

Вывод из OP Stack в Ethereum: как различить initiate, prove и finalize

Пользователь начал L2-to-L1 вывод из OP Stack и хочет определить этап, понять отдельные prove/finalize действия и сохранить tx identifiers.

Материал подготовлен с помощью ИИ; источники и примеры проверены редакцией ZASLON. Учебные примеры не описывают результаты клиентов.

Вывод из OP Stack — поясняющая схема
Редакционная схема: Вывод из OP Stack. Условные обозначения, не реальные результаты клиента.

Вывод из OP Stack — не одно действие, а последовательность: инициирование на L2, доказательство на L1 и финализация на L1 после периода challenge. Подтверждённая L2-транзакция говорит, что запрос был инициирован, но не что средства уже получены в Ethereum. Спецификация OP описывает эти стадии отдельно и указывает, что финализация исполняется транзакцией в L1 portal (OP Stack withdrawal specification).

Три стадии и что проверить

Initiate — L2. Пользователь отправляет withdrawal message через L2ToL1MessagePasser. Сохрани L2 hash, сеть, сумму и адрес назначения. Успешный receipt подтверждает включение вызова на L2, но это ещё не перевод ETH в кошелёк Ethereum.

Prove — L1. Сообщение доказывается в OptimismPortal с использованием данных о включении в L2 output. Сохрани L1 hash и убедись, что доказательство относится к тому же withdrawal/message. С этого этапа начинается challenge period по правилам конкретного OP Stack rollup. Не переноси длительность одного rollup на другой; проверь актуальные параметры сети и интерфейс провайдера.

Finalize — L1. После выполнения условий портала withdrawal можно финализировать отдельной L1-транзакцией. Помимо периода ожидания могут действовать проверки доказательства и паузы; истечение одного таймера не гарантирует доступность финализации. Затем открой L1 receipt и проверь событие WithdrawalFinalized для того же withdrawal hash и его поле success: статус внешней транзакции success сам по себе не равен успешному исполнению сообщения внутри портала. Если поле события указывает неуспех, изучи причину/повторную попытку по документации конкретной сети. Подтверди также фактическое изменение баланса получателя. Для понимания общей модели optimistic rollups пригодится справка Ethereum.org, но конкретные статусы сверяй со спецификацией и порталом своей сети.

Пример журнала статусов

Условный запрос: L2 инициирование получило hash 0x…11; L1 proof ещё отсутствует. Запиши статус «инициирован на L2; proof не подтверждён». Не называй вывод завершённым и не отправляй второй запрос вместо проверки.

Позже появляется L1 prove transaction. Запиши её отдельно и отметь challenge period как ожидающий. После окончания периода проверь, что интерфейс для нужной сети разрешает finalize и что параметр withdrawal совпадает с исходным сообщением. Только после успешной L1 финализации и проверки receipt/баланса обозначай «финализирован». Сами hashes в примере вымышлены.

Как диагностировать «успешно», если деньги не видны

Не полагайся только на зелёную галочку интерфейса: она может относиться к внешнему вызову, транзакции-обёртке или первому этапу. Открой нужную сеть и раздели запись на:

Контроль Стадия Что подтверждает
L2 receipt и message hash Initiate Запрос записан на L2
L1 prove receipt и соответствующее сообщение Prove Доказательство принято на L1
L1 receipt, WithdrawalFinalized с success=true и баланс получателя Finalize Сообщение исполнено и поступление подтверждено

При финализации проверь не только внешний L1 receipt: спецификация OP Stack описывает событие WithdrawalFinalized(bytes32 withdrawalHash, bool success), где success сообщает исход исполнения целевого сообщения. Сверь его hash и флаг, затем баланс. Перед любым действием сверь официальный интерфейс конкретной сети, адрес назначения, комиссии и статус сообщения. Не делай повторную отправку, пока не разобрана существующая операция. Срок, комиссии и шаги зависят от выбранного rollup и его текущей конфигурации; этот материал не гарантирует время вывода и не заменяет документацию провайдера.

Сопоставить обе сети и не потерять промежуточный статус поможет журнал проверки bridge-перевода.