nLockTime, CLTV и CSV в Bitcoin: как проверить, когда можно потратить UTXO

nLockTime — абсолютная граница всей транзакции

Значение nLockTime меньше 500 000 000 трактуется как высота блока, не меньше порога — как Unix time. По текущей consensus-реализации оно обозначает последнюю ещё недопустимую height/time: для следующего блока nLockTime должен быть строго меньше проверяемой высоты или MTP. Если все inputs имеют nSequence 0xffffffff, IsFinalTx игнорирует nLockTime. Поэтому число в поле без последовательностей inputs не даёт ответа.

BIP-113 использует Median Time Past — медиану timestamp предыдущих 11 блоков — вместо локальных часов. MTP движется дискретно и может отставать от календарного времени. Подтверждения и финальность также важны для исходного UTXO: неподтверждённый prevout ещё не даёт стабильной height, от которой можно надёжно считать относительную ветку.

CLTV связывает script operand с nLockTime

Когда выполняется OP_CHECKLOCKTIMEVERIFY, верхний элемент stack должен быть неотрицательным, иметь тот же тип height/time, что tx.nLockTime, и быть не больше tx.nLockTime. У проверяемого input nSequence не может быть final 0xffffffff. CLTV сам не выбирает ветку и не проверяет текущую цепь напрямую: он заставляет spending transaction нести подходящий nLockTime, который затем ограничивает включение блока.

Если CLTV находится под IF/ELSE, условие действует только для реально исполняемой ветки. Адрес или descriptor должен раскрыть точный script и условия подписей; один txid prevout показывает сумму, но не намерение выбранного пути. Начните с модели UTXO и сдачи, затем сопоставьте outpoint с полным locking script.

CSV считает возраст конкретного input

BIP-68 при transaction version не ниже 2 интерпретирует nSequence input как относительный lock, если старший disable bit не установлен. Type flag выбирает blocks или time; значимы младшие 16 бит. Time-based значение умножается на 512 секунд и сравнивается через MTP предыдущих блоков. Для block-based значения исходная точка — height блока, подтвердившего spent output.

OP_CHECKSEQUENCEVERIFY сравнивает operand ветки с masked nSequence этого же input. Ошибка возникает при version ниже 2, disable flag в transaction input, несовпадении height/time типа или недостаточном masked value. CSV не говорит «через N блоков от создания кошелька»: он относится к возрасту точного prevout, который этот input тратит.

Spendability подтверждена только когда exact script path, signatures и все lock constraints валидны в одном chain context; достаточный срок не гарантирует inclusion или разумную fee. Если transaction отклонена, сохраните raw hex и reject reason, исправьте поля без раскрытия ключей и только затем применяйте coin control или работу с мемпулом, RBF и CPFP — эти инструменты не обходят timelock.