nimbus-eth2/docs
Jacek Sieka 3d7bee8502
REST API client, JSON-RPC cleanups (#2756)
This refactoring puts the JSON-RPC and REST APIs on more equal footing
by renaming and moving things around, creating a separation between
client and server, and documenting what they are - the aim is to have a
simple-to-use base to start from when developing API clients, as well as
make it easier to navigate the code when looking for the legacy JSON-RPC
interface vs the new REST API.

* move REST client, serialization and supporting types to spec/eth2_apis
* REST stuff now starts with `rest_`, JSON-RPC stuff starts with `rpc_`,
more or less
* simplify imports such that there's a simple module to import for both
server and client
* map REST type and proc names to yaml spec more closely - in
particular, reuse operation and type names in `rest_types` to make
comparisons against spec more easy
* cleaner separation between client and server modules - modules common
between server and client such as `rest_types` and serialization move to
the spec folder - this allows the client to be built with less knowledge
about server internals
2021-08-03 17:17:11 +02:00
..
nbc_audit_2020 Consensus object pools [reorg 4/5] (#2374) 2021-03-04 10:13:44 +01:00
the_auditors_handbook openarray -> openArray 2020-11-03 23:23:10 +02:00
the_nimbus_book REST API client, JSON-RPC cleanups (#2756) 2021-08-03 17:17:11 +02:00
README.md bin dist related docs (#2684) 2021-07-05 12:31:25 +02:00
attestation_flow.dot [RFC - Doc] State of Nimbus block & attestation flows (#2351) 2021-03-01 11:22:16 +01:00
attestation_flow.md update docs to use v1.0.1 spec ref URLs (#2368) 2021-03-02 09:32:07 +01:00
attestation_flow.png [RFC - Doc] State of Nimbus block & attestation flows (#2351) 2021-03-01 11:22:16 +01:00
block_flow.dot [RFC - Doc] State of Nimbus block & attestation flows (#2351) 2021-03-01 11:22:16 +01:00
block_flow.md Implement the new Altair req/resp protocols (#2676) 2021-07-07 12:09:47 +03:00
block_flow.png [RFC - Doc] State of Nimbus block & attestation flows (#2351) 2021-03-01 11:22:16 +01:00
cpu_features.md Cpu architecture optimization documentation (#2483) 2021-04-08 15:48:43 +02:00
e2store.md e2store: add era format (#2382) 2021-03-15 11:31:39 +01:00
logging.md Revisiting log levels (#1788) 2020-10-01 20:56:42 +02:00
rayonism_catalyst_logs.png non-intrusive, novel portions of merge (#2535) 2021-05-04 11:54:19 +00:00
rayonism_merge.md Remove the obsolete testnet0/1 scripts (#2727) 2021-07-16 13:02:27 +03:00
rayonism_metamask_network_setup.png non-intrusive, novel portions of merge (#2535) 2021-05-04 11:54:19 +00:00
rayonism_metamask_send_eth.png non-intrusive, novel portions of merge (#2535) 2021-05-04 11:54:19 +00:00
rayonism_metamask_transaction_confirmation.png non-intrusive, novel portions of merge (#2535) 2021-05-04 11:54:19 +00:00

README.md

The books in this folder were produced using mdBook - see installation guide.

Some books also use mdbook-toc for tables of contents.

# Install or update tooling (make sure you add "~/.cargo/bin" to PATH):
cargo install mdbook mdbook-toc mdbook-open-on-gh

# Work on the book locally - open "http://localhost:4000" for live version
cd docs/the_nimbus_book
mdbook serve -p 4000

# Publish book using makefile (in the top-level dir)
make publish-book