Skip to content

Commit 5119b03

Browse files
committed
Update .env file to latest images, that support replication mode with two miners. Update README
1 parent 7b316e4 commit 5119b03

File tree

2 files changed

+12
-6
lines changed

2 files changed

+12
-6
lines changed

Diff for: .env

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
## the section below.
33

44
## 2k network
5-
IMAGE=ghcr.io/filecoin-project/filecoin-fvm-localnet-preproofs-2k:sha-fa13f1a
5+
IMAGE=ghcr.io/filecoin-project/filecoin-fvm-localnet-preproofs-2k:sha-7b316e4
66
SECTOR_SIZE=2048
77

88
## 8M network
9-
#IMAGE=ghcr.io/filecoin-project/filecoin-fvm-localnet-preproofs-8m:sha-fa13f1a
9+
#IMAGE=ghcr.io/filecoin-project/filecoin-fvm-localnet-preproofs-8m:sha-7b316e4
1010
#SECTOR_SIZE=8388608
1111

Diff for: README.md

+10-4
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Filecoin FVM localnet
44

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.
66

77

88
## System requirements
@@ -31,15 +31,21 @@ Ensure you have [Docker installed](https://docs.docker.com/get-docker/).
3131

3232
1. OPTIONAL: Edit the file `.env` if you wish to optionally run an 8M sector network, otherwise the default 2k sectors will be used
3333

34-
1. Run Docker `compose up`:
34+
1. To run a single miner instance (default): run Docker `compose up`:
3535

3636
```sh
3737
docker compose up
3838
```
3939

40+
1. To run two miners and two Boost instances (replication): run:
41+
42+
```sh
43+
docker compose --profile replication up
44+
```
45+
4046
1. To stop the network type `ctrl-c`.
4147

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`.
4349

4450
## Metamask and Funding a Wallet
4551

@@ -93,5 +99,5 @@ In order to transact with the network, you will need some funds (tFIL) in your w
9399

94100
- This network has a block time of 15 seconds (half the time of Filecoin mainnet).
95101

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.
97103

0 commit comments

Comments
 (0)