Todas as postagens
Guias

Casas decimais de um token na Solana: 6 ou 9

O que são as casas decimais de um token na Solana, por que 6 virou o número comum e quando 9 faz sentido. O campo trava na cunhagem e não muda mais.

9 min de leitura J Tools Editorial
Ilustração editorial do guia sobre as casas decimais de um token na Solana e por que o campo é permanente

Você está preenchendo o formulário de criação do token, todo o resto se explicava sozinho, e aí aparece um campo pedindo as casas decimais sem dizer nada. O formulário quer um número. Não diz qual. E parece detalhe pequeno até você descobrir que o valor trava na cunhagem.

Vamos com calma neste, que é um dos poucos campos sem conserto. Se você só tem dez segundos: na dúvida, digite 6. É o que USDC, USDT e a maioria dos tokens da Solana usam, e o que a Pump.fun aplica sozinha.

O que são as casas decimais de um token

São quantos dígitos a moeda pode ter depois da vírgula: em quantos pedaços dá para partir uma unidade. Pense no dinheiro de todo dia. Você escreve 1,25 dólares, mas não 1,255, porque o dinheiro usa duas casas e nada mais fino.

O número escolhido fixa o menor pedaço possível:

  • 9 casas partem até 0,000000001 de moeda, finíssimo.
  • 6 casas chegam a 0,000001, de sobra para quase tudo.
  • 2 casas param em 0,01, como os centavos.
  • 0 casa significa moedas inteiras, sem partir nada.

Três palavras do texto: um token SPL é o formato padrão da Solana, cunhar é criar o token na blockchain e fornecimento é quantas moedas existem.

E aqui está a confusão mais comum: casas decimais não têm nada a ver com fornecimento. Um bilhão de moedas pode ter 0 ou 9 casas. São duas perguntas separadas, e o glossário com 30 termos da Solana tem o resto do vocabulário.

Por que importa: a menor fatia que o token vai ter

Este é o motivo de verdade, e ele nunca aparece ao lado do campo. As casas decimais fixam, para sempre, o menor pedaço que alguém vai conseguir guardar ou mover.

Com 2 casas esse pedaço é 0,01 de moeda, e não existe nada entre 0,01 e 0,02. Com 6 ele cai para 0,000001, e com 9 para 0,000000001. Esse tamanho nasce na cunhagem e não dá para refinar depois: precisa servir ao token a vida inteira.

Aí mora o risco. Imagine uma memecoin (moeda de comunidade ou de piada, quase sempre bem barata) que você criou com 0 casas. O menor pedaço passa a ser uma moeda inteira. Enquanto ela vale 0,0001 dólar, ninguém percebe. Depois ela sobe para 40 dólares. Quem quer comprar só 10 dólares dessa moeda não consegue, porque o menor degrau é uma moeda inteira. Todo swap arredonda para moedas inteiras, e as negociações pequenas falham ou perdem parte do valor no arredondamento.

Preço caindo não é o perigo. Uma moeda mais barata só faz cada pedaço valer menos, e pedaços minúsculos continuam sendo negociados. O aperto vem quando o preço sobe e o menor pedaço fica caro. Por isso 6 e 9 são as apostas seguras: o menor pedaço é um milionésimo ou um bilionésimo de moeda, um valor desprezível em qualquer preço realista.

Quantidade bruta e quantidade na tela

Na blockchain o seu saldo nunca fica guardado como "1,5 token". A Solana guarda todo saldo como número inteiro, a quantidade bruta (as unidades base). A cifra legível na carteira é a quantidade na tela, e só as casas decimais traduzem uma na outra.

A fórmula vale nos dois sentidos. Aqui 10^casas é "10 elevado ao número de casas", ou seja 1.000.000 com 6 e 1.000.000.000 com 9:

  • Quantidade bruta = quantidade na tela × 10^casas
  • Quantidade na tela = quantidade bruta ÷ 10^casas

Com 6 casas, um token inteiro são 1.000.000 de unidades base. Com 9, o mesmo token são 1.000.000.000. O token inteiro continua sendo um só: as casas mudam em quantas unidades base a rede o divide e, com isso, o quão fino ele pode ser partido.

Na telaBruto com 6 casasBruto com 9 casas
1 token1.000.0001.000.000.000
0,5 token500.000500.000.000
0,000001 token11.000
menor pedaço1 (0,000001 token)1 (0,000000001 token)

Do lado bruto não dá para descer abaixo de 1, porque o valor é inteiro. O menor pedaço é sempre uma unidade base, e quanto ela vale na tela depende das casas: 0,000001 de token com 6, e 0,000000001 com 9. Com poucas casas essa unidade fica grossa, e ela é a menor negociação que o token vai permitir.

Dois frascos medidores de vidro lado a lado, o da esquerda gravado com 6 marcas grossas e o da direita com 9 finas, os dois com a mesma gota âmbar na mesma altura

Trava na cunhagem e não muda nunca mais

As casas decimais travam no instante em que você cunha o token e não mudam depois. Nem por você, nem pela plataforma, nem por ninguém. Não existe botão de editar.

Surpreende porque quase todo o resto pode mudar. Dá para trocar o nome e o logo, reduzir o fornecimento queimando moedas e revogar as autoridades do token, inclusive a de cunhagem. As casas são o único número gravado em pedra.

O campo é escrito na instrução que inicializa o mint, dentro de uma transação que ou é concluída por inteiro ou é revertida, como descreve a documentação de transações da Solana. O único conserto possível é cunhar um token novo e migrar os holders: lançamento novo, liquidez nova, confiança para reconstruir.

Qual número para qual token

Não precisa inventar resposta. Os tokens grandes da Solana já se acomodaram em um punhado de valores padrão. Procure a linha parecida com o seu caso.

