Resolução de problemas do Ginger Wallet

Nível de leitura: utilização quotidiana. Escolha este guia quando precisar realizar a tarefa que ele descreve.

Comece pelo erro exato, pela carteira selecionada, pela rede e pela versão do programa. Preserve as informações de recuperação e os ficheiros da carteira antes de alterar dados. Reinstalar, apagar pastas ou criar palavras novas raramente é o primeiro passo para um problema de ligação ou exibição.

Saldo, recuperação e receção

Sintoma	O que conferir primeiro	Próximo passo
A carteira recuperada está vazia	Palavras originais, frase de segurança exata, rede e progresso da pesquisa	Compare endereços conhecidos ou o histórico após a sincronização; use verificações avançadas de recuperação apenas se essas verificações comuns não explicarem o problema
Um pagamento recebido não aparece	Endereço correto, identificador de transação do remetente e carteira selecionada	Confira a transmissão e a confirmação, depois a sincronização local
Receive ou Send não aparecem	A recuperação ainda está ativa? A carteira é apenas de observação?	Aguarde a recuperação ou use o dispositivo de assinatura necessário
Um endereço antigo desapareceu da lista de receção	Recebeu pagamento ou foi ocultado?	Verifique o histórico; a visibilidade na lista não invalida as chaves
Apenas um pagamento minúsculo não aparece	Limite de poeira e sincronização	Compare o limite configurado antes de presumir que os fundos foram roubados
As etiquetas desapareceram após recuperação pela semente	O ficheiro ATTR correspondente foi copiado para cópia de segurança?	Preserve esse ficheiro; as etiquetas não podem ser reconstruídas a partir da cadeia de blocos

Não introduza palavras de recuperação num site para “ressincronizar” uma carteira. Use o fluxo de recuperação da carteira instalada e verificada apenas num computador de confiança.

Ligação ou sincronização

Confira a conectividade, o relógio do computador, o espaço livre e o estado de um nó completo configurado. Uma primeira pesquisa pode simplesmente precisar de tempo. Se o progresso nunca mudar, feche o Ginger normalmente e reabra uma vez. Registe o que acontece, em vez de reiniciar uma pesquisa repetidamente.

Awaiting connection pode impedir CoinJoin e outros serviços mesmo quando a carteira tem histórico em cache. Considere um saldo sem ligação potencialmente incompleto. Mantenha Tor ativado durante a investigação. A ligação P2P e as estimativas de taxas obtidas via RPC de um nó configurado são separadas; o funcionamento de uma não comprova o da outra.

Se usar Wallet Settings → Tools → Resync, preserve as cópias de segurança primeiro e espere uma nova pesquisa. Não apague Wallets, WalletBackups ou ficheiros de 2FA apenas para remover uma mensagem de progresso.

O arranque indica uma configuração inválida

Na v2.0.27, o Ginger interrompe o arranque se não conseguir carregar Config.json, preservando o ficheiro original. O erro informa o caminho dele. Quando possível, o Ginger cria um Config.Default.json separado ao lado dele como modelo das definições predefinidas; um modelo existente também é preservado. Esse erro diz respeito às definições da aplicação e, por si só, não significa que uma carteira ou suas chaves estejam danificadas.

1. Feche o Ginger e preserve a pasta de dados e as cópias de segurança das carteiras antes de alterar ficheiros. Mantenha uma cópia separada do Config.json original.
2. Se entender a configuração, compare-a com Config.Default.json e corrija o JSON inválido ou o valor da configuração. O modelo pode estar ausente se o Ginger não tiver conseguido guardá-lo.
3. Para arrancar deliberadamente com as definições predefinidas da aplicação, renomeie o Config.json original, por exemplo para Config.before-repair.json, e guarde-o. Reinicie o Ginger para gerar um novo Config.json.
4. Confira suas definições de rede, Tor, nó completo e outras personalizações antes de retomar o uso normal. Renomear esse ficheiro de definições não recupera uma frase de segurança esquecida nem substitui as cópias de segurança da carteira. Mantenha Wallets, WalletBackups e os ficheiros de 2FA intactos.

Se as definições de arranque do Windows causavam um erro, a v2.0.27 passa a lidar com a ausência de uma entrada de arranque no Registo. Confira Settings → General → Run Ginger when computer starts após atualizar.

O JSON-RPC não arranca

Esta verificação aplica-se se tiver ativado explicitamente o servidor JSON-RPC da carteira Ginger. Na v2.0.27, ele exige que JsonRpcUser e JsonRpcPassword contenham valores não vazios; valores compostos apenas por espaços são rejeitados. Sem eles, o servidor RPC recusa-se a arrancar e regista o motivo, enquanto a aplicação da carteira continua a funcionar.

