Todas as postagens
Guias

Metadados imutáveis: o que muda para a marca do token Solana

O que os metadados imutáveis fixam num token Solana (nome, símbolo, URI), o que depende do arquivo externo e o que revisar antes de travar a marca.

9 min de leitura J Tools Editorial
Um volante de válvula de metal com a borda em brasa, girando entre fumaça, ao lado de uma prancheta de couro lacrada com cera e três marcas de verificação

Travar os metadados de um token da Solana deixa fixos para sempre o nome, o símbolo e o link de onde saem o logo e a descrição. Um token com metadados imutáveis não muda de nome de surpresa, e isso tranquiliza os compradores. A pergunta de marca é outra: o que de fato fica congelado e do que você abre mão no dia em que assina.

A resposta curta tem pegadinha. Os metadados imutáveis congelam o ponteiro, não o arquivo para onde ele aponta. O logo, a descrição e os links vivem fora da rede e duram exatamente o que durar o lugar onde estão hospedados.

O que os metadados imutáveis congelam e o que não

Três cadeados numa parede cinza-escura: um de latão aberto, outro fechado com o corpo partido e, à direita, um bloco de metal sem arco iluminado de vermelho por baixo

Um token SPL clássico guarda a identidade em duas camadas. Na rede fica uma conta de metadados da Metaplex, ligada ao mint, com o nome, o símbolo e uma URI, que é só um link. Fora da rede fica o arquivo JSON para onde essa URI aponta, com a descrição, os links do site, X, Telegram ou Discord, e o logo.

O logo também não está dentro do arquivo: o JSON guarda apenas outro link, o campo image, que leva à imagem. Do token ao logo são dois saltos, primeiro a URI e depois o link da imagem.

Travar os metadados significa pôr em false um indicador da conta da Metaplex, o Is Mutable. A partir daí o programa rejeita qualquer alteração, e o indicador só anda num sentido: de true para false, nunca de volta. Depois da trava, um explorador ainda pode listar um endereço como autoridade de atualização; o que decide é o indicador.

Parte da marcaOnde ficaDepois da trava
NomeNa redeNão muda mais
SímboloNa redeNão muda mais
URINa redeNão muda mais
Descrição e linksNo arquivo JSONSó mudam se o arquivo puder mudar
LogoUm link de imagem dentro do arquivoComo o arquivo, mais a hospedagem da imagem

A documentação oficial de Token Metadata da Metaplex diz isso com todas as letras: o indicador impede mudar a URI, e só a combinação com armazenamento permanente para o arquivo garante que o JSON também não mude.

O arquivo por trás da URI decide o que fica travado

É como gravar em pedra o endereço de uma casa: o endereço não muda mais, mas o dono ainda pode reformar a casa ou deixá-la desabar.

  • Servidor web ou domínio alugado. O dono do servidor pode trocar o arquivo, e com ele o logo, mesmo com os metadados travados. Se o domínio expira ou o servidor sai do ar, o arquivo some: o nome e o símbolo continuam na rede, mas o logo, a descrição e os links se perdem.
  • IPFS. Um link IPFS nomeia o conteúdo pelo hash criptográfico, o CID. Conteúdo diferente gera outro CID, então esse link não passa a mostrar outro logo. Mas o arquivo só continua acessível enquanto pelo menos um nó o mantiver fixado (o pin).
  • Arweave. É vendido como armazenamento permanente e é a opção que a própria Metaplex cita junto com o indicador.

O segundo salto pesa igual: um JSON no Arweave com o campo de imagem apontando para um servidor comum deixa o logo tão exposto quanto antes.

Para o detentor, arquivo fora do ar se vê na hora: o nome está lá, a imagem não carrega. Como esse sintoma tem outras causas, vale ler por que um token Solana não aparece na Phantom.

Se você vai comprar: um explorador mostrar o indicador de mutabilidade em false não prova que o logo está fixo. Abra a URI no navegador, veja para onde aponta o link da imagem e confira se os dois são IPFS, Arweave ou um domínio qualquer.

O que a marca perde para sempre

Com metadados imutáveis não tem volta. Um erro de digitação no nome fica. Rebranding, nem pensar. Se amanhã você trocar de domínio ou de conta nas redes, não dá para apontar o token para um arquivo com links novos. E se a hospedagem morrer, ninguém redireciona o token para uma cópia. A única identidade nova é um mint novo.

Em troca, os detentores sabem que ninguém vai trocar o nome ou o logo por baixo dos panos, desde que arquivo e imagem estejam em armazenamento permanente ou endereçado por conteúdo.

Um token de comunidade já pronto. Nome definitivo, logo carregando, links estáveis e nenhum rebranding à vista. A trava completa faz sentido: da marca, não sobra nada a administrar.

Um projeto com rebranding planejado. Com logo novo a caminho ou nome ainda em discussão, o sensato é deixar os metadados abertos e fechar o que já está pronto, como a cunhagem se a oferta já é definitiva.

Antes de decidir, pergunte: vou precisar mudar isso nos próximos 12 meses? Se a resposta for sim para nome, logo ou links, ainda não é hora de travar.

Antes de travar: o checklist da marca

  1. Nome e símbolo exatos. Revise letra por letra, maiúsculas incluídas. Erro de digitação é para sempre.
  2. O logo aparece. Confira na Phantom e num explorador de blocos, não só no seu painel.
  3. A URI carrega. Abra no navegador: ela precisa devolver o JSON, não um 404. Dentro dele, abra também o link da imagem.
  4. Os links são seus a longo prazo. Site, X, Telegram e Discord devem apontar para contas e domínios que você vai manter.
  5. Os dois saltos em armazenamento que não muda. Arquivo e imagem no IPFS com pin ou no Arweave, com o token já apontando para esse arquivo enquanto os metadados ainda aceitam edição.
  6. Só então, trave.

