Atualizar metadados do Sui Coin

A ferramenta de atualização de metadados Sui da 20lab permite modificar os metadados on-chain de uma moeda Sui - nome, símbolo, imagem e descrição - através de uma única interface. Funciona com qualquer token usando o módulo Coin padrão da Sui e armazena os metadados atualizados diretamente on-chain.

Mudanças de metadados são como você atualiza o que carteiras, exploradores, DEXs e rastreadores exibem para seu token. A ferramenta gerencia uploads para IPFS para imagens e atualizações de metadados on-chain automaticamente - não há necessidade de hospedar seus próprios arquivos ou interagir com contratos Move manualmente. Guia prático: como alterar metadados de tokens Sui.

A ferramenta suporta atualizar todos os campos de metadados padrão em uma moeda Sui:

• Nome - O nome completo exibido em carteiras e exploradores
• Símbolo - O ticker curto (SUI, USDC etc.)
• Imagem - Logo do token mostrado em carteiras e agregadores
• Descrição - Resumo curto do seu projeto

A 20lab fixa imagens no IPFS automaticamente e atualiza os metadados on-chain em uma única transação, então as mudanças se propagam para todas as principais carteiras e exploradores Sui sem hospedagem manual.

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

1. Conecte a carteira que possui o treasury cap e metadata cap
2. Digite o coin type ou endereço do seu token
3. Edite qualquer combinação de nome, símbolo, logo ou descrição
4. Confirme a transação

A 20lab faz upload da nova imagem para o IPFS e atualiza os metadados on-chain em uma única etapa. A maioria das carteiras e exploradores Sui atualiza dentro de minutos, mais rápido que atualizações equivalentes no Ethereum ou Solana graças à arquitetura orientada a objetos da Sui. Para contexto mais profundo sobre como os metadados são estruturados, veja nosso guia de metadados personalizados de tokens Sui.

Para moedas Sui, a carteira que possui tanto o treasury cap quanto o metadata cap pode atualizar metadados. Isso é tipicamente:

• A carteira que originalmente implantou o token
• Qualquer carteira para a qual os caps foram transferidos
• Uma carteira multisig se os caps foram atribuídos a uma

Se o treasury cap ou metadata cap foi revogado, os metadados se tornam permanentemente imutáveis. A ferramenta verifica os caps da carteira conectada antes de permitir atualizações, então você nunca desperdiça gas em uma transação que falharia.

Metadados de moeda Sui são armazenados de forma diferente do Ethereum e Solana. O módulo Coin do Move armazena metadados como um objeto on-chain separado vinculado ao seu coin type.

Propriedades principais:

• Metadados vivem diretamente on-chain, não apenas como um ponteiro URI
• A URL da imagem aponta para armazenamento off-chain (tipicamente IPFS via 20lab)
• Atualizações requerem possuir o cap apropriado
• O modelo orientado a objetos da Sui significa que atualizações de metadados se propagam rapidamente pela rede

Este design torna os metadados Sui mais diretamente legíveis que sistemas que dependem de resolução de JSON off-chain. Tokens implantados com o gerador de tokens Sui da 20lab seguem este mesmo padrão.

Mudanças de metadados Sui se propagam rapidamente graças ao modelo orientado a objetos:

• Dados on-chain - Atualizados imediatamente quando a transação é finalizada
• Sui Explorer e Suiscan - Dentro de segundos a minutos
• Sui Wallet, Suiet, Slush e outras carteiras - Minutos a algumas horas dependendo das configurações de cache
• DexScreener, Birdeye, CoinGecko on-chain - Horas a um dia, às vezes requer uma solicitação manual de atualização
• Exchanges centralizadas - Atualização manual requerida das suas equipes

Se uma plataforma não atualiza, 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 descrição não afeta:

• Saldos de moedas ou endereços de detentores
• Suprimento total ou decimais
• Funcionalidade do treasury cap ou deny cap
• Pools de liquidez existentes ou listagens DEX (embora possam precisar atualizar a exibição)
• Programas ou contratos integrados com sua moeda

O coin type - o identificador imutável do seu token - nunca muda, mesmo que nome e símbolo mudem. Qualquer coisa on-chain que referencia sua moeda pelo type continua funcionando sem interrupção.

Sim - para tornar os metadados da sua moeda Sui permanentemente imutáveis, revogue o treasury cap ou metadata cap usando a ferramenta de revogação de autoridade. Uma vez revogado:

• Ninguém pode jamais alterar o nome, símbolo, imagem ou descrição
• A identidade da moeda é criptograficamente bloqueada
• Isso é irreversível

Muitos projetos revogam o treasury cap após seu rebranding final para sinalizar que a identidade do token está finalizada. Esta é uma parte padrão de "renunciar" uma moeda Sui junto com revogar deny cap e upgrade cap. Guia completo: como revogar metadata cap na Sui.

A ferramenta funciona com qualquer moeda Sui construída no módulo Coin padrão do Move, incluindo moedas criadas com o gerador de tokens Sui da 20lab (padrão e regulamentadas).

A ferramenta não pode atualizar:

• Moedas onde o treasury cap ou metadata cap foi revogado (metadados são permanentemente bloqueados)
• Moedas onde a carteira conectada não possui os caps necessários
• Moedas construídas em módulos Move personalizados que não seguem o padrão Coin padrão