Com o Ginger fechado, defina ambas as credenciais em Config.json e configure o cliente que se liga para usá-las. Se não precisar do servidor, defina JsonRpcServerEnabled como false. Não inclua credenciais em logs partilhados e pedidos de apoio. Essas são definições RPC da carteira Ginger, separadas das credenciais RPC de um nó Bitcoin Core ou da frase de segurança da carteira.

CoinJoin não inicia

Mensagem ou condição	Ação provável
Insufficient funds eligible for coinjoin	Inspecione confirmações, valores das moedas, taxas e exclusões; o saldo total, por si só, não estabelece a elegibilidade
Only excluded funds are available	Confira Exclude Coins se quiser que algumas moedas participem
Only immature funds are available	Aguarde a maturidade exigida; saídas recém-mineradas têm regras especiais de gasto
Some funds are rejected from coinjoining	Leia o motivo associado e os termos atuais do serviço; uma rejeição não transfere a propriedade dos seus fundos
Awaiting cheaper coinjoins	Confira as preferências de custo e decida se esperar atende ao seu objetivo
Coinjoin may be uneconomical	Confira o limite de paragem e os custos relativos antes de ignorá-lo manualmente
Awaiting the blame round	Aguarde a nova tentativa do protocolo; isso não é uma instrução para culpar outro utilizador
Awaiting closure of send dialog	Conclua ou feche o fluxo de envio
Mining fee rate was too high ou Coordination fee rate was too high	Espere ou investigue as condições oferecidas; não aumente os limites às cegas
Carteira de hardware como origem	A assinatura automática CoinJoin exige uma carteira de software elegível

Os participantes de uma ronda podem não concluir suas etapas, ou uma moeda pode ficar temporariamente indisponível após uma participação interrompida. Repetir tentativas, importações ou esforços para contornar a rejeição de um coordenador não é uma correção. Use o motivo e o estado atual para decidir se deve esperar ou contactar o apoio oficial.

A versão 2.0.27 corrige um encerramento inesperado no macOS ao parar o CoinJoin. Se o Ginger fechar durante a participação, reabra-o, deixe a carteira sincronizar e inspecione o histórico antes de presumir que uma transação falhou. Fechar a aplicação não reverte uma transação já transmitida. Registe qualquer erro recorrente e a versão instalada para o apoio.

Problemas de pagamento ou taxas

Quando as estimativas de taxas estiverem indisponíveis, espere, corrija a ligação com o prestador ou nó selecionado, ou use uma taxa por byte virtual escolhida manualmente que compreenda. Garanta que o valor final mais as taxas caiba nos fundos disponíveis para gastar. Uma longa cadeia de transações não confirmadas pode exigir esperar as confirmações anteriores.

Use Speed Up Transaction ou Cancel Transaction apenas quando o Ginger oferecer a opção e depois de conferir a taxa. Cancelar é uma tentativa de substituir um pagamento pendente, não uma reversão de pagamento confirmado. Após um resultado incerto de transmissão, confira o histórico antes de pagar duas vezes.

2FA e hardware

Para um código de autenticador rejeitado, confira a hora do telefone, a entrada selecionada, a compatibilidade do autenticador com o Ginger e a conectividade com Tor e com o serviço. Preserve os ficheiros existentes da carteira e da 2FA. Se não for possível restaurar o arranque normal, as palavras de recuperação mais a frase de segurança original são a cópia de segurança independente das chaves; reinstalar sobre os mesmos dados não recria um autenticador perdido. As perguntas frequentes avançadas explicam a dependência do ficheiro.

Para detetar o dispositivo, use uma carteira de hardware desbloqueada, um cabo de dados e uma porta USB direta, com os programas concorrentes do dispositivo fechados. Conclua as etapas necessárias no dispositivo para o programa Bitcoin, o PIN ou a frase de segurança. No Linux, verifique as permissões USB do fabricante. Mantenha a semente do dispositivo fora do computador.

Relate um problema de forma útil

Use as ligações do repositório oficial do Ginger. Inclua a versão lançada, o sistema operativo e o processador, o erro exato, o resultado esperado e os passos mais curtos sem segredos que o reproduzem. Mencione o modelo e a versão do firmware de hardware quando for relevante.

A ação Logs da pesquisa do Ginger abre os logs de diagnóstico. Inspecione e remova informações sensíveis antes de partilhar: caminhos, endereços, identificadores de transação, etiquetas e dados de pedidos podem ser sensíveis. Partilhe um excerto mínimo relevante, não a pasta inteira de dados. Um relato público de problema é público; nenhuma solicitação de apoio deve exigir suas palavras de recuperação ou frase de segurança.