APRENDER
¿Qué es ₿? Nodos Mitos y FUD Glosario Curso ⚡
EXPLORAR
Libros Referentes Mapa de adopción
ACTUAR
Compra tu ₿ Guarda tu ₿ Privacidad Calculadora Contribuye⚡
🔍 ESC

Qué es un timelock:
bitcoins que esperan su momento.

Qué es un timelock en Bitcoin: nLockTime, CLTV y CSV, bloqueos absolutos o relativos, con ejemplos de herencia y de canales Lightning.

Ilustración animada: una cadena de bloques avanza. Una moneda con CLTV está bloqueada hasta la altura 1.000.000, la misma para todos. Otra con CSV necesita 144 confirmaciones (≈ 1 día) contadas desde el bloque que la confirma, el 999.904, así que su gasto puede entrar a partir del bloque 1.000.048. Al cumplirse cada plazo, su candado se abre.
CLTVGastable
1.000.000 altura fija Ya se puede gastar: el gasto puede entrar en el bloque #1.000.001.
CSVBloqueada
+144 bloques tras confirmarse Confirmada en el bloque 999.904: faltan 37 bloques. 107 / 144 confirmaciones
Ejemplo con los números de esta guía. El absoluto apunta a una altura fija; el relativo empieza a contar en el bloque que confirma la moneda. A 10 minutos por bloque, 144 bloques son unas 24 horas.

Qué es un timelock

Respuesta corta: un timelock (bloqueo de tiempo) es una regla que impide gastar unos bitcoins, o confirmar una transacción, antes de un momento dado. Ese momento puede ser absoluto (un número de bloque o una fecha: «no antes del bloque 1.000.000») o relativo (un plazo que empieza a contar cuando se confirma la moneda: «no antes de 144 bloques después»). Lo comprueban todos los nodos de la red, así que nadie, ni siquiera el dueño de la clave, puede saltárselo. Es la pieza que hace posibles los canales de Lightning y los planes de herencia sin intermediarios.

En 30 segundos

Cuatro herramientas: nLockTime y nSequence son campos de la transacción; OP_CHECKLOCKTIMEVERIFY (CLTV) y OP_CHECKSEQUENCEVERIFY (CSV) son instrucciones del script que bloquean las propias monedas. Absoluto = hasta un bloque o una fecha; relativo = N bloques o N×512 segundos desde que se confirmó la moneda. Regla del número: por debajo de 500.000.000 es una altura de bloque; a partir de ahí, una fecha Unix. Cuentas rápidas: 144 bloques ≈ 1 día, 1.008 ≈ 1 semana, 52.560 ≈ 1 año. Lo importante: un timelock no se puede adelantar; si te equivocas, las monedas esperan igual.

Las cuatro herramientas

Dos viven en la transacción (deciden cuándo puede entrar en un bloque esa transacción concreta) y dos en el script de una salida (deciden cuándo se pueden gastar esas monedas, las gaste quien las gaste y con la transacción que sea).

HerramientaDónde estáTipoDesde
nLockTimeCampo de 4 bytes de la transacciónAbsolutoBitcoin original (2009)
OP_CHECKLOCKTIMEVERIFY (CLTV)Script de la salida (antiguo OP_NOP2)AbsolutoBIP 65, activado en diciembre de 2015 (bloque 388.381)
nSequenceCampo de cada entrada (transacciones versión 2)RelativoBIP 68, activado en julio de 2016 (bloque 419.328)
OP_CHECKSEQUENCEVERIFY (CSV)Script de la salida (antiguo OP_NOP3)RelativoBIP 112, activado con el BIP 68 en julio de 2016

Los BIP 68, 112 y 113 se activaron juntos como un único soft fork (conocido como «CSV») el 4 de julio de 2016. El BIP 113 cambió la forma de medir el tiempo: desde entonces los bloqueos por fecha se comparan con la mediana del tiempo de los 11 bloques anteriores (MTP, median time past), y no con la hora que pone el minero en su bloque, que podría falsear un poco.

Absoluto o relativo: la diferencia

Un bloqueo absoluto fija el mismo momento para todos: si el script dice «bloque 1.000.000», da igual cuándo recibiste las monedas, todas se liberan a la vez. Un bloqueo relativo pone en marcha un reloj por cada moneda (cada UTXO) en el momento en que se confirma: «144 bloques después» significa cosas distintas para una moneda que llegó hoy y para otra que llegó hace un mes.

Laboratorio: CLTV y CSV en la línea de bloques

Dos monedas, dos bloqueos de unos 52.560 bloques (≈ 1 año). La moneda A usa CLTV: se libera en una altura fija de la cadena, la misma para todo el mundo. La moneda B usa CSV: se libera N bloques después de confirmarse, así que su reloj no empieza hasta que entra en un bloque. Mueve el deslizador para avanzar el tiempo y confirma la moneda B antes o después: verás que su desbloqueo se desplaza y el de A no.

