Sia-UI and Wallet FAQs

Common questions and answers to using the Sia client.


Expand All

Looking for topics related to Renting or Hosting? We also have general information on Sia, Siacoins/Siafunds, a Wallet Setup Guide and a Guide to Buying Siacoins.

General Sia Usage

Sia takes forever to fully synchronize. Any way to speed it up?

Sia has to download the entire blockchain and build a consensus database in order to synchronize. This requires several gigabytes (currently, about 10 GB) of data to be downloaded, and frequent read/writes to your hard drive. Sia will synchronize much faster if your primary hard drive is a Soild-State Drive (SSD) and you have a fast internet connection. Sia can take several days to synchronize in certain cases. Some users have reported that disabling write caching may improve performance while synchronizing, though we haven't tested this.

We provide a download of the Sia consensus database, built nightly, which may help you speed up synchronization. You can check it out here.

Should I back anything up to make sure I don't lose my wallet or other important data in Sia?

Yes! Glad you asked. The most important thing to save is your wallet seed. You're told to write it down when you create your wallet. If you lose your wallet seed, you can view it again by clicking on Backup Wallet under the Wallet tab. If you no longer have access to the Sia installation where your wallet was set up, and you don't have your wallet seed, you're out of luck and your wallet (and Siacoin) is gone. There's no way to recover it without your wallet seed.

Another good thing to back up (outside of Sia) is your Sia-UI data directory, especially if you're renting or hosting. The location of this directory on various operating systems is provided in a topic below.

Where are Sia's internal data files stored?

In the Sia-UI, you can click About > Show Sia Data and you'll be taken to Sia's internal data files. Sia keeps internal files related to your specific installation in these locations:

  • Linux: $HOME/.config/Sia-UI/sia/
  • Mac: $HOME/Library/Application Support/Sia-UI/sia/
  • Windows: %APPDATA%\Sia-UI\sia\

If backing up these files, you can skip the consensus folder if you'd like, as it takes up the most space (around 10 GB) and is what Sia downloads when it synchronizes. Sia can download it again if needed; the other files are unique to your installation, and your renter or host setup if applicable. Without them, you can lose access to your files or lose your storage contracts. It's a good idea to back them up regularly!

How do I move Sia's internal data files (i.e. the consensus database) to another folder or drive?

There are two ways to relocate your Sia data folder. You may want to do this if your default OS drive isn't a solid state drive, or doesn't have about 10GB of free space to hold the consensus database. Keep in mind that if you move the data folder to a traditional hard drive, Sia will synchronize more slowly and may perform slowly in other ways.

To relocate the internal data folder:

  1. Open Sia at least once first if you haven't before. This will cause the internal data files to start generating, so you'll have something to move.
  2. Close Sia completely (see the FAQ topic below if needed).
  3. Open Sia's internal data folder (see the FAQ topic above if needed for the location).

From here, you've got two ways to proceed - you only need to choose one:

Method 1: Edit config.json
  1. Copy the sia folder found within Sia-UI to the new location. For example, we could move the folder to our D:\ drive.
  2. Edit config.json in the Sia-UI folder and change the "datadir": line to point to the path where you moved the data folder to, i.e. "D:\\sia". Be sure to follow the convention of the path, i.e. use double backslashes in the path if they're currently used.
  3. Delete the sia folder in the original Sia-UI internal data folder (i.e. the one in %APPDATA% or $HOME), but leave the config.json and Preferences files. Sia will still look at the config.json file in the Sia-UI folder to know where to find the sia folder after you moved it.
Method 2: Create a Symbolic Link
  1. Copy the Sia-UI folder found within %APPDATA% or $HOME to the new location. For example, we could move the folder to our D:\ drive.
  2. Delete the Sia-UI folder in the original internal data folder (i.e. the one in %APPDATA% or $HOME).
  3. Create a symbolic link - in Windows, open Command Prompt as an administrator and type mklink /D %APPDATA%\Sia-UI D:\Sia-UI, replacing D:\Sia-UI with the new location you moved the Sia-UI folder to.

