-
Notifications
You must be signed in to change notification settings - Fork 19
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
82 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,47 +1,104 @@ | ||
| # mainnet-eth | ||
|
|
||
| Mainnet Ethereum stack (experimental) | ||
| Deploys a "head-tracking" mainnet Ethereum stack comprising a [go-ethereum](https://github.com/cerc-io/go-ethereum) execution layer node and a [lighthouse](https://github.com/sigp/lighthouse) consensus layer node. | ||
|
|
||
| ## Clone required repositories | ||
|
|
||
| ``` | ||
| $ laconic-so --stack mainnet-eth setup-repositories | ||
| ``` | ||
|
|
||
| ## Build the fixturenet-eth containers | ||
| ## Build containers | ||
|
|
||
| ``` | ||
| $ laconic-so --stack mainnet-eth build-containers | ||
| ``` | ||
|
|
||
| This should create several container images in the local image registry: | ||
|
|
||
| * cerc/go-ethereum | ||
| * cerc/lighthouse | ||
| * cerc/fixturenet-eth-geth | ||
| * cerc/fixturenet-eth-lighthouse | ||
|
|
||
| ## Create a deployment | ||
|
|
||
| ``` | ||
| $ laconic-so --stack mainnet-eth deploy create | ||
| $ laconic-so --stack mainnet-eth deploy init --output mainnet-eth-spec.yml | ||
| $ laconic-so deploy create --spec-file mainnet-eth-spec.yml --deployment-dir mainnet-eth-deployment | ||
| ``` | ||
| ## Start the stack | ||
| ``` | ||
| $ laconic-so deployment --dir mainnet-eth-deployment start | ||
| ``` | ||
| Display stack status: | ||
| ``` | ||
| $ laconic-so deployment --dir mainnet-eth-deployment ps | ||
| Running containers: | ||
| id: f39608eca04d72d6b0f1f3acefc5ebb52908da06e221d20c7138f7e3dff5e423, name: laconic-ef641b4d13eb61ed561b19be67063241-foundry-1, ports: | ||
| id: 4052b1eddd886ae0d6b41f9ff22e68a70f267b2bfde10f4b7b79b5bd1eeddcac, name: laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-geth-1-1, ports: 30303/tcp, 30303/udp, 0.0.0.0:49184->40000/tcp, 0.0.0.0:49185->6060/tcp, 0.0.0.0:49186->8545/tcp, 8546/tcp | ||
| id: ac331232e597944b621b3b8942ace5dafb14524302cab338ff946c7f6e5a1d52, name: laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1, ports: 0.0.0.0:49187->8001/tcp | ||
| ``` | ||
| See stack logs: | ||
| ``` | ||
| $ laconic-so deployment --dir mainnet-eth-deployment logs | ||
| time="2023-07-25T09:46:29-06:00" level=warning msg="The \"CERC_SCRIPT_DEBUG\" variable is not set. Defaulting to a blank string." | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.362 INFO Logging to file path: "/var/lighthouse-data-dir/beacon/logs/beacon.log" | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.365 INFO Lighthouse started version: Lighthouse/v4.1.0-693886b | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.365 INFO Configured for network name: mainnet | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.366 INFO Data directory initialised datadir: /var/lighthouse-data-dir | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.366 INFO Deposit contract address: 0x00000000219ab540356cbb839cbe05303d7705fa, deploy_block: 11184524 | ||
| laconic-ef641b4d13eb61ed561b19be67063241-mainnet-eth-lighthouse-1-1 | Jul 25 15:45:13.424 INFO Starting checkpoint sync remote_url: https://beaconstate.ethstaker.cc/, service: beacon | ||
| ``` | ||
| ## Monitoring stack sync progress | ||
| Both go-ethereum and lighthouse will engage in an initial chain sync phase that will last up to several hours depending on hardware performance and network capacity. | ||
| Syncing can be monitored by looking for these log messages: | ||
| ``` | ||
| Jul 24 12:34:17.001 INFO Downloading historical blocks est_time: 5 days 11 hrs, speed: 14.67 slots/sec, distance: 6932481 slots (137 weeks 3 days), service: slot_notifier | ||
| INFO [07-24|12:14:52.493] Syncing beacon headers downloaded=145,920 left=17,617,968 eta=1h23m32.815s | ||
| INFO [07-24|12:33:15.238] Syncing: chain download in progress synced=1.86% chain=148.94MiB headers=368,[email protected] bodies=330,[email protected] receipts=330,[email protected] eta=37m54.505s | ||
| INFO [07-24|12:35:13.028] Syncing: state download in progress synced=1.32% state=4.64GiB accounts=2,850,[email protected] slots=18,663,[email protected] [email protected] eta=3h18m0.699s | ||
| ``` | ||
| Once synced up these log messages will be observed: | ||
| ``` | ||
| INFO Synced slot: 6952515, block: 0x5bcb…f6d9, epoch: 217266, finalized_epoch: 217264, finalized_root: 0x6342…2c5c, exec_hash: 0x8d8c…2443 (verified), peers: 31, service: slot_notifier | ||
| INFO [07-25|03:04:48.941] Imported new potential chain segment number=17,767,316 hash=84f6e7..bc2cb0 blocks=1 txs=137 mgas=16.123 elapsed=57.087ms mgasps=282.434 dirty=461.46MiB | ||
| INFO [07-25|03:04:49.042] Chain head was updated number=17,767,316 hash=84f6e7..bc2cb0 root=ca58b2..8258c1 elapsed=2.480111ms | ||
| ``` | ||
|
|
||
|
|
||
| ## Clean up | ||
|
|
||
| Stop all services running in the background: | ||
|
|
||
| ```bash | ||
| $ laconic-so deployment --dir <directory> down | ||
| Stop the stack: | ||
| ``` | ||
|
|
||
| Clear volumes created by this stack: | ||
|
|
||
| ```bash | ||
| # List all relevant volumes | ||
| $ docker volume ls -q --filter "name=.*fixturenet_eth_bootnode_geth_data|.*fixturenet_eth_geth_1_data|.*fixturenet_eth_geth_2_data|.*fixturenet_eth_lighthouse_1_data|.*fixturenet_eth_lighthouse_2_data" | ||
|
|
||
| # Remove all the listed volumes | ||
| $ docker volume rm $(docker volume ls -q --filter "name=.*fixturenet_eth_bootnode_geth_data|.*fixturenet_eth_geth_1_data|.*fixturenet_eth_geth_2_data|.*fixturenet_eth_lighthouse_1_data|.*fixturenet_eth_lighthouse_2_data") | ||
| $ laconic-so deployment --dir mainnet-eth-deployment stop | ||
| ``` | ||
| This leaves data volumes in place, allowing the stack to be subsequently re-started. | ||
| To permanently *delete* the stack's data volumes run: | ||
| ``` | ||
| $ laconic-so deployment --dir mainnet-eth-deployment stop --delete-data-volumes | ||
| ``` | ||
| After deleting the volumes, any subsequent re-start will begin chain sync from cold. | ||
| ## Data volumes | ||
| Container data volumes are bind-mounted to specified paths in the host filesystem. | ||
| The default setup (generated by `laconic-so deploy init`) places the volumes in the `./data` subdirectory of the deployment directory: | ||
| ``` | ||
| $ cat mainnet-eth-spec.yml | ||
| stack: mainnet-eth | ||
| volumes: | ||
| mainnet_eth_config_data: ./data/mainnet_eth_config_data | ||
| mainnet_eth_geth_1_data: ./data/mainnet_eth_geth_1_data | ||
| mainnet_eth_lighthouse_1_data: ./data/mainnet_eth_lighthouse_1_data | ||
| ``` | ||
| A synced-up stack will consume around 900GB of data volume space: | ||
| ``` | ||
| $ sudo du -h mainnet-eth-deployment/data/ | ||
| 150M mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data/beacon/freezer_db | ||
| 25G mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data/beacon/chain_db | ||
| 16K mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data/beacon/network | ||
| 368M mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data/beacon/logs | ||
| 26G mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data/beacon | ||
| 26G mainnet-eth-deployment/data/mainnet_eth_lighthouse_1_data | ||
| 8.0K mainnet-eth-deployment/data/mainnet_eth_config_data | ||
| 4.0K mainnet-eth-deployment/data/mainnet_eth_geth_1_data/keystore | ||
| 527G mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/chaindata/ancient/chain | ||
| 527G mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/chaindata/ancient | ||
| 859G mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/chaindata | ||
| 4.8M mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/nodes | ||
| 242M mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/ethash | ||
| 669M mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth/triecache | ||
| 860G mainnet-eth-deployment/data/mainnet_eth_geth_1_data/geth | ||
| 860G mainnet-eth-deployment/data/mainnet_eth_geth_1_data | ||
| 885G mainnet-eth-deployment/data/ | ||
| ``` |