Ir para o conteúdo
Financial Context Wiki

Por que uma carteira pode mostrar o saldo de tokens errado?

Entenda divergências entre carteiras e indexadores, o efeito do bloco e da contabilidade do token e como verificar o estado on-chain com segurança.

Atualizado

Apenas para fins educacionais; não constitui aconselhamento de investimento. Ativos digitais e transações on-chain podem causar perdas irreversíveis.

Resposta direta

O saldo da carteira é uma visão derivada, não a autoridade sobre a propriedade. RPC, índice de eventos, metadados, preços, filtros e cache podem estar desatualizados ou apontar para rede ou contrato errados. Ausência não prova perda; um número visível não garante transferência, resgate ou valor.

Para ERC-20 convencional, comece pelo balanceOf da conta exata em um bloco definido da rede correta. Tokens rebase, cotas de cofre, ativos wrapped e posições podem exigir conversão adicional.

Como funciona

A exibição combina quatro caminhos:

  • Estado do contrato: o RPC executa balanceOf via eth_call no bloco escolhido.
  • Índice de eventos: o serviço lê logs Transfer e atualiza histórico e cache.
  • Metadados e avaliação: decimals, símbolo, listas, câmbio e preços convertem o inteiro bruto.
  • Política da interface: a carteira pode ocultar spam, agrupar contas, atrasar ou manter cache.

ERC-20 define balanceOf e exige Transfer em transferências padrão, mas índices podem omitir ou duplicar logs, começar tarde, errar reorganizações ou contabilidade específica. Eventos não substituem o estado atual; decimals errado também distorce a exibição.

JSON-RPC aceita latest, safe e finalized, e provedores podem ter pontas diferentes. EIP-1898 fixa leituras no mesmo hash, podendo exigir bloco canônico.

Verifique nesta ordem:

  1. Confirme rede e chainId; origem e destino de bridge são livros separados.
  2. Obtenha o contrato de fonte confiável, nunca apenas pelo símbolo.
  3. Confirme conta, padrão e tipo do ativo.
  4. Consulte balanceOf em dois RPCs no mesmo número ou hash; separe inteiro bruto e decimals.
  5. Confira recibo, status, contrato, logs e bloco canônico; compare blocos explícitos.
  6. Para rebase ou cotas, use conversão e resgate documentados. Em ERC-4626, balanceOf informa cotas e convertToAssets apenas estima ativos.

Exemplo

O explorer confirma a transferência para Lina, mas a carteira mostra zero. Dois RPCs retornam o mesmo balanceOf positivo no bloco finalizado, com recibo e log canônicos: índice, filtro ou cache está atrasado. Importar o contrato verificado ou aguardar é melhor que reenviar. Se o balanceOf do contrato verificado for zero, compare também o balanceOf na rede indicada pela interface.

Se o contrato verificado retorna zero para um símbolo com saldo visível, pode ser contrato homônimo ou outra rede. Num cofre, as cotas podem estar corretas e o valor errado sem conversão atual.

Riscos e controles

  • Rede ou endereço errado: confira chainId, conta e contrato completos.
  • RPC desatualizado: compare provedores num bloco; não misture latest de horários distintos.
  • Reorganização: trate blocos recentes como provisórios e reconfirme o recibo.
  • Falha do índice: reescaneie, concilie logs e estado e reverta blocos órfãos.
  • Contabilidade não padrão: não some Transfer para rebase, cofre ou recibo sem documentação.
  • Erro de metadados ou preço: separe unidades, quantidade e valor; decimals altera a exibição.
  • Token ou interface maliciosa: visualizar não exige aprovação nem assinatura; rejeite links de “atualização”.

Se persistir, pare transferências e guarde rede, conta, contrato, número e hash do bloco, respostas RPC e hash da transação. Verifique upgrade, pausa, rebase, migração ou bridge e use suporte público sem revelar seed ou chave privada.

Saldo correto não garante saída. Verifique restrições, resgate, liquidez, taxas e permissões; mais gas ou slippage não corrige índice.

Equívocos comuns

  • “A tela é a blockchain.” É uma visão com dados on-chain e off-chain.
  • “Logs Transfer sempre somam o saldo.” O índice pode errar e alguns tokens exigem conversão.
  • “Mais confirmações atualizam a carteira.” Elas não forçam cache ou indexador.
  • “Saldo positivo pode ser vendido.” Regras, pausas, limites ou liquidez podem impedir.
  • “Preciso assinar para ver o saldo.” Leituras públicas não exigem aprovação, assinatura nem seed.

Tópicos relacionados

Fontes

Navegação

Pesquisar na wiki...