Hyperspace App FAQs

Common questions and answers to using the Hyperspace app.


Expand All

Looking for topics related to Renting or Hosting? We also have general information on Hyperspace, Space Cash, a Wallet Setup Guide and a Guide to Buying Space Cash.

General Hyperspace Usage

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

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 Hyperspace installation where your wallet was set up, and you don't have your wallet seed, you're out of luck and your wallet (and Space Cash) is gone. There's no way to recover it without your wallet seed.

Another good thing to back up (outside of Hyperspace) is your Hyperspace 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 Hyperspace's internal data files stored?

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

  • Linux: $HOME/.config/Hyperspace.app/hyperspace/
  • Mac: $HOME/Library/Application Support/Hyperspace.app/hyperspace/
  • Windows: %APPDATA%\Hyperspace.app\hyperspace\

If backing up these files, you can skip the consensus folder if you'd like, as it takes up the most space and is what Hyperspace downloads when it synchronizes. Hyperspace 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 Hyperspace's internal data files (i.e. the consensus database) to another folder or drive?

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

To relocate the internal data folder:

  1. Open Hyperspace 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 Hyperspace completely (see the FAQ topic below if needed).
  3. Open Hyperspace'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 hyperspace folder found within Hyperspace.app to the new location. For example, we could move the folder to our D:\ drive.
  2. Edit config.json in the Hyperspace.app folder and change the "datadir": line to point to the path where you moved the data folder to, i.e. "D:\\hyperspace". 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 hyperspace folder in the original Hyperspace.app internal data folder (i.e. the one in %APPDATA% or $HOME), but leave the config.json and Preferences files. Hyperspace will still look at the config.json file in the Hyperspace.app folder to know where to find the hyperspace folder after you moved it.
Method 2: Create a Symbolic Link
  1. Copy the Hyperspace.app folder found within %APPDATA% or $HOME to the new location. For example, we could move the folder to our D:\ drive.
  2. Delete the Hyperspace.app 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%\Hyperspace.app D:\Hyperspace.app, replacing D:\Hyperspace.app with the new location you moved the Hyperspace.app folder to.

When you open Hyperspace, 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 the Hyperspace app? Closing it only seems to minimize it to the system tray.

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

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

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

Warning: Following these steps will wipe out your Hyperspace 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 Hyperspace to a clean state for some reason, such as if you're having a problem that other troubleshooting methods aren't fixing. To reset Hyperspace to it's original, new, out-of-the-box state:

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

When you open Hyperspace, 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 Hyperspace 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 Hyperspace?

Follow these easy steps:

  1. Close Hyperspace completely (see the topic above if necessary).
  2. Download the latest version of Hyperspace from the Hyperspace GitHub releases. You can also download from the Hyperspace site, but the link there doesn't always point to the latest version.
  3. Extract the new files. If you had your Hyperspace 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 Hyperspace 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 Hyperspace application folder because those files are stored elsewhere (see the topic above regarding where Hyperspace's internal data files are stored).

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

Wallet

Where can I get more information on the Space Cash airdrop or how to claim it?

The Hyperspace airdrop happened at the beginning of July 2018 and is already complete. We have a guide with more information on the airdrop, as well as how to claim your Space Cash, which can be found here.

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 SPACE 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 Space Cash 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 Space Cash, so be careful when recovering seeds.

How do I restore my wallet from a seed?
On a new Hyperspace 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 Hyperspace installation.

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


On an existing Hyperspace 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 SPACE balance.

    If you use this method, make sure you have your current wallet seed written down too, as this is where your Space Cash 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 top of the Hyperspace app and type wallet init-seed --force. This will replace the existing wallet in the Hyperspace app 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 top of the Hyperspace app (or use hsc) 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 Hyperspace, the wallet password reverts to default, which is the wallet seed. If you're importing your wallet seed into a new Hyperspace 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 SPACE 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. Hyperspace occasionally consolidates balances on these addresses in the background. To do so, it requires a transaction on the network. The 0.088 SPACE 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 HSSetup'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 Hyperspace working on getting into any exchanges?

Yes - exchanges are a priority for the team. A block explorer was just released, which is a major pre-requisite to being listed on an exchange, so if we're lucky we can expect to see Space Cash listed on an exchange within the next month (August 2018) or so.

Will Space Cash's ticker be SPACE? Isn't there already a coin with SPACE?

There is another coin with the SPACE ticker, but it's a dead project that hasn't been maintained for some time. The Hyperspace team plans to try to convince exchanges to drop the dead coin and take over the SPACE ticker. If this isn't possible, Space Cash may be referred to as something other than SPACE, though we don't know what yet.

Common Issues

I sent Space Cash somewhere (my wallet, an exchange, etc) and it's not showing up. (Transaction Troubleshooting)
Notice: A block explorer doesn't yet exist for Hyperspace, so it's not possible to follow these troubleshooting steps entirely. You can try the other items mentioned, and this item will be updated with a block explorer when one becomes available.

If you've sent or are expecting to receive Space Cash 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 Space Cash 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 Hyperspace Block Explorer.
    • 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 Hyperspace Wallet (Hyperspace app, Hyperspace 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. If 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 Hyperspace Wallet (Hyperspace app, Hyperspace 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. 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 Hyperspace 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.

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

If you recently updated Hyperspace, some changes can take a while to process depending on how old your previous Hyperspace 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, Hyperspace 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, Hyperspace is making progress and you should let it continue until it's finished.

Hyperspace 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 Hyperspace to a new version. To fix:

  1. Close Hyperspace completely (see the topic above if needed).
  2. Navigate to Hyperspace's internal data files (see the topic above for the location if needed).
  3. Delete the transactionpool folder and open Hyperspace again.
  4. If you still see the error, close Hyperspace, go back to the internal data files and delete the transactionpool and consensus folders, and open Hyperspace again. This will require Hyperspace 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 Hyperspace.

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

First, make sure you're fully synchronized. Then 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 the "Consensus change series" error above - even though the error is different, the solution is the same.

I'm getting a different error when I open the Hyperspace app, and it 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 which also apply to Hyperspace.

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

  1. Try closing Hyperspace 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 Hyperspace. Check the Hyperspace site to see if there's a newer version. It might not hurt to re-download Hyperspace anyway to make sure one of your Hyperspace files didn't somehow become corrupted. You can either overwrite your current Hyperspace 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 Hyperspace and see if things are working. Hyperspace 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 Hyperspace internal data folder is. See the other FAQ topic above for the location of this folder.

  1. If you have a previous backup of your Hyperspace internal data folder, close Hyperspace and try reverting to a recent version of that. It's likely that something became corrupted, especially if Hyperspace didn't shut down correctly. If you rent or host, this may affect your contracts, so also back up the current Hyperspace data folder before you replace it, even if it seems to be broken.
  2. You may have to remove some of Hyperspace's files so that it can rebuild them. Close Hyperspace, 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 Hyperspace's log files for clues on what might be going wrong. Look at \Hyperspace.app\hyperspace\hsd-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. Hyperspace 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 \Hyperspace.app data folder (again, make sure you have your wallet seed written down first), and Hyperspace 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 Space Cash.

If Hyperspace 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.

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

Hyperspace tends to be particularly intensive while synchronizing the consensus database, and your computer may lag or stutter a bit while this happens. Hyperspace also does not currently run well on computers with low RAM. Once Hyperspace is synchronized, resource use should decrease. When you first open Hyperspace, try closing all other programs and letting Hyperspace 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