Sincronização e conectividade

Como funciona a sincronização de carteiras?

Quando liga uma carteira, o CryptaCount obtém dados de blockchain em duas categorias paralelas:

• Transactions — transações nativas da chain (transferências ETH, chamadas de contrato, etc.)
• Token Transfers — eventos de transferência de tokens (ERC-20, ERC-721, etc.)

Cada categoria acompanha o seu próprio progresso de sincronização de forma independente, pelo que uma nunca bloqueia a outra. O indicador de estado de sincronização no cartão da carteira mostra o progresso de cada categoria separadamente.

Nota

Ambas as categorias têm de ser concluídas para que os dados de uma carteira estejam completamente atualizados.

A sincronização da minha carteira está bloqueada ou sem progresso

Se uma sincronização parecer bloqueada:

1. Verifique o indicador de estado de sincronização no cartão da carteira — mostra os blocos processados por categoria.
2. Se o estado apresentar um erro, clique na carteira para ver os detalhes do erro.
3. Tente voltar a acionar a sincronização a partir das definições da carteira. A sincronização retoma a partir do último bloco processado de cada categoria, não desde o início.
4. Se voltar a acionar não resolver, verifique se precisa de aprovação — as sincronizações podem exigir um pedido de sincronização dependendo do seu plano. Aceda à carteira e clique em “Request Sync” se o botão de sincronização estiver desativado.

Repetição automática: Se um fornecedor de dados de blockchain estiver temporariamente indisponível, a plataforma repete automaticamente os pedidos falhados. Se o fornecedor estiver completamente indisponível, a sincronização é pausada até a ligação ser restabelecida.

Fluxo de pedido de sincronização

Alguns planos ou configurações de espaço de trabalho requerem aprovação antes de sincronizar. O fluxo é o seguinte:

1. Solicita uma sincronização a partir da página da carteira
2. O pedido entra no estado Pending
3. Um utilizador autorizado analisa e aprova ou rejeita o pedido
4. Após aprovação, a sincronização inicia automaticamente
5. O progresso é acompanhado com contagens de carteiras e de conclusão

O meu saldo não corresponde ao explorador de blocos (Etherscan, etc.)

Uma discrepância de saldo entre o CryptaCount e um explorador de blocos indica geralmente um dos seguintes problemas:

A sincronização não foi concluída. Aguarde que ambas as categorias de sincronização (Transactions e Token Transfers) terminem. Verifique o estado de sincronização de cada uma.

Transações pendentes. O CryptaCount sincroniza apenas transações confirmadas. As transações Pending (não confirmadas) não são refletidas enquanto não forem confirmadas na chain.

Tokens de spam. A deteção de spam do CryptaCount pode ter ocultado tokens que o explorador de blocos ainda apresenta. Verifique Settings → Asset Registry e procure ativos sinalizados como spam.

Transações internas. Algumas interações com contratos geram transações internas que não são capturadas por todos os métodos de sincronização. Verifique se as chamadas de contrato relevantes aparecem na sua lista de transações.

As Token Transfers aparecem como TRANSFER_OUT mas não existe TRANSFER_IN correspondente

Este era um problema de classificação conhecido que já foi corrigido. As comparações de endereços são agora insensíveis a maiúsculas e minúsculas, pelo que as diferenças de capitalização em endereços EVM já não causam classificações incorretas.

Se ainda detetar este problema:

1. Verifique se o endereço da carteira nas suas definições corresponde ao esperado
2. Certifique-se de que ambas as carteiras (se controlar ambos os lados) estão ligadas ao espaço de trabalho
3. Confirme que as Token Transfers terminaram a sincronização
4. Se necessário, reclassifique manualmente as transações afetadas a partir da vista de detalhe da transação

Como funciona a deduplicação de transações?

Cada transação sincronizada recebe um identificador único baseado na chain, bloco, hash de transação e posição do evento. Isto garante que voltar a sincronizar nunca cria duplicados, mesmo que a sincronização seja interrompida e reiniciada.

A sincronização indica “Already up to date” mas sei que existem novas transações

A sincronização acompanha o último bloco processado por categoria (Transactions vs. Token Transfers). Se estiver a perder Token Transfers mas as transações nativas estiverem corretas, significa que a categoria de Token Transfers precisa de acompanhar de forma independente.

Para resolver:

1. Verifique o número do último bloco sincronizado para cada categoria nos detalhes de sincronização da carteira
2. Compare com o número do bloco das transações que espera encontrar
3. Se os números de bloco parecerem corretos mas os dados estiverem em falta, contacte o suporte — o estado de sincronização pode precisar de ser reposto para essa carteira/categoria

Quais as redes de blockchain suportadas?

O CryptaCount suporta 131 chains em 21 tipos de endereço. A lista completa é visível ao adicionar uma nova carteira — o seletor de chains mostra todas as opções disponíveis.

Os tipos de endereço suportados incluem: EVM, Bitcoin (Legacy, P2SH, SegWit, Taproot), Solana, TRON, XRP, Cardano, Cosmos, TON, Polkadot, Stellar, NEAR, Aptos, SUI, StarkNet, Hedera, Avalanche cadeias X/P, e mais.

As ligações a exchanges (CEX) não estão a sincronizar

O CryptaCount suporta dados de exchanges centralizadas através de vários métodos de importação:

• Ligações API — Forneça chaves API só de leitura para exchanges suportadas
• Importação CSV — Carregue ficheiros CSV de exchanges suportadas (modelos disponíveis)
• Importação Excel / PDF — Para exchanges que exportam nestes formatos
• CSV genérico — Mapeie colunas manualmente para formatos não suportados

Problemas comuns nas ligações API:

• Chave API expirada — Regenere a chave na exchange e atualize-a no CryptaCount
• Permissões insuficientes — A chave necessita de acesso de leitura a transações, saldos e depósitos/levantamentos. O acesso de escrita nunca é necessário.
• Lista de permissões de IP — Algumas exchanges exigem a inclusão de IPs em lista de permissões. Contacte o suporte para obter os IPs dos servidores do CryptaCount.
• Limitação de taxa — Históricos de negociação extensos podem requerer vários ciclos de sincronização. O CryptaCount gere os limites de taxa automaticamente.

As chaves API de CEX são armazenadas de forma encriptada — consulte Segurança para mais detalhes.

Com que frequência são sincronizados os dados?

Após a sincronização inicial completa, as carteiras são sincronizadas periodicamente. Também pode acionar uma sincronização manual a qualquer momento a partir das definições da carteira (sujeito aos limites do plano e requisitos de aprovação).

Posso sincronizar dados históricos anteriores à data em que liguei a carteira?

Sim. A sincronização inicial obtém o histórico completo de transações on-chain para o endereço da carteira, desde a primeira transação. Não existe data de corte.