Riferimento codici di errore

Quando qualcosa non va, J Tools mostra un breve titolo e una riga che spiega cosa è successo e cosa fare. Dietro ogni messaggio c’è un codice, come AFF_WITHDRAW_MIN o VALIDATION_ERROR, che è quello che riportano le risposte API e che il supporto può rintracciare. Questa pagina spiega quelli che incontrerai più probabilmente e cosa fare per ciascuno.

I codici dell’affiliazione hanno il prefisso AFF_ e stanno sotto Affiliazione. Tutto il resto sono messaggi di strumenti o transazioni, ordinati per provenienza: Swap e trading, Wallet e trasferimenti, Transazioni e firma e Generali e altri. Se vedi solo un messaggio senza codice, di solito lo spiega anche la sezione “Problemi comuni” nella pagina dello strumento.

J Tools è non-custodial, quindi tutto quello che parte dal tuo wallet finisce nel tuo wallet. Non si muove nulla finché non firmi.

Affiliazione

#affiliazione

Compaiono intorno al pannello di affiliazione: durante la registrazione, la richiesta di un prelievo o l’accredito di un referral.

Account e accesso

Codice	Cosa significa	Come risolvere
AFF_NOT_FOUND	A questo wallet non è collegato nessun account di affiliazione.	Registrati prima come partner, oppure ricollega il wallet a cui appartiene l’account partner. Vedi Come funziona il programma di affiliazione.
AFF_BANNED	L’account partner è sospeso, quindi il pannello gli è chiuso. La finestra di accesso dice che l’account è sospeso; le altre richieste rispondono “Access denied.”	Contatta il supporto. Un partner sospeso non può usare il pannello, richiedere un prelievo o guadagnare nuove provvigioni.
AFF_ALREADY_REGISTERED	Questo wallet è già un partner.	Accedi con il wallet esistente invece di registrarti di nuovo.
AFF_WALLET_REQUIRED	L’indirizzo del wallet manca o non è un indirizzo Solana valido.	Collega un wallet, oppure inserisci un indirizzo Solana valido (circa da 32 a 44 caratteri base58).
AFF_TERMS_REQUIRED	La registrazione è stata inviata senza accettare i termini di affiliazione attuali.	Spunta la casella dei termini nella finestra di registrazione, poi registrati di nuovo.

Prelievi

Codice	Cosa significa	Come risolvere
AFF_WITHDRAW_MIN	L’importo è sotto il prelievo minimo.	Richiedi almeno il minimo indicato nel pannello. Vedi Prelievi.
AFF_WITHDRAW_MAX	L’importo supera il saldo disponibile.	Abbassalo fino al saldo prelevabile attuale, oppure aspetta che arrivino altre provvigioni confermate.
AFF_SOCIAL_REQUIRED	Non c’è nessun link social verificato, e per prelevare ne serve almeno uno.	Aggiungi un link in Impostazioni, aspetta che il nostro team lo verifichi, poi riprova.
AFF_WITHDRAW_PENDING	Hai già una richiesta di prelievo in attesa.	Aspetta che venga pagata o respinta. Può essere aperta una sola richiesta alla volta.
AFF_WITHDRAW_REJECTED	Un amministratore ha respinto la richiesta senza indicare un motivo. Il pannello la mostra come respinta senza motivo, e l’importo è tornato sul tuo saldo.	Contatta il supporto per i dettagli, poi invia una nuova richiesta di prelievo.

Attribuzione dei referral

Codice	Cosa significa	Come risolvere
AFF_REF_INVALID	Il codice di referral non è scritto correttamente, oppure non appartiene a nessun partner attivo.	Usa un link aggiornato nella forma https://j.tools/it?ref=CODICE. Il codice potrebbe appartenere a un partner non più attivo. Vedi Come funziona l’accredito.
AFF_RATE_LIMITED	Troppe richieste agli endpoint dell’affiliazione in poco tempo (HTTP 429).	Aspetta circa un minuto e riprova. Questo limite protegge gli endpoint pubblici dagli abusi.

Attenzione

