This starter script lets you generate a running local Ethereum 1 simulation with a deployed Ethereum 2 deposit contract, a private key with a million ether to distribute, and an included faucet through which to distribute that ether. Optionally, you can pass in the number of accounts you want auto-deposited with 32 ether, so they immediately qualify as validators.
You will have to pollute your system a little for this to work. Luckily, it works fine inside a VM too, and also NVM (see below) keeps things somewhat clean.
- Install NVM to have a working NodeJS setup. If you don't, nodeJS and npm will probably break in many, many ways. Once you have NVM, set it to Node version 10.
- Install the Yarn package manager: https://yarnpkg.com/lang/en/docs/install/
yarn install && cd deploy/faucet && yarn installto install dependencies
- Clone repo and modify the mnemonic in the
- If you want to add some pre-created private keys, add them to the
node start.js. Optionally, pass in a
vargument to autogenerate that many validators (
v=10) and/or the
mykeysargument to make the script read the keys specified in step 2.
The blockchain database will be stored in the
deploy/db subfolder. The
deploy/keys subfolder will have keys for relevant accounts generated, including the address to the deposit contract. The
deploy/faucet folder will contain a simple web UI for a faucet. See hosting below for how to run it.
start.js with flags, .e.g.
node start.js v=50 mykeys:
v: Number of validators to generate. These validators will be generated with 32.1 ether each and will auto-deposit 32 ether to the deposit contract. Their private keys will be in
deploy/keys. Defaults to 10 if omitted, but only triggers default is
mykeysargument not provided.
mykeys: This is a boolean flag, so just include it to activate it. Passing this in will make the boostrapper read a
.mykeys.jsonfile in the root of the project, looking for private keys. The file should be a JSON object of (address => privkey) pairs,
0xincluded. These keys will then also be included as validators: they will be given 32.1 ether and deposit it into the contract. See
The generator is deterministic. You always end up with the same addresses, accounts and balances if you use the same mnemonic and
.mykeys list. Thus, to host it somewhere, simply clone this repo to the server and run it the same way you do locally.
node start.jswill run the blockchain and start the server in listen mode with RPC/Web3 allowed
yarn faucetwill host the ether faucet at
yarn validator-uiwill host the validator UI at
- To clean the DB and start over run
yarn run clean.
Please consider contributing PRs, we'd love the help! There's only one condition: please try to keep the dependencies to a minimum of minimums, and do NOT use something that needs node-gyp.
Licensed and distributed under either of
at your option. These files may not be copied, modified, or distributed except according to those terms.