Atualizar metadados do token Solana

A ferramenta de atualização de metadados Solana da 20lab permite que você modifique os metadados on-chain de um token SPL - nome, símbolo, imagem, descrição, e links sociais - através de uma única interface. Ela suporta tanto metadados de token Metaplex quanto a extensão de metadados Token-2022.

Mudanças de metadados são como você atualiza o que carteiras, exploradores, DEXes e rastreadores exibem para seu token. A ferramenta lida com uploads IPFS e atualizações on-chain automaticamente - sem necessidade de hospedar seus próprios arquivos JSON ou interagir com o CLI da Metaplex. Tutorial prático: como atualizar metadados de token Solana.

A ferramenta suporta a atualização de todos os campos de metadados padrão:

• Nome do token - Exibido em carteiras e exploradores
• Símbolo do token - O ticker curto (BONK, JUP, etc.)
• Imagem - Logo do token mostrado em carteiras e agregadores
• Descrição - Resumo curto do seu projeto
• URL do site - Site oficial do projeto
• Links sociais - Twitter/X, Telegram, Discord, etc.

A 20lab fixa imagens e JSON no IPFS automaticamente e atualiza a URI de metadados on-chain, então as mudanças se propagam para todas as principais carteiras e exploradores Solana sem hospedagem manual.

Para alterar o nome, símbolo ou logo do seu token SPL:

1. Conecte a carteira que possui a Autoridade de atualização de metadados
2. Digite o endereço de cunhagem do seu token
3. Edite qualquer combinação de nome, símbolo, logo, descrição, site ou redes sociais
4. Confirme a transação

A 20lab faz upload da nova imagem e JSON para o IPFS e atualiza o ponteiro de metadados on-chain em uma única etapa. A maioria das carteiras e exploradores Solana atualiza em minutos a horas. Se seu token foi criado sem metadados, veja nosso guia sobre adicionar metadados a novo token SPL.

Apenas a atual Autoridade de atualização de metadados pode alterar os metadados de um token. Isso é tipicamente:

• A carteira que originalmente implantou o token
• Qualquer carteira para a qual a autoridade de atualização foi transferida
• Uma carteira multisig se a autoridade foi atribuída a uma

Se a autoridade de atualização de metadados foi revogada, os metadados se tornam permanentemente imutáveis - mesmo o criador original não pode mais modificá-los. A ferramenta verifica a carteira conectada contra a autoridade on-chain e desabilita o botão de atualização se você não tiver permissão, para que nunca desperdice taxas em uma transação que falharia.

Os metadados de tokens SPL Solana são armazenados usando um de dois padrões:

• Metadados de token Metaplex - O padrão original, usado pela maioria dos tokens SPL clássicos. Os metadados ficam em uma conta Metaplex separada vinculada à cunhagem do token.
• Extensão de metadados Token-2022 - Uma alternativa mais nova que armazena metadados diretamente na cunhagem do token, usada por tokens criados com o programa Token-2022 (incluindo tokens Solana 20lab).

Ambos os padrões referenciam um arquivo JSON off-chain (geralmente hospedado no IPFS) que contém a URL da imagem e campos extras como descrição e redes sociais. A 20lab abstrai ambos os padrões por trás de uma única interface.

Mudanças de metadados SPL se propagam em velocidades diferentes pelo ecossistema Solana:

• Dados on-chain - Atualizados imediatamente quando a transação é confirmada
• Solana Explorer, Solscan, Solana FM - Em minutos
• Phantom, Solflare e outras carteiras - 1-24 horas, dependendo do cache
• DexScreener, Birdeye, CoinGecko on-chain - 1-3 dias, às vezes requer solicitação manual de atualização
• Exchanges centralizadas e listagens principais CoinGecko/CMC - Atualização manual necessária por suas equipes

Se uma plataforma específica não atualizar, a maioria tem um formulário "solicitar atualização de informações do token" que você pode enviar.

Não - atualizações de metadados são puramente cosméticas. Alterar o nome, símbolo, imagem ou redes sociais não afeta:

• Saldos de tokens ou endereços de detentores
• Suprimento total ou decimais
• Funcionalidade de cunhagem, congelamento ou taxa de transferência
• Pools de liquidez existentes ou listagens em DEX (embora possam precisar atualizar a exibição)
• Programas ou contratos integrados com seu token

O endereço de cunhagem - o identificador imutável do seu token - nunca muda, mesmo que nome e símbolo mudem. Qualquer coisa on-chain que referencie seu token pelo endereço de cunhagem continua funcionando sem interrupção.

Sim - para tornar os metadados do seu token SPL permanentemente imutáveis, revogue a autoridade de atualização de metadados usando a ferramenta de revogação de autoridade. Uma vez revogada:

• Ninguém pode mais alterar o nome, símbolo, imagem ou outros campos de metadados
• A identidade do token está criptograficamente bloqueada
• Isso é irreversível

Muitos projetos revogam a autoridade de atualização de metadados após sua renomeação final para sinalizar que a identidade do token está finalizada. Isso é uma parte padrão de "renunciar" a um token Solana junto com revogar autoridade de cunhagem e congelamento. Tutorial completo: guia de metadados imutáveis.

A ferramenta funciona com qualquer token SPL que tenha um padrão de metadados ativo:

• Metadados Metaplex - Todos os tokens SPL clássicos com metadados registrados na Metaplex
• Extensão de metadados Token-2022 - Tokens criados com o programa Token-2022 (incluindo aqueles construídos com o gerador de tokens Solana da 20lab)

A ferramenta não pode atualizar:

• Tokens com autoridade de atualização de metadados revogada (os metadados estão permanentemente bloqueados)
• Tokens criados sem uma conta ou extensão de metadados (raro - principalmente tokens SPL muito antigos)
• Tokens onde a carteira conectada não é a autoridade de atualização atual