Skip to content

Troubleshooting decision tree

Support safety (read this first)

  • Admins/devs will not DM you first. Keep support conversations public (Telegram group / GitHub issues).
  • Never share your seed phrase, private keys, or wallet.dat with anyone.
  • Use only official download links (https://reddcoin.com / https://redd.love / https://download.reddcoin.com). Beware look‑alike sites.
  • If someone asks you to “verify” by sending coins, installing remote-control software, or sharing secrets (seed/private key), it’s a scam.
  • When sharing logs/screenshots publicly, redact personal info (paths, IPs, usernames). Do not redact block hashes needed for fork checks.
  • If you’re not sure what to back up (and where it lives), see Reference → Wallet files & locations in this knowledgebase.

If you prefer a guided flow (instead of scanning a table), follow this decision tree.

Before you change anything: make an offline backup of your wallet files (wallet.dat and/or the wallets/ folder). If you’re unsure where those are, see Wallet files & locations.

flowchart TD
  A[Pick the closest symptom] --> B{Does the wallet start?}

  B -->|No / crashes| C[Startup crash / corrupted database]
  C --> C1[Likely fix: clean resync]

  B -->|Yes| D{Do you have peers?}
  D -->|0 connections| E[No peers / can't connect]
  E --> E1[Likely fix: reset peers + check conf]

  D -->|Yes| F{Is sync progressing?}
  F -->|Stuck / hours behind| G[Sync stalled / stuck at a height]
  G --> G1[Likely fix: clean resync or bootstrap]

  F -->|Looks synced but balance/tx looks wrong| H[Suspect wrong chain / fork]
  H --> H1[Likely fix: verify known hashes; resync or invalidate]

  F -->|Synced| I{Is the problem a transaction?}
  I -->|Unconfirmed / stuck| J[Stuck transaction]
  J --> J1[Likely fix: zapwallettxes + resend]

  I -->|Exchange deposit/withdrawal missing| K[Exchange issue]
  K --> K1[Likely fix: verify tx, explorer, and venue status]

  I -->|Not about a transaction| L{Is the problem staking?}
  L -->|No anvil / not staking| M[Staking won't start]
  M --> M1[Likely fix: unlock-for-staking + enable staking]

  L -->|Staking enabled but no rewards yet| N[Staking expectations]
  N --> N1[Likely: coin age / weight / patience]

  A --> O{Are you upgrading?}
  O -->|v3 → v4 upgrade| P[Upgrade path]
  P --> P1[Likely fix: clean upgrade + resync]

  A --> Q{Are you restoring a backup?}
  Q -->|Moved computers / restoring wallet| R[Restore wallet files]
  R --> R1[Likely fix: copy wallets into data directory]

Go to the matching runbook

If you’re still unsure which branch applies, use: Quick triage (1–2 clicks)