Troubleshooting Problems
Last updated for Bison Wallet v1.0.0.
Caution
Before starting any attempt at fixing a broken wallet, ensure you have your correct 12 word seed written down (preferably physically, on a piece of paper) and accessible, along with an export of your DCRDEX server accounts.
If you have lost your seed, you are in serious danger of losing access to your funds permanently - we recommend backing it up via the Settings Panel.
Contents
The main location for Bison Wallet data files is OS-dependent:
| OS | Bison Wallet Path |
|---|---|
| Windows | %LocalAppData%/Dexc/ |
| macOS | ~/.dexc/ |
| Linux | ~/Library/Application\ Support/Dexc/ |
There are different log files which may be reviewed when troubleshooting a problem:
| Log | Location |
|---|---|
| Main application | mainnet/logs/dexc.log |
| Native DCR wallet | mainnet/assetdb/dcr/mainnet/spvlogs/neutrino.log |
| Native BTC wallet | mainnet/assetdb/btc/mainnet/logs/neutrino.log |
| Native LTC wallet | mainnet/assetdb/ltc/mainnet/logs/neutrino.log |
NOTE: This section of the is only applicable to Decred, Bitcoin and Litecoin wallets.
In rare circumstances, your wallet may need to rescan the blockchain for missed transactions.
This is a process that can take several hours, depending on the number of transactions in the wallet.
To rescan the wallet, open the wallet settings dialog and click the Rescan button.
You will a message with a green check icon if the rescan was successfully initiated.
NOTE: This section of the is only applicable to Neutrino based wallets like Bitcoin and Litecoin.
If a neutrino wallet is corrupted, the dexc.log may have a message similiar to:
[ERR] CORE: Unable to connect to btc wallet (start and sync wallets BEFORE starting dex!): connectWallet: failed to connect btc wallet: connect failure: wallet not found
Note btc in the above message, and wallet not found.
This may also say something about db corruption, or similar errors, which may also be addressed by
recovering the wallet.
In this case, the Wallet will still show the BTC wallet since it was previously configured, but it will not be synchronized and cannot be unlocked or connected.
To recover the wallet, open the wallet settings for the affected wallet, and click the
Recover button:
A warning will appear indicating what actions to expect, click Submit.
Once the recovery process has completed, the wallet will be re-created and start synchronizing:
Caution
The recommended procedure for rescanning is through the Wallet Settings as described in the Rescanning section of this wiki.
If you wish to force a rescan, you can do so by following these steps:
- Delete the wallet.db file in the
assetdb/btc/mainnet/(for mainnet) folder as described at the end of the previous section. Start DEX and log in. Follow the instructions in recovery section to reinitialize the wallet and begin a resync. - OR (safest option) use the
dropwtxmgrtool on that wallet.db file.
See the instructions in https://github.com/btcsuite/btcwallet/blob/master/docs/force_rescans.md. You will build that tool as described there and then run it on DEX's btc wallet.db. For exampledropwtxmgr --db ~/.dexc/mainnet/assetdb/btc/mainnet/wallet.db. When you start DEX and login again, it will begin to rescan the wallet.
Caution
The recommended procedure for recovery is through the Wallet Settings as described in the Recovery section of this wiki.
In addition to reinitializing or rescanning the wallet.db files, you may also remove all of the chain data
files to force resynchronization of all blockchain data used by the neutrino service that powers the wallet.
To do this, shutdown Bison Wallet and delete all the files in assetdb/btc/mainnet/ (for mainnet BTC),
including neutrino.db, reg_filter_headers.bin, block_headers.bin, and wallet.db.
You may keep peers.json to help with bootstrapping when you restart, but it may be deleted too.
Next, start Bison Wallet and go to the Wallet view, open wallet settings for the
affected wallet, and click Recover after ensuring it is currently showing the Native wallet option.