L’accredito del referral si lega a un wallet la prima volta che paga una commissione di piattaforma mentre in quel browser è salvato il codice del link di un partner (il codice resta per 7 giorni), e resta solo a quel primo partner. Un wallet che ha pagato una commissione prima che venisse aperto un link resta senza attribuzione finché una transazione a pagamento successiva non porta un codice. Leggi Come funziona l’accredito prima di aspettarti una provvigione.

Swap e trading

#swap-e-trading

Compaiono quando fai uno swap o sposti un token che possiedi.

Messaggio	Cosa significa	Come risolvere
Token insufficienti	Stai cercando di inviare, scambiare o bruciare più token di quanti ne abbia il wallet.	Abbassa l’importo a quello che hai davvero, oppure controlla di aver scelto il token giusto.

Wallet e trasferimenti

#wallet-e-trasferimenti

Quasi sempre vengono dal wallet stesso: non è collegato, punta al cluster sbagliato o l’indirizzo inserito non è corretto.

Messaggio	Cosa significa	Come risolvere
Hai annullato dal wallet	La transazione è stata rifiutata nella schermata di approvazione del wallet. Non è stato inviato né addebitato nulla.	Riprova quando sei pronto ad approvare.
Wallet non collegato	Lo strumento ha bisogno di un wallet collegato prima di poter firmare.	Collega prima un wallet. Vedi Collega il wallet.
L’approvazione ha richiesto troppo tempo	La transazione è scaduta mentre la richiesta del wallet era ancora aperta.	Riprova e approva senza lunghe pause.
Il wallet è sulla rete sbagliata	Il wallet è impostato su un cluster diverso da quello che lo strumento si aspetta.	Passa il wallet alla mainnet di Solana, poi riprova.
Hai rinunciato davanti a un avviso del wallet	Il wallet ha mostrato un avviso sulla transazione e tu l’hai rifiutata. Non è stato inviato nulla.	Leggi la nota qui sotto. Se l’avviso non ti sembrava coerente con quello che avevi impostato, segnalalo al supporto così possiamo controllare cosa ha costruito lo strumento.
Indirizzo wallet non valido	Un campo destinatario o wallet non contiene un indirizzo Solana valido (circa da 32 a 44 caratteri base58).	Incolla di nuovo l’indirizzo completo. Attenzione a refusi, caratteri in più o copie troncate.

Nota

Sugli avvisi del wallet. Alcuni strumenti uniscono più istruzioni in una sola transazione, per esempio la creazione di un token insieme ai suoi metadati. Per queste transazioni Phantom può mostrare un banner di avviso: se lo strumento ti dice di aspettartelo, non significa che qualcosa non va. Leggi cosa stai firmando e approva se corrisponde a quello che hai impostato. Se compare un avviso che lo strumento non aveva menzionato, rifiuta e avvisa il supporto.

Transazioni e firma

#transazioni-e-firma

Compaiono mentre una transazione viene costruita o trasmessa: quando va finanziata, quando deve raggiungere la rete o superare i controlli dello strumento.

Saldo e fondi

Messaggio	Cosa significa	Come risolvere
SOL insufficienti	Il wallet non riesce a coprire la commissione di piattaforma più i costi di rete di questa azione.	Ricarica il wallet, poi riprova. Vedi la nota sulle commissioni qui sotto.
Un account resterebbe sotto il minimo di rent	Ogni account Solana deve mantenere il suo minimo per l’esenzione dal rent. O il saldo non ci arriva, o l’importo lascerebbe nel wallet mittente solo polvere.	Aggiungi SOL, abbassa l’importo oppure svuota del tutto il wallet mittente.

Attenzione

Sulle commissioni. Ogni azione ha due costi: la commissione di rete di Solana, pagata ai validator, e la commissione di piattaforma di J Tools. La commissione di piattaforma compare sempre nell’app prima della conferma, e non paghi nulla finché non firmi. Le commissioni possono cambiare nel tempo, quindi fidati del riepilogo nell’app e non di una cifra vista una volta.

Rete e RPC