Para os últimos ajustes existe a ferramenta para atualizar metadados: muda nome, símbolo, logo e links enquanto os metadados estão abertos, a partir da carteira com a autoridade de atualização, e não trava nada. Se o lançamento já passou, o que fazer depois de lançar um token na Solana organiza o resto.

Só os metadados ou a trava completa

Um sinete de latão com cabo de madeira pressionado em cera vermelho-alaranjada ainda líquida sobre um envelope creme, com gotas de cera espalhadas numa mesa escura

Travar a marca e fechar o resto são decisões diferentes.

  • Revogar a autoridade de atualização trava só os metadados, pondo o indicador em false. Pede a carteira que tem essa autoridade e, depois da confirmação, relê a conta para checar o resultado.
  • A ferramenta que torna o token imutável lê o token primeiro e põe numa única transação só as travas que a sua carteira conectada ainda tem: autoridades de cunhagem e de congelamento para nenhuma e indicador de metadados em false. O que já foi revogado ou está em outra carteira fica de fora, sem ser forçado. Você assina uma vez; a taxa da plataforma aparece na página antes da assinatura e é paga na mesma transação. A vantagem real: nenhuma trava fica pela metade.
  • Revogar a autoridade de cunhagem e revogar a autoridade de congelamento são travas à parte, que não tocam na marca.

Sem autoridade de cunhagem, a oferta fica fixa para sempre; o guia de oferta do token na Solana ajuda a decidir. Sem autoridade de congelamento, ninguém congela nem descongela conta nenhuma de novo, e as contas congeladas naquele momento ficam assim para sempre. Se houver alguma congelada por engano, descongele antes com a ferramenta de descongelar contas.

Também dá para travar tudo desde o início: o criador de tokens da j.tools pode criar o token com os metadados já travados e revogar cunhagem e congelamento no mesmo fluxo. O passo a passo de cada revogação está em como revogar as autoridades de um token.

Não tem desfazer. Nenhuma instrução dos programas de token devolve uma autoridade de cunhagem ou de congelamento revogada, e o programa de metadados rejeita qualquer mudança quando o indicador está em false. As ferramentas da j.tools rodam só na mainnet, e cada trava é definitiva assim que a transação confirma. Para ensaiar, use a devnet com a CLI da Solana (por exemplo spl-token authorize <mint> mint --disable) e SOL de teste do faucet da devnet.

Token-2022: a marca mora no próprio mint

Um token criado com Token-2022 pode guardar nome, símbolo, URI e a própria autoridade de atualização de metadados no mint, pela extensão TokenMetadata. Apagar essa autoridade é o que trava os metadados. Já a extensão de ponteiro de metadados tem autoridade própria, que pode mudar o endereço de onde os metadados são lidos. Uma trava de marca completa exige que não sobre nenhuma das duas, como descreve a documentação da Solana sobre metadados no mint.

As ferramentas de trava da j.tools agem sobre a conta de metadados da Metaplex de um token SPL clássico. Se o seu é Token-2022, confira antes essas duas autoridades e as de outras extensões; as diferenças estão em Token-2022 ou SPL: qual escolher.

Como conferir a trava

Abra o endereço do mint num explorador. Se você revogou cunhagem e congelamento, esses dois campos devem aparecer vazios. Na conta de metadados, o indicador de mutabilidade precisa estar em false. Depois abra a URI no navegador e, dentro do JSON, o link da imagem: os dois têm de carregar.

Um comprador atento faz a mesma checagem, que é uma das verificações para detectar um rug pull na Solana.

Perguntas frequentes sobre metadados imutáveis

Os metadados estão travados se ainda aparece uma autoridade de atualização?

Sim, se o indicador de mutabilidade está em false. É ele que decide nos metadados da Metaplex; o endereço listado no explorador já não muda nada.

Um token com metadados imutáveis ainda pode trocar de logo?

Só se o arquivo ou o link da imagem estiverem num servidor que alguém controla. Um link IPFS endereçado por conteúdo não mostra outra coisa, e o Arweave é armazenamento permanente. Se a hospedagem morrer, o token fica sem logo e ninguém pode redirecioná-lo.

Dá para destravar os metadados depois, para um rebranding?

Não. O indicador só vai num sentido. Nome ou logo novos exigem um mint novo, e a marca travada é a que fica.

Travar os metadados também fixa a oferta do token?

Não. Cunhagem e congelamento são autoridades separadas, embora a ferramenta que torna o token imutável possa fechar numa só transação as que você tiver. E mesmo com tudo fechado, cada detentor pode queimar tokens da própria conta, então a oferta ainda pode cair. Veja como queimar tokens na Solana.

Metadados imutáveis tornam um token seguro para comprar?

Tiram um risco: a troca de nome ou de logo. Não dizem nada sobre liquidez, detentores ou demanda, e não mexem no preço. São uma checagem entre várias, não um veredito.

Trave quando a marca estiver pronta e os dois links, o do arquivo e o da imagem, apontarem para armazenamento permanente.

J
Autor
J Tools Editorial

Uma postagem da equipe J Tools.

Ver todos os posts de J Tools Editorial →

Postagens relacionadas