Timestamp GIT

← Todos los artículos

2026-11-16

¿Las marcas de tiempo de los commits de Git sirven como prueba?

¿Las marcas de tiempo de los commits de Git sirven como prueba?
timestamp git blockchain proof

¿Los timestamps de los commits de Git sirven como prueba?

Abre una terminal, ejecuta git log y cada commit te devuelve la mirada con una fecha. Parece algo con autoridad: un registro permanente, generado por la máquina, de que el código existía en ese momento. Así que cuando surge una pregunta semanas o años después (“¿quién lo tuvo primero?”, “¿cuándo se publicó realmente?”), es tentador tratar esas fechas como evidencia.

No lo son. No en el sentido que importa cuando un abogado, un auditor o un ex empleado está al otro lado de la mesa.

Este artículo responde la pregunta directamente —¿tienen los commits de Git timestamps en los que puedas confiar?— y luego muestra cómo se ve un timestamp en el que sí puedes confiar: un hash de commit anclado en la blockchain de Bitcoin, producido automáticamente por una GitHub App que instalas una sola vez.

La respuesta corta: los timestamps de Git no son prueba

Los timestamps de los commits de Git son metadatos autoinformados. Los establece la máquina que creó el commit, se pueden modificar después y nada en el protocolo de Git verifica que correspondan al tiempo del mundo real.

En concreto:

  • Git almacena una fecha de autor y una fecha de committer como campos simples dentro del objeto commit. Cualquiera que pueda crear un commit puede ponerles lo que quiera.
  • Esos campos no están firmados por una fuente de tiempo confiable. No hay mecanismo de consenso, ni tercero, ni testigo.
  • El historial se puede reescribir: commits enmendados, rebasados o recreados desde cero con nuevas fechas y nuevos hashes.

Hay un segundo problema, más sutil. Aunque nunca toques las fechas, la única copia de “cuándo ocurrió esto” vive en infraestructura que no controlas: los servidores de GitHub, tus logs de CI, el reflog de tu portátil. En una disputa, los logs internos se descartan habitualmente por interesados: claro que tu sistema dice que lo hiciste primero, tú escribiste el sistema.

Así que hay una distinción real que trazar:

Propósito El timestamp de Git es…
Ordenar commits, leer el historial, hacer bisect de bugs Perfectamente válido
Mensajes de Slack, changelogs, notas de versión Válido
Disputas de patentes, reclamaciones de propiedad intelectual, disputas de pago, auditorías No es evidencia

Los timestamps de Git son una comodidad de flujo de trabajo. Nunca se diseñaron para ser prueba.

Por qué los timestamps de Git son tan fáciles de falsificar

El reloj es tuyo

Git lee el reloj del sistema de la máquina donde se crea el commit. Cambia el reloj, cambia el timestamp:

GIT_AUTHOR_DATE="2019-03-04T10:00:00" \
GIT_COMMITTER_DATE="2019-03-04T10:00:00" \
git commit -m "Feature that definitely existed in 2019"

Ese commit es un objeto Git perfectamente válido. Se hará push, clone y se mostrará en la interfaz de GitHub sin queja alguna. Cualquiera con acceso al repositorio puede hacer esto, y no hay rastro de auditoría que muestre que la fecha fue fabricada.

El historial es mutable por diseño

El historial de Git es una cadena de hashes, pero la cadena es tuya para reconstruirla:

git commit --amend --date="2019-03-04T10:00:00"
git rebase -i HEAD~10   # reword, squash, reorder, re-date

Reescribir el historial produce nuevos hashes de commit, que es exactamente el punto. El hash antiguo desaparece, el nuevo lleva la fecha que hayas escrito y nada externo es testigo de la transición. Si te preguntas si el contenido de un commit es a prueba de manipulación (lo es: cambiar un byte cambia el hash), esa es una propiedad distinta de que la fecha sea confiable. El hash demuestra qué era el código. No dice nada sobre cuándo.

La plataforma de alojamiento no es un notario

GitHub registra las fechas que Git le entrega. Sus logs viven en sus propios servidores y son mutables por la plataforma, por los administradores del repositorio y por cualquiera que reescriba y haga force-push. En un contexto legal, “nuestro historial de commits en GitHub lo dice” es una afirmación, no una prueba matemática.

La analogía del diario

Piensa en una entrada de diario frente a un documento notariado. Ambos registran una fecha. Ambos parecen oficiales cuando los lees. Pero solo el notariado es confiable para un desconocido, porque un tercero sin interés en el resultado confirmó la fecha y la hizo imposible de cambiar después sin que se detecte.

Un timestamp de commit de Git es una entrada de diario. El timestamp criptográfico es el notario.

Qué demuestra realmente que el código existió en un momento específico