When you open Sia, it should now use the data folder in the new location. Make sure you protect this folder (back it up and don't accidentally delete it or disconnect it if on an external drive), as it contains your wallet and renter/host data.

How do I completely close Sia-UI? Closing it only seems to minimize it to the system tray.

Sia stays open and leaves an icon in the system tray by the clock. Right-click on that icon and select Quit Sia, and Sia will shut down completely.

If you don't want Sia to stay open in the system tray when you close the main UI window, you can edit \Sia-UI\config.json in Sia's internal data files (described above) and change "closeToTray": true to "closeToTray": false.

How do I start over with a fresh install of Sia?

Warning: Following these steps will wipe out your Sia wallet, as well as renting or hosting if you have them configured. Make sure you have your wallet seed written down and you're not renting or hosting (or you accept the loss of files, contracts or collateral) before continuing!

You may want to reset Sia to a clean state for some reason, such as if you're having a problem that other troubleshooting methods aren't fixing. To reset Sia to it's original, new, out-of-the-box state:

  1. Make sure Sia is closed completely (see the topic above if necessary).
  2. Delete the entire Sia-UI folder found in:
    • Linux: $HOME/.config
    • Mac: $HOME/Library/Application Support
    • Windows: %APPDATA%
  3. Before opening Sia again, consider downloading Sia from the Sia Downloads page again as well to make sure that you have the latest version and that your existing Sia application files haven't also become corrupt somehow.

When you open Sia, it will act like it's the first time you've opened it and will start to synchronize from the beginning again. You can then use your wallet seed to load your wallet into Sia again. If you want to speed up synchronization, consider using our Consensus Download to bootstrap the consensus file.

How do I upgrade to a new version of Sia?

Follow these easy steps:

  1. Close Sia completely (see the topic above if necessary).
  2. Download the latest version of Sia from the Sia Downloads page.
  3. Extract the new files. If you had your Sia files in a particular location before, you can replace the old files with the new ones.
  4. If you don't replace the old files with the new downloaded ones, you should delete the old Sia folder to prevent any of the old files from accidentally being used.

Your wallet, renting/hosting configuration, and synchronization status won't be lost during upgrade even if you delete your old Sia application folder because those files are stored elsewhere (see the topic above regarding where Sia's internal data files are stored).

You can also upgrade via the Sia-UI under About > Check for Update and downloading the update there. Sia will only download the new version and put it next to the folder Sia is runnning in - you'll still have to close Sia, extract the new version, and open it as described above.

Wallet

What does the "Recover Seed" button do? Should I use it?

The Recover Seed button in the wallet takes a seed that you enter and transfers (sweeps) all of that seed's funds to the currently loaded wallet. The seed that you enter for recovery will be left empty with a 0 SC balance. You should only use the Recover Seed option if you want to combine two wallets by transferring all funds out of the seed you enter into your currently loaded wallet.

You should also make sure you have the current wallet's seed written down, as this is where your Siacoins will be after recovering a seed - if you don't have the current wallet seed written down, click on Backup Wallet in the Wallet and write it down. If you recover a seed to a wallet and then lose access to that wallet or you don't have the seed, you'll lose your Siacoins, so be careful when recovering seeds.

How do I restore my wallet from a seed?
On a new Sia installation:

When you click on the Wallet tab for the first time, you'll have two options: "Create a new wallet" or "Load a wallet from a seed". Select the second option and enter your wallet seed. Your password will also be your wallet seed. If you choose to, you can set a new password after your wallet is imported and unlocked by clicking on Change Password at the top of the Wallet page. Custom wallet passwords are only valid on each local Sia installation.

You can also load a seed via the Terminal or command line with the command wallet init-seed.


On an existing Sia installation with a wallet already in use:

You have two options to recover a wallet, depending on if you want to simply add the funds from your old wallet/seed to your current wallet or if you want to use the seed you're importing as your main wallet:

  • To transfer the funds from the old wallet seed to your current wallet, click Recover Seed at the top of the Wallet page. This is also known as sweeping the old wallet, and upon completion the old wallet will then have a 0 SC balance.

    If you use this method, make sure you have your current wallet seed written down too, as this is where your Siacoins will be now. You can click Backup Wallet at the top of the Wallet page to see your current wallet seed again if you need it.

  • To load a wallet seed to use as your main wallet, click on the Terminal tab at the left of the Sia-UI and type wallet init-seed --force. This will replace the existing wallet in the Sia-UI with the wallet your seed is associated with, so make sure you have your existing wallet seed written down if it's not empty or if you plan to use it again in the future.

How do I force my wallet to rescan the blockchain for transactions? (Wallet Re-initialization)

You may need to force your wallet to re-initialize in order to find a missing transaction that isn't included in your transaction list.

  1. Grab your wallet seed.
  2. Click on the Terminal tab at the left of the Sia-UI (or use siac) and type wallet init-seed --force.
  3. Enter your seed when prompted.
  4. Click on the Wallet tab to view progress. If you're prompted for a wallet password, use your seed as well.