Bloque actual#—
Tiempo avanzado—
CLTVMoneda A · bloqueo absoluto

CSVMoneda B · bloqueo relativo

  • CSV ≤ 65.535El plazo relativo ocupa 16 bits de nSequence: como mucho 65.535 bloques (≈ 455 días) o 65.535 × 512 s (≈ 388 días). Prueba a escribir 70.000 en la moneda B. Fuente: BIP 68.
  • < 500.000.000Un valor de nLockTime o de CLTV menor que 500.000.000 es una altura de bloque; si es mayor o igual, es una fecha Unix en segundos. Fuente: BIP 65.
  • OP_CSV · v2OP_CHECKSEQUENCEVERIFY obliga a que la entrada lleve ese nSequence, y el bloqueo relativo solo cuenta en transacciones de versión 2 o superior. Fuente: BIP 112.

El tiempo es aproximado: se cuenta a 10 minutos por bloque (144 al día), pero los bloques llegan cuando llegan. La altura actual sale de mempool.space; si no hay conexión, se estima a partir del bloque 840.000 (20 de abril de 2024). Detalle fino: con CLTV la transacción que gasta puede entrar en el bloque siguiente a la altura indicada; con CSV, en el bloque «confirmación + N».

Por bloques o por tiempo: el umbral de 500.000.000

Absoluto. El campo nLockTime guarda un solo número y Bitcoin decide qué significa por su tamaño: si es menor que 500.000.000 es una altura de bloque; si es mayor o igual, es una fecha Unix (segundos desde el 1 de enero de 1970). El umbral no es casual: 500.000.000 bloques son unos 9.500 años, y 500.000.000 segundos caen en noviembre de 1985, antes de que existiera Bitcoin, así que no hay confusión posible. Ejemplos: 1000000 = «no antes del bloque 1.000.000»; 1893456000 = «no antes del 1 de enero de 2030 a las 00:00 UTC» (según la MTP, que va más o menos una hora por detrás de la hora real). La transacción solo puede entrar en un bloque cuando la cadena ya ha superado ese valor, y el campo solo cuenta si al menos una entrada tiene un nSequence distinto de 0xFFFFFFFF.

Relativo. El BIP 68 reaprovecha el campo nSequence de cada entrada (solo en transacciones de versión 2 o superior). De sus 32 bits importan tres cosas:

Ejemplos: 0x00000090 = 144 bloques (≈ 1 día); 0x004000A9 = 169 unidades × 512 s = 86.528 s (≈ 1 día por tiempo). El máximo es 65.535 bloques (≈ 455 días) o 65.535 × 512 s (≈ 388 días): un bloqueo relativo no puede durar más de un año y pico. Para plazos más largos hace falta uno absoluto.

Pruébalo: ¿qué significa este número?

Escribe un valor de nLockTime (o de CLTV) para ver cómo lo interpreta un nodo, o un plazo relativo para ver cuánto dura y cómo queda en nSequence.

Los días por bloques son aproximados: un bloque tarda 10 minutos de media, pero puede tardar bastante más o menos.

Cómo se escribe en un script

CLTV y CSV no leen ningún reloj. Lo que hacen es obligar a la transacción que gasta la moneda a llevar un nLockTime (o un nSequence) igual o mayor que el valor del script y del mismo tipo (bloques con bloques, tiempo con tiempo); si no, el script falla. Y como esa transacción no puede entrar en un bloque antes de su propio bloqueo, las monedas quedan bloqueadas hasta entonces. Es el truco del BIP 65 y del BIP 112.

# Absoluto: esta moneda solo la puede gastar «clave» a partir del bloque 1.000.000 1000000 OP_CHECKLOCKTIMEVERIFY OP_DROP <clave> OP_CHECKSIG # Relativo: solo «clave», y 144 bloques (≈ 1 día) después de confirmarse 144 OP_CHECKSEQUENCEVERIFY OP_DROP <clave> OP_CHECKSIG

Nadie escribe estos scripts a mano en el día a día: las wallets modernas usan descriptores y Miniscript, donde los mismos bloqueos se escriben after(1000000) (absoluto) y older(144) (relativo). Con Taproot, además, el camino con timelock puede ir escondido en una hoja del árbol de scripts y solo se revela si se usa (mira Taproot y SegWit).

Ejemplo 1: herencia con multifirma y llave de recuperación

El problema clásico: si solo tú puedes mover tus bitcoins, tu familia no podrá cuando faltes; si les das una copia de tus llaves, pueden moverlos hoy. Un timelock relativo resuelve las dos cosas. La wallet tiene dos caminos para gastar:

