Notice: Because the Hyperspace network just launched late July 2018, there are not currently enough hosts available in order to successfully rent storage. The topics below are carried over from Sia functionality and will still apply when renting is possible.Expand All
Allowance and Contracts
How do I change my allowance?
You can click on Create Allowance and enter your new allowance. It will look like you're creating a new allowance, but it will actually change your existing allowance to whatever you set.
Why do I see a bunch of small transactions taken from my wallet while renting?
As you create contracts with hosts, a portion of your allowance is removed from your wallet and locked up in an allocation to that host. Since you'll be creating 30+ contracts, you'll see several transactions coming out of your wallet. You may also see transactions when your allowance tops back off after about 6 weeks of renting, when your contracts renew, or if you're uploading or downloading data frequently. Remember that you'll only ultimately be charged for the storage and bandwidth that you actually use, so if you don't actually use all the storage space allocated to you while renting, you'll see some of your Space Cash return to you at the end of the contract.
How do I stop renting, end my contracts, or cancel my allowance?
renter allowance cancel into the Terminal. This will immediately cancel your allowance, and your data will be inaccessible. It effectively stops all activity as a renter, because without an allowance, you can't upload or download your files. At the end of your contract period, your contracts can't renew if there's no allowance, so your files will be deleted at that time.
One other way to stop renting is to not open Hyperspace within the last 3 weeks of your contract period, by the default contract renewal settings (i.e. the last 3 weeks of your 3 month contract). If Hyperspace isn't open when it needs to renew your contracts, your contracts will eventually expire and your data will be deleted at that point. It's still recommended to cancel your allowance as described above instead of relying on this method.
Can I set a different contract length, number of hosts I form contracts with, or the renewal period for my contracts?
Yes, though this is more advanced than simply using the Create Allowance button.
renter setallowance -h into the Terminal. This will explain how to manually set all of the items mentioned. As an example, if we want to start renting with a 1000 SPACE allowance, a 6 month contract (26 weeks), use the bare minimum of 30 hosts, and we want our contract to renew when we're online within the last 30 days of our current contract, we could type:
renter setallowance 1000SC 26W 30 30D
Note that most hosts by default have their maximum contract length set to 6 months (26 weeks), so trying to create a contract longer than that will likely result in far fewer hosts than keeping your contract length at or below 6 months. You also shouldn't set your number of hosts any lower than 30, because your files will not be sufficiently protected and may never reach full 3x redundancy. Finally, remember that when you upload files, you'll be charged for storing them the entire duration of the contract. If you set a 6 month contract, your storage prices will be twice as high as a 3 month contract, so take that into consideration when you calculate your allowance.
Why do I see that more than 50 contracts (or whatever number of hosts I manually set) have been created?
If Hyperspace finds that a host has gone offline for a while during your contract period, it will automatically find a new host to replace it and create another contract. You might see a few more contracts than the maximum number for this reason. Hyperspace also sometimes creates contracts with hosts it determines are better than your current hosts, even if you've got enough contracts already. If you start seeing significantly more contracts, see the topic below.
Hyperspace is creating significantly more contracts than 50, or my allowance is being totally eaten up by contract fees!
This issue was previously addressed in Sia v1.3.3 before Hyperspace forked. We believe it to be fixed, but please let us know if you encounter it.
Do prices listed for renting storage on Hyperspace include the cost of 3x redundancy?
Yes - price estimates provided by the Hyperspace app include the required redundancy. Technically hosts will individually charge about 1/3 of the renter price quote becaues they'll only fulfill about 1/3 of your total data storage requirement when taking 3x redundancy into account.
How can I get an estimate of what I'll pay as a renter?
The most accurate way is to type
renter prices in the Terminal. This will give you an average set of prices for storage, bandwidth and contracts. This number is unique to your Hyperspace installation because it's basing the prices on hosts your node has actually been in contact with.
We also have a Renting Calculator that you can use to get an estimate of storage costs based on current network averages.
When I run
renter prices, the prices are very high and not similar to what I'd expect.
Make sure Hyperspace is fully synchronized before trying to run
renter prices, otherwise it will not find all current hosts. Also, if you can let Hyperspace run for a few hours (ideally, 24 hours) before querying renter prices, you'll have a better picture of current prices because your node will have time to contact many hosts.
Uploading and Data Redundancy
Hyperspace doesn't look very user-friendly for uploading. Are there any other ways to use Hyperspace to store my data that work more similar to Dropbox?
Hyperspace is still in development, so the UI you see now will likely not be the final version of the product. One of Hyperspace's main goals of forking away from Sia was to become a more user-friendly product, so it's very likely we'll see significant improvements in this area over time.
There are a few products currently integrated with Sia which make storing data easier that may plan to adapt for Hyperspace as well. Visit our External Links to view some of the third-party applications available. You can also interact with Hyperspace via command line or the API if you're technically saavy and want to write your own scripts or applications to leverage Hyperspace.
Can I specify a different level of redundancy if I want my data to be more or less secure?
Not currently. This may be a planned feature for a future release, but right now by default all uploaded files are distributed to 30 hosts for what amounts to 3x redundancy. Hyperspace may occasionally exceed 3x redundancy on it's own when it thinks hosts have gone offline and they show back up again later, but it is not something you can currently control.
Do I need to keep my files locally after upload?
Technically you don't need to keep a local copy of your file once you upload it, though if you don't it will be more expensive to boost redundancy if needed because Hyperspace will have to download the file first to reconstruct it before uploading it again. Because upload and download bandwidth carry a fee, this can become expensive.
Also keep in mind that Hyperspace is still in development, and still has occasional bugs. At this time, you should never store critical data only on Hyperspace.
If hosts go offline, do I need to do anything for my files to be safe?
Yes. Your files will be repaired automatically, or redundancy restored, as long as there are still at least 10 hosts with your file. You simply need to open the Hyperspace client that you uploaded the files with as a renter, and the client will automatically restore redundancy by redistributing it to hosts as necessary to maintain 3x redundancy. For this reason, it's suggested that you open your Hyperspace client at least once a month for files to be checked and redundancy boosted if needed.
My uploads seem to have stalled, but I've still got plenty of allowance left.
Watch your Space Cash allowance over a period of about an hour, and make sure your uploads aren't moving and Space Cash isn't being deducted. Sometimes upload progress is hard to see, and sometimes uploads bog down for 10-15 minutes.
If you're sure that your uploads have stalled, about the only thing you can do is restart Hyperspace by completely exiting it and opening it back up again. Make sure you completely exit Hyperspace - if you simply close the Hyperspace app, Hyperspace still runs in the background and via a system tray icon. Right click the icon and select Quit Hyperspace, wait a few minutes, and then open Hyperspace again and see if your uploads resume. Only do this if you're certain your uploads have stalled, because we've found that quitting Hyperspace while uploading may sometimes cause several new contracts to be created when we open Hyperspace again, which eats up Space Cash and our allowance quickly due to contract fees.
Can I download my files from Hyperspace on another computer, i.e. if my renter computer crashes?
Yes, but only if you've backed up your Hyperspace local data files that contain your renter contract and file metadata. A current limitation of Hyperspace is that the internal data files are required to retrieve files from the Hyperspace network. Without these files, you will lose access to your data on the network. If you're renting storage on Hyperspace, you should also back these files up separately and outside of Hyperspace so that you can use them to access your data in the event your computer crashes or you encounter any other issues.
A further complication is that these files are only valid if you back them up after you last uploaded or downloaded any data from Hyperspace. Any time you interact with the Hyperspace network, you need to back up your metadata files again afterwards. For this reason, Hyperspace is only recommended for cold storage at this time.
This limitation will likely be removed in the future with the introduction of file sharing, but for now it's an important detail to be aware of because most users assume data stored on the Hyperspace network is safe and can be retrieved from anywhere like any other type of cloud service by just downloading Hyperspace again, when this is not necessarily the case.
Legal and Liability
Please note that the information provided below is for general reference only. It is not intended to be legal advice. If you have any legal concerns, please consult an appropriately qualified attorney or other legal counsel.
Since Hyperspace encrypts and distributes my data, what's to stop me from using Hyperspace to store illegal content?
An honest answer: nothing, really. Being a decentralized platform, there's nobody policing what data is uploaded to the Hyperspace network. This has raised concerns from some users that Hyperspace will inevitably be used to store illegal material of various kinds, which might draw unwanted attention from law enforcement. The Hyperspace developers have said that this should not be an issue in regards to liability of the network or the hosts, that strong legal protections apply to hosts, and that the renter would be responsible for any such use.
At this time, there's no method of sharing files directly from or on the Hyperspace network with other users, so any illegally uploaded content would only be accessible to a renter. Because the renter would be the only one with the key to the file, nobody would know what the renter was storing if they didn't otherwise draw attention to the fact. It would not be advisable to store illegal content on Hyperspace, of course, but the honest answer is that little could be done to prevent it.
Are hosts liable for losing my data? What if more than 20 hosts go offline and I lose my files?
It would be extremely unlikely that the majority of your hosts would go offline during your contract period. Hosts have many incentives to keep them online, including a host score for uptime and a financial incentive in the way of collateral that a host is at risk of losing if they don't complete your contract. For this reason, most hosts will stick around and stay online with your data 24/7. Additionally, if you open your Hyperspace app every month or so, your files will be redistributed if any hosts have disappeared, so this should never be an issue.
If you did end up in the unfortunate situation where you lost enough hosts to be able to restore your files, there's not much you'd be able to do about it. A storage contract from a host basically says "I'll store your files for this duration and this price, or else I'll lose my collateral as a host". The satisfaction of knowing that several hosts would be experiencing a financial penalty for losing your data would probably be the extent of your recourse.
Don't see your question answered? Let us know and we'll see if we can add it to the FAQ.