Parametri indicizzati
Topic filtrabili
Parametri indicizzati è una lezione Web3 & DApp Development Fundamentals gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Web3 & DApp Development Fundamentals, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Web3 & DApp Development Fundamentals include 4 lezioni in totale.
Filtrare i log
Quando un contratto emette molti eventi, le applicazioni off-chain hanno bisogno di un modo per filtrarli in modo efficiente, ad esempio per trovare ogni Transfer verso un indirizzo specifico.
Solidity lo supporta con i parametri degli eventi indicizzati, che diventano topic ricercabili.
La parola chiave indexed
Contrassegni un parametro come indexed per memorizzarlo come topic del log anziché nella sezione dei dati. I nodi Ethereum possono filtrare rapidamente i topic.
<code>event Transfer(
address indexed from,
address indexed to,
uint256 amount
);</code>Topic e dati
Ogni log contiene fino a 4 topic e un blocco arbitrario di dati:
- Il topic 0 è l'hash della firma dell'evento (automatico per gli eventi non anonimi)
- Ogni parametro
indexedoccupa uno slot topic aggiuntivo - I parametri non indicizzati vengono inseriti nella sezione dei dati
Il limite di tre parametri indicizzati
Un evento non anonimo può avere al massimo tre parametri indicizzati, perché il topic 0 è riservato all'hash della firma.
L'aggiunta di un quarto parametro indicizzato genera un errore di compilazione.
<code>// OK: 3 indexed params
event Trade(
address indexed maker,
address indexed taker,
uint256 indexed orderId,
uint256 price // not indexed
);</code>Scegliere cosa indicizzare
Indicizzi i campi in base ai quali effettuerà le ricerche: indirizzi, ID, categorie. Mantenga i valori grandi o descrittivi (importi, stringhe) non indicizzati, così resteranno leggibili nella sezione dei dati.
<code>event ItemSold(
uint256 indexed itemId,
address indexed buyer,
uint256 price
);</code>Indicizzare stringhe e bytes
Quando indicizza un tipo dinamico come string o bytes, il topic memorizza l'hash keccak256 del valore, non il valore stesso.
Può comunque filtrare calcolando l'hash del termine di ricerca, ma non può recuperare il testo originale dal topic.
<code>event Tagged(string indexed label, uint256 value);
// topic = keccak256(label), original text not in log</code>Filtrare sul client
Le librerie client usano i topic indicizzati per creare filtri. Ad esempio, recuperare tutti i trasferimenti ricevuti da un indirizzo diventa un rapido confronto tra topic.
<code>// ethers.js (off-chain)
// const filter = token.filters.Transfer(null, myAddress);
// const logs = await token.queryFilter(filter);</code>L'evento Transfer standard
ERC-20 ed ERC-721 definiscono un evento Transfer con indirizzi indicizzati. Per questo i wallet possono mostrare così rapidamente i trasferimenti in entrata e in uscita.
<code>// ERC-20
event Transfer(address indexed from, address indexed to, uint256 value);
// ERC-721
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);</code>Considerazioni sul gas
I parametri indicizzati costano leggermente più gas di quelli non indicizzati, perché occupano slot topic dedicati. Indicizzi solo ciò che deve davvero essere usato nei filtri.
Eventi anonimi
Un evento anonymous omette l'hash della firma dal topic 0, liberando un quarto slot indicizzato. Sono rari e più difficili da decodificare, quindi li utilizzi solo nei casi avanzati a basso livello.
<code>event LowLevel(uint256 indexed a, uint256 indexed b,
uint256 indexed c, uint256 indexed d) anonymous;</code>Combinare indicizzazione e dati
In un evento pratico si indicizzano le chiavi ricercabili e si lascia il contenuto descrittivo nei dati, bilanciando filtrabilità e leggibilità.
<code>event Deposit(
address indexed account, // searchable
uint256 amount, // readable in data
uint256 timestamp
);</code>Verifica rapida
Verifichi la Sua comprensione dei parametri indicizzati.
Riepilogo
Ha imparato a conoscere i parametri indicizzati degli eventi:
indexedtrasforma un parametro in un topic filtrabile- Massimo 3 parametri indicizzati (topic 0 = hash della firma)
- I tipi dinamici indicizzati memorizzano un hash keccak256, non il valore
- Indicizzi le chiavi ricercabili e mantenga il contenuto descrittivo nella sezione dei dati
Una buona indicizzazione rende le query off-chain rapide ed economiche.
Impara Web3 & DApp Development Fundamentals con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 29
- Lezioni
- 105
Domande Frequenti
La lezione «Parametri indicizzati» è gratuita?
Sì — il testo completo di «Parametri indicizzati» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Web3 & DApp Development Fundamentals, passa a CoddyKit PRO. Il corso Web3 & DApp Development Fundamentals include 4 lezioni in totale.
Cosa imparerò in «Parametri indicizzati»?
Topic filtrabili Eserciti Web3 & DApp Development Fundamentals con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Web3 & DApp Development Fundamentals?
Non è richiesta alcuna esperienza precedente. Web3 & DApp Development Fundamentals su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Parametri indicizzati»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Web3 & DApp Development Fundamentals?
Sì. Ogni lezione Web3 & DApp Development Fundamentals include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Dichiarazione degli eventi
- Parametri indicizzati
- Ascolto degli eventi
- Eventi e storage a confronto