Camino normal · siempre2 de 3 llaves: A, B y CTus llaves de la multifirma (por ejemplo, dos Trezor en sitios distintos y una tercera copia). Las usas como siempre.
Camino de recuperación · tras el plazoLlave H del heredero + 52.560 bloquesSolo vale cuando las monedas llevan ≈ 1 año (365 × 144 bloques) sin moverse. Antes, la llave H sola no puede gastar nada.

En Miniscript sería algo así: or_d(multi(2,A,B,C), and_v(v:pk(H), older(52560))). Cómo funciona con números:

Simúlalo: la llave del heredero y el reloj que se renueva

Recibes las monedas en el bloque actual. Mueve el deslizador para que pase el tiempo y pulsa «Mover las monedas» para renovar: cada movimiento crea una moneda nueva y su reloj de 52.560 bloques vuelve a cero. Prueba el plan «renovar cada 10 meses», avanza un año y medio y pulsa «Dejas de renovar»: la rama del heredero se abre 52.560 bloques después del último movimiento.

Bloque actual#—
Último movimiento#—
Bloques sin moverse0
Camino normal · 2 de 3 (A, B, C)Abierto

Camino de recuperación · llave H

¿Y con un bloqueo absoluto? Con after() el camino de recuperación se abre en una fecha fija (por ejemplo, el 1 de enero de 2030) para todas las monedas a la vez; antes de esa fecha tienes que pasar los fondos a una wallet nueva con una fecha posterior. Sirve también para plazos de más de 455 días, que el relativo no permite.

Ejemplo 2: canales Lightning y to_self_delay

Un canal de Lightning funciona gracias a dos timelocks. El primero, relativo, protege contra las trampas al cerrar. Según la especificación BOLT 3, la parte del saldo de quien cierra el canal por su cuenta (la salida to_local) lleva este script:

OP_IF # la otra parte, si este reparto ya estaba revocado (penalización) <revocationpubkey> OP_ELSE # quien cierra, pero solo tras to_self_delay bloques `to_self_delay` OP_CHECKSEQUENCEVERIFY OP_DROP <local_delayedpubkey> OP_ENDIF OP_CHECKSIG

El plazo lo elige cada nodo para su contraparte: LND, por ejemplo, lo escala con el tamaño del canal entre 144 y 2.016 bloques (≈ 1 día a 2 semanas). El segundo timelock es absoluto: cada pago en tránsito (HTLC) lleva un vencimiento cltv_expiry con CLTV, y cada nodo de la ruta se guarda un margen (cltv_expiry_delta, 80 bloques por defecto en LND). Si un pago caduca en el bloque N + 240 para el primer salto, el segundo recibe N + 160 y el tercero N + 80: así cada intermediario tiene tiempo de reclamar su parte en la cadena si algo sale mal.

Otros usos que ya ves cada día

Riesgos y errores comunes

Preguntas frecuentes

¿Qué diferencia hay entre CLTV y CSV?

CLTV (OP_CHECKLOCKTIMEVERIFY, BIP 65) es un bloqueo absoluto: hasta un bloque o una fecha concretos. CSV (OP_CHECKSEQUENCEVERIFY, BIP 112) es relativo: un número de bloques o de unidades de 512 segundos contado desde que se confirmó la moneda que se gasta.

¿Cómo sabe Bitcoin si un nLockTime es un bloque o una fecha?

Por el número: si es menor que 500.000.000 es una altura de bloque; si es 500.000.000 o mayor, es una fecha Unix en segundos, que se compara con la mediana del tiempo de los 11 bloques anteriores (BIP 113).

¿Cuánto puede durar como máximo un timelock relativo?

65.535 bloques (unos 455 días) o 65.535 unidades de 512 segundos (unos 388 días), porque el valor ocupa 16 bits del campo nSequence. Para plazos más largos se usa un bloqueo absoluto.

¿Se puede cancelar o adelantar un timelock?

No. Lo comprueban todos los nodos y ninguna firma lo salta. Solo se puede evitar si el script tiene otro camino sin bloqueo (por ejemplo, el 2 de 3 de una herencia) y tienes las llaves de ese camino.

¿Qué es to_self_delay en Lightning?

Es el plazo relativo, con CSV, que espera quien cierra un canal de forma forzosa antes de poder gastar su saldo. Sirve para que la otra parte tenga tiempo de penalizarle si publicó un estado antiguo del canal. Suele ir de 144 bloques (un día) a 2.016 (dos semanas).

Sigue aprendiendo

Fuentes: BIP 65 (CHECKLOCKTIMEVERIFY), BIP 68 (nSequence relativo), BIP 112 (CHECKSEQUENCEVERIFY), BIP 113 (median time past), BOLT 3 (to_local y HTLC en Lightning), Miniscript y documentación de LND. Esta guía es educativa: prueba cualquier montaje con timelocks con una cantidad pequeña antes de confiarle tus ahorros.