Your wallet will re-initialize and rescan the blockchain for your transactions. This should find any missing incoming transactions that were included in a block and successfully sent to you, but that didn't show up in your transaction list for some reason. The process can take 20 minutes or more, depending on your computer hardware.

If you need further assistance finding a missing transaction, see the Transaction Troubleshooting topic below.

I'm trying to unlock my wallet or restore my wallet from my wallet seed, and my password isn't working.

Try using your wallet seed as the password. Sometimes if you upgrade Sia, the wallet password reverts to default, which is the wallet seed. If you're importing your wallet seed into a new Sia instance or installation and you previously set a custom password, that password was only effective on the old installation.

Why do I see one or more 0.088 SC transactions taken out of my wallet?

Your wallet is a collection of several receiving addresses, especially when renting or hosting - many addresses are created automatically to facilitate contract payments. Sia occasionally consolidates balances on these addresses in the background. To do so, it requires a transaction on the network. The 0.088 SC transaction you see is the network fee for automatic wallet consolidation/defragmentation and is nothing to be concerned about.

Exchanges

The following information is not investment advice, and is SiaSetup's opinion only. You are responsible for understanding the risks of any investment, and should consult with an appropriately qualified financial advisor if you have questions on investments, investment risks or investment strategies.

Is Sia working on getting into any new exchanges? Won't this help the price increase?

Sia/Siacoin is already on several exchanges such as Binance, Bittrex, Poloniex, and many other smaller exchanges. Certain exchanges are sometimes requested, but the Sia team has so far been unable to reach an agreement to be listed on these exchanges that doesn't involve an exorbitant listing fee. Considering the Sia project is still in development, getting listed on new exchanges has not been a huge priority.

Because Sia is a utility token (it is exchanged for services on the network, i.e. storage via renting and hosting), the price of the coin is intended to remain stable. Listing the coin on a new exchange may result in a temporary increase in price, but this is almost always temporary and short-term. In the long term, it is more beneficial for the Sia product and users of Sia for the coin price to remain fairly consistent. Exchange prices are generally fueled by speculation anyway - cryptocurrency coins often increase and decrease in value for no real reason, or in relation to another coin like Bitcoin. There are hundreds of other coins and projects that are better suited to price speculation - Sia is probably one of the worst projects around in regards to expecting high returns.

Why did my preferred exchange disable Siacoin deposits/withdrawls? Is the Sia team aware? When is it going to be fixed?

Exchanges are a unique use case for the Sia wallet because they handle millions of transactions. Sometimes new issues with the Sia software are discovered based on the heavy usage of exchanges, which can cause an exchange to stop all Siacoin transactions if things aren't working properly.

The Sia development team is usually aware of these issues, and works to fix them. However, some exchanges are both difficult to communicate with, and elect to not use any Sia version that isn't a full release (i.e. release candidate versions that may have fixed the issue, but are still being tested). For this reason, resolution of exchange issues often takes several weeks or more. There isn't much you can do except wait for a fix to be completed and accepted/implemented by the exchange.

Common Issues

I sent Siacoins somewhere (my wallet, an exchange, etc) and they're not showing up. (Transaction Troubleshooting)

If you've sent or are expecting to receive Siacoins and they're not showing up in the destination wallet, follow these steps to troubleshoot. Please follow along carefully and follow all steps, and your transaction issue will almost certainly be resolved.

For All Situations:
  1. Make sure you sent your Siacoins to the correct address. If not, there's your problem!
    • If you sent them to a wrong address related to an exchange, contact the exchange to see about the possibility of retrieving the coins. They may have a way to gain access to the address you sent them to, especially if it was an old address for the exchange that was accidentally re-used.
    • If you sent them to a wrong address anywhere else (in other words, a random unknown address) and the transaction is confirmed, you're probably out of luck. The coins went to wherever they went, possibly to an address that has no wallet associated and never will. Unless the owner of the wallet (if one exists) noticed the transaction and decided to return it, your coins are as good as gone.
  2. Look up the transaction by searching for the transaction ID in a Block Explorer, such as the Sia Block Explorer or Sia Navigator.
    • If the transaction doesn't appear, it hasn't been finalized on the network yet. Wait 20-30 minutes and check again.
    • If the transaction appears, has a block number and confirmations, it's on the network and has been successfully received, which is good.
    • If you're sending from an exchange and have no transaction ID, you can't check whether or not the transaction was sent. Contact the exchange if you don't receive a transaction ID.

From here, continue to the appropriate section below to further troubleshoot why your transaction hasn't been sent or why you can't see it:
To Local Wallet To Exchange From Local Wallet From Exchange


Sending To a Local Sia Wallet (Sia-UI, Sia Daemon, etc):

