Certyo
ContattaciAccedi
Torna al blogTutorial

Guida pratica: il tuo primo record durevole in 10 minuti

Basta con la teoria. In questa guida, creerai un record durevole reale, lo ancorerai su blockchain e ne verificherai l'integrita. Il tutto in meno tempo di quanto ci vuole per prendere un caffe.

4 aprile 2026
10 min di lettura

Hai letto tutto sui record durevoli. Hai capito il concetto. Sai che la blockchain puo provare l'integrita. Ma niente sostituisce il farlo tu stesso. Nei prossimi 10 minuti, invierai un record reale all'API di Certyo, lo vedrai passare attraverso il pipeline di ancoraggio e verificherai la sua integrita con prova crittografica. Non ti serve esperienza in blockchain, crittografia e nemmeno molta esperienza tecnica. Ti basta curiosita e un terminale.

Cosa farai

Questo tutorial copre il ciclo completo di un record durevole: ingestione, ancoraggio e verifica. Al termine, avrai un record la cui integrita puo essere verificata indipendentemente da chiunque abbia accesso a internet. Letteralmente, chiunque.

Non useremo pseudocodice ne esempi teorici. Ogni passo usa l'API reale di Certyo. Gli endpoint, i payload, le risposte — tutto e reale e riproducibile.

Passo 1: Invia il tuo primo record

Il punto di ingresso e un POST all'API di ingestione. Invii un record con i dati del tuo dominio e Certyo fa il resto:

  • POST /api/v1/records con il tuo tenantId, database, collection, recordId e il payload del record
  • Certyo canonicalizza il payload, genera l'hash SHA-256 e lo mette in coda per il batch anchoring
  • Ricevi un 202 Accepted con lo snapshotId — il tuo biglietto per tracciare e verificare questo record

Passo 2: Osserva il pipeline in azione

Il tuo record ora e nel pipeline. In meno di 60 secondi, passera attraverso queste fasi:

Ingested
Il tuo record e stato ricevuto e canonicalizzato
Batched
E stato raggruppato con altri record in un lotto Merkle
Anchored
La radice Merkle e stata ancorata su Polygon — il tuo record e immutabile

Puoi consultare lo stato in qualsiasi momento con GET /api/v1/snapshots/{snapshotId}. Il campo status ti dice esattamente a che punto del pipeline si trova il tuo record. Quando raggiungi 'Anchored', hai la prova crittografica on-chain che il tuo record esiste e non e stato alterato.

Passo 3: Verifica l'integrita

Ora arriva la parte magica. Verificare che il tuo record e integro richiede una sola chiamata API:

POST /verify/record
Ricalcola hash
Cerca prova Merkle
Valida contro on-chain
Restituisce risultato

La verifica richiede meno di 500ms. La risposta include il pacchetto di prova completo: l'hash del tuo record, la prova Merkle, la radice del lotto, il txHash della transazione su Polygon, il numero di blocco e il timestamp dell'ancoraggio. Tutto cio di cui qualsiasi terza parte ha bisogno per verificare indipendentemente che il tuo record e autentico.

Cosa hai appena realizzato

In meno di 10 minuti, hai completato qualcosa che la maggior parte delle organizzazioni regolamentate non riesce a fare con la propria infrastruttura attuale:

  • Hai creato evidenza immutabileIl tuo record ha una prova crittografica ancorata su Polygon che nessuno — ne tu, ne Certyo, ne un attaccante — puo alterare.
  • Hai abilitato la verifica indipendenteChiunque abbia il pacchetto di prova puo verificare il tuo record contro la blockchain pubblica, senza chiederti permesso ne fidarsi della tua infrastruttura.
  • Hai eliminato l'ambiguitaSe domani qualcuno mette in dubbio che questo record sia stato alterato, hai una risposta da 500ms con prova matematica. Niente opinioni. Niente log interni. Matematica.

Prossimi passi

Questo tutorial e solo l'inizio. I team che implementano Certyo in produzione tipicamente partono con un sottoinsieme di record critici — transazioni finanziarie, modifiche a dati sensibili, record di compliance — e si espandono gradualmente. Il pipeline e lo stesso, il costo e lo stesso (frazioni di centesimo per record) e l'evidenza si accumula dal primo giorno. Richiedi il tuo pilota e inizia a costruire la tua catena di evidenza.

La differenza tra sapere che i record durevoli funzionano e averlo fatto tu stesso e la differenza tra leggere di nuoto e tuffarsi in acqua. Ti sei appena tuffato. E l'acqua e perfetta.

Vuoi vederlo in azione?

Richiedi una demo e verifica il tuo primo record in pochi minuti.