---
title: "Oracolo blockchain"
description: "Un oracolo blockchain fornisce ai contratti attestazioni autenticate su dati che non possono derivare dallo stato deterministico della rete; l'uso sicuro dipende dall'intero percorso tra fonti, report, trasporto, verifica e consumatore."
image: "https://wiki.fcontext.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://wiki.fcontext.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Oracolo blockchain
> Solo a scopo educativo; non costituisce consulenza né raccomandazione d’investimento. Gli investimenti possono comportare perdite.
## Risposta diretta
Un oracolo blockchain è un sistema che fornisce a un contratto un'attestazione autenticata su dati che la transizione deterministica dello stato della rete non può derivare autonomamente. Un feed di prezzi può comunicare un riferimento di mercato, un oracolo pull può verificare un aggiornamento firmato trasmesso dall'utente e un oracolo ottimistico può accettare un'affermazione garantita da una cauzione se non viene contestata. La casualità verificabile e i messaggi cross-chain sono sistemi affini di input esterno, ma le loro attestazioni e i loro modelli di sicurezza non sono intercambiabili con quelli dei feed di prezzi.
La registrazione di un valore onchain dimostra che una transazione, una firma, un quorum, una prova o l'esito di una controversia ha rispettato regole specifiche. Non dimostra crittograficamente che un mercato esterno, un evento meteorologico o una valutazione umana siano oggettivamente veri. Il percorso di fiducia completo comprende il fenomeno osservato, le fonti e le sedi di negoziazione, i publisher, l'aggregazione, l'autenticazione del report, il trasporto, il proxy o verificatore onchain, la validazione del consumatore e l'azione economica che trasferisce valore.
La decentralizzazione va valutata separatamente a ogni livello. Molti firmatari possono condividere una stessa API, borsa, infrastruttura cloud, operatore o amministratore. Una mediana firmata e recente può comunque usare la coppia o i decimali errati, riflettere un mercato illiquido o essere inadatta alla dimensione dell'operazione del consumatore. Quest'ultimo resta responsabile di identità, unità, stato, timestamp, disponibilità L2, limiti di esposizione, comportamento di fallback e ripristino.
## Come funziona
1. Fissare rete e blocco, contratto consumatore e azione, indirizzo esatto del feed o del proxy e ID del feed, versione dell'implementazione, coppia base/quotata, decimali o esponente, orari di mercato e valore a rischio.
2. Tracciare l'intero percorso di fiducia dal fenomeno e dalle sedi di negoziazione ai publisher, all'aggregazione delle fonti, all'aggregazione di firmatari o quorum, al trasporto, alla verifica onchain, ai controlli del proxy e alla logica del consumatore; verificare separatamente l'indipendenza di fonti, operatori, infrastruttura e amministratori.
3. Decodificare l'interfaccia e il report distribuiti. Validare identità del feed, firma o prova e dominio, sequenza o round, valore firmato, stato o confidenza, timestamp della fonte, ora di aggiornamento onchain, comportamento contro replay e revert e stato dell'upgrade.
4. Normalizzare le unità una sola volta e applicare controlli espliciti su intervallo, segno e timestamp. Distinguere osservazione o pubblicazione alla fonte, creazione del report, inclusione nella rete di origine, finalità del relay, aggiornamento sulla rete di destinazione e ora del blocco consumatore.
5. Applicare regole specifiche per azione a `maxAge`, deviazione, confidenza e confronto tra fonti. Sulle implementazioni L2 supportate, controllare separatamente lo stato del sequencer e il periodo di tolleranza dopo il ripristino; per i valori composti, vincolare la freschezza alla dipendenza necessaria meno recente.
6. Confrontare il riferimento con la profondità di mercato eseguibile e stimare il costo di manipolazione o corruzione rispetto all'esposizione del consumatore per prestito, emissione, liquidazione, negoziazione o regolamento. Trattare prezzo spot e costruzione TWAP di un AMM come specifici per pool e versione.
7. Definire stati normale, degradato, sospeso e di ripristino per ogni azione; preservare ove possibile il rimborso sicuro del debito o l'aggiunta di garanzia, monitorare fonti e configurazione, collaudare report mancanti, obsoleti, errati e manipolati e riconciliare tutti i saldi e le azioni interessati dopo il ripristino.
Push e pull descrivono modalità di consegna, non un modello universale di pagamento o fiducia. Un publisher può creare un report firmato mentre qualsiasi utente lo inoltra e paga la commissione di aggiornamento. I parametri di heartbeat e deviazione possono attivare una pubblicazione, ma non garantiscono la consegna né definiscono il limite di freschezza del consumatore. Una fonte alternativa o l'ultimo valore valido sono modalità controllate di degrado per cui vanno nuovamente verificati direzione, unità, età, indipendenza e azioni consentite.
## Esempi svolti
- **Soglia di liquidazione.** Una posizione ha `10 ETH` in garanzia, prezzo dell'oracolo pari a `3,000 USD/ETH`, debito di `18,000 USD` e soglia di liquidazione del `75%`. La garanzia vale `30,000 USD`, l'LTV è `60%` e `healthFactor = 10 * 3,000 * 0.75 / 18,000 = 1.25`. Il prezzo di attivazione è `18,000 / (10 * 0.75) = 2,400 USD/ETH`. A `2,300 USD/ETH`, l'health factor è `0.9583333333` e il rapporto debito/garanzia è `78.2608695652%`: la posizione può essere liquidata, sebbene la garanzia nominale di `23,000 USD` superi ancora il debito prima di bonus, commissioni ed effetti dell'esecuzione.
- **Errore di unità.** Una risposta grezza pari a `250,000,000,000` con `8 decimals` significa `2,500 USD`. Dividerla per `10^18` produce invece `0.00000025 USD`, sottostimando il prezzo di un fattore `10^10`. Firma valida e timestamp recente non correggono un errore di unità del consumatore.
- **Scelta dell'aggregazione.** Le osservazioni `[99, 100, 100, 101, 160]` hanno mediana `100` e media aritmetica `112`, una differenza del `12%` rispetto alla mediana. In questo esempio didattico la mediana resiste a un singolo valore anomalo elevato; se però tutti e cinque i reporter dipendono da un'API compromessa e comunicano `130`, anche la mediana è `130`.
- **Freschezza per azione.** A `consumerClock = 1,800,000,000`, un report con `sourceTimestamp = 1,799,998,200` ha `age = 1,800 seconds`. Una nuova erogazione con `maxAge = 900 seconds` lo rifiuta per `900 seconds`; un percorso di rimborso con `maxAge = 3,600 seconds` lo accetta con `1,800 seconds` di margine. Lo stesso report può essere insicuro per aumentare l'esposizione ma accettabile per ridurla.
## Rischi
- Rete, distribuzione, implementazione o ambiente di rete errati.
- Proxy, aggregatore, ID del feed, asset o versione del contratto errati.
- Direzione base/quotata invertita o denominazione incoerente.
- Mancata corrispondenza di decimali, esponente, virgola fissa, segno, arrotondamento o unità.
- Accettazione di una risposta zero, negativa, fuori dominio, in overflow o troncata.
- Accettazione di un timestamp mancante, nullo, futuro, riportato o identificato in modo errato.
- Limite di freschezza del consumatore troppo permissivo per l'asset e l'azione.
- Limite troppo restrittivo che causa negazione del servizio o impedisce la riduzione del rischio.
- Configurazione di heartbeat o deviazione trattata come garanzia del livello di servizio.
- Chiusura del mercato, operazione societaria, perdita dell'ancoraggio, indisponibilità della sede o semantica del dato riportato ignorate.
- Più publisher condividono API, borsa, cloud, operatore, percorso delle chiavi o metodologia.
- Fallimento di soglia dei firmatari, quorum, custodia delle chiavi, autenticazione, dominio o protezione contro il replay.
- Regole inadeguate di aggregazione, ponderazione, valori anomali, confidenza o selezione delle fonti.
- Liquidità della fonte esigua, artificiale, frammentata, obsoleta o manipolabile alla dimensione protetta.
- Manipolazione spot o di un TWAP breve, controllo multiblocco, ordinamento, censura o MEV alterano l'input.
- Publisher, relay, gas, congestione, riorganizzazione o indisponibilità della rete impediscono la consegna tempestiva.
- Stato del sequencer L2, periodo di tolleranza, orologio del relay cross-chain o dipendenza dalla finalità vengono omessi.
- Proxy, amministratore, insieme dei firmatari, configurazione, migrazione, sospensione o dismissione del feed cambiano senza essere rilevati.
- Il fallback è obsoleto, correlato, su scala diversa o circolare, oppure si attiva tramite fail-open insicuro o fail-closed indiscriminato.
- L'esposizione del consumatore supera il costo di manipolazione o corruzione mentre falliscono monitoraggio, limiti, sospensione, ripristino, liquidazione e riconciliazione dei crediti deteriorati.
## Idee errate comuni
- **«Un oracolo predice il futuro».** La maggior parte autentica osservazioni, report, prove o affermazioni risolte su un oggetto e un momento definiti.
- **«I dati firmati o onchain sono quindi oggettivamente veri».** Autenticazione e consenso provano il rispetto delle regole, non la correttezza economica del fatto esterno.
- **«Più nodi implicano automaticamente una decentralizzazione indipendente».** Fonti, operatori, infrastruttura, chiavi e governance possono restare correlati.
- **«Il valore recente più aggiornato è un prezzo equo ed eseguibile».** La freschezza non prova direzione, unità, confidenza, liquidità o profondità eseguibile.
- **«Un fornitore autorevole elimina il rischio di integrazione del consumatore».** L'applicazione resta responsabile di identità della distribuzione, decodifica, freschezza, controlli L2, esposizione, modalità di errore e ripristino.
## Argomenti correlati
- [Attacchi agli oracoli](/it/crypto/oracle-attack/)
- [Prezzi obsoleti degli oracoli](/it/crypto/oracle-price-staleness/)
- [Oracolo TWAP](/it/crypto/oracle-twap/)
## Fonti
- [Oracles](https://ethereum.org/developers/docs/oracles/) - Ethereum.org (consultato: 2026-08-13)
- [Chainlink Data Feeds](https://docs.chain.link/data-feeds) - Chainlink Documentation (consultato: 2026-08-13)
- [Data Feeds API Reference](https://docs.chain.link/data-feeds/api-reference) - Chainlink Documentation (consultato: 2026-08-13)
- [Developer Responsibilities: Market Integrity and Application Code Risks](https://docs.chain.link/data-feeds/developer-responsibilities) - Chainlink Documentation (consultato: 2026-08-13)
- [Selecting Quality Data Feeds](https://docs.chain.link/data-feeds/selecting-data-feeds) - Chainlink Documentation (consultato: 2026-08-13)
- [How to Use Real-Time Data in EVM Contracts](https://docs.pyth.network/price-feeds/core/use-real-time-data/pull-integration/evm) - Pyth Developer Hub (consultato: 2026-08-13)
- [Uniswap v2 Core](https://app.uniswap.org/whitepaper.pdf) - Uniswap (consultato: 2026-08-13)
- [SC03:2026 Price Oracle Manipulation](https://scs.owasp.org/sctop10/SC03-PriceOracleManipulation/) - OWASP Smart Contract Security (consultato: 2026-08-13)
Source: https://wiki.fcontext.com/it/crypto/oracle/index.mdx