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

IBC-перевод истёк по timeout: как понять, когда возможен возврат

Почему IBC timeout не равен мгновенному возврату: проверка packet receipt, acknowledgement, сообщения timeout и средств в исходной сети.

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

Схематическая иллюстрация: IBC timeout. Схема IBC timeout и возвратного пути; не обещает мгновенное зачисление и не показывает реальный перевод.
Схематическая иллюстрация: IBC timeout. Схема IBC timeout и возвратного пути; не обещает мгновенное зачисление и не показывает реальный перевод.

Отсутствующий ACK — это ещё не доказательство, что пакет не дошёл. Для IBC timeout на исходной цепи требует доказательства, что receipt пакета отсутствует на принимающей стороне после истечения заданной высоты или времени. Только после успешной timeout-обработки приложение ICS-20 выполняет возврат на исходной цепи. ICS-20 Fungible Token Transfer, IBC: проверка отсутствия receipt для MsgTimeout.

Есть два важных пути возврата: отрицательный acknowledgement может запустить refund на отправляющей цепи после доставки подтверждения; timeout требует истечения условия и доказательства отсутствия receipt. IBC спецификация описывает вызов onTimeoutPacket только для пакета, который истёк и не будет принят на destination. Запрос статуса в интерфейсе и отсутствие нового события сами по себе не заменяют cryptographic proof.

Учебный пример

Допустим, условный перевод токена A отправлен по конкретным source/destination port и channel, с sequence 42 и timeout height H. К сроку в обозревателе не видно ACK. Возможны разные объяснения:

  • пакет ещё не принят, а ACK пока не создан;
  • пакет принят, но ACK не передан обратно;
  • эксплорер или relayer обновляет данные с задержкой.

Поэтому не отправляй второй перевод, опираясь только на отсутствие ACK. Сверь source tx hash, sequence, channel, timeout height/timestamp и состояние packet receipt/ack через поддерживаемый обозреватель или интерфейс маршрута. Если destination уже принял пакет, proof об отсутствии receipt не пройдет; отсутствие ACK не превращает полученные на destination средства в автоматический refund.

Чек-лист статуса

  1. Проверь исходную транзакцию и точную цепь отправления.
  2. Запиши port/channel и sequence пакета; сверь с destination chain.
  3. Проверь фактический timeout height и timestamp, которые были включены в пакет.
  4. Ищи либо acknowledgement (успешный или ошибочный), либо подтверждённый timeout/refund event на source chain.
  5. Для timeout убедись, что его обработчик/relayer предъявил доказательство non-receipt на высоте после timeout; само наступление даты не возвращает токен без обработки сообщения.
  6. Сверь возвратный актив и сумму на исходной цепи с условиями маршрута и комиссиями.

Если receipt destination есть, но ACK не виден, не делай timeout/refund выводов по одному UI-статусу. Нужна проверка пути acknowledgement/relayer и официальная поддержка маршрута. Если timeout уже обработан, ищи транзакцию на исходной цепи: именно она подтверждает refund, а не надпись «expired» без ссылки на источник.

Частые ошибки

  • «ACK не пришёл, значит токены вернутся». Неверно: ACK мог задержаться после приёма; timeout должен доказать отсутствие receipt.
  • «Время вышло — средства уже на кошельке». Истечение — условие для timeout, а не само выполнение возврата.
  • Повторить перевод с теми же реквизитами, пока первый неясен. Это может создать второй независимый пакет.
  • Смешать сети и каналы. Одинаковый токен-тикер не определяет source/destination denomination и channel.

Успешная диагностика заканчивается одним из проверяемых состояний: положительный ACK и получение, отрицательный ACK и возврат, либо обработанный timeout с proof/транзакцией возврата на source. Если данных не хватает, зафиксируй hash и sequence и обратись к поддержке конкретного relayer/моста, не отправляя повторно. Это разбор статусов, не проведение IBC-перевода.

Что читать дальше