Metodologia de cripto

O cluster de cripto converte entre três denominações Ethereum — Wei (atômica), Gwei (unidade de preço de gas) e ETH (voltada para o usuário). A matemática é trivial em conceito (potências de dez) e complicada na implementação (números excedem a precisão nativa do JavaScript). Esta página explica as escolhas de implementação.

As relações de unidade

1 ETH = 10⁹ Gwei = 10¹⁸ Wei

A EVM armazena todos os saldos e a aritmética em Wei como inteiros não assinados de 256 bits. ETH e Gwei são puramente rótulos voltados para humanos sem representação on-chain — são convenções de divisão por potência de dez para exibição.

Por que BigInt é obrigatório

O tipo Number do JavaScript usa precisão dupla IEEE 754: ~15-17 dígitos decimais significativos. Number.MAX_SAFE_INTEGER é 2⁵³ − 1 ≈ 9,007 × 10¹⁵. Um saldo de 9 ETH é aproximadamente 9 × 10¹⁸ Wei — três ordens de magnitude além do limite de precisão.

Concretamente: se você armazenar 1.234567890123456789 ETH em um Number e converter para Wei, os últimos vários dígitos são arredondados. Bibliotecas de cripto em produção (ethers.js, viem, web3.js) todas usam BigInt ou um wrapper BigNumber para valores em Wei. Nosso conversor usa BigInt nativo em toda parte.

O caminho de análise de string decimal

Para uma entrada do usuário como 1,234 ETH:

1. Dividir no ponto decimal. Parte inteira: 1; parte fracionária: 234.
2. Preencher a parte fracionária com zeros até 18 dígitos (precisão do ETH): 234000000000000000.
3. Concatenar: 1234000000000000000.
4. Construir um BigInt a partir do resultado.
5. Para converter para Gwei, dividir por 10⁹ (divisão BigInt é divisão inteira — correto porque Gwei tem 9 casas decimais a menos que Wei).

Garantia de ida e volta

• ETH → Wei → ETH preserva todos os 18 dígitos fracionários.
• Gwei → Wei → Gwei preserva todos os 9 dígitos fracionários.
• Wei → ETH → Wei é exato porque valores Wei são inteiros.

Entradas com mais precisão do que a unidade suporta (ex.: “1,5 Wei”) são truncadas, não arredondadas — valores sub-Wei não existem.

Implementação de referência

function ethToWei(input: string): bigint {
  const [intPart, fracPartRaw = ""] = input.split(".");
  if (fracPartRaw.length > 18) throw new Error("over-precise");
  const fracPart = fracPartRaw.padEnd(18, "0");
  return BigInt(intPart) * 10n ** 18n + BigInt(fracPart);
}

Pressupostos e limitações

• Aritmética pura, sem rede. A calculadora nunca lê um RPC de chain ou saldo de carteira.
• Valores sub-Wei são truncados, não arredondados. Uma entrada de 0,5 Wei resolve para 0 Wei.
• Sem preço ETH/USD em tempo real. Conversão de moeda fiduciária usa um serviço de preço em cache separado no cluster de câmbio.
• Apenas tokens nativos de chain EVM. Tokens ERC-20 têm decimais configuráveis (USDC tem 6, DAI tem 18); use o valor de decimals() do contrato do token, não os 18 do ETH, para esses casos.
• Sem assinatura, transmissão ou custódia de transações. Use uma carteira (Metamask, Rabby) para qualquer movimentação; o conversor apenas exibe números.