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).
| Herramienta | Dónde está | Tipo | Desde |
|---|---|---|---|
| nLockTime | Campo de 4 bytes de la transacción | Absoluto | Bitcoin original (2009) |
| OP_CHECKLOCKTIMEVERIFY (CLTV) | Script de la salida (antiguo OP_NOP2) | Absoluto | BIP 65, activado en diciembre de 2015 (bloque 388.381) |
| nSequence | Campo de cada entrada (transacciones versión 2) | Relativo | BIP 68, activado en julio de 2016 (bloque 419.328) |
| OP_CHECKSEQUENCEVERIFY (CSV) | Script de la salida (antiguo OP_NOP3) | Relativo | BIP 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.
La moneda A se confirmó antes que la B, así que se libera antes. En el bloqueo absoluto la fecha de llegada no importa.
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.
- 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
nLockTimeo 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 · v2
OP_CHECKSEQUENCEVERIFYobliga a que la entrada lleve esenSequence, 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:
- 1<<31bit 31 = 1: sin bloqueo relativo (desactivado)
- 1<<22bit 22: 0 = bloques · 1 = unidades de 512 segundos
- 0x0000FFFFbits 0-15: el valor (de 0 a 65.535)
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.
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:
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:
- Recibes 0,5 BTC y se confirman en el bloque X. El reloj de esa moneda empieza a contar.
- Cada ~10-11 meses te envías las monedas a una dirección nueva de la misma wallet (con 2 de 3 firmas). Al confirmarse, el reloj vuelve a cero. Cuesta una comisión por cada renovación.
- Si faltas, nadie renueva. Cuando la cadena llega al bloque X + 52.560, tu heredero puede gastar con la llave H sola, sin depender de una empresa ni de un notario que custodie tus claves.
- Y si alguien roba H antes, no puede hacer nada mientras sigas renovando: el plazo le cierra el paso.
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.
¿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:
- Canal de 1.000.000 sats: Ana tiene 700.000 y Bea 300.000. Al abrirlo pactaron
to_self_delay= 144 bloques (≈ 1 día). - Ana cierra de forma forzosa y publica su último estado. Bea cobra sus 300.000 enseguida; los 700.000 de Ana quedan bloqueados 144 bloques desde que se confirma el cierre.
- Si Ana hizo trampa y publicó un estado antiguo (en el que tenía más), Bea tiene esos 144 bloques para usar la clave de revocación y llevarse todo el canal. Si no hay trampa, pasado el plazo Ana gasta sus 700.000 normalmente.
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
- Contra el «fee sniping». Bitcoin Core y otras wallets ponen en
nLockTimela altura del bloque actual. Así la transacción solo cabe en el bloque siguiente o posteriores, y a un minero no le compensa reescribir el bloque anterior para quedarse sus comisiones. - Pagos programados. Puedes firmar hoy una transacción con
nLockTimefuturo y entregarla: el destinatario no puede difundirla antes. Ojo: tú sí puedes gastar esas monedas antes en otra transacción, así que no es una garantía para quien la recibe (para eso hace falta CLTV en el script). - Monedas recién minadas. La recompensa de un bloque no se puede gastar hasta 100 bloques después. No usa CLTV ni CSV: es una regla de consenso propia (mira la transacción coinbase).
Riesgos y errores comunes
- No hay marcha atrás. Si bloqueas monedas hasta el bloque equivocado (o pones una fecha de 2062 en vez de 2026), esperan igual: ningún nodo ni minero puede adelantarlo.
- Bloques no son minutos exactos. 52.560 bloques suelen ser un año, pero pueden ser semanas más o menos. Y los bloqueos por fecha siguen la MTP, que va ~1 hora por detrás. Deja margen.
- Herencia: si te olvidas de renovar, el camino de recuperación se abre en vida y el heredero (o quien le robe la llave H) puede gastar. Pon un recordatorio y guarda la llave H tan bien como las demás.
- Sin el descriptor no hay recuperación. Tus herederos necesitan las llaves y también la descripción de la wallet (descriptor con las claves públicas y los plazos). Déjala junto a unas instrucciones claras y pruébalo antes con una cantidad pequeña.
- Lightning: no te quedes desconectado más que el plazo. Si tu nodo está apagado más de
to_self_delaybloques, la otra parte podría publicar un estado viejo sin que nadie lo castigue. Usa una watchtower. - Transacciones «no finales». Una transacción cuyo
nLockTimeaún no ha llegado no se acepta en la mempool: tienes que guardarla y difundirla tú cuando toque, y para entonces las comisiones pueden ser otras.
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.