cerc-io/lighthouse
10
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity

Fix testnet docs (#747)

Browse Source 
* Fix testnet docs

* Minor fixes

* More fixes

* Describe http flag

* Tidy

* Revert change

* Address suggestion from Pawan
This commit is contained in:
Paul Hauner 2020-01-06 14:31:43 +11:00 committed by GitHub
parent 5427664cf4
commit 4d0ef41a2c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 24 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
book/src/simple-testnet.md
View File

@ -1,33 +1,32 @@
# Simple Local Testnet # Simple Local Testnet
With a functional [development environment](./setup.md), starting a local multi-node First, [install Lighthouse](./installation.md).
testnet is easy:
1. Start the first node: `$ lighthouse bn testnet -f recent 8` Then, get the current unix time in seconds; you can use
1. Start a validator client: `$ lighthouse bn testnet -b insecure 0 8` [epochconverter.com](https://www.epochconverter.com/) or `$ date +%s`. It
1. Start more nodes with `$ lighthouse bn -b 10 testnet -f bootstrap should look like this `1576803034` and you should use it wherever we put
http://localhost:5052` `<time>`.
- Increment the `-b` value by `10` for each additional node.
## Detailed Instructions > If you choose a time that's more than several minutes in the past the
> validator client will refuse to produce blocks. We will loosen this
First, setup a Lighthouse development environment and navigate to the > restriction in the future, the issue is tracked
`target/release` directory (this is where the binaries are located). > [here](https://github.com/sigp/lighthouse/issues/714).
## Starting a beacon node ## Starting a beacon node
Start a new node (creating a fresh database and configuration in `$HOME/.lighthouse`), using: Start a new node with:
```bash ```bash
$ lighthouse bn testnet -f recent 8 $ lighthouse bn --http testnet -r quick 8 <time>
``` ```
> Notes: > Notes:
> >
> - The `-f` flag ignores any existing database or configuration, backing them > - The `--http` flag starts the API so the validator can produce blocks.
> up before re-initializing. > - The `-r` flag creates a random data directory to avoid clashes with other
> nodes.
> - `8` is number of validators with deposits in the genesis state. > - `8` is number of validators with deposits in the genesis state.
> - See `$ lighthouse bn testnet recent --help` for more configuration options, > - See `$ lighthouse bn testnet --help` for more configuration options,
> including `minimal`/`mainnet` specification. > including `minimal`/`mainnet` specification.
## Starting a validator client ## Starting a validator client
@ -35,13 +34,11 @@ $ lighthouse bn testnet -f recent 8
In a new terminal window, start the validator client with: In a new terminal window, start the validator client with:
```bash ```bash
$ lighthouse vc testnet -b insecure 0 8 $ lighthouse vc testnet insecure 0 8
``` ```
> Notes: > Notes:
> >
> - The `-b` flag means the validator client will "bootstrap" specs and config
> from the beacon node.
> - The `insecure` command uses predictable, well-known private keys. Since > - The `insecure` command uses predictable, well-known private keys. Since
> this is just a local testnet, these are fine. > this is just a local testnet, these are fine.
> - The `0 8` indicates that this validator client should manage 8 validators, > - The `0 8` indicates that this validator client should manage 8 validators,
@ -51,23 +48,18 @@ $ lighthouse vc testnet -b insecure 0 8
## Adding another beacon node ## Adding another beacon node
You may connect another (non-validating) node to your local network using the You may connect another (non-validating) node to your local network by starting
lighthouse `bootstrap` command. a new terminal and running:
In a new terminal window, run:
```bash ```bash
$ lighthouse bn -b 10 testnet -r bootstrap lighthouse bn -z --libp2p-addresses /ip4/127.0.0.1/tcp/9000 testnet -r quick 8 <time>
``` ```
> Notes: > Notes:
> >
> - The `-b` (or `--port-bump`) increases all the listening TCP/UDP ports of > - The `z` (or `--zero-ports`) flag sets all listening ports to be zero, which then
> the new node to `10` higher. Your first node's HTTP server was at TCP > means that the OS chooses random available ports. This avoids port
> `5052` but this one will be at `5062`. > collisions with the first node.
> - The `-r` flag creates a new data directory with a random string appended > - The `--libp2p-addresses` flag instructs the new node to connect to the
> (avoids data directory collisions between nodes). > first node.
> - The default bootstrap HTTP address is `http://localhost:5052`. The new node
> will download configuration via HTTP before starting sync via libp2p.
> - See `$ lighthouse bn testnet bootstrap --help` for more configuration.