This is a tool to create an Eth2 testnet genesis state, without having to make deposits for all validators.
The steps are:
- Deploy a deposit contract
- Take an Eth1 block hash and corresponding timestamp as starting point. The deposit contract contents must be empty at this block.
- Configure the minimum genesis time. This normally specifies what the above would be, the first eligible eth1 block starting point. Make sure to pick an eth1 block that is compatible (has equal or later timestamp) than the minimum genesis time. If you pick a time in the future, the generated state is invalid.
- Configure the genesis delay to adjust the actual genesis time (
actual genesis time = chosen eth1 time + delay)
The result:
- The deposit data tree at genesis will be empty, instead of filled with the genesis validators.
- The expected empty deposit tree root is
0xd70a234731285c6804c2a4f56711ddb8c82c99740f207854891028af34e27e5e(32th order zero hash, with zero length-mixin)
- The expected empty deposit tree root is
- The validators will be pre-filled in the genesis state.
- The state has an existing eth1 block, empty deposit tree, and zero deposit count, from where deposits can continue.
- The state has a zero deposit index: block proposers won't have to search for non-existing deposits of the pre-filled validators.
- The deposit contract is considered to be empty by Eth2 nodes at genesis. Any deposits will be appended to the validator set, as expected.
Create genesis state. See sub-commands for different fork versions.
Sub commands:
phase0 Create genesis state for phase0 beacon chain
altair Create genesis state for altair beacon chain
merge Create genesis state for post-merge beacon chain, from eth1 and eth2 configs
Create genesis state for phase0 beacon chain
Flags/args:
--config string Eth2 spec configuration, name or path to YAML (default "mainnet")
--eth1-block bytes32 Eth1 block hash to put into state (default 0000000000000000000000000000000000000000000000000000000000000000)
--legacy-config string Eth2 legacy configuration (combined config and presets), name or path to YAML (default "mainnet")
--mnemonics string File with YAML of key sources (default "mnemonics.yaml")
--preset-altair string Eth2 altair spec preset, name or path to YAML (default "mainnet")
--preset-merge string Eth2 merge spec preset, name or path to YAML (default "mainnet")
--preset-phase0 string Eth2 phase0 spec preset, name or path to YAML (default "mainnet")
--preset-sharding string Eth2 sharding spec preset, name or path to YAML (default "mainnet")
--state-output string Output path for state file (default "genesis.ssz")
--timestamp uint Eth1 block timestamp (default 1623884847)
--tranches-dir string Directory to dump lists of pubkeys of each tranche in (default "tranches")
Create genesis state for altair beacon chain
Flags/args:
--config string Eth2 spec configuration, name or path to YAML (default "mainnet")
--eth1-block bytes32 Eth1 block hash to put into state (default 0000000000000000000000000000000000000000000000000000000000000000)
--legacy-config string Eth2 legacy configuration (combined config and presets), name or path to YAML (default "mainnet")
--mnemonics string File with YAML of key sources (default "mnemonics.yaml")
--preset-altair string Eth2 altair spec preset, name or path to YAML (default "mainnet")
--preset-merge string Eth2 merge spec preset, name or path to YAML (default "mainnet")
--preset-phase0 string Eth2 phase0 spec preset, name or path to YAML (default "mainnet")
--preset-sharding string Eth2 sharding spec preset, name or path to YAML (default "mainnet")
--state-output string Output path for state file (default "genesis.ssz")
--timestamp uint Eth1 block timestamp (default 1623884908)
--tranches-dir string Directory to dump lists of pubkeys of each tranche in (default "tranches")
Create genesis state for Merge beacon chain, from execution-layer (only required if post-transition) and consensus-layer configs
Flags/args:
--legacy-config Eth2 legacy configuration (combined config and presets), name or path to YAML (default: mainnet) (type: string)
--config Eth2 spec configuration, name or path to YAML (default: mainnet) (type: string)
--preset-phase0 Eth2 phase0 spec preset, name or path to YAML (default: mainnet) (type: string)
--preset-altair Eth2 altair spec preset, name or path to YAML (default: mainnet) (type: string)
--preset-merge Eth2 merge spec preset, name or path to YAML (default: mainnet) (type: string)
--preset-sharding Eth2 sharding spec preset, name or path to YAML (default: mainnet) (type: string)
--eth1-config Path to config JSON for eth1. No transition yet if empty. (default: engine_genesis.json) (type: string)
--eth1-block If not transitioned: Eth1 block hash to put into state. (default: 0000000000000000000000000000000000000000000000000000000000000000) (type: bytes32)
--eth1-timestamp If not transitioned: Eth1 block timestamp (default: 1633434014) (type: uint64)
--mnemonics File with YAML of key sources (default: mnemonics.yaml) (type: string)
--state-output Output path for state file (default: genesis.ssz) (type: string)
--tranches-dir Directory to dump lists of pubkeys of each tranche in (default: tranches) (type: string)
A genesis.json, as specified in Geth.
A standard YAML file, as specified in Eth2.0 specs. Concatenation of configs of all relevant phases.
The mnemonics.yaml is formatted as:
- mnemonic: "reward base tuna ..." # a 24 word BIP 39 mnemonic
count: 100 # amount of validators
- mnemonic: "hint dizzy fog ..."
count: 9000
# ... moreThe output will be:
genesis.ssz: a state to start the network withtranches: a dir with text files for each mnemonic, listing all pubkeys (1 per line). Useful for to check if keystores are generated correctly before genesis, and to track the validators.
To get info such as fork digest, genesis validators root, etc. run the compute_genesis_details.py script.
Install dependencies with (use of a venv recommended):
pip install milagro-bls-binding==1.6.3 eth2spec==1.1.0a7
MIT. See LICENSE file.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent