> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Panoramica dell'architettura

> Intention è una rete di trading AI-native: matching, compensazione e regolamento sono eseguiti come operazioni di protocollo, non dentro il sistema privato di un operatore.

<h2 id="intention-is-an-ai-native-trading-network">
  Intention è una rete di trading AI-native
</h2>

Una *rete* di trading, non un'applicazione di trading. Le parti di un exchange che decidono chi ha eseguito cosa, a quale prezzo e chi deve cosa a chi sono eseguite dai validatori della rete stessa, ordinate dal consenso e riproducibili da chiunque disponga degli stessi blocchi. Non c'è un motore di matching che gira da un'altra parte e poi riferisce.

AI-native, perché è questo che serve davvero a un agente che opera per conto di qualcuno. Una persona può osservare una sede di negoziazione e reagire. Un agente no: può agire solo su ciò che la sede è in grado di dimostrare. Portare matching, margine, funding, liquidazione e regolamento dentro il protocollo è ciò che trasforma una sede da controparte di cui ti fidi a infrastruttura che puoi verificare.

Tutto ciò che di solito viene presentato come un elenco di funzionalità discende da quell'unica decisione. L'esecuzione avviene su un ordinamento fissato dal consenso: rieseguire un blocco lo riproduce esattamente. Il prezzo è certificato nel blocco che lo consuma, quindi non c'è alcun ciclo dell'oracolo da anticipare. Liquidazione e funding sono operazioni di protocollo, non chiamate a contratto: girano nello stesso passo dell'esecuzione che le ha innescate. E poiché la macchina a stati emette output per transazione, ogni effetto ha un autore.

<Note>
  Un exchange è più di questo. Intorno ci sono il front end, l'operatività dei conti, la quotazione dei mercati, l'assistenza e le condizioni commerciali. Ciò che la rete rende pubblico e verificabile è il nucleo critico per il regolamento: la parte in cui una discrepanza costa denaro a qualcuno.
</Note>

<h2 id="the-layers">
  I livelli
</h2>

Quattro livelli, nell'ordine in cui una transazione li attraversa.

