Rust implementation of the Filecoin Protocol

Run Forest to access Filecoin, the decentralized storage network.

With Forest, you can...

Validate the Filecoin blockchain

Gain access to Filecoin chain data

Generate blockchain snapshots

Send and receive FIL with a built-in wallet

All this is available with minimal hardware.

The Forest beta awaits testers

Join our beta program to help make Forest the best it can be. Let us know how we can support your needs.

Bootstrap your custom full node.

Select Calibration testnet or Filecoin main network.

Test our new HTTP-RPC interfaces.

Import the Filecoin archive.

Requirements to run a Filecoin node on the mainnet:

  • Forest (minimal)

    2-core

    CPU

    8 GiB

    RAM

    128 GiB

    SSD

    none

    GPU

  • Forest (recommended)

    4-core

    CPU

    16 GiB

    RAM

    512 GiB (NVMe)

    SSD

    none

    GPU

  • Lotus (minimal)

    8-core

    CPU

    32 GiB

    RAM

    512 GiB (NVMe)

    SSD

    none

    GPU

  • Lotus (storage miner)

    8-core

    CPU

    256 GiB

    RAM

    2 TiB (NVMe)

    SSD

    Nvidia (11GiB VRAM)

    GPU

Forest comes with different command-line binaries.

forest

The Forest daemon to connect to the Filecoin network and synchronize the latest tipset of the blockchain.

forest-cli

The Forest command-line interface to interact with the daemon, querying the Filecoin blockchain, network, and state.

forest-tool

A set of utilities to manage databases, snapshots, and state migrations.

forest-wallet

Create Filecoin accounts and send and receive FIL.

Running a Node

Start the forest node. It will automatically connect to the bootstrap peers and start synchronizing the chain. If it is the first time starting the node, it will download the latest state snapshot

On calibnet: forest --chain calibnet

On mainnet: forest

In another shell, invoke commands on the running node using forest-cli, i.e., to check the synchronization status:

On calibnet and mainnet: forest-cli sync status

Learn More

The end-user and developer documentation is available on GitHub pages.

The source code is available under the Apache 2.0 License on GitHub.

The full API documentation is available as a rust-doc book.

Accessing Filecoin Data

Snapshot Service

No matter which Filecoin client software you operate, you can download the lightweight Forest chain state snapshots to bootstrap your node.

Full

A full snapshot contains all block headers from genesis and the entirely inhabited chain state.

Lite

A light snapshot contains all block headers from genesis and only the state tree for the latest N epochs.

Diff

A diff snapshot contains only block headers and messages for the latest N epochs.

Download latest snapshots

The Forest node automatically downloads the latest snapshots. For all other clients, you can provide the following downloads:

Calibnet

Mainnet

Forest Archive

The entire archive of the Filecoin history was generated by Forest and is available for download free of charge. The archive is split into multiple snapshots, which can be joined together to form a complete history of the network.

Calibration Testnet Diff-Snapshots

Calibration Testnet Lite-Snapshots

Filecoin Mainnet Diff-Snapshots

Filecoin Mainnet Lite-Snapshots

Stay up to date with Forest

The Forest Team

About the team

The Forest team comprises ten developers distributed across the world. ChainSafe, one of the world's leading blockchain research and development firms, maintains the client.

The seeds of Forest

Thank you for your incredible contributions to Filecoin.

Join the team!