Messaggio	Cosa significa	Come risolvere
La transazione è scaduta	Il blockhash è scaduto prima che la transazione entrasse, di solito perché la rete era congestionata.	Riprova. Una transazione scaduta non è mai entrata, quindi non è stato addebitato nulla.
La rete Solana non è raggiungibile	L’endpoint RPC non ha risposto.	Aspetta circa 30 secondi e riprova. Se succede ancora, prova un’altra connessione (per esempio senza una VPN restrittiva).
Troppe richieste	Il provider RPC o un endpoint condiviso ha ricevuto troppe chiamate in poco tempo (HTTP 429).	Aspetta qualche secondo, poi riprova.
Nessuna conferma è arrivata in tempo	La transazione è stata inviata, ma lo strumento ha smesso di aspettare il risultato. Potrebbe comunque essere entrata.	Controlla il wallet o un explorer prima di inviarla di nuovo, così non la esegui due volte.

Validazione

Messaggio	Cosa significa	Come risolvere
Quell’indirizzo mint non è valido	L’indirizzo del token non è scritto correttamente, oppure non corrisponde al mint di un token.	Scegli il token con il selettore invece di incollarlo.
Un campo obbligatorio è vuoto	Al modulo manca qualcosa che serve per questa esecuzione.	Compila i campi evidenziati e invia di nuovo.
Importo non valido	L’importo è zero, negativo o non è un numero.	Inserisci un importo maggiore di zero. Se lo strumento mostra un limite accanto al campo, restaci dentro.
Please check your input and try again	Un controllo lato server ha rifiutato i dati, e la risposta resta generica per sicurezza. Il messaggio arriva in inglese.	Ricontrolla i campi. Se non vedi niente di sbagliato, aggiorna la pagina e inserisci di nuovo i valori.

Generali e altri

#generali-e-altri

Alcune risposte API riportano un breve codice testuale invece di un messaggio specifico. Sono volutamente generici, per non esporre dettagli del server.

Codice	Cosa significa	Come risolvere
VALIDATION_ERROR	Uno o più dati non hanno superato un controllo lato server. Lo strumento lo mostra come “Un campo obbligatorio è vuoto”.	Correggi i campi evidenziati e invia di nuovo. È lo stesso caso dei messaggi di validazione qui sopra.
RATE_LIMITED	Hai raggiunto il limite di richieste su un endpoint condiviso (HTTP 429). Lo strumento lo mostra come “Troppe richieste”.	Aspetta un po’, poi riprova.
UNAUTHORIZED	La sessione manca o è scaduta.	Accedi o ricollega il wallet, poi ripeti l’azione.
NOT_FOUND	Quello che hai chiesto non è disponibile, o non è mai esistito.	Ricontrolla il link o l’identificativo che hai usato.
GENERIC_ERROR	Un errore imprevisto che il server non è riuscito a classificare. Lo strumento mostra “Qualcosa è andato storto”.	Riprova una volta. Se si ripete, manda al supporto il testo esatto e cosa stavi facendo.

Ancora bloccato?

#ancora-bloccato

Il messaggio nell’app è sempre il riferimento. Se un codice non è in questa pagina, se il testo è diverso o se la soluzione indicata non ha funzionato, segui l’app e scrivici. Mandaci il messaggio esatto che hai visto, lo strumento che stavi usando e cosa stavi facendo subito prima. Di solito basta per trovare il problema in fretta.

• Supporto Come contattare il team di J Tools, cosa includere perché un problema si risolva in fretta e i dati che non devi mai dare a chi dice di essere il supporto.
• Tabella delle tariffe Tutte le commissioni di piattaforma di J Tools in un'unica tabella, per strumento e categoria, e in cosa la commissione di rete di Solana e i depositi di rent si distinguono da quello che addebita J Tools.

Consiglio

J Tools è non-custodial. Non memorizziamo mai le chiavi private del tuo wallet e non ti chiediamo mai la seed phrase. Ogni transazione che approvi in un wallet collegato viene firmata dentro quel wallet, e la sua chiave non arriva mai ai nostri server. Alcuni strumenti multi-wallet ti permettono di incollare le chiavi private di hot wallet usa e getta: restano nella scheda del browser e firmano lì. Holder Booster è l’unico strumento che affida una chiave al nostro worker, quella del wallet distributore nuovo che crea per ogni esecuzione, inviata cifrata. Non incollare mai la chiave di un wallet in cui tieni fondi a lungo termine e, se una pagina ti chiede la seed phrase, fermati e chiudila.