Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dcspark/milkomeda-c1-evm-passive
Milkomeda evm node configurations for partners wanting to connect to the evm nodes p2p network
https://github.com/dcspark/milkomeda-c1-evm-passive
Last synced: about 1 month ago
JSON representation
Milkomeda evm node configurations for partners wanting to connect to the evm nodes p2p network
- Host: GitHub
- URL: https://github.com/dcspark/milkomeda-c1-evm-passive
- Owner: dcSpark
- License: mit
- Created: 2022-01-19T08:49:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-12T15:49:52.000Z (over 1 year ago)
- Last Synced: 2024-04-16T08:55:26.281Z (9 months ago)
- Language: Shell
- Size: 78.1 KB
- Stars: 15
- Watchers: 7
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Milkomeda EVM Passive
Milkomeda EVM node configurations for partners wanting to connect to the evm nodes p2p network
**NOTE**: Besu supports two node types, commonly referred to as [Full nodes](https://besu.hyperledger.org/stable/public-networks/get-started/connect/sync-node#run-a-full-node) and [Archive nodes](https://besu.hyperledger.org/stable/public-networks/get-started/connect/sync-node#run-an-archive-node). This setup runs an **Archive Node** by default.
- [Usage](#usage)
- [Start Script](#start-script)
- [Docker Compose Direct](#docker-compose-direct)
- [Config](#config)
- [Change to Full Node](#change-to-full-node)
- [Troubleshooting](#troubleshooting)
- [Not Syncing](#not-syncing)
- [Permission Denied](#permission-denied)
- [Known Errors for this remediation](#known-errors-for-this-remediation)
## Usage
### Start Script
There is a simple start script provided to make starting/stoping/cleaning up easier. By default it will launch the EVM in c1-devnet.
**NOTE**: Add the `-o` flag to all commands if using WSL & MacOS (disables Host Network mode and Set Ports)
- Script Help for the most up to date commands `./start.sh -h`
- Find Network(s) to start: `./start.sh -l`
- Start EVM: `./start.sh -n ${NETWORK} -r`
- Add Log Tailing: `./start.sh -n ${NETWORK} -r -t`
- Stop EVM: `./start.sh -n ${NETWORK} -s`
- Tail logs: `./start.sh -n ${NETWORK} -t`
- Cleanup EVM: `./start.sh -n ${NETWORK} -c`
### Docker Compose Direct
**NOTE**: Use `docker-compose-non-linux.yml` instead for WSL & MacOS usage (disables Host Network mode and Set Ports)
- Switch to Directory of network you wish to Run EVM in Example: `cd c1-devnet`
- Start EVM:
- `docker-compose -f docker-compose.yml -p ${NETWORK}-passive build`
- `docker-compose -f docker-compose.yml -p ${NETWORK}-passive up --detach --force-recreate`
- Stop EVM: `docker-compose -f docker-compose.yml -p ${NETWORK}-passive stop`
- Tail logs: `docker-compose -f docker-compose.yml -p ${NETWORK}-passive logs --follow --tail="all"`
- Cleanup EVM: `docker-compose -f docker-compose.yml -p ${NETWORK}-passive down`
## Config
### Change to Full Node
**NOTE**: If you enable sync-mode="FAST" then you need 5 peers before it'll begin syncing. The setting to modify this is below
- Edit the config file at `${NETWORK}/config/config.toml`
- Change `sync-mode="FULL"` to `sync-mode="FAST"`
- **Optional**: Add number of minimum peers to config file (e.g.; `fast-sync-min-peers=2`). Also can be added to docker-compose.yml under the Command section as `--fast-sync-min-peers=2`
### Using env file:
Following settings can be customized using .env file. Example:
```
### Besu repository (mainnet default: hyperledger/besu; devnet default: dcspark/besu)
BESU_REPO=dcspark/besu
### Besu tag (mainnet default: 22.1.3; devnet default: 22.10.1-milkomeda-c1)
BESU_TAG=22.1.3
### Besu data dir (default: ./storage/data)
DATA_DIR=./storage/data
### Besu data dir (default: ./storage/logs)
LOGS_DIR=./storage/logs
```
.env file has to be pleaced in `./c1-mainnet` or `./c1-devnet` directory
## Troubleshooting
### Not Syncing
1. Pull Latest Updates from Github
2. Trying restarting the service
- `docker-compose -f docker-compose.yml -p ${NETWORK}-passive restart`
3. If issue persists, run the commands under the [Usage](#usage) section in this order `Stop EVM` `Clean EVM` `Start EVM`
- Disconnect - Inbound - 0x04 TOO_MANY_PEERS
If you have on logs the following message over and over, it means that the bootstrap nodes are full and there are no other nodes to connect too at the moment.
```
{"timestamp":"2022-03-29T13:54:32,453","container":"xxxx","level":"INFO","thread":"EthScheduler-Timer-0","class":"FullSyncTargetManager","message":"No sync target, waiting for peers: 0","throwable":""}
```
To avoid peer starvation and help others to connect to p2p network, the users should enable p2p discovery and have their nodes accessible so the p2p network doesn't rely only on bootstrap/static nodes.
- https://besu.hyperledger.org/stable/private-networks/how-to/configure/bootnodes
- https://besu.hyperledger.org/stable/public-networks/how-to/connect/configure-ports
- https://besu.hyperledger.org/stable/public-networks/how-to/connect/specify-nat
### Full Node Stops Syncing with "no peers"
This is a known problem with the Besu full node where for some reason it loses known static peers and it's not able to recover. During full sync this may happen a few times and it's resolved by restarting the node e.g. `docker restart XXX`
### Permission Denied
If you get a Permission Denied error, e.g.:
```
root@blockscout:~/milkomeda-evm-passive# docker-compose -f c1-devnet/docker-compose.yml -p c1-devnet-passive up
[+] Running 1/0
⠿ Container c1-devnet-passive-besu-1 Created 0.0s
Attaching to c1-devnet-passive-besu-1
c1-devnet-passive-besu-1 | 2022-04-05 14:14:16,508 main ERROR Unable to create file /tmp/besu/besu-blockscout.log java.io.IOException: Permission denied
```
run the following command(s),
- `chmod a+w -R ${NETWORK}/storage`
- You may have to restart `docker-compose -f docker-compose.yml -p ${NETWORK}-passive restart`
#### Known Errors for this remediation
```
ANTLR Runtime version 4.7.1 used for parser compilation does not match the current runtime version 4.8/opt/besu/data/DATABASE_METADATA.json (Permission denied)
```