Atualizar metadata de token na Solana: nome, símbolo, logo
O nome fica na rede e o logo em um arquivo. Quanto custa cada alteração, em que ordem fazer e quando travar a metadata realmente compensa.
Atualizar metadata token Solana parece uma tarefa só e na verdade são duas. Metadata é a ficha pública do token: nome, símbolo, logo, descrição e links. Essas informações não ficam em um lugar, ficam em dois, e cada um é editado separadamente.
Daí vem a mensagem mais comum depois de um lançamento: o logo mudou faz uma semana e a Solscan continua mostrando o nome antigo.
- Nome, símbolo e endereço web ficam na rede. Mudar custa uma taxa.
- Logo, descrição e links sociais ficam em um arquivo. Mudar sai de graça.
- Editar uma camada nunca mexe na outra.
- Travar é a única decisão que não dá para desfazer.
As duas camadas da metadata
Quando um token é criado, os dados dele chegam pelo Metaplex Token Metadata, o padrão que quase todo token da Solana segue. É isso que cria a primeira camada. Como essa conta é ligada ao mint está descrito na documentação da Solana sobre Metaplex Metadata.
A camada um fica na rede. Guarda exatamente três coisas: o nome, o símbolo (o ticker) e um endereço web que aponta para um arquivo. Carteiras e exploradores leem aqui primeiro. Mexer em qualquer um dos três é uma escrita on-chain e tem custo.
A camada dois é o arquivo que está nesse endereço. Dentro dele ficam o logo, a descrição, o site e os links sociais. Trocar qualquer um se resume a subir o arquivo de novo no mesmo endereço. Sem transação e sem taxa.
Então quando alguém troca o logo e o nome não muda, não tem nada quebrado. O logo está no arquivo, o nome está na rede, e editar um nunca move o outro.
| Campo | Camada | Como mudar | Custo |
|---|---|---|---|
| Nome do token | On-chain | Ferramenta de atualização | 0,2 SOL |
| Símbolo (ticker) | On-chain | Ferramenta de atualização | 0,2 SOL |
| Endereço web (URI) | On-chain | Ferramenta de atualização | 0,2 SOL |
| Logo | O arquivo | Subir de novo no mesmo endereço | grátis |
| Descrição | O arquivo | Subir de novo no mesmo endereço | grátis |
| Site e redes | O arquivo | Subir de novo no mesmo endereço | grátis |
Quando realmente vale mexer
- Quer um logo novo. O design entregou uma versão melhor. Como o logo mora no arquivo, você sobe de novo no mesmo endereço e pronto. Grátis.
- Um link mudou. O Discord mudou de servidor, a conta do X é outra, o site foi para outro domínio. Mesma coisa: edita o arquivo.
- O nome ou o símbolo estão errados. O lançamento saiu com um nome provisório, ou o ticker tem um erro de digitação. Essa é a face lacrada, então passa pela ferramenta de atualização.
- O arquivo vai para armazenamento permanente. Como o próprio endereço muda, isso também é uma escrita on-chain. Esse passo vem sempre antes de travar qualquer coisa.
Os dois primeiros casos nunca tocam a rede e não custam nada, e dá para repetir quantas vezes precisar. Os dois últimos passam pelo mesmo formulário, seja o nome, o ticker ou o endereço. Na prática: o que é cosmético sai de graça, e só os três campos lacrados têm preço.
Atualizar metadata de token na Solana, passo a passo
Atualizar metadata token Solana quando se trata de logo ou links não exige nada disso. Para nome, símbolo ou endereço, o caminho tem quatro passos.
- Veja primeiro como está. Abra a ferramenta de snapshot e cole o endereço do token. Ela lê os valores atuais e diz se a permissão de edição ainda está com alguma carteira. É gratuita, e se a permissão já foi entregue não faz sentido pagar nada.
- Conecte a carteira certa. Só a que tem essa permissão consegue assinar. Com outra, a alteração simplesmente não entra.
- Digite os valores novos e assine. Na ferramenta de atualizar metadata você cola o endereço, escreve o que muda e aprova na carteira. A taxa do momento aparece na página antes de confirmar.
- Confira depois. Rode o snapshot de novo. Com o logo, tenha paciência: carteiras guardam a imagem em cache por dez a trinta minutos.
Antes de travar, o arquivo precisa estar em um lugar permanente. O desastre que se repete: o time sobe o arquivo em uma hospedagem gratuita no lançamento, trava a metadata semanas depois, e meses adiante a hospedagem expira. O endereço passa a devolver um 404. O nome continua aparecendo porque está lacrado na rede, mas o logo e a descrição somem, e como a permissão acabou ninguém consegue apontar o token para um arquivo novo.
Travar ou deixar aberto
Uma hora alguém vai dizer para travar a metadata. Travar significa entregar de vez a permissão de edição, de modo que ninguém mais mude nada, incluindo o próprio time. Quem compra gosta de ver isso, e algumas listas de verificação de listagem pedem.
Quem decide é a ordem. Primeiro move o arquivo para Arweave ou para IPFS com pinning, depois aponta o endereço on-chain para o link novo, então confirma em duas máquinas diferentes durante alguns dias, e só aí trava.
Na hora de travar você escolhe até onde. A ferramenta de revogar a permissão de edição tira só o direito sobre nome, símbolo e endereço. A ferramenta make immutable entrega de uma vez as permissões de edição, emissão e congelamento. As três aparecem lado a lado no guia para revogar as autoridades do token.
Como regra prática: trave quando a marca já assentou, quando o token roda há seis meses sem previsão de mudança de nome, quando o arquivo já vive em armazenamento permanente ou quando uma corretora pede explicitamente. Espere enquanto um rebrand ainda for possível, enquanto a hospedagem puder ser perdida, enquanto uma versão dois seguir na mesa. É a única porta desse processo que abre em um sentido só.
Por que às vezes a alteração não passa
Dois motivos cobrem quase todos os casos. Ou a permissão de edição já foi revogada, muitas vezes durante a criação, e aí nome, símbolo e endereço estão lacrados de vez. Ou a carteira conectada não é a que tem a permissão.
O segundo caso parece um defeito da ferramenta e não é. O snapshot mostra qual carteira tem a permissão; basta conectar exatamente aquela. Se a permissão foi mesmo embora, não tem volta, e o único caminho é um mint novo.
Existe um terceiro caso parecido e inofensivo: a alteração entrou faz tempo e a carteira ainda mostra a imagem antiga. Os motivos para um token aparecer errado ou não aparecer estão reunidos em token Solana não aparece na Phantom. Já fazer o token surgir na busca do explorador é outro procedimento, com requisitos próprios, explicado no guia de verificação de tokens da Solana.
Os erros que mais se repetem
- Editar o arquivo achando que o nome vai junto. O logo está no arquivo, o nome está na rede. Cada um se confere por conta própria.
- Travar com o arquivo em hospedagem temporária. O erro mais caro da lista, e depois não tem conserto.
- Não esperar o cache. Dez a trinta minutos é normal. Antes de repetir a operação, leia o snapshot.
- Tentar renomear pelo arquivo. O campo de nome do arquivo é ignorado pelas carteiras. Renomear de verdade passa pela ferramenta.
- Assinar com a carteira errada. Não custa taxa, custa alguns minutos de confusão toda vez.
Perguntas frequentes sobre metadata
Dá para mudar o nome do token depois do lançamento?
Dá, desde que a permissão de edição ainda esteja com alguma carteira. O snapshot mostra isso de graça, e a mudança custa 0,2 SOL assinados por essa carteira.
Por que meu token ainda mostra o logo antigo?
Ou foi editada a camada errada, ou a carteira ainda guarda a imagem em cache. Suba o logo no mesmo endereço, leia o snapshot e espere o cache passar.
Quanto custa atualizar?
Editar o arquivo não custa nada. Mudar nome, símbolo ou endereço custa 0,2 SOL mais uma pequena despesa de rede, e o valor aparece na página antes de confirmar.
Vale a pena tornar o token imutável?
Quando a marca está firme, o token tem alguma história e o arquivo está em armazenamento permanente, vale. Enquanto um rebrand for possível, melhor esperar.
O que é update authority?
É a permissão, guardada por uma carteira específica, de editar depois a metadata escrita na rede. Entregue ela e o registro fica lacrado para sempre.
Isso vale para Token-2022 também?
Só em parte. O Token-2022 pode carregar a metadata dentro do próprio token e aí segue outro caminho. Este guia cobre o fluxo clássico de SPL com Metaplex.
Resumo prático
Atualizar é barato e repetível, então o primeiro dia não precisa sair perfeito. Um nome se corrige, um logo se troca, links se movem quantas vezes for preciso. A única jogada definitiva é travar: mova o arquivo para armazenamento permanente, aponte o endereço, confirme que carrega, e só então entregue a permissão.
