The process of storing and retrieving data using the Filecoin network is slightly different from how most storage platforms work. This tutorial walks you through the whole end-to-end process of keeping your data and then getting it back when you need it! We’re going to use Lotus and the command-line in this tutorial.
The process is split into three main parts: the set-up, storing your data and retrieving your data. Each section has several sub-processes that we need to follow.
|Set up||1. Get access to a Lotus full-node.|
2. Start a Lotus lite-node on your local computer.
3. Get a FIL address.
4. Sign up for Filecoin Plus.
|Store data||1. Package your data.|
2. Import your data into Lotus.
3. Find a storage provider through the Filecoin Plus storage provider registry.
4. Create a storage deal.
5. Wait for the deal to complete.
|Retrieve data||1. Create a retrieval deal.|
2. Download your data.
It will take about an hour to complete this tutorial. While there aren’t too many steps involved, there’s a bit of waiting around for the network to process your requests.
There are a few things to remember throughout this tutorial, such as Miner IDs and addresses. There is a table at the end of each section showing the information you should record:
|Miner ID||The unique identifier for each storage provider.|
The above table is an example of what you will see throughout the tutorial; you don’t have to copy it down.
Terms and phrases
This tutorial contains some words and phrases that you might not be familiar with. Refer back to this table if you encounter something you don’t understand:
|Address||A string of letters and numbers that other users can send FIL to.|
|Block explorer||A service, usually a website, that lets you view details of a blockchain such as transactions, deals, and addresses.|
|Deal||An agreement between two computers about what to do with some data.|
|FIL||The shorthand representation of the filecoin cryptocurrency. For example: We charge 0.5 FIL per GiB.|
|Filecoin (upper-case ||The network that transactions and storage deals take place on. For example: Museums can use the Filecoin network to store their digital archives.|
|filecoin (lower-case ||The cryptocurrency that the Filecoin network runs on. For example: You can use filecoin to pay for your transactions.|
|Miner||An alternate name for a storage provider.|
|Private key||A string of letters and numbers that programs use to interact with the Filecoin network. Keep your private key safe, and don’t share it with anyone.|
|Storage deal||An agreement between a storage provider and a client about what data to store, how long for, and how much the storage provider can charge for storage.|
|Retrieval deal||An agreement between a storage provider and a client about how much the storage provider can charge to send data to a client.|
|Storage client||The user that wants to store something on the Filecoin network. In this tutorial, you are the storage client.|
|Storage provider||A computer on the Filecoin network offering storage space to other users who want to store data. Storage providers are sometimes called miners.|
|Wallet||A collection of addresses. Think of each wallet as a folder and each address as a single file in that folder.|
Before we can manage data on the Filecoin network, we need to set up things like a Lotus node and a Filecoin wallet. Head to the set-up section to start gathering your resources →