Did your transaction show up in the Block Explorer in Step 2 above?

  • Yes: You have received your coins, but they're just not showing up in your wallet for some reason. Check the following items.
    1. Make sure that your wallet is fully synchronized. Transactions may not show in the transaction list of a receiving wallet that isn't fully synchronized.
    2. Make sure your wallet isn't stuck on block 139885 (see this topic if so).
    3. If the above two items are ok, and the transaction isn't showing in your wallet's transaction list, you'll need to reinitialize your wallet to force a rescan of the blockchain to find the missing transaction. See this topic for instructions.
  • No: Your coins haven't been included in a block yet. Wait for 1-2 blocks to occur (usually about 20 minutes), and check the Block Explorer again. If your transaction still isn't appearing, look at the appropriate "Sending From" section (or contact the sending party) to troubleshoot why: From Local Wallet From Exchange

Sending To An Exchange:

Did your transaction show up in the Block Explorer in Step 2 above?

  • Yes: The exchange has received your coins. Exchanges usually require 6 confirmations, sometimes more, before they'll show your coins in your exchange balance. The number of confirmations can be seen in the Block Explorer. 6 confirmations typically takes an hour, but can take longer (and if they require more confirmations, it may take a few hours). If you still don't see your coins after several hours and after your exchange's policy for confirmations, you'll need to contact your exchange with your transaction ID for assistance.
  • No: Your coins haven't been included in a block yet. Wait for 1-2 blocks to occur (usually about 20 minutes), and check the Block Explorer again. If your transaction still isn't appearing, look at the appropriate "Sending From" section to troubleshoot why: From Local Wallet From Exchange

Sending From a Local Sia Wallet (Sia-UI, Sia Daemon, etc):

Did your transaction show up in the Block Explorer in Step 2 above?

  • Yes: You have successfully sent your coins. The transaction should say it's confirmed in your wallet. The problem is on the receiving end. See the appropriate "Sending To" section (or refer the receiving party to it) to troubleshoot why: To Local Wallet To Exchange
  • No: Your coins haven't been sent or included in a block yet. Follow these steps:
    1. Make sure that your wallet is fully synchronized. You cannot send coins until your wallet is synchronized.
    2. Make sure your wallet isn't stuck on block 139885 (see this topic if so).
    3. If the transaction says "Unconfirmed" in your wallet, wait for 1-2 blocks to occur (usually about 20 minutes) and see if it changes to "Confirmed".

Sending From An Exchange:

Did your transaction show up in the Block Explorer in Step 2 above?

  • Yes: The exchange has successfully sent your coins. The problem is on the receiving end. See the appropriate "Sending To" section to troubleshoot why: To Local Wallet To Exchange
  • No: Your coins haven't been included in a block yet, which means the exchange hasn't actually sent them on the Sia network. Exchanges can take longer than usual to send coins - we'd suggest waiting at least an hour, if not two, and then check the Block Explorer again. If you still don't see your transaction, you'll need to contact your exchange with your transaction ID for assistance.

If the above steps don't help your solve your transaction issue, try some of the support resources in our External Links section.

Sia says "Loading may take a while after upgrading to a new version" for a long time.

If you recently updated Sia, some changes can take a while to process depending on how old your previous Sia version was. Just like with synchronization, these processes take longer on a traditional hard drive, and can sometimes take hours.

If you deleted files during troubleshooting or bootstrapped a consensus database, Sia may have to go through and rebuild other information related to renting, hosting, or the transacation pool block-by-block. Even on a fast computer with a SSD, this can take several hours. As long as you see the update message and no other error, Sia is making progress and you should let it continue until it's finished.

Sia says the current block is 139885, is not synchronizing further, and new transactions aren't confirming.

This is a known issue related to a hard fork that happened to fix a mining difficulty issue some time ago. You'll see this happen if you're running an older version of Sia, or sometimes if you just upgraded from an old version to the current version. To fix it:

  1. Navigate to Sia's internal data folders (see the topic above if needed, or click "Show Sia Data" in the About section of Sia-UI).
  2. Close Sia completely (see the topic above if needed).
  3. Update to the latest version of Sia if you haven't yet (see the topic above if needed).
  4. Delete \Sia-UI\sia\consensus\consensus.db in the internal data folder you opened earlier.
  5. Open Sia and let it fully synchronize.

Sia should then synchronize beyond block 139885 and your transactions will be up to date. If you want to speed up synchronization, consider using our Consensus Download to bootstrap the consensus file.

Sia says "Consensus change series appears to be inconsistent - we are applying the wrong block." and won't load.

