Escrow в XRP Ledger: почему Finish или Cancel ещё недоступны

Вся развилка записана в одном объекте

Найдите подтверждённую `EscrowCreate`. Её отправитель записан в поле `Account`. Обычный порядковый номер `Sequence` становится `OfferSequence`. Если создание использовало объект `Ticket` вместо обычного номера, в `OfferSequence` ставят его `TicketSequence`. Эта пара нужна и для `EscrowFinish`, и для `EscrowCancel`. В завершающей транзакции поле `Owner` должно повторять исходный `Account`. Отправить её может любой аккаунт, но получатель и направление возврата уже зафиксированы.

Сохраните `Amount`, `Destination`, `FinishAfter`, `CancelAfter`, `Condition`, индекс объекта и номер подтверждённого реестра. `Amount` — удерживаемая сумма, а `Destination` — зафиксированный получатель. `FinishAfter` задаёт временную границу завершения, а `CancelAfter` — временную границу отмены. `Condition` — криптографическое условие, а `Fulfillment` — данные, которые его выполняют. Разбор ниже относится к классическому XRP Escrow.

Если `Amount` представлен объектом токена, отдельно проверьте активность TokenEscrow и правила доверительной линии. У токенов есть дополнительные условия, поэтому ветку классического XRP к ним нельзя переносить автоматически.

Временную границу задаёт предыдущий реестр

Поля времени считаются от эпохи Ripple. Сеть сравнивает их со временем закрытия предыдущего подтверждённого реестра. Завершение слишком раннее, пока `FinishAfter` позже этого времени. Отмена недоступна, пока `CancelAfter` позже времени предыдущего реестра. Равенство не подпадает под эти два условия отказа. Однако часы устройства не показывают, какой предыдущий реестр увидит следующая транзакция.

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

Condition не раскрывает секрет выполнения

`Condition` — шестнадцатеричное представление криптографического условия PREIMAGE-SHA-256. Для завершения передают исходное `Condition` и соответствующий `Fulfillment`. По одному условию нельзя восстановить секрет. Если байты изменились или относятся к другому объекту, операция не пройдёт.

Не вставляйте `Fulfillment` в публичную форму до отправки: любой аккаунт вправе подать корректный `EscrowFinish`. Это не позволяет переназначить получателя, но посторонний отправитель выберет момент исполнения и заплатит свою комиссию. После `CancelAfter` правильное выполнение условия уже не возвращает ветку завершения.

Finish и Cancel закрывают объект по-разному

Для завершения укажите `Owner` исходного отправителя и его `OfferSequence`. Добавьте `Condition` и `Fulfillment` только если они есть в объекте. При успехе Escrow удаляется, а сумма поступает на неизменяемый `Destination`. Если у получателя включён DepositAuth, авторизация входящего зачисления проверяется отдельно.

Для отмены используются те же `Owner` и `OfferSequence`, но только после `CancelAfter`. Успешная операция удаляет объект и возвращает удержанную сумму исходному `Account`. Если истёкший Escrow всё ещё виден, транзакцию отмены ещё никто не отправил. Средства автоматически не возвращаются.

Если операция не прошла, объект не нужно создавать заново

При слишком ранней попытке перечитайте подтверждённое время. При ошибке условия сравните байты `Condition` и `Fulfillment` с исходным объектом. При неверной паре `Owner` и `OfferSequence` вернитесь к `EscrowCreate`. Если объект уже исчез, найдите закрывшую его транзакцию и проверьте фактически доставленную сумму.

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