diff --git a/docs/node/README.mdx b/docs/node/README.mdx index cdd44385e0..6c76fa606f 100644 --- a/docs/node/README.mdx +++ b/docs/node/README.mdx @@ -3,15 +3,38 @@ import {findSidebarItem} from '@site/src/sidebarUtils'; # Run Node -The following documentation is intended to assist any individual or -organization in participating in the Oasis network as a node operator. To join -the network we recommend you first try running a node on the Testnet. The -Testnet is a playground where you can learn and experiment without the risk -of losing real tokens. +Welcome! This documentation is designed to provide you with a comprehensive +understanding and step-by-step guidance for becoming a node operator within the +Oasis Network. + +Embark on your journey by setting up a node on the Testnet. The Testnet serves +as an experimental sandbox, offering a safe environment for learning and +experimentation, free from the risks associated with real token loss. + +For any queries or support related to node operation, our team and community +members are readily available on [Discord] to assist you. + +[Discord]: https://oasis.io/discord + +## Validator and ParaTime nodes [Oasis Network] consists of the consensus layer and ParaTimes. Consensus and ParaTime nodes can be operated by anyone. +To run a **validator node**, make sure your system meets the [hardware] and the +[system] prerequisites and has [Oasis Node] installed. + +Then proceed by following the [Run a Validator Node] guide to: + +* Create your entity. +* Initialize and configure your node. +* Put enough stake in your escrow account. +* Register your entity on the network. + +To run a **ParaTime node** make sure to first set up a validator node. Then, +set up a [trusted execution environment (TEE)], if you want to run confidential +ParaTimes. Afterwards, proceed to the [Run a ParaTime node] chapter. + :::info Consensus layer is a decentralised set of 120 validator nodes that are a @@ -31,27 +54,10 @@ node operator you can participate in any number of ParaTimes. ::: -If you have any questions about running a node you can find us on [Discord]. - [Oasis Network]: ..//general/oasis-network/README.mdx [Oasis Scan]: https://www.oasisscan.com/validators -[Discord]: https://oasis.io/discord - -## Node Roles - -To run a **Validator node**, make sure your system meets the [Hardware] and the -[System] prerequisites and has [Oasis Node] installed. - -Then proceed by following the [Run a Validator Node] guide to: -* Create your entity. -* Initialize and configure your node. -* Put enough stake in your escrow account. -* Register your entity on the network. - -To run a **ParaTime node** make sure to first set up a Validator node. Then, -set up a [trusted execution environment (TEE)], if you want to run confidential -ParaTimes. After that, proceed to the [Run a ParaTime node]. +## DApp Developers If you are **building a service** on top of the Oasis Network, you will simply want to set up your own **[Non-validator node]** and (optionally) a @@ -60,8 +66,8 @@ party endpoints which can be behind a traffic limiter, can go down unexpectedly, or they can have some more CPU-intensive queries disabled which you would like to use. -[Hardware]: ./run-your-node/prerequisites/hardware-recommendations.md -[System]: ./run-your-node/prerequisites/system-configuration.mdx +[hardware]: ./run-your-node/prerequisites/hardware-recommendations.md +[system]: ./run-your-node/prerequisites/system-configuration.mdx [Oasis Node]: ./run-your-node/prerequisites/oasis-node.md [Run a Validator Node]: ./run-your-node/validator-node.mdx [trusted execution environment (TEE)]: ./run-your-node/prerequisites/set-up-trusted-execution-environment-tee.md