Timestamp GIT

← Tutti gli articoli

2026-10-12

Come verificare in modo indipendente il timestamp di un commit Git

Come verificare in modo indipendente il timestamp di un commit Git
timestamp git blockchain proof

Come verificare in modo indipendente il timestamp di un commit Git

Un timestamp che non puoi verificare da solo non è una prova — è una promessa di un fornitore. Questa distinzione conta nel momento in cui qualcun altro ti chiede di dimostrare quando il tuo codice è esistito: un revisore della conformità, la controparte in una controversia brevettuale o un acquirente che svolge due diligence tecnica.

Questo articolo mostra come verificare in modo indipendente il timestamp di un commit Git utilizzando gli artefatti di prova e gli strumenti di Timestamp GIT: la pagina di stato pubblica, la pagina di verifica Merkle basata su browser, l’API REST, i badge di verifica e i report scaricabili. Nessun codice sorgente deve lasciare il tuo repository e nessuno — incluso il fornitore — deve essere considerato affidabile perché il risultato sia valido.

Perché la verifica indipendente è importante

Ogni timestamp crittografico è forte solo quanto la tua capacità di verificarlo alle tue condizioni.

  • La verifica non deve dipendere dalla sopravvivenza del fornitore. Le prove di Timestamp GIT si basano esclusivamente su SHA-256 e sui dati dei blocchi Bitcoin. Puoi verificarle offline, anche se il servizio non esiste più.
  • Autorità di regolamentazione, revisori e tribunali si aspettano prove riproducibili. “Lo diceva la dashboard” non è una prova. Una radice di Merkle confrontata con un blocco Bitcoin lo è.
  • La due diligence pone domande difficili. Durante un’acquisizione o un round di finanziamento, la maturità della proprietà intellettuale viene esaminata. Poter consegnare una catena di prove verificabile è molto diverso dal consegnare uno screenshot.
  • Il tuo codice sorgente resta privato. La verifica richiede esattamente due cose: i file di prova (manifest e ricevuta .ots) e i dati pubblici della blockchain. Non la tua implementazione, non i tuoi segreti commerciali.

Il resto di questo articolo è la checklist pratica.

Com’è fatta una prova di Timestamp GIT

Un singolo giorno di commit produce un insieme di artefatti piccolo e ben definito:

  • Un file manifest giornaliero (.txt) contenente gli hash dei commit raccolti per quel repository in quel giorno.
  • Una radice di Merkle calcolata sul manifest. La radice è il singolo valore che rappresenta ogni commit del batch.
  • Un file di ricevuta .ots — una prova OpenTimestamps che collega crittograficamente quella radice di Merkle a uno specifico blocco Bitcoin.

Questi artefatti risiedono in un branch dedicato ai timestamp o in un repository shadow, deliberatamente separato dal tuo codice sorgente. Questa separazione è il punto centrale: la prova viaggia indipendentemente dal codice che protegge.

Accanto ai file, il record include l’altezza del blocco Bitcoin e l’ID della transazione che hanno ancorato il batch. Sono questi due valori che permettono a chiunque — tu, un avvocato, un revisore esterno — di confermare che i dati esistevano quando il blocco è stato estratto.

Passo dopo passo: verificare con gli strumenti di Timestamp GIT

I timestamp vengono prodotti automaticamente: installa la GitHub App una volta, collega il repository e ogni commit viene ancorato ogni notte senza passaggi manuali. La verifica è il momento in cui prendi il controllo — e hai cinque modi per farlo.

1. La pagina di stato pubblica

Apri https://timestampgit.dev/status/{user}/{repo}. Questa dashboard mostra:

  • la longevità della prova e la data di ancoraggio più antica,
  • la regolarità giornaliera (una heatmap a calendario rende evidenti le lacune),
  • l’altezza del blocco Bitcoin e l’ID della transazione per ogni ancoraggio.

È il controllo di sanità più rapido. Se una controparte mette in dubbio la continuità, la heatmap è la risposta.

2. La pagina di verifica basata su browser

