LEGAL DISCLAIMER: The following questions and answers are provided for general informational purposes only, and may contain forward looking statements subject to risks and uncertainties. The actual properties and behavior of the protocol may differ materially from the information provided here. Statements in this document are not investment or legal advice.
These FAQs include questions and answers to help those interested in the Filecoin network further understand: 1) the Filecoin protocol’s value proposition, and the problems it aims to solve, 2) certain protocol design decisions, and 3) how to participate in the Filecoin network.
We also have a translation of the Filecoin FAQs available in Chinese.
1. Filecoin 101
What is Filecoin?
Filecoin is a decentralized storage network that turns cloud storage into an algorithmic market. Miners earn the native protocol token (also called “filecoin”) by providing data storage and/or retrieval. Conversely, clients pay miners to store or distribute data and to retrieve it. “Filecoin” can refer to a) the network, b) the protocol, c) the token powering the network, and d) the project. For more details, please see the Glossary below and https://filecoin.io/.
What is the connection between IPFS and Filecoin?
Filecoin and IPFS are complementary protocols, both created by Protocol Labs. IPFS allows peers to store, request, and transfer verifiable data with each other. IPFS is open-source and free to download and use, and is already in use by numerous groups. With IPFS, individual nodes store data that they consider important; there’s no simple way to incentivize others to join the network or store specific data.
Filecoin is designed to solve this key problem by providing a system of persistent data storage. Under Filecoin’s incentive structure, clients pay to store data at specific levels of redundancy and availability, and miners earn payments and rewards by continuously storing data and cryptographically proving it.
In short: IPFS addresses and moves content; Filecoin is the missing incentive layer.
Filecoin also employs many components of IPFS. For example:
- Filecoin uses IPLD for blockchain data structures
- Filecoin nodes use libp2p to establish secure connections to each other
- Messaging between nodes and Filecoin block propogation utilizes libp2p pubsub
Moreover, the Filecoin core team includes some members of the IPFS core team. Compatibility is intended to be as seamless as possible between IPFS and Filecoin. Even after Filecoin launches, we expect the IPFS and Filecoin open-source communities to continue to collaborate and improve compatibility.
When should I choose to use Filecoin and when should I choose IPFS?
First, it’s worth repeating that Filecoin and IPFS are intended to complement each other and have significant cross compatibility. We are working to make it easy to migrate between voluntary IPFS storage and paid Filecoin storage.
With IPFS, you are responsible for your own storage nodes by directly provisioning hardware or purchasing storage from a third party. On IPFS, individual nodes store content that they consider important; there’s no simple way to incentivize others to guarantee to store your data on their systems. Filecoin provides the missing incentive structure.
If you prefer to maintain your own storage nodes, or have external arrangements to store data cooperatively with peers, IPFS may be your preferred option. If you prefer to pay competitive prices and have storage managed for you at specific levels of redundancy and availability, Filecoin may be your preferred option.
Why use decentralized storage on Filecoin with IPFS instead of existing data storage solutions?
When you type a URL into your web browser to access information on the internet today, the URL resolves to an IP address that identifies one server storing the information you are looking for. Nearly every publisher, vendor, and service on the internet stores information on servers located in specific data centers under their control, which makes the internet as we know it today “centralized”.
Filecoin is a decentralized storage system that uses cryptographic hashes to identify and distribute data stored on the network. The network protocol itself works to ensure your files are stored. Novel cryptographic proofs create a useful and valuable storage service for clients as a byproduct of the Filecoin mining process. The miners are incentivized to monetize open hard drive space on Filecoin’s verifiable marketplace for storage, and they are awarded proportionally: the more they store, the more filecoin tokens they earn.
We believe this additional supply of verifiable, decentralized storage will both reduce costs and improve performance for clients. As a decentralized protocol, the data stored in the network and access to it cannot be controlled or exploited by a central entity, which improves robustness. At scale, information distributed across Filecoin miners will be stored nearer to users than is currently possible with monolithic centralized servers and large content distribution networks, making information retrieval much faster. Indexed data via cryptographic hashes on Filecoin enables users to efficiently orchestrate and update massive datasets. Lastly, as an open-source project, the software itself can be examined, verified, and improved publicly, unlike most cloud storage and distribution platforms today. As Filecoin evolves and new capabilities are added, we hope the network can provide a platform for most, if not all, information storage and delivery needs across the internet.
Back to Table of Contents
2.1 Setting up to mine
How do I become a storage and/or a retrieval miner?
In short, you will be able to run Filecoin mining node software in a way that is similar to networks like Bitcoin and Ethereum. We will continue to share more information and issue guidance as development progresses. Please be sure to join the miner mailing list to receive future updates.
What are the hardware requirements for mining Filecoin?
We have not yet released exact hardware specifications for Filecoin mining.
Storage miners earn filecoin by storing data for clients, and computing cryptographic proofs to verify storage across time. The probability of earning the block reward and transaction fees is proportional to the amount of storage the miner contributes to the Filecoin network, and not hashing power.
Retrieval miners earn filecoin by winning bids and mining fees for a particular file that are determined by the market value of that file. A retrieval miner’s bandwidth and bid/initial response time for deals (i.e., latency and proximity to clients) will determine its ability to close retrieval deals on the network. The maximum bandwidth of a retrieval miner will set the total quantity of deals it can make.
Therefore, mining hardware should include ample storage space for storage mining, and/or a fast internet connection for retrieval mining. We expect that mining hardware will contain configurations with many hard drives, likely similar to a network-attached storage (NAS) device. Exact specifications for CPU and RAM have not yet been published. We also note that early storage and retrieval miners will be required to run full nodes of the Filecoin network.
Will I need an ASIC to mine Filecoin?
We’re doing our best to design the protocol so that “specialized Filecoin mining hardware” is most likely a highly optimized hard drive. Because Filecoin’s consensus mechanism is based on Proof-of-Replication and Proof-of-Spacetime, there is no hash-intensive Proof-of-Work. While the Filecoin proofs do require frequent storage lookups that could be facilitated by hardware, it would be expensive and likely impractical to design ASICs that support such random access to large amounts of memory. Realistically, we expect commodity hard-drives to generate and verify proofs at competitive speeds.
2.2 Running your node
What kind of data is stored on a storage node?
The Filecoin whitepaper states that storage miners will store two types of data: (1) sealed copies of the data they have agreed to store and (2) blockchain data. We expect miners will act as full nodes to better support the protocol, storing and verifying the complete blockchain. Since stored files will not be included in the blockchain itself, total storage required for storing the entire blockchain will be much lower than the sealed data that miners will store for deals.
Can retrieval miners store data without being storage miners (for instance, store some popular data to serve to others)?
Yes, retrieval miners can store data without being storage miners. However, storing data does not make a retrieval miner a storage miner. All storage miners are required to engage in the Filecoin Mining Protocol. That means: pledge storage, commit collateral, and prove storage continuously through Proofs-of-Spacetime.
How do retrieval miners acquire the data to send to clients?
We anticipate retrieval miners will also be storage miners (in which case they get the data directly from the client) or will retrieve a file from other storage miners if they realize the file is in high demand. The retrieval miner is not restricted to obtaining the data through Filecoin. It is possible that the data was temporarily available on IPFS or a server for free.
How can a blockchain-based protocol handle fast retrieval of files?
While the storage market takes place on-chain, the retrieval market will operate entirely off-chain. We also expect that retrieval miners serving popular data will be globally distributed and efficient. You can watch the Filecoin Storage Market Basics video for more information.
2.3 Rewards and profitability
How do I earn Filecoin as a miner?
Individual miners can participate in both the storage and retrieval markets to earn filecoin.
In the storage market, miners are paid filecoin over time as they continue to prove they are storing a particular file. In addition, storage market miners have some likelihood of winning the next block, and earning the block reward and fees from transactions included in the block (similar to block rewards in other cryptocurrencies).
In the retrieval market, miners are paid in filecoin via off-chain payment channels for quickly providing files to clients who request them.
Back to Table of Contents
3.1 Usage and costs
Why do I have to use Filecoin to pay for data storage and retrieval? Why not another cryptocurrency, like bitcoin, or a fiat currency, like USD?
Filecoin uses a native currency to engineer an incentive structure for the participation of storage and retrieval miners, or the supply side, of our network. Filecoin was designed with the goal of ensuring that the most profitable choice of every participant (including clients, miners, investors, and developers) is to act to improve the quality of service for the network.
Filecoin is built around a novel blockchain consensus protocol based on Proof-of-Storage. Clients who want to store files on the Filecoin network hire miners to store multiple copies of their files across the network. Each miner must submit publicly verifiable cryptographic proofs that they are continuing to store the data in order to receive payment and block rewards in filecoin. Payment and rewards in filecoin power the incentive structure to guarantee a fair, permissionless, robust, and decentralized storage network.
Will there be any charges to users for retrieving the data?
In some cases yes, and in some cases no. Someone needs to pay for the bandwidth costs incurred by miners serving the data to whoever is retrieving it. The simplest structure is for whoever is retrieving the data to pay for the costs of their own request.
Of course, that simple structure is not enough to satisfy the wide variety of data storage and distribution arrangements in the internet today. It is anticipated that Filecoin will offer constructions that allow one party to pay for another party to retrieve data (for example, via the use of vouchers or tickets). That will make many other kinds of models work, including the main content distribution model of web 2.0 websites. In that model, website owners pay for infrastructure services to serve data to their users for free, and then monetize the content in some other way. We aim for Filecoin to support structures like these. But we also aim to enable users and content creators to explore all kinds of new content distribution and economic models.
IPFS is and will remain free to download, run, and use, and will run independently from Filecoin. Once Filecoin launches, IPFS nodes may also offer retrieval of their files on the Filecoin retrieval market at no cost or for a profit.
In addition, we believe that data sets with significant scientific or cultural value that are currently hosted on IPFS may have their Filecoin costs sponsored by nonprofits and governments.
3.2 Usage and guarantees
I might like to store data on Filecoin. How do I stay informed?
How do you prevent information loss on Filecoin’s decentralized storage network?
Filecoin is designed for highly redundant, highly available, and highly geo-replicated storage. Nobody can cover against all data loss scenarios, but we can drastically increase the probability of success by encouraging high replication, repairing damage proactively, and making it expensive for miners to fail.
Filecoin stores data redundantly across multiple storage miners. If one of those miners loses the file, they then lose their committed collateral (as a fee for failing to honor the deal), and a new miner will be automatically hired to store another replica of the file. In this way, the Filecoin network is expected to be self-healing, and repair damage over time. This is similar in some ways to how professional cloud storage providers work today, but with an added repair that works across multiple storage providers.
On the Filecoin network, clients can adjust the number of times their data is replicated, also known as the replication factor (or erasure coding), to achieve higher levels of redundancy and safety, though at a higher cost. Replication defaults will be carefully chosen to optimize safe storage and reduce the risk of data loss. Clients can adjust these defaults to achieve even higher (or lower) levels of redundancy and safety, at different costs.
In addition, we expect reputation systems to emerge. We expect that client nodes will then be able to run software that learns the past history of storage miners and aims to hire more reliable miners.
What happens if a miner storing my data loses internet connectivity?
It’s difficult for a protocol to distinguish a miner who has lost connectivity from a miner who has maliciously deleted the data they’ve promised to store. As a result, miners are required to lock up collateral, which they lose if they fail to prove that they’re storing the files. If a single miner is offline for a short period of time, and continues to generate proofs, they will be subject to little or no penalization. Eventually, if the miner is offline for too long, the miner is declared to have failed. The miner loses its collateral, and the network triggers the repair process, hiring a new miner to store the data.
How will users retrieve their files by name? Won’t people upload different files with the same name?
Like IPFS, Filecoin uses content addressing. We use cryptographic hash functions to generate concise content identifiers (CIDs). This acts as a unique identifier or “fingerprint” for each file, regardless of name.
What about hash collisions? Isn’t it possible that two files can get the same hash value?
We believe the probability of encountering a collision with modern, secure, collision resistant cryptographic hash functions is astronomically low. Further, the likelihood of finding a second file that hashes to a specific value (second preimage attack) is even more unlikely. Cryptosystems around the world rely on these values being secure, and thus we believe it is safe to do so in Filecoin.
That said, secure hash functions have broken in the past. The collisions we have found in secure hash functions have generally been due to the hash function breaking under cryptanalysis (such as md5 and sha1). This is always a possibility, and most other cryptosystems – such as Bitcoin, Ethereum, DNSSEC, Certificate Authorities, HTTPS, and more – are equally vulnerable. Nevertheless, we have planned for this unlikely event! Our content identifiers (CIDs) use the Multihash format, allowing safe upgrades to a new hash function.
Okay, but am I supposed to remember those CIDs or hashes?
If you want to remember that QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco gets you a Wikipedia mirror, you have our respect. But users should not be expected to remember content identifiers (CIDs) in this format. Over time, we and other developers building on Filecoin plan to make it easy for users to seamlessly and conveniently find files using human-readable naming systems.
Back to Table of Contents
4. Filecoin 201
For those who want to dig deeper…
Why is Filecoin decentralized?
The Filecoin network is decentralized because, anybody, without requiring permission from any central party, can:
- Participate by providing data storage or retrieval
- Use the network to store and retrieve data
- Audit and verify the codebase
- Improve the protocol by proposing and implementing improvements
- Build applications, features, or functionality on top of the network without asking for permission
- Voice dissent and propose other options or directions for the network
- Fork the codebase
- Fork the blockchain
- Hold or transact with the filecoin token
Filecoin will be an open-source protocol to which anyone can contribute or choose to run; moreover, the protocol, not a particular company, will mediate interactions between the participants. Filecoin will rely on support from its communities of developers, storage providers, and storage users building and using the protocol, rather than on the efforts of any particular company.
Clients who want to store files on this network hire miners to store multiple copies of their files across the network. Each of these miners must submit proofs that they are continuing to store the correct number of copies of the data in order to receive payment and rewards. The publicly verifiable proofs allow the Filecoin protocol to permissionlessly admit any aspiring participant (without verification or centralized approval) and still provide a system for guarantees based on the engineered incentives: Filecoin was designed with the goal that the most profitable choice of every participant (including clients, miners, investors, and developers) is to act to improve the quality of service for the network.
What’s the difference between all these “proofs”?
Most blockchains use a Proof-of-Work consensus protocol to incentivize mining and provide network security. These proofs are generally energy intensive as they require computers running nodes to calculate many computations of a hash function in order to verify the transactions on the network. While some novel projects are working toward a Proof-of-Stake consensus mechanism, the Filecoin protocol will use Proof-of-Replication (PoRep) and Proof-of-Spacetime (PoSt) to demonstrate that files have been allocated their own unique space in storage memory and are being stored over time. A Proof-of-Replication is a type of Proof-of-Storage with specific properties, which are outlined in detail in our Technical Report on Proofs-of-Replication.
Why use Proof-of-Replication?
Proof-of-Replication was developed to solve the specific problems of a verifiable, decentralized storage network that could incentivize and reward file storage. One of the biggest draws for developing a blockchain consensus algorithm based on Proof-of-Replication was, in fact, our dismay for the wasted energy from hash-based Proof-of-Work schemes. Proof-of-Replication not only requires much less energy than Proof-of-Work, but the work required is a demonstration that miners are contributing a valuable resource to the network, namely additional storage capacity. Furthermore, the block reward serves to incentivize miners to contribute as much storage as possible, driving down the price of storage on the Filecoin network.
Will networks prefer Proof-of-Storage currencies over those that use Proof-of-Work consensus?
We find the power consumption of wasteful proofs-of-work incredibly alarming. Given the quality and number of proposals for useful Proof-of-Work and Proof-of-Stake consensus protocols under development, we think that wasteful proofs-of-work should and will slowly wane as various networks adapt, or rise and fall. We hope and expect the Filecoin network to grow and adapt in a sustainable manner. We aim for the energy expenditure of the Filecoin network to be a negligible fraction of the energy spent maintaining Bitcoin, while providing the same level of security, and the utility of file storage as a side effect. We also hope to establish an optimization structure that may one day yield more power-efficient cloud storage networks. To that end, we’re looking into estimating the environmental impact of all aspects of Filecoin.
Why did Filecoin choose to use Proof-of-Storage, rather than Proof-of-Stake?
Filecoin uses a Proof-of-Storage consensus protocol because it is simple, aligns incentives, and drives miners to provide real, new storage at competitive prices. In developing a new type of Proof-of-Storage that we call Proof-of-Replication, we will enable miners’ storage devices to contain useful data, making them a valuable resource for the network. Proof-of-Stake is an interesting area of research that we closely follow.
Back to Table of Contents
How do I access or view my SAFTs?
How will I receive my tokens?
We intend for Filecoin tokens to be distributed when the main network is launched (please see the development roadmap for the latest estimated timeframe). Shortly before then, we’ll send instructions to the email address associated with your CoinList account.
Will Filecoin issue K-1s for my SAFTs?
No K-1s will be issued for investments in Filecoin SAFTs. To review your final Filecoin SAFTs, follow the steps in this guide we have published on our website. Unfortunately we’re unable to give tax advice, so we suggest consulting with your tax advisor.
When does the token vesting period start?
The filecoin token vesting period begins at main network launch. Shortly before then, we’ll send instructions to the email address associated with your CoinList account. Please see development roadmap for the latest estimated timeframe.
Can I purchase Filecoin right now?
The Filecoin token sale was closed in September 2017, and we’re not able to complete any new investments at this time. Fortunately we expect there will be more opportunities to participate in Filecoin upon main network launch. At that point, Filecoin tokens will be able to be mined through making storage and retrieval available on the network, and likely available on certain exchanges to be bought and sold.
I’ve seen some sites claiming to trade Filecoin. Are those real?
Investor caution: During and after the Filecoin token sale, we have seen parties claiming to sell Filecoin SAFTs or tokens, as well as exchanges listing Filecoin and Filecoin derivatives. Remember that the Filecoin token will not be live until network launch, and any exchange that lists Filecoin or IPFS tokens right now is likely fraudulent. We will announce on the Filecoin blog when the Filecoin network and token go live. Until then, we strongly recommend staying away from any exchange or entity who claims to be buying, selling, or trading Filecoin or IPFS SAFTS, tokens or derivatives.
Back to Table of Contents
Are there community forums?
We plan to open up official community forums for miners, clients, and developers as we are closer to launching the network. In the meantime, please look for our updates on the Filecoin blog.
Does Protocol Labs, Filecoin, or IPFS have any official community partners around the world, specifically in China?
Protocol Labs is excited to see that IPFS is being embraced and promoted by many communities around the world. Some of those communities and their members have been in contact with us, and have offered to help us with things like translations. In some cases, we may accept open-source help, but that does not establish any sort of official or formal relationship. At this time, Protocol Labs has no official partnership with any community or individual, including Chinese communities or individuals. Any updates about official community partners will be announced on our website, or on the Filecoin blog.
Where are the code repositories for Filecoin?
The code repositories for Filecoin can be found on Github. We’ll be opening the Github repositories hosting the go-filecoin implementation and related tools in the coming months (see the development roadmap).
How can I contribute to the Filecoin codebase?
We have nearly passed the critical period when we needed to keep the codebase private, and are quickly reaching a point where the implementation would benefit more from being public. Therefore we plan to publish the codebase in the coming months. This will be an exciting time to get involved! At that point, everybody interested can come learn about Filecoin, help build parts of it, and start building on top of it.
We will be inviting a number of collaborators and contributors to our codebases before opening them up. You can register your interest in this form.
I have an idea! How do I discuss it with you?
I want to start a Filecoin Meetup group! How do I do it?
We love to see volunteers developing communities around Filecoin. Please email email@example.com with your information (name, background, experience, and location) and we’ll try to help however we can!
How do we get someone from the Filecoin team to speak at our event?
How do we get someone from the Filecoin team to speak to our research group?
I want to work on this full time! How can I join the Filecoin Team?
Ambitious projects like Filecoin succeed or fail depending on their teams. If you might be excited to help us build the Filecoin network, and share our vision, mission, and values, please apply for full time roles or check out our RFP program if you’d like to specifically help research our open problems.
Back to Table of Contents
I’d like to build an application on Filecoin. How do I stay informed?
My question isn’t listed here. How can I get some answers?
Back to Table of Contents
Filecoin is a decentralized data storage network powered by a blockchain and a native token. Filecoin’s blockchain runs on a novel proof, called Proof-of-Spacetime, where blocks are created by miners that are storing data. The Filecoin network refers to the network of independent data storage and retrieval miners (or providers) and the clients that can hire them. Clients can hire miners via two decentralized, verifiable markets: the Storage Market and the Retrieval Market. The Filecoin network handles storage and retrieval requests on its verifiable markets without relying on centralized coordination from a single company. Protocol Labs initially proposed the Filecoin network in July 2014 (link), and the design was substantially improved in early 2017 (link).
The Filecoin protocol refers to the communication standard that independent participants (miners and clients) adopt as part of our network. This standard is implemented in the Filecoin codebase and run by all participants on the Filecoin network. The protocol enables Filecoin’s data storage and retrieval service without relying on a single coordinator. The Filecoin protocol builds on the decentralized storage network, novel Proofs-of-Storage, verifiable markets and useful Proof-of-Work.
The filecoin token is the native crypto token of the Filecoin network, similar to bitcoin and ether. Filecoin is used to participate and transact in the Filecoin network (i.e., pay for data storage and retrieval).
The Filecoin project includes the Filecoin protocol, Filecoin codebase, filecoin token, supporting communities (participants, developers, investors and token holders), project communications, and a team of individuals. The Filecoin project team is responsible for developing the Filecoin network’s codebase, launching the network, and cultivating the ecosystems that support the miner, user, developer, and investor communities of the network.
Access is provided to anybody; no approval or formal verification from a single entity or authoritative third party is required to participate.