El mecanismo es más simple de lo que suena:

  1. Huella el contenido. Ejecuta un hash criptográfico (SHA-256) sobre los datos. El hash es una cadena de tamaño fijo que cambia por completo si cambia un solo byte de la entrada.
  2. Ancla la huella públicamente. Escribe ese hash en un libro contable que ninguna parte controla y que no se puede reescribir: Bitcoin.
  3. Conserva el recibo. Ahora cualquiera que tenga los datos originales puede volver a hashearlos, compararlos con el valor anclado y confirmar que existían en el momento del bloque o antes.

Bitcoin es el ancla correcta porque es descentralizado: ninguna empresa, incluida la que presta el servicio, puede alterar un bloque confirmado. Una vez que una transacción queda enterrada unos cuantos bloques, reescribirla requeriría rehacer más trabajo del que produce la red.

OpenTimestamps hace esto práctico a escala. En lugar de poner cada hash directamente on-chain, agrupa muchos hashes en un árbol de Merkle y compromete solo la raíz, de modo que miles de commits comparten una sola transacción de Bitcoin: barato, rápido y preservando la privacidad. El resultado es un pequeño archivo de recibo .ots que puedes verificar de forma independiente.

El inconveniente es operativo: hacerlo a mano implica ejecutar herramientas, gestionar calendarios y manejar recibos por lote. Esa es la forma difícil, y es precisamente lo que Timestamp GIT automatiza.

Cómo Timestamp GIT hace confiables los timestamps de Git

Timestamp GIT es un servicio gestionado construido en torno a una GitHub App. Instalas la app una vez en un repositorio; a partir de entonces, cada commit se ancla en Bitcoin automáticamente. Sin CLI, sin scripts, nada que ejecutar en las máquinas de los desarrolladores.

Paso 1 — La huella. Git ya produce un hash único para cada commit. Ese hash es una huella unidireccional del estado de tu repositorio en ese momento.

Paso 2 — El ancla. Cada noche, un worker recopila los hashes de commit pendientes del día, los escribe en un manifiesto por repositorio (.txt), construye un árbol de Merkle y ancla la raíz de Merkle en un bloque de Bitcoin a través de calendarios públicos de OpenTimestamps. La confirmación de Bitcoin suele tardar unas tres horas, así que los archivos de prueba llegan unas horas después de que se ejecute el lote.

Paso 3 — La prueba. El manifiesto y los archivos de recibo .ots correspondientes se devuelven a tu repositorio, en una rama dedicada de timestamps, o en un repositorio sombra separado si prefieres mantenerlos aparte. Ahora tienes un recibo que demuestra que los hashes existían antes de un bloque de Bitcoin específico.

Las garantías que se derivan de este diseño:

  • Zero-knowledge. El servicio solo lee hashes de commit. Tu código fuente nunca se copia, almacena ni inspecciona.
  • Independiente del proveedor. La prueba es SHA-256 más datos de bloques de Bitcoin. Sin formato propietario, sin lock-in: un verificador de OpenTimestamps de terceros puede comprobarla sin nuestra intervención.
  • Verificable offline. El archivo .ots es autocontenido. Si el servicio desapareciera mañana, la prueba seguiría en pie.

Para la confirmación del día a día, ni siquiera abres los recibos. La página de estado pública de un repositorio muestra la longevidad de la prueba, la fecha de anclaje más temprana, la regularidad diaria y los datos del bloque y la transacción de Bitcoin, además de un CSV de auditoría descargable y un certificado PDF por fecha. Hay una página de verificación en el navegador que recorre la cadena de Merkle paso a paso, calculando todo localmente para que nadie —incluidos nosotros— vea lo que estás comprobando. Y un badge de Shields.io embebible puede ir directamente en tu README.

Si quieres integrar esto en tus propias herramientas, la API es sencilla:

# Combined summary (feeds the Shields.io badge)
curl https://timestampgit.dev/api/statusSummary/acme/payments-service

# Latest anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/acme/payments-service

# Full Merkle chain data for a specific day, for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-11-15

Los repositorios privados añaden un HMAC cifrado a estas URL, de modo que el estado solo es visible para usuarios autorizados.

Conceptos erróneos comunes sobre Git y los timestamps

“Los commits de Git son inmutables, así que los timestamps deben ser confiables.” La inmutabilidad se aplica al contenido, no a los metadatos. Cambiar la fecha de un commit produce un hash distinto, que es exactamente por lo que la fecha no es evidencia: simplemente creas un nuevo commit con un nuevo hash y una nueva fecha, y el antiguo desaparece de la rama.

“El historial de commits de GitHub es prueba suficiente.” Los logs de la plataforma no están anclados criptográficamente a nada fuera de la plataforma. Los administradores y los force-push pueden reescribirlos, y en las disputas se descartan con frecuencia por autoinformados.