CasasQuem usaQuando serve para você
9O próprio SOL, o wSOL e as variantes de SOL em stakingSeu token está amarrado ao SOL
6USDC, USDT, a maioria dos tokens de utilidade e as memecoins da Pump.funQuase tudo, inclusive memecoin que vai negociar abaixo de um dólar
5BONKVocê segue a convenção de um token que já existe
2Tokens no formato de fração de açãoCentésimos, como centavos, e nada menor
0Tokens em formato de NFT, governança de uma carteira um votoSó unidades inteiras

E o dado que a maioria dos guias pula: a Pump.fun cria todo token com 6 casas decimais e fornecimento fixo de um bilhão de moedas. Lá você escolhe nome, símbolo e imagem, e o campo de casas nem aparece.

Como é de lá que sai a maior parte das memecoins, 6 virou o padrão de memecoin da Solana. Veja como criar uma memecoin na Solana.

Por que copiar o 9 do SOL costuma dar errado

Muita gente vê que o SOL usa 9 casas e vai de 9 por reflexo. Esse instinto costuma sair pela culatra.

O SOL tem 9 por um motivo específico: ele paga as taxas de rede, e cada ação custa uma lasca mínima, então precisa se dividir em quantias muito pequenas. O seu token não paga taxa de rede. Fora os casos amarrados ao SOL, como o wSOL ou o SOL travado em staking, copiar esse 9 não te dá nada.

E custa alguma coisa. Nove dígitos deixam os saldos compridos e chatos de ler: 1,000000000 é mais difícil de ler de relance do que 1,000000. Multiplique isso por cada carteira e cada tela de envio: um token mais feio sem motivo.

Já que estamos em números para evitar: não use 18. Esse é o hábito do Ethereum. A Solana até aceita, mas as carteiras e as corretoras da Solana não são testadas de forma confiável acima de 9.

Uma caixa registradora antiga carimbando um recibo com casas de dígitos vazias, e a alavanca de reinício do disco de decimais visivelmente ausente

Guia rápido de decisão

Desça na ordem e pare na primeira que encaixar:

  1. Seu token está amarrado ao SOL, em wSOL ou em staking? Use 9.
  2. É stablecoin ou token de utilidade para durar em DeFi? Use 6.
  3. É memecoin que vai negociar abaixo de um dólar? Use 6, e na Pump.fun ele sai sozinho.
  4. Tem cara de NFT, ou é governança de uma carteira um voto? Use 0, ou 2 para centésimos.
  5. Continua na dúvida? Use 6.

Os quatro tropeços de sempre: 9 em token sem relação com o SOL; 0 em memecoin, que deixa só moedas inteiras para sempre; achar que o campo muda depois; copiar o 18 do Ethereum.

Onde as casas decimais aparecem nas ferramentas

Se você procura onde criar o token sem escrever código, a j.tools é um kit de ferramentas da Solana em vários idiomas. Ela nunca pede sua frase de recuperação; as chaves que você cola nas ferramentas com várias carteiras ficam na aba do seu navegador. Nas ferramentas abaixo, você conecta a própria carteira e aprova cada ação.

A página de cada ferramenta mostra a taxa atual. Queimar fornecimento, trocar nome ou logo e travar as autoridades mexem em outras coisas, e nenhuma reescreve as casas decimais. Se você está começando do zero, o guia para criar um token na Solana percorre o formulário inteiro.

Perguntas frequentes sobre casas decimais

Quantas casas decimais um token SPL traz por padrão?

Nenhuma: não existe padrão no nível do protocolo. Na criação do mint as casas são um campo obrigatório do passo de inicialização, e a documentação de tokens da Solana lista os campos do mint. O que chamam de padrão é o número que a ferramenta já deixa selecionado: a Pump.fun cunha com 6, USDC e USDT usam 6, o SOL usa 9.

As casas decimais funcionam diferente no Token-2022?

Não. O campo se comporta igual nos dois padrões: 6 casas são 1.000.000 de unidades base por unidade inteira, seja um mint SPL clássico ou um Token-2022.

O que muda é o entorno do mint. O Token-2022 traz extensões como taxa de transferência, transfer hooks e transferências confidenciais. Algumas leem valores em unidades base, então as casas escolhidas afetam como esses valores são digitados depois. Para comparar os dois padrões, veja Token-2022 ou SPL, qual escolher.

Dá para mudar as casas decimais depois de cunhar?

Não. Elas são escritas na conta do mint na criação e não existe instrução para editar. Se o lançamento saiu com o número errado, o conserto é criar um token novo com as casas certas e migrar os holders.

As casas decimais mudam o fornecimento?

Não. Fornecimento e casas são ajustes independentes. As casas só decidem em quantos pedaços uma unidade inteira pode ser partida, não quantas unidades existem.

Um token vale mais por ter mais casas decimais?

Não. O preço vem do mercado, não desse campo. Mais casas só permitem negociar frações menores. E nenhuma carteira ou explorador sobrescreve o valor: todos leem do mint.

Que número usar em uma memecoin?

6. É o que a Pump.fun carimba em todo token que cria, e deixa espaço para frações pequenas valha o que valer a moeda. Com 0, moedas inteiras para sempre.

Escolha uma vez e siga o lançamento

As casas decimais só pesam porque são permanentes. Com a regra na mão, a escolha leva um segundo: 6 por padrão, 9 apenas se o token está amarrado ao SOL, 0 quando fração nenhuma faria sentido.

Depois disso, como calcular a capitalização de mercado mostra como preço e fornecimento viram valor quando o token já negocia, e o comparativo de criadores de token mostra qual formulário pede o quê.

J
Autor
J Tools Editorial

Uma postagem da equipe J Tools.

Ver todos os posts de J Tools Editorial →

Postagens relacionadas