From 1e3a1fac32a9a60fb3057408de2a4da2d3de741d Mon Sep 17 00:00:00 2001 From: q9f <58883403+q9f@users.noreply.github.com> Date: Wed, 1 Apr 2020 18:14:44 +0200 Subject: [PATCH] docs: update readme to properly reflect the 3 testnets --- README.md | 31 +++++++++++++++++++------------ 1 file changed, 19 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 4283d356a0..1fdece1367 100644 --- a/README.md +++ b/README.md @@ -72,7 +72,7 @@ This command will: This tool is optional and if you leave it out you can always attach to an already running `geth` instance with `geth attach`. -### A Full node on the Ethereum test network +### A Full node on the Görli test network Transitioning towards developers, if you'd like to play around with creating Ethereum contracts, you almost certainly would like to do that without any real money involved until @@ -81,19 +81,19 @@ network, you want to join the **test** network with your node, which is fully eq the main network, but with play-Ether only. ```shell -$ geth --testnet console +$ geth --goerli console ``` The `console` subcommand has the exact same meaning as above and they are equally -useful on the testnet too. Please see above for their explanations if you've skipped here. +useful on the testnet too. Please, see above for their explanations if you've skipped here. -Specifying the `--testnet` flag, however, will reconfigure your `geth` instance a bit: +Specifying the `--goerli` flag, however, will reconfigure your `geth` instance a bit: - * Instead of connecting the main Ethereum network, the client will connect to the Goerli + * Instead of connecting the main Ethereum network, the client will connect to the Görli test network, which uses different P2P bootnodes, different network IDs and genesis states. * Instead of using the default data directory (`~/.ethereum` on Linux for example), `geth` - will nest itself one level deeper into a `goerli` subfolder (`~/.ethereum/goerli` on + will nest itself one level deeper into a `goerli/` subfolder (`~/.ethereum/goerli` on Linux). Note, on OSX and Linux this also means that attaching to a running testnet node requires the use of a custom endpoint since `geth attach` will try to attach to a production node endpoint by default, e.g., @@ -108,17 +108,24 @@ accounts available between them.* ### Full node on the Rinkeby test network -The above test network is a cross-client one based on the ethash proof-of-work consensus -algorithm. As such, it has certain extra overhead and is more susceptible to reorganization -attacks due to the network's low difficulty/security. Go Ethereum also supports connecting -to a proof-of-authority based test network called [*Rinkeby*](https://www.rinkeby.io) -(operated by members of the community). This network is lighter, more secure, but is only -supported by go-ethereum. +Go Ethereum also supports connecting to the older proof-of-authority based test network +called [*Rinkeby*](https://www.rinkeby.io) which is operated by members of the community. ```shell $ geth --rinkeby console ``` +### Full node on the Ropsten test network + +In addition to Görli and Rinkeby, Go-Ethereum also supports the ancient Ropsten testnet. +The Ropsten test network is based on the Ethash proof-of-work consensus algorithm. As such, +it has certain extra overhead and is more susceptible to reorganization attacks due to the +network's low difficulty/security. + +```shell +$ geth --ropsten console +``` + ### Configuration As an alternative to passing the numerous flags to the `geth` binary, you can also pass a