This error is usually caused by a corrupt file, most of the time in either the transaction pool or consensus. You may also see this error after upgrading Sia to a new version. To fix:

  1. Close Sia completely (see the topic above if needed).
  2. Navigate to Sia's internal data files (see the topic above for the location if needed).
  3. Delete the transactionpool folder and open Sia again.
  4. If you still see the error, close Sia, go back to the internal data files and delete the transactionpool and consensus folders, and open Sia again. This will require Sia to re-synchronize, but it is necessary to fix the issue. If you want to speed up synchronization, consider using our Consensus Download to bootstrap the consensus file.

If you still see the error, something else is corrupt and it's best to start with a fresh install of Sia.

Sia says "Unable to fund transaction: wallet has coins spent in incomplete transactions - not enough remaining coins" when trying to send Siacoins.

First, make sure you're fully synchronized. Check the block number that Sia says it's synchronized to.

If the block number is 139885:

Sia is stuck on that specific block due to a hard fork that occurred some time ago to fix a mining difficulty issue. See the topic above titled "Sia says the current block is 139885, is not synchronizing further, and new transactions aren't confirming" and follow the instructions there.

If the block number is higher than 139885:

Wait until you see the block number increase by a block or two (usually about 20-30 minutes), make sure all your transactions show as confirmed, and try again. This issue is usually temporary, and can happen if you try to send coins multiple times within a few minutes (more information on why can be found here). If you still have the issue, follow the steps above for Sia being stuck on block 139885 - even though you're not stuck on this block, the solution at this point is the same.

I'm getting a different error when I open the Sia-UI, and Sia won't load.

There is a very comprehensive Sia Troubleshooting Thread from tbenz9 with many common errors and resolutions that you may also wish to look into.

There are a few things you can try, in order from least to most drastic:

  1. Try closing Sia and opening it again. Close it completely per the topic above. You can also try restarting your computer. Easy things first!
  2. Make sure you're running the latest version of Sia. Check the Sia Downloads page to see if there's a newer version. It might not hurt to re-download Sia anyway to make sure one of your Sia files didn't somehow become corrupted. You can either overwrite your current Sia-UI folder, or erase it and extract the files from scratch. Either option won't cause any data loss in terms of your wallet or your host or renter configurations. After that's done, open Sia and see if things are working. Sia may say that it'll take a while to upgrade - let it do what it needs to do.

For the following tasks, you'll need to know where your Sia-UI data folder is. See the other FAQ topic above for the location of the Sia data folder.

  1. If you have a previous backup of your Sia internal data folder, close Sia and try reverting to a recent version of that. It's likely that something became corrupted, especially if Sia didn't shut down correctly. If you rent or host, this may affect your contracts, so also back up the current Sia data folder before you replace it, even if it seems to be broken.
  2. You may have to remove some of Sia's files so that it can rebuild them. Close Sia, back up these files before removing any of them, and make sure you have your wallet seed written down! If you remove the wrong files and don't have a backup, it'll be like starting from scratch. If you don't have your wallet seed and you mess something up, you'll lose access to your wallet. You've been warned!

    Start by checking Sia's log files for clues on what might be going wrong. Look at \Sia-UI\sia\siad-output.txt, and then the text files in each directory. They might mention problems with a particular subfolder, like \consensus or \host. If you see an error, try removing the appropriate folder, or taking whatever other action might be necessary if the error is specific. Be advised that if you're a renter or host and you remove the corresponding directories, it may also remove your renter or host contracts. Sia may be able to rebuild them, but if not, restore them from the backup copy you were told to make before messing with these files. You did make a backup, right?

  3. Worst case, if you're not a host or renter, you can delete the entire \Sia-UI data folder (again, make sure you have your wallet seed written down first), and Sia will behave as if it's brand new the next time you open it. With your wallet seed, you can then recover your wallet and your Siacoins.

If Sia still isn't loading after all of that, or if you're a renter or host concerned about losing your files or contracts, you might consider asking for help in one of the communities listed in our External Links, like Reddit or Discord.

Sia is being very resource-intensive (high RAM use, causing computer to stutter, etc).

Reports of high resource use seem to have increased with Sia v1.3.2, but have improved with v1.3.3. Sia tends to be particularly intensive while synchronizing the consensus database, and your computer may lag or stutter a bit while this happens. Sia also does not currently run well on computers with low RAM. Once Sia is synchronized, resource use should decrease. When you first open Sia, try closing all other programs and letting Sia fully synchronize before you do anything else.

Don't see your question answered? Let us know and we'll see if we can add it to the FAQ.


Top
Highlight and share