Aggiornare i metadata di un token Solana: nome e logo

Aggiornare i metadata di un token Solana sembra una sola operazione e invece sono due. I metadata sono la scheda pubblica del token: nome, simbolo, logo, descrizione e link. Queste informazioni non stanno in un posto solo, ne occupano due, e si modificano separatamente.

Da qui il messaggio più frequente dopo un lancio: il logo è cambiato da una settimana e Solscan mostra ancora il vecchio nome.

• Nome, simbolo e indirizzo web stanno sulla rete. Cambiarli costa una commissione.
• Logo, descrizione e link social stanno in un file. Cambiarli è gratuito.
• Modificare un livello non tocca mai l'altro.
• Il blocco è l'unica scelta che non si può annullare.

I due livelli dei metadata

Quando un token viene creato, i suoi dati arrivano tramite Metaplex Token Metadata, lo standard che segue quasi ogni token su Solana. È questo a creare il primo livello. Come quell'account viene agganciato al mint è descritto nella documentazione di Solana su Metaplex Metadata.

Il livello uno sta sulla rete. Contiene esattamente tre cose: il nome, il simbolo (il ticker) e un indirizzo web che punta a un file. Wallet ed explorer leggono prima qui. Toccare uno di questi tre campi è una scrittura on-chain e ha un costo.

Il livello due è il file che sta a quell'indirizzo. Dentro ci sono il logo, la descrizione, il sito e i link social. Cambiarne uno significa ricaricare il file allo stesso indirizzo. Nessuna transazione, nessuna commissione.

Quindi quando qualcuno sostituisce il logo e il nome resta fermo, non si è rotto niente. Il logo sta nel file, il nome sta sulla rete, e modificare uno non sposta mai l'altro.

Campo	Livello	Come si cambia	Costo
Nome del token	On-chain	Strumento di aggiornamento	0,2 SOL
Simbolo (ticker)	On-chain	Strumento di aggiornamento	0,2 SOL
Indirizzo web (URI)	On-chain	Strumento di aggiornamento	0,2 SOL
Logo	Il file	Ricaricarlo allo stesso indirizzo	gratis
Descrizione	Il file	Ricaricarlo allo stesso indirizzo	gratis
Sito e social	Il file	Ricaricarlo allo stesso indirizzo	gratis

Quando serve davvero metterci mano

• Serve un logo nuovo. Il design ha consegnato una versione migliore. Il logo sta nel file, quindi lo ricarichi allo stesso indirizzo e hai finito. Gratis.
• È cambiato un link. Il Discord si è spostato, l'account X è nuovo, il sito è su un altro dominio. Stessa storia: si modifica il file.
• Nome o simbolo sbagliati. Il lancio è avvenuto con un nome provvisorio, oppure nel ticker c'è un refuso. Quella è la faccia sigillata, quindi passa dallo strumento di aggiornamento.
• Il file si sposta su un archivio permanente. Cambiando l'indirizzo stesso, anche questa è una scrittura on-chain. Questo passaggio viene sempre prima di qualsiasi blocco.

I primi due casi non toccano mai la rete e non costano nulla, e si possono ripetere quante volte serve. Gli ultimi due passano dallo stesso modulo, che si tratti del nome, del ticker o dell'indirizzo. In pratica: l'estetica è gratis, e solo i tre campi sigillati hanno un prezzo.

Aggiornare i metadata di un token Solana, passo per passo

Aggiornare metadata token Solana per un logo o dei link non richiede nulla di tutto questo. Per nome, simbolo o indirizzo il percorso sta in quattro passaggi.

• Guarda prima com'è messo. Apri lo strumento di snapshot e incolla l'indirizzo del token. Legge i valori attuali e dice se il permesso di modifica è ancora in mano a un wallet. È gratuito, e se il permesso è già stato ceduto non ha senso pagare nulla.
• Collega il wallet giusto. Solo quello che detiene quel permesso può firmare. Con un altro la modifica semplicemente non entra.
• Inserisci i valori nuovi e firma. Nello strumento di aggiornamento dei metadata incolli l'indirizzo, scrivi cosa cambia e approvi dal wallet. La commissione del momento compare sulla pagina prima della conferma.
• Controlla dopo. Ripassa lo snapshot. Per il logo serve pazienza: i wallet tengono l'immagine in cache dai dieci ai trenta minuti.

Prima di bloccare, il file deve stare in un posto permanente. Il disastro che si ripete: un team lo carica su un hosting gratuito durante il lancio, blocca i metadata qualche settimana dopo, e mesi più tardi l'hosting scade. L'indirizzo restituisce un 404. Il nome resta visibile perché è sigillato sulla rete, ma logo e descrizione spariscono, e siccome il permesso non esiste più nessuno può puntare il token a un file nuovo.

