Le sezioni Read Contract e Write Contract di Etherscan consentono di interagire con uno smart contract senza passare necessariamente dall’interfaccia grafica di una dApp. Sono strumenti utili per controllare informazioni tecniche, verificare impostazioni e, in alcuni casi, eseguire funzioni direttamente sulla blockchain.
Questa possibilità richiede però prudenza. Una funzione visualizzata su Etherscan non è automaticamente sicura, conveniente o adatta al proprio caso. La pagina mostra il modo in cui il contratto espone alcune operazioni, ma non elimina i rischi del codice, degli errori nei parametri, delle autorizzazioni sui token o delle transazioni irreversibili.
La distinzione fondamentale è semplice: Read Contract serve a leggere lo stato del contratto senza inviare una transazione; Write Contract serve a proporre una modifica dello stato e normalmente richiede una firma dal wallet. Capire questa differenza è il primo controllo da fare.
Che cosa serve prima di aprire la pagina del contratto
Per usare correttamente queste sezioni bisogna partire dall’indirizzo esatto dello smart contract e dalla rete corretta. Un contratto distribuito su Ethereum Mainnet non è lo stesso contratto distribuito su una rete layer 2 o su una testnet, anche quando utilizza lo stesso nome o lo stesso token.
Prima di procedere è quindi utile controllare:
- la rete selezionata su Etherscan;
- l’indirizzo completo del contratto, confrontandolo con una fonte ufficiale indipendente;
- la presenza del simbolo di contratto verificato e del codice sorgente pubblicato;
- l’eventuale presenza di un proxy e dell’indirizzo dell’implementazione;
- il dominio dal quale si è partiti, evitando copie o pagine raggiunte tramite link sospetti.
Un nome familiare, un logo o un simbolo del token non sono sufficienti per identificare un contratto legittimo. Gli indirizzi copiati da messaggi, commenti o risultati sponsorizzati possono portare a contratti diversi da quelli attesi.
Come leggere la sezione Read Contract
La scheda Read Contract raccoglie funzioni che, in genere, restituiscono informazioni senza modificare lo stato della blockchain. La consultazione non richiede una firma, non consuma gas e non trasferisce fondi. Etherscan esegue una chiamata di lettura al nodo e mostra il risultato disponibile in quel momento.
I nomi delle funzioni dipendono dal contratto. Nei token compatibili con gli standard più comuni si possono trovare, tra le altre:
- name e symbol, che restituiscono nome e ticker dichiarati;
- decimals, che indica come rappresentare le unità del token;
- totalSupply, che mostra la quantità totale secondo la logica del contratto;
- balanceOf, per interrogare il saldo associato a un indirizzo;
- allowance, per controllare quanto un determinato spender può utilizzare per conto di un proprietario.
Per una funzione come balanceOf occorre inserire un indirizzo. Il risultato deve essere interpretato tenendo conto dei decimali: il valore tecnico restituito dal contratto può essere espresso nell’unità minima, non nella quantità visualizzata normalmente in un wallet.
Anche allowance richiede due indirizzi: il proprietario dei token e lo spender autorizzato. Il controllo è utile per verificare un’autorizzazione già concessa, ma non significa che lo spender abbia effettivamente utilizzato quei token o che li utilizzerà in futuro.
Le funzioni di lettura possono riguardare anche protocolli più complessi. Possono mostrare, per esempio, il proprietario del contratto, lo stato di una pausa d’emergenza, i parametri di una pool, l’indirizzo di un treasury o la soglia di una multisig. Il risultato va sempre collegato al significato della funzione: una voce chiamata owner non dimostra da sola che il proprietario sia affidabile, mentre una voce chiamata paused non spiega perché il contratto sia stato fermato.
Che cosa significa usare Write Contract
La sezione Write Contract elenca le funzioni che possono modificare lo stato del contratto. Per eseguirne una bisogna normalmente collegare un wallet compatibile, inserire i parametri e confermare una transazione. La firma autorizza il wallet a inviare una richiesta alla rete: non equivale alla garanzia che l’operazione andrà a buon fine.
Le funzioni possono produrre effetti molto diversi. Alcune trasferiscono token, altre concedono autorizzazioni, modificano impostazioni, depositano fondi in un protocollo, effettuano un prelievo o aggiornano un indirizzo amministrativo. Il nome della funzione aiuta, ma non basta: bisogna comprendere il codice e i parametri, soprattutto quando il contratto non è familiare.
Una funzione come approve può autorizzare uno spender a utilizzare una determinata quantità di token. Una funzione come transfer può spostare token da un indirizzo a un altro. Una funzione deposit può richiedere anche l’invio di valuta nativa insieme alla transazione, mentre una funzione withdraw può avere condizioni, limiti o finestre temporali definite dal protocollo.
Il collegamento del wallet non significa che Etherscan possa prelevare automaticamente i fondi. Tuttavia, una firma effettuata senza capire la funzione può autorizzare trasferimenti o modifiche importanti. Il wallet dovrebbe mostrare almeno destinatario, rete, valore e costo stimato; per le operazioni più complesse, la schermata potrebbe non rappresentare in modo comprensibile tutti gli effetti della chiamata.
Parametri, valore inviato e costi
Ogni funzione di scrittura può richiedere parametri specifici. Possono essere indirizzi, numeri interi, quantità di token, identificativi di posizione, valori booleani o array. Un errore di formato può causare il fallimento della transazione; un parametro formalmente valido ma sbagliato può invece produrre un’operazione irreversibile.
Gli indirizzi devono essere controllati carattere per carattere. Quando possibile, è preferibile usare copia-incolla da una fonte attendibile e confrontare i primi e gli ultimi caratteri. Le quantità devono essere convertite correttamente in base ai decimali del token. Inserire un importo senza considerare questa conversione può significare inviare molto più o molto meno di quanto previsto.
Alcune funzioni hanno un campo chiamato Value. Questo campo riguarda la valuta nativa della rete, come ETH su Ethereum, e non i token ERC-20. Se la funzione è payable, un valore inserito può essere trasferito insieme alla chiamata. Se non è previsto o viene impostato in modo errato, la transazione può fallire o avere un effetto diverso da quello immaginato.
Il costo di una transazione dipende dal gas utilizzato e dal prezzo del gas. Anche una chiamata fallita può consumare gas, perché la rete deve eseguire il codice prima di determinare che una condizione non è stata soddisfatta. Il gas non è una commissione pagata a Etherscan: viene corrisposto alla rete tramite il wallet.
Come controllare una funzione prima della firma
Prima di premere il pulsante di invio è utile seguire una procedura separata dalla semplice lettura della pagina:
- verificare che la rete del wallet coincida con quella del contratto;
- confrontare l’indirizzo del contratto con la documentazione ufficiale;
- leggere il codice verificato e cercare la definizione della funzione;
- controllare quali modificatori o condizioni possono impedire l’esecuzione;
- verificare se la funzione trasferisce fondi, concede allowance o modifica ruoli amministrativi;
- controllare i parametri e il campo Value prima della firma;
- simulare l’operazione, quando il wallet o un servizio affidabile mette a disposizione una simulazione comprensibile;
- eseguire prima una prova con un importo limitato solo quando il rischio e il funzionamento dell’operazione lo consentono.
Il codice verificato migliora la trasparenza, ma non è una certificazione di sicurezza. Un contratto può essere verificato e contenere comunque una logica rischiosa, privilegi amministrativi, funzioni aggiornabili o meccanismi che l’utente non comprende.
Proxy, contratti aggiornabili e funzioni amministrative
Molti protocolli utilizzano proxy. In questo modello l’indirizzo con cui l’utente interagisce può conservare lo stato e inoltrare le chiamate a un altro contratto, chiamato implementazione. La pagina del proxy può quindi non mostrare da sola tutta la logica operativa.
Quando Etherscan indica un’implementazione, bisogna verificare il codice associato a quell’indirizzo e capire chi può modificarla. Una funzione come upgradeTo, upgradeAndCall, pause, setFee o transferOwnership può avere un ruolo amministrativo rilevante. La presenza di una funzione non dimostra che sia stata usata, ma segnala che il contratto dispone di un certo potere.
Le informazioni nella sezione Read Contract possono aiutare a controllare il proprietario corrente, lo stato di pausa o l’indirizzo dell’implementazione. Non sostituiscono però un’analisi del modello di governance, dei ruoli e delle eventuali chiavi amministrative.
Errori e rischi da evitare
Il primo errore è considerare Etherscan una dApp neutrale che rende sicuro qualsiasi contratto. Etherscan è un explorer: visualizza dati e può fornire un’interfaccia per chiamare funzioni, ma non garantisce il risultato economico dell’operazione.
Un secondo errore è usare Write Contract per “sbloccare” fondi, correggere un saldo o ricevere un airdrop indicato da un messaggio. Le richieste di collegare il wallet e inviare una transazione per reclamare premi inattesi sono spesso un vettore di truffa.
Bisogna inoltre distinguere una transazione di approvazione da un trasferimento diretto. Un’allowance molto ampia può consentire a un contratto di spendere token in futuro, secondo le regole previste. Dopo aver interagito con servizi non più utilizzati, è opportuno controllare le autorizzazioni e revocare quelle non necessarie, considerando il costo della transazione e la rete corretta.
Infine, non bisogna inserire seed phrase, chiavi private o codici di recupero su Etherscan o in qualunque pagina web. Per interagire serve il wallet, non la consegna delle credenziali.
Quando usare queste sezioni
Read Contract è particolarmente utile per verificare saldi, allowance, parametri pubblici e ruoli senza firmare nulla. Write Contract può essere utile in casi tecnici specifici, per esempio quando l’interfaccia ufficiale non è disponibile o quando si deve eseguire una funzione documentata con precisione.
Per operazioni con conseguenze economiche significative è generalmente più prudente usare l’interfaccia ufficiale del protocollo, verificando comunque ogni richiesta nel wallet. Etherscan resta uno strumento prezioso per controllare ciò che il contratto espone, confrontare lo stato prima e dopo l’operazione e analizzare la transazione una volta inclusa in un blocco.
La regola essenziale è separare tre domande: che cosa dichiara la funzione, quali parametri sto inviando e quale effetto può avere sul mio wallet o sul contratto. Solo dopo aver risposto a tutte e tre ha senso valutare la firma.