Per un giorno specifico, vai su https://timestampgit.dev/verification/{user}/{repo}/{date}. Questa pagina percorre passo dopo passo la catena di Merkle multilivello ed esegue tutti i calcoli localmente nel tuo browser — zero-knowledge. Nessuno vede cosa verifichi, il che è utile quando il repository stesso è riservato.

Questa è la pagina da aprire davanti a un revisore, perché ogni livello della catena viene mostrato, non riassunto.

3. L’API di verifica

Quando la verifica deve essere scriptata o archiviata, recupera la catena grezza:

curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
  -H "Accept: application/json" | jq .

La risposta contiene i dati completi della catena di Merkle per il timestamp di quel giorno, così puoi ricalcolarla localmente invece di fidarti della pagina renderizzata.

4. I badge di verifica

Nella pagina di connessione del repository ottieni un badge Shields.io incorporabile più il suo snippet markdown. Inseriscilo nel tuo README:

[![Timestamped with Bitcoin](BADGE_URL)](BADGE_LINK)

Chiunque clicchi sul badge arriva alla vista di verifica del tuo repository. È un’affermazione pubblica e sempre aggiornata di prova di esistenza — e poiché il link rimanda a dati verificabili anziché a un’immagine statica, non è solo decorazione.

5. Report ed esportazioni per l’audit

Due endpoint coprono la parte documentale:

# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
  -o certificate-2026-10-05.pdf

# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o audit-ledger.csv

Il PDF è ciò che alleghi a un deposito legale. Il CSV è ciò che inserisci in un archivio di audit interno o in un foglio di calcolo che consegni a un team di due diligence.

Nota che i repository privati aggiungono un HMAC cifrato ai loro URL, così solo gli utenti autorizzati possono aprire le loro pagine di stato e di verifica. La prova sottostante è invariata — è comunque ancorata in Bitcoin e comunque verificabile da chiunque possieda il file di prova.

Interpretare i risultati della verifica e i casi limite

Una verifica riuscita significa una cosa specifica: la radice di Merkle che hai ricalcolato dal manifest corrisponde al valore ancorato nel blocco Bitcoin a cui fa riferimento la ricevuta .ots. Quella corrispondenza prova che l’insieme degli hash dei commit esisteva non oltre il timestamp di quel blocco. Non importa chi esegue il controllo o dove.

Vale la pena conoscere quattro casi limite prima di promettere a qualcuno un risultato di verifica:

  • Il giorno corrente probabilmente non è ancora verificabile. L’ancoraggio viene eseguito ogni notte e la conferma Bitcoin richiede diverse ore (normalmente circa 3 ore). Una prova per i commit di oggi potrebbe non esistere ancora, e il batch della notte precedente potrebbe essere ancora in attesa di conferma. Pianifica gli audit tenendo conto di questa finestra.
  • I repository privati richiedono l’HMAC. La verifica funziona esattamente come per i repository pubblici, ma l’URL porta un HMAC cifrato specifico dell’istanza server. Niente HMAC, niente pagina di stato.
  • Un timestamp prova l’esistenza, non la paternità. La prova dice che un hash di commit esisteva in un momento specifico. Non stabilisce, di per sé, chi ha scritto il codice né che il codice sia nuovo. Usala come prova di anteriorità, non come sostituto di una catena di titolarità.
  • Chiunque può verificare, anche senza Timestamp GIT. Poiché la prova è costruita su standard aperti, un ingegnere sufficientemente motivato può verificare il file .ots con gli strumenti OpenTimestamps standard contro la blockchain Bitcoin. Questa è una caratteristica: significa che la tua prova sopravvive al fornitore.

Verificare senza il SaaS: alla maniera difficile (e perché non ti serve)

In linea di principio potresti assemblare questa pipeline da solo — eseguire gli strumenti OpenTimestamps, interrogare i nodi Bitcoin, riconciliare a mano le prove di Merkle. In pratica ciò significa mantenere infrastruttura e competenze per un compito che non è il tuo prodotto.

Timestamp GIT esiste proprio per evitartelo. Installa la GitHub App una volta su un repository monitorato e ogni commit viene ancorato automaticamente in Bitcoin ogni notte — nessuna CLI, nessun passaggio manuale, nessuna conoscenza del protocollo richiesta. La verifica è poi un link, un badge o una chiamata API. Per le organizzazioni che devono tenere tutto sul proprio hardware, il self-hosting è disponibile come immagine Docker:

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