Bloccare oppure lasciare aperto

A un certo punto qualcuno dirà di bloccare i metadata. Bloccare vuol dire cedere per sempre il permesso di modifica, così che nessuno possa più cambiare niente, team compreso. Chi compra lo guarda volentieri, e alcune checklist per il listing lo chiedono.

A decidere è l'ordine. Prima sposti il file su Arweave o su IPFS con pinning, poi punti l'indirizzo on-chain al nuovo link, quindi verifichi da due macchine diverse per qualche giorno, e solo allora blocchi.

Quando blocchi scegli fino a dove arrivare. Lo strumento per revocare il permesso di modifica toglie solo il diritto su nome, simbolo e indirizzo. Lo strumento make immutable cede in un colpo solo i permessi di modifica, emissione e congelamento. I tre sono messi a confronto nella guida per revocare le autorità di un token.

Come regola pratica: blocca quando il marchio si è assestato, quando il token gira da sei mesi senza rinomine in vista, quando il file sta già su un archivio permanente o quando un exchange lo chiede esplicitamente. Aspetta finché un rebrand resta possibile, finché l'hosting può sfuggirti di mano, finché una versione due è ancora sul tavolo. È l'unica porta di questo percorso che si apre in una sola direzione.

Perché a volte la modifica non passa

Due motivi coprono quasi tutti i casi. O il permesso di modifica è già stato revocato, spesso durante la creazione, e allora nome, simbolo e indirizzo sono sigillati per sempre. Oppure il wallet collegato non è quello che detiene il permesso.

Il secondo caso sembra un difetto dello strumento e non lo è. Lo snapshot dice quale wallet ha il permesso, basta collegare esattamente quello. Se il permesso è davvero andato non si torna indietro, e l'unica strada è un nuovo mint.

C'è un terzo caso che gli somiglia ed è innocuo: la modifica è passata da un pezzo e il wallet mostra ancora la vecchia immagine. I motivi per cui un token si vede male o non si vede affatto sono raccolti in token Solana non visibile su Phantom. Far comparire un token nella ricerca dell'explorer è invece una procedura a parte, con requisiti suoi, spiegata nella guida di Solana alla verifica dei token.

Gli errori che si ripetono

• Modificare il file dando per scontato che il nome segua. Il logo sta nel file, il nome sulla rete. Ognuno si verifica per conto suo.
• Bloccare con il file su un hosting temporaneo. L'errore più caro dell'elenco, e dopo non si ripara.
• Non aspettare la cache. Dieci o trenta minuti sono normali. Prima di rifare l'operazione, leggi lo snapshot.
• Provare a rinominare dal file. Il campo nome nel file i wallet lo ignorano. Una rinomina vera passa dallo strumento.
• Firmare con il wallet sbagliato. Non costa commissioni, costa qualche minuto di confusione ogni volta.

Domande frequenti sui metadata

Si può cambiare il nome di un token dopo il lancio?

Sì, finché il permesso di modifica è ancora in un wallet. Lo snapshot lo dice gratis, poi il cambio costa 0,2 SOL firmati da quel wallet.

Perché il token mostra ancora il vecchio logo?

O è stato modificato il livello sbagliato, o il wallet tiene ancora l'immagine in cache. Ricarica il logo allo stesso indirizzo, leggi lo snapshot e lascia passare la cache.

Quanto costa un aggiornamento?

Modificare il file non costa nulla. Cambiare nome, simbolo o indirizzo costa 0,2 SOL più una piccola spesa di rete, e l'importo compare prima della conferma.

Conviene rendere immutabile il token?

Quando il marchio è stabile, il token ha un po' di storia e il file sta su un archivio permanente, sì. Finché un rebrand resta possibile, meglio aspettare.

Che cos'è l'update authority?

È il permesso, in mano a un wallet preciso, di modificare più avanti i metadata scritti sulla rete. Ceduto quello, il registro resta sigillato per sempre.

Vale anche per Token-2022?

Solo in parte. Token-2022 può portare i metadata dentro al token stesso e allora segue un'altra strada. Questa guida copre il flusso classico SPL con Metaplex.

Prima di toccare qualcosa

Aggiornare costa poco e si ripete, quindi il primo giorno non deve venire perfetto. Un nome si corregge, un logo si sostituisce, i link si spostano tutte le volte che serve. L'unica mossa definitiva è il blocco: sposta il file su un archivio permanente, punta l'indirizzo, controlla che si carichi, e solo dopo cedi il permesso.