# Filecoin 技術文件

## Lotus 環境設定

### 系統需求

Linux系統都可以, 本文是用 Ubuntu-20.04

Package dependency

go (1.13 or higher)
gcc (7.4.0 or higher)
git (version 2 or higher)
bzr (some go dependency needs this)
jq
pkg-config
opencl-icd-loader
opencl driver (like nvidia-opencl on arch) (for GPU acceleration)
opencl-headers (build)
rustup (proofs build)
llvm (proofs build)
clang (proofs build)

### 安裝步驟

# Install package
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install golang-go gcc git bzr jq pkg-config mesa-opencl-icd ocl-icd-opencl-dev

# Download lotus code
git clone https://github.com/filecoin-project/lotus.git
cd lotus/

# Build and install
make clean && make all
sudo make install

### 執行服務

# 更改 ulimit (重要!!!)
ulimit -n 10000

# 執行 lotus daemon
lotus daemon

執行完成之後, terminal 就會持續同步節點.

**直到節點同步完成之前, 都不能進行做挖礦的動作**

如果要檢查本機端的同步狀態:

lotus sync wait

如果要得知整個網路的狀態:

[filecoin Grafana dashboard](https://filscan.io/#/)

最後, 無論如何都必須要有一點點 FIL 才能開始做事

**請先新增一個錢包, 再去 Faucet 要錢(Send Funds)**

[Faucet](https://faucet.testnet.filecoin.io/)

---

## Lotus 基本 Commands

lotus --help # 說明
lotus net peers # 查看已連接的 peers
lotus net peers | wc -l # 統計已連接的 peer 數量
lotus sync wait # 觀察同步狀態


lotus wallet new # 新增錢包
lotus wallet list # 查看所有錢包
lotus wallet new bls # 新增一個 bls 錢包(for 挖礦)
lotus wallet balance <YOUR_NEW_ADDRESS> # 查看餘額
lotus send <target> <amount> # 轉 amount 數量的 FIL 給 target address

## 挖礦步驟

等節點同步完成, 就可以參考官網指示開始挖礦

https://docs.lotu.sh/en+mining

## Trouble Shooting

1. lotus daemon跑起來之後, 務必檢查有沒有連接到節點
如果沒有的話, 請參考 reference 的官網 trouble shooting

## Reference
[官方網站](https://docs.lotu.sh)

[安裝步驟](https://docs.lotu.sh/en+install-lotus-ubuntu)

[Faucet](https://faucet.testnet.filecoin.io/)

[挖礦教學](https://docs.lotu.sh/en+mining)