L’istanza è raggiungibile su http://localhost:8080 e una procedura guidata ti accompagna nel collegamento della tua GitHub App e nella configurazione dell’istanza al primo avvio.

Automatizzare la verifica nel tuo flusso di lavoro

La verifica manuale va bene per le controversie. Per la conformità continua, automatizzala.

Blocca la tua CI/CD in base allo stato dell’ancoraggio. L’endpoint di riepilogo combinato è progettato esattamente per questo:

curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json

Un piccolo script di controllo lo trasforma in un gate di build:

import json
import sys
import urllib.request

URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"

with urllib.request.urlopen(URL) as response:
    summary = json.load(response)

print(json.dumps(summary, indent=2))

# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
    sys.exit("No Bitcoin anchor reported for this repository yet.")

Collegalo a un workflow pianificato, così un ancoraggio mancante diventa un ticket invece di una sorpresa durante un audit:

name: Timestamp anchor check
on:
  schedule:
    - cron: "0 8 * * *"
  workflow_dispatch:

jobs:
  verify-anchor:
    runs-on: ubuntu-latest
    steps:
      - name: Check anchor status
        run: |
          curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
            -o summary.json
          cat summary.json

Archivia le prove con cadenza regolare. Scarica il CSV di audit mensilmente e conservalo nel tuo sistema di archiviazione:

curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o "audit-ledger-$(date +%Y-%m).csv"

Pubblica il badge. Costa una riga nel tuo README e offre alle controparti un modo self-service per verificare le tue affermazioni.

Se tenere il contenuto del repository fuori dal servizio è un requisito, la modalità di deployment Enterprise ZK esegue una breve GitHub Action sulla tua infrastruttura che invia gli hash dei commit all’API di Timestamp GIT. La verifica si comporta allo stesso modo; cambia solo il percorso di acquisizione.

FAQ

Devo fidarmi di Timestamp GIT per verificare un timestamp? No. La prova si basa esclusivamente su SHA-256 e sui dati dei blocchi Bitcoin. Puoi verificarla in modo indipendente usando il file .ots e gli strumenti OpenTimestamps standard contro la blockchain Bitcoin, anche se Timestamp GIT non esiste più.

Quanto tempo ci vuole perché il timestamp di un commit diventi verificabile? Dopo il processo di ancoraggio notturno, la prova viene scritta nel tuo repository. La conferma Bitcoin richiede tipicamente circa 3 ore, dopodiché il timestamp è immutabile e verificabile.

Posso verificare il timestamp di un repository privato? Sì. I repository privati usano un HMAC cifrato aggiunto all’URL, così solo gli utenti autorizzati possono accedere alla pagina di stato e agli strumenti di verifica. La prova sottostante è comunque ancorata in Bitcoin e può essere verificata da chiunque possieda il file di prova.

Quali strumenti fornisce Timestamp GIT per la verifica? Una pagina di stato pubblica, una pagina di verifica basata su browser che calcola tutto localmente, endpoint API REST per i dati della catena di Merkle e i report di audit, e badge Shields.io incorporabili. Tutti sono progettati per la verifica indipendente senza coinvolgimento del fornitore.

Conclusione

La verifica indipendente è ciò che distingue un timestamp da un’affermazione di marketing. Con Timestamp GIT ottieni la catena di prove dalla pagina di stato, ricalcoli il percorso di Merkle nel tuo browser, scripti lo stesso controllo in CI ed esporti un certificato PDF per il fascicolo — il tutto senza esporre una singola riga di codice sorgente.

Se vuoi che tutto questo funzioni sui tuoi repository, il servizio gestito richiede una configurazione una tantum: installa la GitHub App, collega il repo e lascia che l’ancoraggio notturno faccia il resto. Per requisiti air-gapped o self-hosted, la licenza self-hosted Docker copre anche quel percorso. Inizia su timestampgit.dev e verifica un repository con le tue mani.

Articoli correlati

EU label: AI-generated content