63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Storing Data
|
|
|
|
> There are recent bug reports with these instructions. If you happen to encounter any problems, please create a [GitHub issue](https://github.com/filecoin-project/lotus/issues/new) and a maintainer will address the problem as soon as they can.
|
|
|
|
Here are instructions for how to store data on the **Lotus Testnet**.
|
|
|
|
## Adding a file locally
|
|
|
|
Adding a file locally allows you to make miner deals on the **Lotus Testnet**.
|
|
|
|
```sh
|
|
lotus client import ./your-example-file.txt
|
|
```
|
|
|
|
Upon success, this command will return a **Data CID**.
|
|
|
|
## List your local files
|
|
|
|
The command to see a list of files by `CID`, `name`, `size` in bytes, and `status`:
|
|
|
|
```sh
|
|
lotus client local
|
|
```
|
|
|
|
An example of the output:
|
|
|
|
```sh
|
|
bafkreierupr5ioxn4obwly4i2a5cd2rwxqi6kwmcyyylifxjsmos7hrgpe Development/sample-1.txt 2332 ok
|
|
bafkreieuk7h4zs5alzpdyhlph4lxkefowvwdho3a3pml6j7dam5mipzaii Development/sample-2.txt 30618 ok
|
|
```
|
|
|
|
## Make a Miner Deal on Lotus Testnet
|
|
|
|
Get a list of all miners that can store data:
|
|
|
|
```sh
|
|
lotus state list-miners
|
|
```
|
|
|
|
Get the requirements of a miner you wish to store data with:
|
|
|
|
```sh
|
|
lotus client query-ask <miner>
|
|
```
|
|
|
|
Store a **Data CID** with a miner:
|
|
|
|
```sh
|
|
lotus client deal <Data CID> <miner> <price> <duration>
|
|
```
|
|
|
|
Check the status of a deal:
|
|
|
|
```sh
|
|
lotus client list-deals
|
|
```
|
|
|
|
- The `duration`, which represents how long the miner will keep your file hosted, is represented in blocks. Each block represents 45 seconds.
|
|
|
|
Upon success, this command will return a **Deal CID**.
|
|
|
|
The storage miner will need to **seal** the file before it can be retrieved. If the **Lotus Storage Miner** is not running on a machine designed for sealing, the process will take a very long time.
|