You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-4
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
# Filecoin FVM localnet
4
4
5
-
Filecoin FVM Localnet is a complete Filecoin [Lotus](https://lotus.filecoin.io/) and [Boost](https://boost.filecoin.io/) Docker image that allows you to spin up a localnet for FVM smart contract development.
5
+
Filecoin FVM Localnet is a complete Filecoin [Lotus](https://lotus.filecoin.io/) and [Boost](https://boost.filecoin.io/) Docker image that allows you to spin up a localnet for FVM smart contract development. You can also run two miners for testing things like replication between SPs.
6
6
7
7
8
8
## System requirements
@@ -31,15 +31,21 @@ Ensure you have [Docker installed](https://docs.docker.com/get-docker/).
31
31
32
32
1. OPTIONAL: Edit the file `.env`if you wish to optionally run an 8M sector network, otherwise the default 2k sectors will be used
33
33
34
-
1. Run Docker `compose up`:
34
+
1. To run a single miner instance (default): run Docker `compose up`:
35
35
36
36
```sh
37
37
docker compose up
38
38
```
39
39
40
+
1. To run two miners and two Boost instances (replication): run:
41
+
42
+
```sh
43
+
docker compose --profile replication up
44
+
```
45
+
40
46
1. To stop the network type`ctrl-c`.
41
47
42
-
Once the localnet is started, you can navigate the Boost UI at: `http://localhost:8080`.
48
+
Once the localnet is started, you can navigate the Boost UI at: `http://localhost:8080`. If you run in replication mode there is a second Boost instance at: `http://localhost:8081`.
43
49
44
50
## Metamask and Funding a Wallet
45
51
@@ -93,5 +99,5 @@ In order to transact with the network, you will need some funds (tFIL) in your w
93
99
94
100
- This network has a block time of 15 seconds (half the time of Filecoin mainnet).
95
101
96
-
102
+
- Running in'replication' mode will start up a second Lotus miner instance and a second boost instance connected to it. This allows you to test replication between miners, and smart contracts that need two miners to work.
0 commit comments