Perché la mia transazione Solana non è riuscita e come scoprirne il motivo su Solscan?

Uno swap mostra l’etichetta rossa "non riuscita", i fondi che volevi trasferire non si sono mossi e il tuo wallet ti offre poco più di un messaggio d’errore generico. È un’esperienza comune su Solana, e di solito la spiegazione completa è sulla blockchain, a portata di una ricerca.

La cosa fondamentale è capire in quale di queste due situazioni ti trovi: una transazione che ha raggiunto la rete ma non è riuscita, oppure una che non è mai arrivata on-chain. Solscan di solito può dirti quale delle due si è verificata e spesso anche il motivo.

Cosa può significare "non riuscita" su Solana

Nel primo caso, la transazione ha raggiunto un validator, è stata inclusa in un blocco e poi rifiutata durante l’esecuzione perché una condizione da cui dipendeva non era soddisfatta. Questo tipo di errore viene registrato in modo permanente on-chain, insieme a un errore e ai log del programma.

Nel secondo caso, la transazione non viene mai inclusa. Ogni transazione Solana fa riferimento a un blockhash recente, che resta valido per circa 150 blocchi, ovvero all’incirca da 60 a 90 secondi. Se la transazione non viene elaborata entro questo intervallo, scade e viene eliminata. Di solito una transazione di questo tipo non compare su nessun explorer, perché non è mai arrivata sulla blockchain.

Motivi comuni per cui una transazione Solana non riesce

Per le transazioni che vengono incluse ma poi non riescono, le cause più frequenti sono una quantità insufficiente di SOL per coprire la commissione di rete (oltre a un piccolo deposito quando è necessario creare un nuovo account token), il superamento della tolleranza allo slippage durante uno swap perché il prezzo si è mosso troppo, oppure una modifica dello stato di un account tra la firma e l’esecuzione. Una transazione può anche esaurire il proprio limite di calcolo, evenienza più comune nelle operazioni complesse.

Per le transazioni che non vengono mai incluse, le cause più frequenti sono un blockhash scaduto, spesso dovuto a una firma lenta, all’esitazione davanti alla richiesta di conferma o a una connessione lenta, e la congestione della rete. Quando la rete è molto utilizzata, una transazione con una commissione prioritaria facoltativa bassa può essere eliminata prima ancora che un validator la elabori.

Come scoprire il motivo su Solscan

Per prima cosa, copia la firma della transazione dalla cronologia delle attività del tuo wallet o dall’app che hai utilizzato, quindi incollala nella barra di ricerca di Solscan. Se la transazione è stata inclusa, la pagina di solito ne mostra lo stato come non riuscita anziché riuscita e potrebbe indicare l’istruzione che ha generato l’errore.

Più in basso nella pagina, cerca sezioni come i dettagli delle istruzioni o i messaggi di log: i nomi esatti e la disposizione possono cambiare nel tempo. I log mostrano quale programma è stato eseguito e in quale punto si è interrotto, di solito indicando il numero dell’istruzione insieme al nome o al codice dell’errore. I codici di errore sono specifici di ciascun programma, quindi lo stesso numero può avere significati diversi a seconda del programma; la relativa documentazione può aiutarti a interpretarlo. Se Solscan non trova affatto la firma, è possibile che la transazione non sia stata inclusa, o che non lo sia ancora.

Cosa succede ai fondi e alla commissione

Solana esegue una transazione come un’unica operazione. Se una qualsiasi istruzione al suo interno non riesce, tutte le modifiche che avrebbe apportato vengono annullate, quindi i saldi dei tuoi token restano invariati. In genere, l’unico costo è la piccola commissione di rete per il tentativo, che viene comunque addebitata perché i validator hanno svolto il lavoro necessario per elaborarlo.

Di norma, una transazione scaduta e mai inclusa non comporta il pagamento di una commissione, perché non ha mai raggiunto la rete. Prima di riprovare, però, vale la pena controllare su Solscan il primo tentativo, perché una transazione che sembra bloccata potrebbe comunque andare a buon fine e inviarla due volte potrebbe causare un trasferimento duplicato.

Promemoria WEEX: controlla prima di riprovare

WEEX ricorda agli utenti di verificare su Solscan lo stato del primo tentativo prima di inviarlo di nuovo e di mantenere nel wallet un piccolo saldo in SOL per coprire le commissioni. Anche le transazioni non riuscite attirano le truffe: chiunque si offra di "risolvere" una transazione non riuscita chiedendo la frase seed o la chiave privata non è una persona affidabile, per quanto possa sembrare ufficiale. Per una vera risoluzione dei problemi non è mai necessario fornire l’una o l’altra.

Conclusione

Una transazione Solana non riuscita non è più un mistero una volta cercata la sua firma. Solscan può mostrare se è fallita on-chain o se non è mai stata inclusa, e i log spesso indicano l’istruzione che l’ha interrotta. Nella maggior parte dei casi i fondi restano dove si trovavano e si perde solo una piccola commissione; la cosa più utile da fare è quindi controllare prima e riprovare dopo.

FAQ

1. Perdo i miei token quando una transazione Solana non riesce?
In genere no. Solana esegue una transazione come un’unica operazione, quindi se una qualsiasi istruzione non riesce, le modifiche vengono annullate e i saldi restano invariati. Di solito si perde solo la commissione di rete.

2. Devo comunque pagare una commissione per una transazione Solana non riuscita?
Se la transazione è arrivata on-chain ma non è riuscita, di solito viene comunque addebitata una piccola commissione di rete. Se è scaduta senza essere inclusa, in genere non viene addebitata e di solito non compare su Solscan.

3. Perché non riesco a trovare la mia transazione su Solscan?
Potrebbe non essere ancora stata inclusa, potrebbe essere scaduta o essere stata eliminata, oppure la firma potrebbe essere stata copiata in modo errato. Controlla la firma, attendi qualche istante e confrontala con lo stato mostrato dal tuo wallet.

4. Dove trovo l’errore su Solscan?
Cerca la firma della transazione, poi individua lo stato di mancato completamento e sezioni come i dettagli delle istruzioni o i log, che in genere mostrano quale istruzione non è riuscita e quale errore è stato restituito. La disposizione e le etichette possono cambiare nel tempo.

5. È sicuro riprovare una transazione Solana non riuscita?
Spesso sì, ma prima controlla su Solscan che la transazione originale non sia andata a buon fine o sia ancora in sospeso. Una transazione che sembra bloccata potrebbe comunque essere completata e inviarla di nuovo troppo presto può causare un trasferimento duplicato.