From 2ec34e67617b03bd94f9c9de3291e3dd61e7afd1 Mon Sep 17 00:00:00 2001 From: sacha Date: Wed, 22 Sep 2021 15:52:42 +0200 Subject: [PATCH] Book edits (#2887) * cp * cp --- docs/the_nimbus_book/src/intro.md | 9 --------- docs/the_nimbus_book/src/rest-api.md | 20 ++++++++++++++++++-- 2 files changed, 18 insertions(+), 11 deletions(-) diff --git a/docs/the_nimbus_book/src/intro.md b/docs/the_nimbus_book/src/intro.md index 8c85b58bd..c37b6afec 100644 --- a/docs/the_nimbus_book/src/intro.md +++ b/docs/the_nimbus_book/src/intro.md @@ -29,15 +29,6 @@ This book explains the ways in which you can use Nimbus to either monitor the et - [Danny Ryan's annotated spec](https://notes.ethereum.org/@djrtwo/Bkn3zpwxB) -### Why eth2? - -Eth2 is a multi-year plan to improve the scalability, security, and programmability of Ethereum, without compromising on decentralisation. - -In contrast to the Ethereum chain, as it currently stands, eth2 uses proof-of-stake (PoS) to secure its network. And while Ethereum as you know and love it will continue to exist as its own independent proof-of-work chain for a little while to come, the transition towards PoS starts now. - -> In traditional PoW, block proposers are called **_miners_**, whereas in PoS, they are called **_validators_**. In essence, _miners_ rely on actual hardware (such as some specifically manufactured mining machines), while _validators_ rely on software (such as Nimbus) and a good network connection. - - ### Get in touch Need help with anything? Join us on [Status](https://join.status.im/nimbus-general) and [Discord](https://discord.gg/9dWwPnG). diff --git a/docs/the_nimbus_book/src/rest-api.md b/docs/the_nimbus_book/src/rest-api.md index 86ee8c8ed..58ba57de4 100644 --- a/docs/the_nimbus_book/src/rest-api.md +++ b/docs/the_nimbus_book/src/rest-api.md @@ -1,5 +1,21 @@ # REST API -Nimbus supports the [common REST API](https://ethereum.github.io/eth2.0-APIs/#/) for runtime communication with the application. For historical reasons, a [JSON-RPC-based API](./api.md) is also supported. +Nimbus supports the [common REST API](https://ethereum.github.io/beacon-APIs/) for runtime communication. + +> The REST API is currently in BETA -- to enable it, use the `--rest` option when starting the beacon node, then access the API from http://localhost:5052/. + + +The API is a REST interface, accessed via HTTP. The API should not, unless protected by additional security layers, be exposed to the public Internet as the API includes multiple endpoints which could open your node to denial-of-service (DoS) attacks through endpoints triggering heavy processing. Currently, the only supported return data type is JSON. + +The beacon node (BN) maintains the state of the beacon chain by communicating with other beacon nodes in the Ethereum network. Conceptually, it does not maintain keypairs that participate with the beacon chain. + +The validator client (VC) is a conceptually separate entity which utilizes private keys to perform validator related tasks, called "duties", on the beacon chain. These duties include the production of beacon blocks and signing of attestations. + +The goal of this specification is to promote interoperability between various beacon node implementations. + +## Specification +The specification is documented [here](https://ethereum.github.io/beacon-APIs/#/Beacon/getGenesis). + +See the Readme [here](https://github.com/ethereum/beacon-apis). + -The REST API is currently in BETA -- to enable it, use the `--rest` option when starting the beacon node, then access the API from http://localhost:5052/.