Once a transaction is broadcasted to the network, it will reside in a temporal database of every Sia node (the mempool) until it is included in the next block mined. In Sia, blocks are mined every 10 minutes on average, but due to the normal variance of the process, this can take much longer or much less. If the transaction was made from a Sia-UI wallet, it will show as “Unconfirmed” during this time.

The first step for troubleshooting is knowing if the transaction is in a block of the blockchain or not. For this, you can use the Transaction ID (TxID) on one of these blockchain explorers:

• http://explore.sia.tech/
• http://explorer.siahub.info/

If the transaction is on the blockchain, these explorers will show all the information related to it. If this is the case, and after some reasonable time the receiving wallet does not show the transaction, the issue is on the receiving wallet.

While transactions from/to exchanges work in the same fashion as the rest of transactions, Exchanges usually require more time (and more blocks of confirmation) to process them due to their own internal rules. It is not unusual an Exchange experiencing delays of several hours or even days. It is not unusual either that the exchange has interrupted the wallet service due to maintenance or software issues. If your operation from an exchange or to an exchange is not being processed, check the wallet status alerts on the website of the Exchange.

These delays are common and in most of the cases are solved without any action from the user after some hours. However, if the delay is longer than 1-2 days, the user should open a support ticket on the Exchange.

It is a common (but not recommendable) practice of some miners to mine to an exchange address instead to a local address in their Sia-UI software. In these cases, it is important to know if the issue is on the mining pool side or the Exchange side. To discern this, check the transaction on the blockchain explorers (explained in the previous section): if the TX is not in the blockchain, it is an issue of the pool. If it is shown included in a block, it is an issue of the Exchange.

If the transaction is already included in a block of the blockchain (check the first section) but it is not showing up on your Sia-UI client, try this troubleshooter:

• Confirm you are using the last version of the Sia software by checking the About tab. Current version can be downloaded here. Older versions of the software might be incompatible with the current blockchain due to a previous hardfork, and so not being able to show new incoming transactions. For example, since January 2018 only versions 1.3.1 and posterior are compatible. Update to the last version of Sia, following these instructions.

• Confirm your Sia-UI is fully synchronized to the blockchain, and the block height is the most recent block. If it is not synchronized, just let your client to sync more time. You can check the current block height of the blockchain in these websites: https://explore.sia.tech/ or https://siastats.info . Be aware that even if the UI claims to be “synchronized”, it can be actually stuck at an incorrect block height, so compare yours with the mentioned websites. If your client is stuck in a block height bellow the current one, follow the instructions on “Method 3” bellow.

• Confirm the recipient address of the transaction is part of the list of addresses being used by your wallet. You can check all the addresses of your wallet by going to the Terminal tab and typing wallet addresses

If these 3 steps have failed, you might need to force the software to re-scan the blockchain to find the missing transaction: in a very limited and rare number of cases, the Sia software might skip one transaction in the wallet. You can force Sia to find those transactions by any of the following two methods. It is essential you have your recovery seed for this. Do not proceed unless you are completely sure your recovery seed works unlocking your wallet, as if you are using a custom password, the password will not unlock anymore your wallet. To check your seed is valid, first lock your wallet and then try to unlock it using your seed instead of your password. You could lose your funds if the seed you are using is not valid.

• 1- Go to About and click on Show Sia Data. A folder will open on your Operating System

• 2- Close Sia completely. On Windows, click “Close” on the Sia system tray icon

• 3- On the folder open on step 1, go to the sia subfolder and move the wallet folder to any other location (or just rename it). Be sure no folder with the name “wallet” remains in the original location

• 4- Open Sia again, and on the Wallet tab, click on Recover seed. Sia will re-scan the blockchain. Depending on your hardware, the process will take from 15 minutes to some hours. Be patient and don’t close Sia during the re-scan

• 1- Download this tool from here: https://github.com/NebulousLabs/Sia-UI/files/1083210/recover.zip

• 2- Go to About and click on Show Sia Data. A folder will open on your Operating System. Open the subfolder sia

• 3- Close Sia completely. On Windows, click “Close” on the Sia system tray icon

• 4- Open the downloaded zip file and extract the files to the sia sub-folder open in step 2

• 5- Open a command prompt:

• In Windows: in the File Explorer window you open on step 2, go to File (upper left corner of the window) > open command prompt > open command prompt
• In MacOS: a) Open the Spootlight by pressing Command + Space. Type Terminal and Open the Terminal app. b) Navigate to the folder you open in step 2 by typing cd followed by a space and the path of the folder. For example, cd /$HOME/Library/Application\ Support/Sia-UI/sia/

• 6- Use the following commands. Depending on your Operative System:

• Windows: type recover-windows.exe scan
• Windows using PowerShell (default in Windows 10 since Creators Update. PowerShell can be recognized as the background of the terminal is blue instead of black): ./recover-windows.exe scan
• MacOS: type ./recover-darwin scan
• Linux: type recover-linux scan

• 7- You will be prompted to introduce your recovery seed. For security, nothing will show up while you type it. Type the seed or paste it. For example, in Windows you can paste it simply by a single right-click on your mouse on the command prompt window. Press enter

• 8- The scan will take several minutes. Take note of the “suggested seed progress” value at the end of the report

• 9- Type the same command you used on step 6 but replacing scan by set followed by the number you obtained on step 8. In Windows, this is an example of the command: recover-windows.exe set 2

• 10- Open Sia-UI again and unlock your wallet. Sia will rescan the blockchain. Depending on your hardware, the process will take from 15 minutes to some hours. Be patient and don’t close Sia during the re-scan

• 1- Go to About and click on Show Sia Data. A folder will open on your Operating System.

• 2- Close Sia completely. On Windows, click “Close” on the Sia system tray icon

• 3- On the folder open on step 1, go to the sia subfolder and delete the consensus sub-folder

• 4- Open Sia software again and let the client to synchronize the blockchain again. If you want to speed up this process, follow these instructions for bootstrapping the blockchain