<div className="dg" data-dg="architecture-layers">
  <div className="dg-c" style={{aspectRatio:"720 / 502"}}>
    <svg className="dg-w" viewBox="0 0 720 502" aria-hidden="true">
      <path className="dg-wire dg--blue" d="M 406.00 96.00 L 406.00 131.60" />

      <path className="dg-head dg--blue" d="M 406.00 138.00 L 401.60 131.60 L 410.40 131.60 Z" />

      <path className="dg-wire dg--sky" d="M 406.00 228.00 L 406.00 263.60" />

      <path className="dg-head dg--sky" d="M 406.00 270.00 L 401.60 263.60 L 410.40 263.60 Z" />

      <path className="dg-wire dg--green" d="M 406.00 360.00 L 406.00 395.60" />

      <path className="dg-head dg--green" d="M 406.00 402.00 L 401.60 395.60 L 410.40 395.60 Z" />

      <path className="dg-wire dg-dash dg-soft" d="M 46.00 447.00 L 46.00 57.40" />

      <path className="dg-head" d="M 46.00 51.00 L 50.40 57.40 L 41.60 57.40 Z" />
    </svg>

    <div className="dg-band" style={{left:"12.7778%",top:"1.9920%",width:"87.2222%",height:"16.3347%"}}><span className="dg-cap">1 · Applicazione — fuori dal protocollo</span></div>
    <div className="dg-band" style={{left:"12.7778%",top:"28.2869%",width:"87.2222%",height:"16.3347%"}}><span className="dg-cap">2 · Rete</span></div>
    <div className="dg-band" style={{left:"12.7778%",top:"54.5817%",width:"87.2222%",height:"16.3347%"}}><span className="dg-cap">3 · Esecuzione — IntentionKernel</span></div>
    <div className="dg-band" style={{left:"12.7778%",top:"80.8765%",width:"87.2222%",height:"16.3347%"}}><span className="dg-cap">4 · Stato</span></div>
    <div className="dg-b" style={{left:"15.0000%",top:"5.5777%",width:"26.2963%",height:"9.1633%"}}><span className="dg-t">Gateway web Intention</span></div>
    <div className="dg-b" style={{left:"43.2407%",top:"5.5777%",width:"26.2963%",height:"9.1633%"}}><span className="dg-t">Front end · wallet</span></div>
    <div className="dg-b" style={{left:"71.4815%",top:"5.5777%",width:"26.2963%",height:"9.1633%"}}><span className="dg-t">Agenti · market maker · client API</span></div>
    <div className="dg-b dg--blue" style={{left:"15.0000%",top:"31.8725%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">Mempool</span><span className="dg-s">ammissione · diffusione</span></div>
    <div className="dg-b dg--blue" style={{left:"57.3611%",top:"31.8725%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">IntentionBFT</span><span className="dg-s">ordinamento · prezzi · definitività</span></div>
    <div className="dg-b dg--sky" style={{left:"15.0000%",top:"58.1673%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">Matching</span><span className="dg-s">book · priorità</span></div>
    <div className="dg-b dg--sky" style={{left:"57.3611%",top:"58.1673%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">Stanza di compensazione</span><span className="dg-s">margine · liquidazione · funding</span></div>
    <div className="dg-b dg--green" style={{left:"15.0000%",top:"84.4622%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">Store di stato</span><span className="dg-s">valori per versione</span></div>
    <div className="dg-b dg--green" style={{left:"57.3611%",top:"84.4622%",width:"40.4167%",height:"9.1633%"}}><span className="dg-t">Stato Merkle</span><span className="dg-s">prove · accumulatori</span></div>
    <div className="dg-lbl" style={{left:"56.3889%",top:"23.3068%"}}>transazioni firmate</div>
    <div className="dg-lbl" style={{left:"56.3889%",top:"49.6016%"}}>blocco confermato</div>
    <div className="dg-lbl" style={{left:"56.3889%",top:"75.8964%"}}>scritture · eventi attribuiti</div>
    <div className="dg-lbl" style={{left:"6.3889%",top:"50.0000%",width:"12.2222%",whiteSpace:"normal"}}>letture · prove</div>
  </div>
</div>

Un quinto gruppo sta di fianco allo stack, non dentro. I processi del **livello di servizio** girano accanto ai validatori e si agganciano in due soli punti: prezzi e asset entrano al livello di rete, i record confermati escono al livello di stato.

<div className="dg" data-dg="overview-txpath">
  <div className="dg-c" style={{aspectRatio:"720 / 236"}}>
    <svg className="dg-w" viewBox="0 0 720 236" aria-hidden="true">
      <path className="dg-wire" d="M 100.67 78.00 L 114.27 78.00" />

      <path className="dg-head" d="M 120.67 78.00 L 114.27 82.40 L 114.27 73.60 Z" />

      <path className="dg-wire" d="M 225.33 78.00 L 238.93 78.00" />

      <path className="dg-head" d="M 245.33 78.00 L 238.93 82.40 L 238.93 73.60 Z" />

      <path className="dg-wire" d="M 350.00 78.00 L 363.60 78.00" />

      <path className="dg-head" d="M 370.00 78.00 L 363.60 82.40 L 363.60 73.60 Z" />

      <path className="dg-wire" d="M 474.67 78.00 L 488.27 78.00" />

      <path className="dg-head" d="M 494.67 78.00 L 488.27 82.40 L 488.27 73.60 Z" />

      <path className="dg-wire" d="M 599.33 78.00 L 612.93 78.00" />

      <path className="dg-head" d="M 619.33 78.00 L 612.93 82.40 L 612.93 73.60 Z" />
    </svg>

    <div className="dg-b dg--blue" style={{left:"0.0000%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Transazione firmata</span></div>
    <div className="dg-b dg--sky" style={{left:"17.3148%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Mempool</span><span className="dg-s">validata prima dell'archiviazione</span></div>
    <div className="dg-b dg--sky" style={{left:"34.6296%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Consenso</span><span className="dg-s">ordinamento e quorum prezzi</span></div>
    <div className="dg-b dg--sky" style={{left:"51.9444%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Kernel</span><span className="dg-s">esecuzione del blocco</span></div>
    <div className="dg-b dg--green" style={{left:"69.2593%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Scritture di stato</span><span className="dg-s">eventi attribuiti</span></div>
    <div className="dg-b dg--green" style={{left:"86.5741%",top:"12.7119%",width:"13.4259%",height:"40.6780%"}}><span className="dg-t">Conferma</span><span className="dg-s">ledger e store di stato</span></div>
    <div className="dg-b dg-dashed dg-left" style={{left:"0.0000%",top:"67.7966%",width:"100.0000%",height:"27.9661%"}}><span className="dg-t">Che cosa produce la sequenza</span><span className="dg-s">Ordinamento e prezzi sono confermati prima che l'esecuzione cominci, e ogni cambiamento di stato è legato alla transazione che lo ha causato — per questo chiunque può rieseguire il blocco e ottenere lo stesso risultato.</span></div>
    <div className="dg-free" style={{left:"0.0000%",top:"0.0000%",width:"100.0000%"}}><div className="dg-n">Una transazione, dall'inizio alla fine</div></div>
  </div>
</div>

**Livello applicativo.** Tutto ciò che persone e macchine toccano davvero: il gateway web di Intention, i front end e i wallet di terze parti, e gli agenti e i market maker che operano in modo programmatico. Niente di tutto questo fa parte del protocollo: è ciò per cui il protocollo esiste, ed è deliberatamente sostituibile. Due front end che non concordano su quanto vale una posizione sono un bug del front end, perché entrambi leggono lo stesso stato confermato.

**Livello di rete.** Dove le transazioni vengono ammesse, diffuse e ordinate. [IntentionBFT](/it/protocol/architecture/intention-bft) conferma un ordinamento e un vettore di prezzi certificati nello stesso evento di consenso; il [mempool](/it/protocol/architecture/mempool) governa che cosa ci arriva; la [topologia](/it/protocol/architecture/intention-bft#network-topology) descrive chi gestisce che cosa.

**Livello di esecuzione.** [IntentionKernel](/it/protocol/architecture/kernel) esegue il blocco confermato come una sequenza fissa di fasi. Il suo insieme di istruzioni è l'insieme enumerato delle operazioni finanziarie di cui ha bisogno una sede di derivati, non una macchina virtuale generalista. [Matching](/it/protocol/architecture/matching) e la [stanza di compensazione](/it/protocol/architecture/clearinghouse) sono fasi al suo interno, non sistemi separati.

**Livello di stato.** [Stato e archiviazione](/it/protocol/architecture/state/model) spiega come i risultati vengono persistiti, autenticati e serviti: uno store dei valori correnti per le letture, una struttura Merkle versionata per le prove e accumulatori su transazioni ed eventi.

**Livello di servizio.** Processi che girano accanto ai validatori invece che dentro il blocco: l'[oracolo](/it/protocol/architecture/oracle) che alimenta il consenso con i prezzi, l'[indexer](/it/protocol/architecture/indexer) che trasforma lo stato confermato in dati interrogabili, i [servizi di programma](/it/protocol/architecture/programs) che derivano lo stato dei conti dallo storico confermato e lo riscrivono tramite transazioni di protocollo, e il [bridge](/it/protocol/architecture/bridge) che sposta asset tra catene.

<h2 id="one-block">
  Un blocco
</h2>

Tutto ciò che rende verificabile il comportamento della sede avviene dentro un singolo blocco confermato.

<div className="dg" data-dg="overview-services">
  <div className="dg-c" style={{aspectRatio:"720 / 288"}}>
    <svg className="dg-w" viewBox="0 0 720 288" aria-hidden="true">
      <path className="dg-wire dg--sky" d="M 185.00 65.00 L 240.47 120.47" />

      <path className="dg-head dg--sky" d="M 245.00 125.00 L 237.36 123.59 L 243.59 117.36 Z" />

      <path className="dg-wire dg--sky" d="M 185.00 175.00 L 240.08 129.10" />

      <path className="dg-head dg--sky" d="M 245.00 125.00 L 242.90 132.48 L 237.27 125.72 Z" />

      <path className="dg-wire dg--green" d="M 455.00 100.00 L 487.00 100.00 L 487.00 65.00 L 508.60 65.00" />

      <path className="dg-head dg--green" d="M 515.00 65.00 L 508.60 69.40 L 508.60 60.60 Z" />

      <path className="dg-wire dg--green" d="M 620.00 104.00 L 620.00 129.60" />

      <path className="dg-head dg--green" d="M 620.00 136.00 L 615.60 129.60 L 624.40 129.60 Z" />

      <path className="dg-wire dg--green dg-dash" d="M 620.00 214.00 L 620.00 250.00 L 350.00 250.00 L 350.00 190.40" />

      <path className="dg-head dg--green" d="M 350.00 184.00 L 354.40 190.40 L 345.60 190.40 Z" />
    </svg>

    <div className="dg-b dg--sky" style={{left:"0.0000%",top:"10.4167%",width:"25.0000%",height:"24.3056%"}}><span className="dg-t">Oracolo</span><span className="dg-s">prezzi certificati, per round</span></div>
    <div className="dg-b dg--sky" style={{left:"0.0000%",top:"48.6111%",width:"25.0000%",height:"24.3056%"}}><span className="dg-t">Bridge</span><span className="dg-s">depositi e prelievi</span></div>
    <div className="dg-b dg--blue" style={{left:"34.7222%",top:"24.3056%",width:"27.7778%",height:"38.1944%"}}><span className="dg-t">I quattro livelli</span><span className="dg-s">rete → esecuzione → stato</span></div>
    <div className="dg-b dg--green" style={{left:"72.2222%",top:"10.4167%",width:"27.7778%",height:"24.3056%"}}><span className="dg-t">Indexer</span><span className="dg-s">record confermati → storico interrogabile</span></div>
    <div className="dg-b dg--green" style={{left:"72.2222%",top:"48.6111%",width:"27.7778%",height:"24.3056%"}}><span className="dg-t">Servizi di programma</span><span className="dg-s">stato derivato, calcolato fuori dal blocco</span></div>
    <div className="dg-lbl" style={{left:"67.3611%",top:"86.8056%",width:"31.9444%",whiteSpace:"normal"}}>riscritto on-chain, letto durante l'esecuzione</div>
  </div>
</div>

L'ordinamento è fissato prima che l'esecuzione cominci, e l'esecuzione è una funzione di quell'ordinamento e dello stato precedente. Due nodi onesti a cui viene dato lo stesso blocco arrivano allo stesso risultato, byte per byte: non per policy, ma perché nulla nel percorso di esecuzione può leggere qualcos'altro. È su quella proprietà che poggia tutto il resto: prove, attribuzione, replay e la capacità di un agente di ragionare su che cosa farà un ordine inviato.

<h2 id="where-the-venues-guarantees-come-from">
  Da dove vengono le garanzie della sede
</h2>

Invece di un elenco di promesse a parte, ogni proprietà risale al livello che la produce.

| Proprietà                                                                                     | Prodotta da                                                                                                                                                                          |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Lo stesso blocco rieseguito dà lo stesso risultato su ogni nodo onesto                        | Il consenso fissa l'ordinamento; il [kernel](/it/protocol/architecture/kernel) lo esegue senza orologio, senza entropia e senza virgola mobile                                       |
| Una transazione viene regolata a un prezzo che la rete ha certificato                         | Il quorum sui prezzi fa parte del blocco, confermato dalle stesse firme — vedi [IntentionBFT](/it/protocol/architecture/intention-bft) e [Oracolo](/it/protocol/architecture/oracle) |
| Liquidazione e funding non possono restare indietro rispetto all'esecuzione che li ha causati | Sono fasi della [stanza di compensazione](/it/protocol/architecture/clearinghouse) nella stessa esecuzione del blocco, non transazioni di keeper                                     |
| Ogni cambiamento di stato è tracciabile fino alla transazione che lo ha causato               | Il kernel emette output per transazione, che il [livello di stato](/it/protocol/architecture/state/model) conferma e l'[indexer](/it/protocol/architecture/indexer) serve            |

<h2 id="the-market-infrastructure-this-replaces">
  L'infrastruttura di mercato che questo sostituisce
</h2>

Una sede tradizionale è un anello di una catena di istituzioni. Un'operazione viene incrociata in borsa, novata e marginata presso una controparte centrale, registrata presso l'istituzione che tiene il libro di chi detiene che cosa, regolata attraverso un sistema di pagamento e segnalata a un repertorio di dati. Cinque funzioni, cinque insiemi di registri e un processo di riconciliazione il cui mestiere è scoprire quando divergono.

Qui quei cinque sono fasi di un solo blocco, ed è questo a rendere l'intera sequenza una **compensazione e un regolamento atomici**: viene confermata come un'unità oppure non viene confermata affatto. Il termine merita precisione. Questa atomicità copre il ledger del protocollo stesso: far entrare o uscire collaterale attraverso il [bridge](/it/protocol/architecture/bridge) attende la finalità di una catena esterna e sta fuori da quell'unità.

<div className="dg" data-dg="fmi-collapse">
  <div className="dg-c" style={{aspectRatio:"720 / 372"}}>
    <svg className="dg-w" viewBox="0 0 720 372" aria-hidden="true" />

    <div className="dg-band" style={{left:"0.0000%",top:"4.8387%",width:"100.0000%",height:"33.8710%"}}><span className="dg-cap">Cinque istituzioni</span></div>
    <div className="dg-band" style={{left:"0.0000%",top:"52.6882%",width:"100.0000%",height:"33.8710%"}}><span className="dg-cap">Un blocco</span></div>
    <div className="dg-b" style={{left:"2.2222%",top:"12.3656%",width:"16.4444%",height:"18.8172%"}}><span className="dg-t">Matching</span><span className="dg-s">una borsa</span></div>
    <div className="dg-b" style={{left:"22.0000%",top:"12.3656%",width:"16.4444%",height:"18.8172%"}}><span className="dg-t">Compensare</span><span className="dg-s">una CCP</span></div>
    <div className="dg-b" style={{left:"41.7778%",top:"12.3656%",width:"16.4444%",height:"18.8172%"}}><span className="dg-t">Registrare</span><span className="dg-s">un depositario</span></div>
    <div className="dg-b" style={{left:"61.5556%",top:"12.3656%",width:"16.4444%",height:"18.8172%"}}><span className="dg-t">Regolare</span><span className="dg-s">un sistema di pagamento</span></div>
    <div className="dg-b" style={{left:"81.3333%",top:"12.3656%",width:"16.4444%",height:"18.8172%"}}><span className="dg-t">Segnalare</span><span className="dg-s">un repertorio di dati</span></div>
    <div className="dg-b dg--blue" style={{left:"2.2222%",top:"60.2151%",width:"18.6667%",height:"18.8172%"}}><span className="dg-t">Matching</span><span className="dg-s">fase di matching</span></div>
    <div className="dg-b dg--blue" style={{left:"21.4444%",top:"60.2151%",width:"18.6667%",height:"18.8172%"}}><span className="dg-t">Compensare</span><span className="dg-s">Stanza di compensazione</span></div>
    <div className="dg-b dg--green" style={{left:"40.6667%",top:"60.2151%",width:"18.6667%",height:"18.8172%"}}><span className="dg-t">Registrare</span><span className="dg-s">livello di stato</span></div>
    <div className="dg-b dg--green" style={{left:"59.8889%",top:"60.2151%",width:"18.6667%",height:"18.8172%"}}><span className="dg-t">Regolare</span><span className="dg-s">lo stesso blocco</span></div>
    <div className="dg-b dg--green" style={{left:"79.1111%",top:"60.2151%",width:"18.6667%",height:"18.8172%"}}><span className="dg-t">Segnalare</span><span className="dg-s">attribuzione</span></div>
    <div className="dg-free dg-mid" style={{left:"0.0000%",top:"40.8602%",width:"100.0000%"}}><div className="dg-n">Quattro intervalli. In ciascuno c'è una promessa che nessuno ha ancora onorato — e la riconciliazione esiste come processo per scoprire quando i registri divergono.</div></div>
    <div className="dg-free dg-mid" style={{left:"0.0000%",top:"88.7097%",width:"100.0000%"}}><div className="dg-n">Le stesse cinque funzioni come una sola unità di conferma. O è avvenuto tutto o niente, e non c'è un secondo registro con cui riconciliare.</div></div>
  </div>
</div>

| Funzione tradizionale | Chi la svolge                                           | Qui                                                                                                                                |
| --------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Matching**          | Il motore di matching della borsa                       | Il [matching](/it/protocol/architecture/matching), una fase dell'esecuzione del blocco                                             |
| **Compensare**        | Una controparte centrale — LCH, CME Clearing, ICE Clear | La [stanza di compensazione](/it/protocol/architecture/clearinghouse)                                                              |
| **Registrare**        | Un depositario centrale — DTCC, Euroclear               | La stessa stanza, che scrive nel [livello di stato](/it/protocol/architecture/state/model)                                         |
| **Regolare**          | Un sistema di pagamento — Fedwire, TARGET2, CLS         | Il blocco stesso: entrambe le gambe vengono confermate, o nessuna                                                                  |
| **Segnalare**         | Una filiera di segnalazione regolamentare separata      | L'[attribuzione](/it/protocol/architecture/state/model) per transazione, servita dall'[indexer](/it/protocol/architecture/indexer) |
| **Prezzare**          | Un amministratore di indici di riferimento              | L'[oracolo](/it/protocol/architecture/oracle), certificato dentro il blocco che lo consuma                                         |

La tesi non è che così costi meno. È che gli intervalli fra quelle istituzioni sono il punto in cui esiste una promessa che nessuno ha ancora onorato: fra un'esecuzione e una richiesta di margine, fra la richiesta e l'arrivo del collaterale, fra un'operazione e il suo regolamento, fra un evento e la sua segnalazione. Ripiegare le funzioni in fasi di un solo blocco non rende le promesse più solide. Elimina gli intervalli in cui possono essere infrante. Qui matching, compensazione e regolamento non sono tre fermate di una pipeline: sono lo stesso evento nello stesso blocco. **L'esecuzione è il regolamento.**

<h2 id="the-network-today">
  La rete oggi
</h2>

L'architettura descritta sopra è già in funzione, su una testnet privata su cui gira l'intero stack. Vedi [La rete oggi](/it/protocol/architecture/network-status) per l'identità della catena, gli endpoint attivi e che cosa aspettarsi prima dell'apertura dell'accesso pubblico il 20 settembre 2026.

<h2 id="where-to-go-next">
  Dove proseguire
</h2>

<CardGroup cols={2}>
  <Card title="IntentionKernel" href="/it/protocol/architecture/kernel">
    Il livello di esecuzione: insieme di istruzioni, pipeline del blocco e i confini che lo mantengono deterministico.
  </Card>

  <Card title="IntentionBFT" href="/it/protocol/architecture/intention-bft">
    Il consenso: impegni sull'ordinamento, quorum sui prezzi e definitività.
  </Card>

  <Card title="Stanza di compensazione" href="/it/protocol/architecture/clearinghouse">
    Margine, liquidazione, auto-deleveraging, assicurazione e funding.
  </Card>

  <Card title="Stato e archiviazione" href="/it/protocol/architecture/state/model">
    Come i risultati confermati vengono persistiti, autenticati e potati.
  </Card>
</CardGroup>