diff --git a/docs/build-cli-usage.sh b/docs/build-cli-usage.sh index 0917cb4737..8e6090474f 100755 --- a/docs/build-cli-usage.sh +++ b/docs/build-cli-usage.sh @@ -58,6 +58,6 @@ in_subcommands=0 while read -r subcommand rest; do [[ $subcommand == "SUBCOMMANDS:" ]] && in_subcommands=1 && continue if ((in_subcommands)); then - section "$(cargo -q run -p solana-cli -- help "$subcommand" | sed -e 's|'"$HOME"'|~|g' -e 's/[[:space:]]\+$//')" "####" >> "$out" + section "$(cargo -q run -p solana-cli -- help "$subcommand" | sed -e 's|'"$HOME"'|~|g' -e 's/[[:space:]]\+$//')" "###" >> "$out" fi done <<<"$usage">>"$out" diff --git a/docs/publish-docs.sh b/docs/publish-docs.sh index 06c34134db..0cbedcf882 100755 --- a/docs/publish-docs.sh +++ b/docs/publish-docs.sh @@ -62,7 +62,7 @@ cat > "$CONFIG_FILE" < ``` -### Extend a program +## Extend a program If a program has already been deployed, and a redeployment goes beyond the `max_len` of the account, it's possible to extend the program to fit the larger @@ -121,7 +121,7 @@ redeployment: solana program extend ``` -### Resuming a failed deploy +## Resuming a failed deploy If program deployment fails, there will be a hanging intermediate buffer account that contains a non-zero balance. In order to recoup that balance you may resume @@ -159,7 +159,7 @@ Then issue a new `deploy` command and specify the buffer: solana program deploy --buffer ``` -### Closing program and buffer accounts, and reclaiming their lamports +## Closing program and buffer accounts, and reclaiming their lamports Both program and buffer accounts can be closed and their lamport balances transferred to a recipient's account. @@ -214,7 +214,7 @@ To show all buffer accounts regardless of the authority solana program show --buffers --all ``` -### Set a program's upgrade authority +## Set a program's upgrade authority The program's upgrade authority must be present to deploy a program. If no authority is specified during program deployment, the default keypair is used as @@ -245,7 +245,7 @@ they do not have access to. The `--skip-new-upgrade-authority-signer-check` option relaxes the signer check. This can be useful for situations where the new upgrade authority is an offline signer or a multisig. -### Immutable programs +## Immutable programs A program can be marked immutable, which prevents all further redeployments, by specifying the `--final` flag during deployment: @@ -260,7 +260,7 @@ Or anytime after: solana program set-upgrade-authority --final ``` -### Dumping a program to a file +## Dumping a program to a file The deployed program may be dumped back to a local file: @@ -283,7 +283,7 @@ $ truncate -r dump.so extended.so $ sha256sum extended.so dump.so ``` -### Using an intermediary Buffer account +## Using an intermediary Buffer account Instead of deploying directly to the program account, the program can be written to an intermediary buffer account. Intermediary accounts can be useful for @@ -328,7 +328,7 @@ account are refunded to a spill account. Buffers also support `show` and `dump` just like programs do. -### Upgrading program using offline signer as authority +## Upgrading program using offline signer as authority Some security models require separating the signing process from the transaction broadcast, such that the signing keys can be completely disconnected from any network, also known as [offline signing](offline-signing.md). diff --git a/docs/src/cli/examples/durable-nonce.md b/docs/src/cli/examples/durable-nonce.md index 7f0199b8d4..11c90c3936 100644 --- a/docs/src/cli/examples/durable-nonce.md +++ b/docs/src/cli/examples/durable-nonce.md @@ -1,5 +1,7 @@ --- -title: Durable Transaction Nonces +title: Durable Transaction Nonces in the Solana CLI +pagination_label: "Solana CLI: Durable Transaction Nonces" +sidebar_label: Durable Transaction Nonces --- Durable transaction nonces are a mechanism for getting around the typical short diff --git a/docs/src/cli/examples/offline-signing.md b/docs/src/cli/examples/offline-signing.md index 8b9312853a..28b5456173 100644 --- a/docs/src/cli/examples/offline-signing.md +++ b/docs/src/cli/examples/offline-signing.md @@ -1,5 +1,7 @@ --- -title: Offline Transaction Signing +title: Offline Transaction Signing with the Solana CLI +pagination_label: "Solana CLI: Offline Transaction Signing" +sidebar_label: Offline Transaction Signing --- Some security models require keeping signing keys, and thus the signing diff --git a/docs/src/cli/examples/sign-offchain-message.md b/docs/src/cli/examples/sign-offchain-message.md index ae14119f7b..578ba511ee 100644 --- a/docs/src/cli/examples/sign-offchain-message.md +++ b/docs/src/cli/examples/sign-offchain-message.md @@ -1,5 +1,7 @@ --- -title: Off-Chain Message Signing +title: Off-Chain Message Signing with the Solana CLI +pagination_label: "Solana CLI: Off-Chain Message Signing" +sidebar_label: Off-Chain Message Signing --- Off-chain message signing is a method of signing non-transaction messages with diff --git a/docs/src/cli/examples/test-validator.md b/docs/src/cli/examples/test-validator.md index 70f050c77f..4641e36b55 100644 --- a/docs/src/cli/examples/test-validator.md +++ b/docs/src/cli/examples/test-validator.md @@ -1,5 +1,6 @@ --- title: Solana Test Validator +pagination_label: "Solana CLI: Test Validator" sidebar_label: Test Validator --- diff --git a/docs/src/cli/examples/transfer-tokens.md b/docs/src/cli/examples/transfer-tokens.md index 89374ebf43..28c933be66 100644 --- a/docs/src/cli/examples/transfer-tokens.md +++ b/docs/src/cli/examples/transfer-tokens.md @@ -1,5 +1,7 @@ --- -title: Send and Receive Tokens +title: Send and Receive Tokens with the Solana CLI +pagination_label: "Solana CLI: Send and Receive Tokens" +sidebar_label: Send and Receive Tokens --- This page describes how to receive and send SOL tokens using the command line diff --git a/docs/src/cli/index.md b/docs/src/cli/index.md index cdf1ed10f8..7757441961 100644 --- a/docs/src/cli/index.md +++ b/docs/src/cli/index.md @@ -1,7 +1,8 @@ --- title: Solana CLI Tool Suite -sidebar_label: Overview sidebar_position: 0 +sidebar_label: Overview +pagination_label: Solana CLI Tool Suite --- In this section, we will describe how to use the Solana command-line tools to @@ -19,6 +20,6 @@ secure access to your Solana accounts. To get started using the Solana Command Line (CLI) tools: - [Install the Solana CLI Tool Suite](./install.md) -- [Choose a Cluster](./examples/choose-a-cluster.md) -- [Create a Wallet](./wallets/index.md) - [Introduction to our CLI conventions](./intro.md) +- [Create a Wallet using the CLI](./wallets/index.md) +- [Choose a Cluster to connect to using the CLI](./examples/choose-a-cluster.md) diff --git a/docs/src/cli/install.md b/docs/src/cli/install.md index 7773631dda..3667c733e3 100644 --- a/docs/src/cli/install.md +++ b/docs/src/cli/install.md @@ -1,5 +1,6 @@ --- title: Install the Solana CLI +pagination_label: Install the Solana CLI sidebar_label: Installation sidebar_position: 1 --- diff --git a/docs/src/cli/intro.md b/docs/src/cli/intro.md index 1701450173..436776ee71 100644 --- a/docs/src/cli/intro.md +++ b/docs/src/cli/intro.md @@ -1,5 +1,6 @@ --- title: Introduction to the Solana CLI +pagination_label: Introduction to the Solana CLI sidebar_label: Introduction sidebar_position: 2 --- @@ -45,7 +46,7 @@ solana-keygen pubkey Below, we show how to resolve what you should put in `` depending on your wallet type. -#### Paper Wallet +## Paper Wallet In a paper wallet, the keypair is securely derived from the seed words and optional passphrase you entered when the wallet was created. To use a paper @@ -59,7 +60,7 @@ To display the wallet address of a Paper Wallet: solana-keygen pubkey prompt:// ``` -#### File System Wallet +## File System Wallet With a file system wallet, the keypair is stored in a file on your computer. Replace `` with the complete file path to the keypair file. @@ -71,7 +72,7 @@ For example, if the file system keypair file location is solana-keygen pubkey /home/solana/my_wallet.json ``` -#### Hardware Wallet +## Hardware Wallet If you chose a hardware wallet, use your [keypair URL](./wallets/hardware/index.md#specify-a-hardware-wallet-key), diff --git a/docs/src/cli/wallets/file-system.md b/docs/src/cli/wallets/file-system.md index 0041c51876..dd21203c4e 100644 --- a/docs/src/cli/wallets/file-system.md +++ b/docs/src/cli/wallets/file-system.md @@ -1,5 +1,7 @@ --- -title: File System Wallets +title: File System Wallets using the CLI +pagination_label: File System Wallets using the CLI +sidebar_label: File System Wallets sidebar_position: 2 --- diff --git a/docs/src/cli/wallets/hardware/index.md b/docs/src/cli/wallets/hardware/index.md index 9c8642cf34..30f53f86d3 100644 --- a/docs/src/cli/wallets/hardware/index.md +++ b/docs/src/cli/wallets/hardware/index.md @@ -1,5 +1,6 @@ --- title: Using Hardware Wallets in the Solana CLI +pagination_label: "Using Hardware Wallets in the Solana CLI" sidebar_label: Using in the Solana CLI sidebar_position: 0 --- diff --git a/docs/src/cli/wallets/hardware/ledger.md b/docs/src/cli/wallets/hardware/ledger.md index e0060aba80..e5a45c63df 100644 --- a/docs/src/cli/wallets/hardware/ledger.md +++ b/docs/src/cli/wallets/hardware/ledger.md @@ -1,5 +1,6 @@ --- title: Using Ledger Nano Hardware Wallets in the Solana CLI +pagination_label: "Hardware Wallets in the Solana CLI: Ledger Nano" sidebar_label: Ledger Nano --- diff --git a/docs/src/cli/wallets/index.md b/docs/src/cli/wallets/index.md index fcd907629c..9643ef61ec 100644 --- a/docs/src/cli/wallets/index.md +++ b/docs/src/cli/wallets/index.md @@ -1,5 +1,6 @@ --- -title: Command Line Wallets +title: Solana Wallets with the CLI +pagination_label: Command Line Wallets sidebar_label: Overview sidebar_position: 0 --- diff --git a/docs/src/cli/wallets/paper.md b/docs/src/cli/wallets/paper.md index 85c76779b8..4e3c3c39ac 100644 --- a/docs/src/cli/wallets/paper.md +++ b/docs/src/cli/wallets/paper.md @@ -1,5 +1,7 @@ --- -title: Paper Wallets +title: Paper Wallets using the Solana CLI +pagination_label: Paper Wallets using the CLI +sidebar_label: Paper Wallets sidebar_position: 1 --- diff --git a/docs/src/clusters/available.md b/docs/src/clusters/available.md index 7abfb06880..dfbca41672 100644 --- a/docs/src/clusters/available.md +++ b/docs/src/clusters/available.md @@ -1,5 +1,7 @@ --- -title: Solana Clusters +title: Available Solana Clusters +sidebar_label: Solana Clusters +pagination_label: Available Solana Clusters --- Solana maintains several different clusters with different purposes. diff --git a/docs/src/clusters/index.md b/docs/src/clusters/index.md index 8ac1dee11d..e2d25c603b 100644 --- a/docs/src/clusters/index.md +++ b/docs/src/clusters/index.md @@ -1,7 +1,8 @@ --- -title: A Solana Cluster -sidebar_label: Overview +title: Overview of a Solana Cluster sidebar_position: 0 +sidebar_label: Overview +pagination_label: Overview of a Solana Cluster --- A Solana cluster is a set of validators working together to serve client transactions and maintain the integrity of the ledger. Many clusters may coexist. When two clusters share a common genesis block, they attempt to converge. Otherwise, they simply ignore the existence of the other. Transactions sent to the wrong one are quietly rejected. In this section, we'll discuss how a cluster is created, how nodes join the cluster, how they share the ledger, how they ensure the ledger is replicated, and how they cope with buggy and malicious nodes. diff --git a/docs/src/clusters/metrics.md b/docs/src/clusters/metrics.md index 575c46a26e..c162ed5011 100644 --- a/docs/src/clusters/metrics.md +++ b/docs/src/clusters/metrics.md @@ -1,5 +1,7 @@ --- -title: Performance Metrics +title: Solana Cluster Performance Metrics +sidebar_label: Performance Metrics +pagination_label: Cluster Performance Metrics --- Solana cluster performance is measured as average number of transactions per second that the network can sustain \(TPS\). And, how long it takes for a transaction to be confirmed by super majority of the cluster \(Confirmation Time\). diff --git a/docs/src/consensus/commitments.md b/docs/src/consensus/commitments.md index 0bfb55e923..404f41dc7f 100644 --- a/docs/src/consensus/commitments.md +++ b/docs/src/consensus/commitments.md @@ -1,5 +1,7 @@ --- -title: Commitment Status +title: Solana Commitment Status +sidebar_label: Commitment Status +pagination_label: Consensus Commitment Status description: "Processed, confirmed, and finalized. Learn the differences between the different commitment statuses on the Solana blockchain." diff --git a/docs/src/consensus/leader-rotation.md b/docs/src/consensus/leader-rotation.md index a52cbb7eaf..c65d91c730 100644 --- a/docs/src/consensus/leader-rotation.md +++ b/docs/src/consensus/leader-rotation.md @@ -1,5 +1,7 @@ --- -title: Leader Rotation +title: Solana Leader Rotation +sidebar_label: Leader Rotation +pagination_label: Leader Rotation --- At any given moment, a cluster expects only one validator to produce ledger entries. By having only one leader at a time, all validators are able to replay identical copies of the ledger. The drawback of only one leader at a time, however, is that a malicious leader is capable of censoring votes and transactions. Since censoring cannot be distinguished from the network dropping packets, the cluster cannot simply elect a single node to hold the leader role indefinitely. Instead, the cluster minimizes the influence of a malicious leader by rotating which node takes the lead. diff --git a/docs/src/index.mdx b/docs/src/index.mdx index 422404b0a7..eff65e951b 100644 --- a/docs/src/index.mdx +++ b/docs/src/index.mdx @@ -3,10 +3,10 @@ slug: / id: home title: Home sidebar_label: Home +pagination_label: Solana Validator Documentation Home description: "Solana is a high performance network that is utilized for a range of use cases, \ including finance, NFTs, payments, and gaming." -# displayed_sidebar: introductionSidebar --- # Solana Validator Documentation diff --git a/docs/src/operations/_category_.json b/docs/src/operations/_category_.json index a32cdd91fe..289f63ff95 100644 --- a/docs/src/operations/_category_.json +++ b/docs/src/operations/_category_.json @@ -2,9 +2,5 @@ "position": 4, "label": "Operating a Validator", "collapsible": true, - "collapsed": true, - "link": { - "type": "doc", - "id": "operations/index" - } + "collapsed": true } diff --git a/docs/src/operations/best-practices/general.md b/docs/src/operations/best-practices/general.md index 3bd0f906f7..29ef42c81b 100644 --- a/docs/src/operations/best-practices/general.md +++ b/docs/src/operations/best-practices/general.md @@ -1,6 +1,7 @@ --- -title: Validator Operations Best Practices +title: Solana Validator Operations Best Practices sidebar_label: General Operations +pagination_label: "Best Practices: Validator Operations" --- After you have successfully setup and started a diff --git a/docs/src/operations/best-practices/monitoring.md b/docs/src/operations/best-practices/monitoring.md index b866a88b86..6d04fc3848 100644 --- a/docs/src/operations/best-practices/monitoring.md +++ b/docs/src/operations/best-practices/monitoring.md @@ -1,6 +1,7 @@ --- -title: Validator Monitoring Best Practices +title: Solana Validator Monitoring Best Practices sidebar_label: Monitoring +pagination_label: "Best Practices: Validator Monitoring" --- It is essential that you have monitoring in place on your validator. In the event that your validator is delinquent (behind the rest of the network) you want to respond immediately to fix the issue. One very useful tool to monitor your validator is [`solana-watchtower`](#solana-watchtower). diff --git a/docs/src/operations/best-practices/security.md b/docs/src/operations/best-practices/security.md index d53491c115..fab46b665a 100644 --- a/docs/src/operations/best-practices/security.md +++ b/docs/src/operations/best-practices/security.md @@ -1,6 +1,7 @@ --- -title: Validator Security Best Practices +title: Solana Validator Security Best Practices sidebar_label: Security +pagination_label: "Best Practices: Validator Security" --- Being a system administrator for an Ubuntu computer requires technical knowledge of the system and best security practices. The following list should help you get started and is considered the bare minimum for keeping your system safe. diff --git a/docs/src/operations/guides/restart-cluster.md b/docs/src/operations/guides/restart-cluster.md index 4039f69a6b..85d4731d60 100644 --- a/docs/src/operations/guides/restart-cluster.md +++ b/docs/src/operations/guides/restart-cluster.md @@ -1,4 +1,10 @@ -## Restarting a cluster +--- +title: "Restarting a Solana Cluster" +# really high number to ensure it is listed last in the sidebar +sidebar_position: 999 +sidebar_label: Restart a Cluster +pagination_label: "Validator Guides: Restart a Cluster" +--- ### Step 1. Identify the latest optimistically confirmed slot for the cluster diff --git a/docs/src/operations/guides/validator-failover.md b/docs/src/operations/guides/validator-failover.md index 34968b7364..168a1a4312 100644 --- a/docs/src/operations/guides/validator-failover.md +++ b/docs/src/operations/guides/validator-failover.md @@ -1,5 +1,8 @@ --- -title: Failover Setup +title: "Validator Guide: Setup Node Failover" +sidebar_position: 9 +sidebar_label: Node Failover +pagination_label: "Validator Guides: Node Failover" --- A simple two machine instance failover method is described here, which allows you to: diff --git a/docs/src/operations/guides/validator-info.md b/docs/src/operations/guides/validator-info.md index 5b232ba02d..56b74f732c 100644 --- a/docs/src/operations/guides/validator-info.md +++ b/docs/src/operations/guides/validator-info.md @@ -1,5 +1,8 @@ --- -title: Publishing Validator Info +title: "Validator Guide: Publishing Validator Info" +sidebar_position: 1 +sidebar_label: Publishing Validator Info +pagination_label: "Validator Guides: Publishing Validator Info" --- You can publish your validator information to the chain to be publicly visible to other users. diff --git a/docs/src/operations/guides/validator-monitor.md b/docs/src/operations/guides/validator-monitor.md index ef18727191..5e314c52e8 100644 --- a/docs/src/operations/guides/validator-monitor.md +++ b/docs/src/operations/guides/validator-monitor.md @@ -1,5 +1,8 @@ --- -title: Monitoring a Validator +title: "Validator Guide: Monitoring a Validator" +sidebar_position: 2 +sidebar_label: Monitoring a Validator +pagination_label: "Validator Guides: Monitoring a Validator" --- ## Check Gossip diff --git a/docs/src/operations/guides/validator-stake.md b/docs/src/operations/guides/validator-stake.md index 85da5c3380..da43c3071d 100644 --- a/docs/src/operations/guides/validator-stake.md +++ b/docs/src/operations/guides/validator-stake.md @@ -1,5 +1,8 @@ --- -title: Staking +title: "Validator Guide: Staking" +sidebar_position: 3 +sidebar_label: Staking +pagination_label: "Validator Guides: Staking" --- **By default your validator will have no stake.** This means it will be diff --git a/docs/src/operations/guides/validator-start.md b/docs/src/operations/guides/validator-start.md index 69cef1315c..378783798b 100644 --- a/docs/src/operations/guides/validator-start.md +++ b/docs/src/operations/guides/validator-start.md @@ -1,5 +1,8 @@ --- -title: Starting a Validator +title: "Validator Guide: Starting a Validator" +sidebar_position: 0 +sidebar_label: Starting a Validator +pagination_label: "Validator Guides: Starting a Validator" --- ## Configure Solana CLI diff --git a/docs/src/operations/guides/validator-troubleshoot.md b/docs/src/operations/guides/validator-troubleshoot.md index abf8d8f442..17ae09cb4d 100644 --- a/docs/src/operations/guides/validator-troubleshoot.md +++ b/docs/src/operations/guides/validator-troubleshoot.md @@ -1,5 +1,8 @@ --- -title: Troubleshooting +title: "Validator Guide: Troubleshooting" +sidebar_position: 4 +sidebar_label: Troubleshooting +pagination_label: "Validator Guides: Troubleshooting" --- There is a `#validator-support` Discord channel available to reach other diff --git a/docs/src/operations/guides/vote-accounts.md b/docs/src/operations/guides/vote-accounts.md index c86b66cb85..b962b1a1df 100644 --- a/docs/src/operations/guides/vote-accounts.md +++ b/docs/src/operations/guides/vote-accounts.md @@ -1,5 +1,8 @@ --- -title: Vote Account Management +title: "Validator Guide: Vote Account Management" +sidebar_position: 5 +sidebar_label: Vote Account Management +pagination_label: "Validator Guides: Vote Account Management" --- This page describes how to set up an on-chain _vote account_. Creating a vote diff --git a/docs/src/operations/prerequisites.md b/docs/src/operations/prerequisites.md index c44c15fc20..fb37d9ec4d 100644 --- a/docs/src/operations/prerequisites.md +++ b/docs/src/operations/prerequisites.md @@ -1,7 +1,8 @@ --- title: Solana Validator Prerequisites -sidebar_label: Prerequisites sidebar_position: 2 +sidebar_label: Prerequisites +pagination_label: Prerequisites to run a Validator --- Operating a Solana validator is an interesting and rewarding task. Generally speaking, it requires someone with a technical background but also involves community engagement and marketing. diff --git a/docs/src/operations/requirements.md b/docs/src/operations/requirements.md index 8c9e8d62cb..2c9cf576e1 100644 --- a/docs/src/operations/requirements.md +++ b/docs/src/operations/requirements.md @@ -1,7 +1,8 @@ --- -title: Validator Requirements -sidebar_label: Requirements +title: Solana Validator Requirements sidebar_position: 3 +sidebar_label: Requirements +pagination_label: Requirements to Operate a Validator --- ## Minimum SOL requirements diff --git a/docs/src/operations/validator-or-rpc-node.md b/docs/src/operations/validator-or-rpc-node.md index c07c5201f1..ca4ded5559 100644 --- a/docs/src/operations/validator-or-rpc-node.md +++ b/docs/src/operations/validator-or-rpc-node.md @@ -1,7 +1,8 @@ --- title: Consensus Validator or RPC Node? -sidebar_label: Validator vs RPC Node sidebar_position: 1 +sidebar_label: Validator vs RPC Node +pagination_label: Consensus Validator vs RPC Node --- Operators who run a [consensus validator](../what-is-a-validator.md) have much diff --git a/docs/src/runtime/programs.md b/docs/src/runtime/programs.md index ae6b0127a2..018169ee1c 100644 --- a/docs/src/runtime/programs.md +++ b/docs/src/runtime/programs.md @@ -1,5 +1,7 @@ --- -title: "Native Programs" +title: "Native Programs in the Solana Runtime" +pagination_label: Runtime Native Programs +sidebar_label: Native Programs --- Solana contains a small handful of native programs, which are required to run diff --git a/docs/src/runtime/sysvars.md b/docs/src/runtime/sysvars.md index 99d271f0a3..36c00747bf 100644 --- a/docs/src/runtime/sysvars.md +++ b/docs/src/runtime/sysvars.md @@ -1,5 +1,7 @@ --- -title: Sysvar Cluster Data +title: Solana Sysvar Cluster Data +pagination_label: Runtime Sysvar Cluster Data +sidebar_label: Sysvar Cluster Data --- Solana exposes a variety of cluster state data to programs via diff --git a/docs/src/runtime/zk-token-proof.md b/docs/src/runtime/zk-token-proof.md index 4127409eeb..46fab4c711 100644 --- a/docs/src/runtime/zk-token-proof.md +++ b/docs/src/runtime/zk-token-proof.md @@ -1,5 +1,7 @@ --- -title: ZK Token Proof Program +title: Solana ZK Token Proof Program +pagination_label: Native ZK Token Proof Program +sidebar_label: ZK Token Proof Program --- The native Solana ZK Token proof program verifies a number of zero-knowledge diff --git a/docs/src/validator/anatomy.md b/docs/src/validator/anatomy.md index 5a61eeff7e..465b08d3fa 100644 --- a/docs/src/validator/anatomy.md +++ b/docs/src/validator/anatomy.md @@ -1,7 +1,8 @@ --- title: Anatomy of a Validator -sidebar_label: Anatomy sidebar_position: 1 +sidebar_label: Anatomy +pagination_label: Anatomy of a Validator --- ![Validator block diagrams](/img/validator.svg) diff --git a/docs/src/validator/blockstore.md b/docs/src/validator/blockstore.md index e49e576bf2..71d41d8a39 100644 --- a/docs/src/validator/blockstore.md +++ b/docs/src/validator/blockstore.md @@ -1,6 +1,8 @@ --- -title: Blockstore +title: Blockstore in a Solana Validator sidebar_position: 3 +sidebar_label: Blockstore +pagination_label: Validator Blockstore --- After a block reaches finality, all blocks from that one on down to the genesis block form a linear chain with the familiar name blockchain. Until that point, however, the validator must maintain all potentially valid chains, called _forks_. The process by which forks naturally form as a result of leader rotation is described in [fork generation](../consensus/fork-generation.md). The _blockstore_ data structure described here is how a validator copes with those forks until blocks are finalized. diff --git a/docs/src/validator/geyser.md b/docs/src/validator/geyser.md index 3ea07473a6..a8a29d10dd 100644 --- a/docs/src/validator/geyser.md +++ b/docs/src/validator/geyser.md @@ -1,5 +1,7 @@ --- -title: Geyser Plugins +title: Solana Validator Geyser Plugins +sidebar_label: Geyser Plugins +pagination_label: Validator Geyser Plugins --- ## Overview diff --git a/docs/src/validator/gossip.md b/docs/src/validator/gossip.md index 3c637f5c70..f0a2e43f51 100644 --- a/docs/src/validator/gossip.md +++ b/docs/src/validator/gossip.md @@ -1,6 +1,8 @@ --- -title: Gossip Service +title: Gossip Service in a Solana Validator sidebar_position: 5 +sidebar_label: Gossip Service +pagination_label: Validator Gossip Service --- The Gossip Service acts as a gateway to nodes in the diff --git a/docs/src/validator/runtime.md b/docs/src/validator/runtime.md index 2bf8a52563..a9afba3c05 100644 --- a/docs/src/validator/runtime.md +++ b/docs/src/validator/runtime.md @@ -1,6 +1,8 @@ --- -title: Runtime +title: Solana Runtime on a Solana Validator sidebar_position: 6 +sidebar_label: Runtime +pagination_label: Validator Runtime --- The runtime is a concurrent transaction processor. Transactions specify their data dependencies upfront and dynamic memory allocation is explicit. By separating program code from the state it operates on, the runtime is able to choreograph concurrent access. Transactions accessing only read-only accounts are executed in parallel whereas transactions accessing writable accounts are serialized. The runtime interacts with the program through an entrypoint with a well-defined interface. The data stored in an account is an opaque type, an array of bytes. The program has full control over its contents. diff --git a/docs/src/validator/tpu.md b/docs/src/validator/tpu.md index 0082902078..7585911bf2 100644 --- a/docs/src/validator/tpu.md +++ b/docs/src/validator/tpu.md @@ -1,7 +1,8 @@ --- -title: Transaction Processing Unit -sidebar_label: TPU +title: Transaction Processing Unit in a Solana Validator sidebar_position: 2 +sidebar_label: TPU +pagination_label: Validator's Transaction Processing Unit (TPU) --- TPU (Transaction Processing Unit) is the logic of the validator diff --git a/docs/src/validator/tvu.md b/docs/src/validator/tvu.md index e3ac7776f0..362b6bae16 100644 --- a/docs/src/validator/tvu.md +++ b/docs/src/validator/tvu.md @@ -1,7 +1,8 @@ --- -title: Transaction Validation Unit -sidebar_label: TVU +title: Transaction Validation Unit in a Solana Validator sidebar_position: 3 +sidebar_label: TVU +pagination_label: Validator's Transaction Validation Unit (TVU) --- TVU (Transaction Validation Unit) is the logic of the validator