“El timestamp con blockchain requiere conocimientos profundos de criptografía o herramientas manuales.” Hacerlo en crudo sí. Usar un servicio gestionado no: instalas la GitHub App y el anclaje ocurre según un calendario nocturno en el que nunca piensas. La criptografía es real; la carga operativa es cero.

“El timestamp expone mi código.” Solo los hashes salen de tu repositorio. El hash de un commit no revela nada sobre su contenido: no puedes revertirlo ni compararlo con nada sin tener ya el original.

Cuándo necesitas prueba criptográfica (y cuándo no)

Para el desarrollo cotidiano, los timestamps de Git están bien. No vas a anclar cada rama de corrección de bugs, y no deberías.

Recurre a la prueba criptográfica cuando una fecha pueda tener que sobrevivir a una conversación adversarial:

  • Disputas de patentes. Una entidad no practicante presenta una patente amplia sobre algo que tú publicaste meses antes. El estado de la técnica anclado es cómo invalidar la reclamación. (Más sobre esto en Cryptographic Prior Art: The Startup Shield Against Patent Trolls.)
  • Reclamaciones de propiedad intelectual de empleados. Un desarrollador líder que se marcha disputa cuándo se concibió una funcionalidad. Un timestamp inmutable pone fin al “él dijo, ella dijo”.
  • Disputas de pago con clientes. Las agencias pueden demostrar fechas de entrega en lugar de discutir sobre los plazos de las facturas.
  • Plagio en freelance. Demuestra que una librería o una pieza de portafolio fue tuya primero.
  • Cumplimiento y auditorías. Muestra un registro verificable, anclado por terceros, de cuándo cambió el código, sin entregar el código fuente.

Que tal prueba sea admisible depende de la jurisdicción y las circunstancias; esa es una conversación para tu abogado, y cubrimos los matices en Is a Bitcoin Timestamp Admissible as Evidence?.

Los precios reflejan esa división: el timestamp es gratuito para repositorios públicos de código abierto, con planes de pago para repositorios privados y equipos más grandes.

Ejecutarlo dentro de tu propia red

Para entornos regulados o configuraciones aisladas (air-gapped), Timestamp GIT se distribuye como una imagen de Docker que alojas tú mismo. Una configuración rápida de Docker Compose se ve así:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

La app arranca en http://localhost:8080; un asistente de configuración en el primer inicio te guía para conectar tu GitHub App. Hay una licencia de demostración por tiempo limitado disponible a través del formulario de solicitud en la página de licencia de Docker. Los detalles completos del despliegue están en Self-Host Git Timestamping With Docker Compose.

FAQ

¿Puedo simplemente cambiar el reloj de mi sistema para falsificar la fecha de un commit de Git? Sí. Git usa tu reloj local y puedes ponerlo en cualquier fecha, o reescribir la fecha después con un amend o un rebase. Es exactamente por eso que los timestamps de Git por sí solos no son prueba confiable de nada.

¿GitHub proporciona timestamps confiables para los commits? GitHub registra las fechas que Git le entrega, pero no están ancladas criptográficamente. Sus logs viven en sus propios servidores, se pueden alterar y se pueden descartar por interesados en un contexto legal.

¿Cómo demuestra Timestamp GIT que mi código existió en un momento determinado sin ver mi código? Solo procesa hashes de commit: huellas criptográficas del estado de tu repositorio. Esos hashes se agrupan y se anclan en Bitcoin mediante OpenTimestamps. Tu código fuente nunca sale de tu repositorio.

¿Es admisible en un tribunal la prueba de Timestamp GIT? La prueba se apoya en el libro contable inmutable de Bitcoin y en el hashing SHA-256 estándar, que se reconocen cada vez más en contextos legales. La admisibilidad sigue dependiendo de tu jurisdicción y de las circunstancias específicas: consulta a un profesional legal. Para una discusión más profunda, consulta nuestro artículo sobre Bitcoin timestamp admissibility.

La conclusión

Los timestamps de los commits de Git responden a “¿en qué orden ocurrieron estos cambios en esta máquina?”. No responden a “¿puedes demostrarle a un desconocido que este código existía en esta fecha?”. Para la segunda pregunta necesitas una huella anclada en algún lugar que no controles, y la forma práctica de conseguirla es dejar de tratar los timestamps como una tarea manual.

Instala la GitHub App una vez, deja que el lote nocturno haga su trabajo y cada commit del repositorio queda respaldado por un bloque de Bitcoin. Puedes ver todo el flujo —y las páginas de verificación y los badges que lo acompañan— en timestampgit.dev.


Artículos relacionados

EU label: AI-generated content