---
title: "Por que uma carteira pode mostrar o saldo de tokens errado?"
description: "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."
image: "https://wiki.fcontext.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://wiki.fcontext.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Por que uma carteira pode mostrar o saldo de tokens errado?
> 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
- [Padrão ERC-20](/pt-br/crypto/erc20/)
- [Nó RPC](/pt-br/crypto/rpc-node/)
- [Reorganização da cadeia](/pt-br/crypto/chain-reorg/)
- [Token rebase](/pt-br/crypto/rebasing-token/)
- [Verificação do contrato](/pt-br/crypto/token-contract-verification/)
## Fontes
- [ERC-20: padrão de tokens](https://eips.ethereum.org/EIPS/eip-20) - Ethereum Improvement Proposals (acessado: 2026-08-21)
- [API JSON-RPC](https://ethereum.org/developers/docs/apis/json-rpc/) - Ethereum.org (acessado: 2026-08-21)
- [EIP-1898: blockHash nos métodos defaultBlock](https://eips.ethereum.org/EIPS/eip-1898) - Ethereum Improvement Proposals (acessado: 2026-08-21)
- [ERC-4626: cofres tokenizados](https://eips.ethereum.org/EIPS/eip-4626) - Ethereum Improvement Proposals (acessado: 2026-08-21)
Source: https://wiki.fcontext.com/pt-br/crypto/token-balance-indexing-risk/index.mdx