diff --git a/.gitbook.yaml b/.gitbook.yaml index 1b474aa070..74d01c16c7 100644 --- a/.gitbook.yaml +++ b/.gitbook.yaml @@ -1,4 +1,4 @@ -root: ./book/src +root: ./docs/src structure: readme: introduction.md diff --git a/.gitignore b/.gitignore index f29f28d1c0..b190130846 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,6 @@ -/book/html/ -/book/src/tests.ok -/book/src/.gitbook/assets/*.svg +/docs/html/ +/docs/src/tests.ok +/docs/src/.gitbook/assets/*.svg /farf/ /solana-release/ /solana-release.tar.bz2 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 32d1fa5b67..76f35c2a1d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -224,21 +224,20 @@ Inventing new terms is allowed, but should only be done when the term is widely used and understood. Avoid introducing new 3-letter terms, which can be confused with 3-letter acronyms. -[Terms currently in use](book/src/terminology.md) +[Terms currently in use](docs/src/terminology.md) ## Design Proposals -Solana's architecture is described by a book generated from markdown files in -the `book/src/` directory, maintained by an *editor* (currently @garious). To -add a design proposal, you'll need to at least propose a change the content -under the [Accepted Design -Proposals](https://docs.solana.com/book/v/master/proposals) chapter. Here's -the full process: +Solana's architecture is described by docs generated from markdown files in +the `docs/src/` directory, maintained by an *editor* (currently @garious). To +add a design proposal, you'll need to include it in the +[Accepted Design Proposals](https://docs.solana.com/proposals) +section of the Solana docs. Here's the full process: 1. Propose a design by creating a PR that adds a markdown document to the - directory `book/src/` and references it from the [table of - contents](book/src/SUMMARY.md). Add any relevant *maintainers* to the PR + `docs/src/proposals` directory and references it from the [table of + contents](docs/src/SUMMARY.md). Add any relevant *maintainers* to the PR review. 2. The PR being merged indicates your proposed change was accepted and that the maintainers support your plan of attack. diff --git a/README.md b/README.md index 0fcf63a713..316f0d2fd6 100644 --- a/README.md +++ b/README.md @@ -23,12 +23,12 @@ It's possible for a centralized database to process 710,000 transactions per sec Furthermore, and much to our surprise, it can be implemented using a mechanism that has existed in Bitcoin since day one. The Bitcoin feature is called nLocktime and it can be used to postdate transactions using block height instead of a timestamp. As a Bitcoin client, you'd use block height instead of a timestamp if you don't trust the network. Block height turns out to be an instance of what's being called a Verifiable Delay Function in cryptography circles. It's a cryptographically secure way to say time has passed. In Solana, we use a far more granular verifiable delay function, a SHA 256 hash chain, to checkpoint the ledger and coordinate consensus. With it, we implement Optimistic Concurrency Control and are now well en route towards that theoretical limit of 710,000 transactions per second. -Architecture +Documentation === -Before you jump into the code, review the online book [Solana: Blockchain Rebuilt for Scale](https://docs.solana.com/book/). +Before you jump into the code, review the documentation [Solana: Blockchain Rebuilt for Scale](https://docs.solana.com). -(The _latest_ development version of the online book is also [available here](https://docs.solana.com/book/v/master/).) +(The _latest_ development version of the docs is [available here](https://docs.solana.com/v/master).) Release Binaries === @@ -121,7 +121,7 @@ $ cargo test Local Testnet --- -Start your own testnet locally, instructions are in the book [Solana: Blockchain Rebuild for Scale: Getting Started](https://docs.solana.com/book/building-from-source). +Start your own testnet locally, instructions are in the online docs [Solana: Blockchain Rebuild for Scale: Getting Started](https://docs.solana.com/building-from-source). Remote Testnets --- diff --git a/RELEASE.md b/RELEASE.md index 00b9f0f797..bb382e3880 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -138,7 +138,7 @@ There are three release channels that map to branches as follows: ### Update documentation TODO: Documentation update procedure is WIP as we move to gitbook -Document the new recommended version by updating `book/src/running-archiver.md` and `book/src/validator-testnet.md` on the release (beta) branch to point at the `solana-install` for the upcoming release version. +Document the new recommended version by updating `docs/src/running-archiver.md` and `docs/src/validator-testnet.md` on the release (beta) branch to point at the `solana-install` for the upcoming release version. ### Update software on devnet.solana.com diff --git a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md b/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md deleted file mode 100644 index dfeddbf99b..0000000000 --- a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md +++ /dev/null @@ -1,11 +0,0 @@ -# Replication-validation Transaction Fees - -**Subject to change.** - -As previously mentioned, validator-clients will also be responsible for validating PoReps submitted into the PoH stream by archiver-clients. In this case, validators are providing compute \(CPU/GPU\) and light storage resources to confirm that these replication proofs could only be generated by a client that is storing the referenced PoH leger block. - -While replication-clients are incentivized and rewarded through protocol-based rewards schedule \(see [Replication-client Economics](../ed_replication_client_economics/)\), validator-clients will be incentivized to include and validate PoReps in PoH through collection of transaction fees associated with the submitted PoReps and distribution of protocol rewards proportional to the validated PoReps. As will be described in detail in the Section 3.1, replication-client rewards are protocol-based and designed to reward based on a global data redundancy factor. I.e. the protocol will incentivize replication-client participation through rewards based on a target ledger redundancy \(e.g. 10x data redundancy\). - -The validation of PoReps by validation-clients is computationally more expensive than state-validation \(detail in the [Economic Sustainability](../ed_economic_sustainability.md) chapter\), thus the transaction fees are expected to be proportionally higher. - -There are various attack vectors available for colluding validation and replication clients, also described in detail below in [Economic Sustainability](../ed_economic_sustainability/README.md). To protect against various collusion attack vectors, for a given epoch, validator rewards are distributed across participating validation-clients in proportion to the number of validated PoReps in the epoch less the number of PoReps that mismatch the archivers challenge. The PoRep challenge game is described in [Ledger Replication](https://github.com/solana-labs/solana/blob/master/book/src/ledger-replication.md#the-porep-game). This design rewards validators proportional to the number of PoReps they process and validate, while providing negative pressure for validation-clients to submit lazy or malicious invalid votes on submitted PoReps \(note that it is computationally prohibitive to determine whether a validator-client has marked a valid PoRep as invalid\). diff --git a/ci/affects-files.sh b/ci/affects-files.sh index edcf58c763..a34db03dac 100755 --- a/ci/affects-files.sh +++ b/ci/affects-files.sh @@ -9,7 +9,7 @@ # ./affects-files.sh ^snap/ -- anything under the snap/ subdirectory # ./affects-files.sh snap/ -- also matches foo/snap/ # Any pattern starting with the ! character will be negated: -# ./affects-files.sh !^book/ -- anything *not* under the book/ subdirectory +# ./affects-files.sh !^docs/ -- anything *not* under the docs/ subdirectory # set -e cd "$(dirname "$0")"/.. diff --git a/ci/buildkite-secondary.yml b/ci/buildkite-secondary.yml index bec263757e..adc660c427 100644 --- a/ci/buildkite-secondary.yml +++ b/ci/buildkite-secondary.yml @@ -15,6 +15,6 @@ steps: - command: "ci/publish-tarball.sh" timeout_in_minutes: 60 name: "publish tarball" - - command: "ci/publish-book.sh" + - command: "ci/publish-docs.sh" timeout_in_minutes: 15 - name: "publish book" + name: "publish docs" diff --git a/ci/publish-book.sh b/ci/publish-docs.sh similarity index 84% rename from ci/publish-book.sh rename to ci/publish-docs.sh index 73028c8559..3c3d706c60 100755 --- a/ci/publish-book.sh +++ b/ci/publish-docs.sh @@ -11,10 +11,10 @@ if [[ -n $CI_BRANCH ]]; then set -x ( . ci/rust-version.sh stable - ci/docker-run.sh "$rust_stable_docker_image" make -Cbook -B svg + ci/docker-run.sh "$rust_stable_docker_image" make -C docs -B svg ) # make a local commit for the svgs - git add -A -f book/src/.gitbook/assets/. + git add -A -f docs/src/.gitbook/assets/. if ! git diff-index --quiet HEAD; then git config user.email maintainers@solana.com git config user.name "$me" diff --git a/ci/test-checks.sh b/ci/test-checks.sh index 65b69d82c0..1d73de5b1b 100755 --- a/ci/test-checks.sh +++ b/ci/test-checks.sh @@ -25,7 +25,7 @@ _ cargo +"$rust_stable" audit --version _ cargo +"$rust_stable" audit --ignore RUSTSEC-2020-0002 _ ci/nits.sh _ ci/order-crates-for-publishing.py -_ book/build.sh +_ docs/build.sh _ ci/check-ssh-keys.sh { diff --git a/ci/test-stable.sh b/ci/test-stable.sh index 4c4ae41b5d..4ba5bd6f60 100755 --- a/ci/test-stable.sh +++ b/ci/test-stable.sh @@ -13,12 +13,12 @@ annotate() { # Run the appropriate test based on entrypoint testName=$(basename "$0" .sh) -# Skip if only the book has been modified +# Skip if only the docs have been modified ci/affects-files.sh \ - \!^book/ \ + \!^docs/ \ || { annotate --style info \ - "Skipped $testName as only book files were modified" + "Skipped $testName as only docs/ files were modified" exit 0 } diff --git a/core/src/repair_service.rs b/core/src/repair_service.rs index a31f22de66..981d4659c4 100644 --- a/core/src/repair_service.rs +++ b/core/src/repair_service.rs @@ -317,7 +317,7 @@ impl RepairService { ); } - // Update the gossiped structure used for the "Repairmen" repair protocol. See book + // Update the gossiped structure used for the "Repairmen" repair protocol. See docs // for details. fn update_epoch_slots( id: Pubkey, diff --git a/core/tests/fork-selection.rs b/core/tests/fork-selection.rs index aa099572c5..c89b9d4cd5 100644 --- a/core/tests/fork-selection.rs +++ b/core/tests/fork-selection.rs @@ -1,6 +1,6 @@ //! Fork Selection Simulation //! -//! Description of the algorithm can be found in [book/src/fork-selection.md](book/src/fork-selection.md). +//! Description of the algorithm can be found in [docs/src/fork-selection.md](docs/src/fork-selection.md). //! //! A test library function exists for configuring networks. //! ``` diff --git a/book/.gitattributes b/docs/.gitattributes similarity index 100% rename from book/.gitattributes rename to docs/.gitattributes diff --git a/book/README.md b/docs/README.md similarity index 77% rename from book/README.md rename to docs/README.md index b1ded98f34..bff13c28c1 100644 --- a/book/README.md +++ b/docs/README.md @@ -1,7 +1,7 @@ Building the Solana Docs --- -Install the book's dependencies, build, and test the book: +Install dependencies, build, and test the docs: ```bash $ brew install coreutils @@ -23,7 +23,7 @@ Render markdown as HTML: $ make build ``` -Render and view the book: +Render and view the docs: ```bash $ make open diff --git a/book/art/data-plane-fanout.bob b/docs/art/data-plane-fanout.bob similarity index 100% rename from book/art/data-plane-fanout.bob rename to docs/art/data-plane-fanout.bob diff --git a/book/art/data-plane-neighborhood.bob b/docs/art/data-plane-neighborhood.bob similarity index 100% rename from book/art/data-plane-neighborhood.bob rename to docs/art/data-plane-neighborhood.bob diff --git a/book/art/data-plane-seeding.bob b/docs/art/data-plane-seeding.bob similarity index 100% rename from book/art/data-plane-seeding.bob rename to docs/art/data-plane-seeding.bob diff --git a/book/art/data-plane.bob b/docs/art/data-plane.bob similarity index 100% rename from book/art/data-plane.bob rename to docs/art/data-plane.bob diff --git a/book/art/fork-generation.bob b/docs/art/fork-generation.bob similarity index 100% rename from book/art/fork-generation.bob rename to docs/art/fork-generation.bob diff --git a/book/art/forks-pruned.bob b/docs/art/forks-pruned.bob similarity index 100% rename from book/art/forks-pruned.bob rename to docs/art/forks-pruned.bob diff --git a/book/art/forks-pruned2.bob b/docs/art/forks-pruned2.bob similarity index 100% rename from book/art/forks-pruned2.bob rename to docs/art/forks-pruned2.bob diff --git a/book/art/forks.bob b/docs/art/forks.bob similarity index 100% rename from book/art/forks.bob rename to docs/art/forks.bob diff --git a/book/art/passive-staking-callflow.msc b/docs/art/passive-staking-callflow.msc similarity index 100% rename from book/art/passive-staking-callflow.msc rename to docs/art/passive-staking-callflow.msc diff --git a/book/art/runtime.bob b/docs/art/runtime.bob similarity index 100% rename from book/art/runtime.bob rename to docs/art/runtime.bob diff --git a/book/art/sdk-tools.bob b/docs/art/sdk-tools.bob similarity index 100% rename from book/art/sdk-tools.bob rename to docs/art/sdk-tools.bob diff --git a/book/art/spv-bank-hash.bob b/docs/art/spv-bank-hash.bob similarity index 100% rename from book/art/spv-bank-hash.bob rename to docs/art/spv-bank-hash.bob diff --git a/book/art/spv-block-merkle.bob b/docs/art/spv-block-merkle.bob similarity index 100% rename from book/art/spv-block-merkle.bob rename to docs/art/spv-block-merkle.bob diff --git a/book/art/tpu.bob b/docs/art/tpu.bob similarity index 100% rename from book/art/tpu.bob rename to docs/art/tpu.bob diff --git a/book/art/tvu.bob b/docs/art/tvu.bob similarity index 100% rename from book/art/tvu.bob rename to docs/art/tvu.bob diff --git a/book/art/validator-proposal.bob b/docs/art/validator-proposal.bob similarity index 100% rename from book/art/validator-proposal.bob rename to docs/art/validator-proposal.bob diff --git a/book/art/validator.bob b/docs/art/validator.bob similarity index 100% rename from book/art/validator.bob rename to docs/art/validator.bob diff --git a/book/book.toml b/docs/book.toml similarity index 100% rename from book/book.toml rename to docs/book.toml diff --git a/book/build-cli-usage.sh b/docs/build-cli-usage.sh similarity index 100% rename from book/build-cli-usage.sh rename to docs/build-cli-usage.sh diff --git a/book/build.sh b/docs/build.sh similarity index 100% rename from book/build.sh rename to docs/build.sh diff --git a/book/makefile b/docs/makefile similarity index 100% rename from book/makefile rename to docs/makefile diff --git a/book/src/.gitbook/assets/p_ex_interest.png b/docs/src/.gitbook/assets/p_ex_interest.png similarity index 100% rename from book/src/.gitbook/assets/p_ex_interest.png rename to docs/src/.gitbook/assets/p_ex_interest.png diff --git a/book/src/.gitbook/assets/p_ex_schedule.png b/docs/src/.gitbook/assets/p_ex_schedule.png similarity index 100% rename from book/src/.gitbook/assets/p_ex_schedule.png rename to docs/src/.gitbook/assets/p_ex_schedule.png diff --git a/book/src/.gitbook/assets/p_ex_supply.png b/docs/src/.gitbook/assets/p_ex_supply.png similarity index 100% rename from book/src/.gitbook/assets/p_ex_supply.png rename to docs/src/.gitbook/assets/p_ex_supply.png diff --git a/book/src/SUMMARY.md b/docs/src/SUMMARY.md similarity index 100% rename from book/src/SUMMARY.md rename to docs/src/SUMMARY.md diff --git a/book/src/apps/README.md b/docs/src/apps/README.md similarity index 100% rename from book/src/apps/README.md rename to docs/src/apps/README.md diff --git a/book/src/apps/drones.md b/docs/src/apps/drones.md similarity index 98% rename from book/src/apps/drones.md rename to docs/src/apps/drones.md index 941d6f2015..05925938da 100644 --- a/book/src/apps/drones.md +++ b/docs/src/apps/drones.md @@ -1,6 +1,6 @@ # Drones -This chapter defines an off-chain service called a _drone_, which acts as custodian of a user's private key. In its simplest form, it can be used to create _airdrop_ transactions, a token transfer from the drone's account to a client's account. +This section defines an off-chain service called a _drone_, which acts as custodian of a user's private key. In its simplest form, it can be used to create _airdrop_ transactions, a token transfer from the drone's account to a client's account. ## Signing Service diff --git a/book/src/apps/javascript-api.md b/docs/src/apps/javascript-api.md similarity index 100% rename from book/src/apps/javascript-api.md rename to docs/src/apps/javascript-api.md diff --git a/book/src/apps/jsonrpc-api.md b/docs/src/apps/jsonrpc-api.md similarity index 100% rename from book/src/apps/jsonrpc-api.md rename to docs/src/apps/jsonrpc-api.md diff --git a/book/src/apps/tictactoe.md b/docs/src/apps/tictactoe.md similarity index 100% rename from book/src/apps/tictactoe.md rename to docs/src/apps/tictactoe.md diff --git a/book/src/apps/webwallet.md b/docs/src/apps/webwallet.md similarity index 100% rename from book/src/apps/webwallet.md rename to docs/src/apps/webwallet.md diff --git a/book/src/building-from-source.md b/docs/src/building-from-source.md similarity index 96% rename from book/src/building-from-source.md rename to docs/src/building-from-source.md index b38f0649e9..2250756bb9 100644 --- a/book/src/building-from-source.md +++ b/docs/src/building-from-source.md @@ -123,7 +123,7 @@ This will dump all the threads stack traces into gdb.txt ### Blockstreamer -Solana supports a node type called an _blockstreamer_. This validator variation is intended for applications that need to observe the data plane without participating in transaction validation or ledger replication. +Solana supports a node type called a _blockstreamer_. This validator variation is intended for applications that need to observe the data plane without participating in transaction validation or ledger replication. A blockstreamer runs without a vote signer, and can optionally stream ledger entries out to a Unix domain socket as they are processed. The JSON-RPC service still functions as on any other node. diff --git a/book/src/cli/.usage.md.header b/docs/src/cli/.usage.md.header similarity index 100% rename from book/src/cli/.usage.md.header rename to docs/src/cli/.usage.md.header diff --git a/book/src/cli/README.md b/docs/src/cli/README.md similarity index 68% rename from book/src/cli/README.md rename to docs/src/cli/README.md index 6d0fc682f4..f5ffb32cc7 100644 --- a/book/src/cli/README.md +++ b/docs/src/cli/README.md @@ -1,5 +1,5 @@ # Using Solana from the Command-line -This chapter describes the command-line tools for interacting with Solana. One +This section describes the command-line tools for interacting with Solana. One could use these tools to send payments, stake validators, and check account balances. diff --git a/book/src/cli/usage.md b/docs/src/cli/usage.md similarity index 100% rename from book/src/cli/usage.md rename to docs/src/cli/usage.md diff --git a/book/src/cluster/README.md b/docs/src/cluster/README.md similarity index 98% rename from book/src/cluster/README.md rename to docs/src/cluster/README.md index d9066c52d7..298e77744b 100644 --- a/book/src/cluster/README.md +++ b/docs/src/cluster/README.md @@ -1,6 +1,6 @@ # 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 chapter, 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. +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. ## Creating a Cluster diff --git a/book/src/cluster/fork-generation.md b/docs/src/cluster/fork-generation.md similarity index 97% rename from book/src/cluster/fork-generation.md rename to docs/src/cluster/fork-generation.md index bfae2b1b30..01d97390dd 100644 --- a/book/src/cluster/fork-generation.md +++ b/docs/src/cluster/fork-generation.md @@ -1,6 +1,6 @@ # Fork Generation -The chapter describes how forks naturally occur as a consequence of [leader rotation](leader-rotation.md). +This section describes how forks naturally occur as a consequence of [leader rotation](leader-rotation.md). ## Overview diff --git a/book/src/cluster/leader-rotation.md b/docs/src/cluster/leader-rotation.md similarity index 100% rename from book/src/cluster/leader-rotation.md rename to docs/src/cluster/leader-rotation.md diff --git a/book/src/cluster/ledger-replication.md b/docs/src/cluster/ledger-replication.md similarity index 100% rename from book/src/cluster/ledger-replication.md rename to docs/src/cluster/ledger-replication.md diff --git a/book/src/cluster/managing-forks.md b/docs/src/cluster/managing-forks.md similarity index 100% rename from book/src/cluster/managing-forks.md rename to docs/src/cluster/managing-forks.md diff --git a/book/src/cluster/performance-metrics.md b/docs/src/cluster/performance-metrics.md similarity index 100% rename from book/src/cluster/performance-metrics.md rename to docs/src/cluster/performance-metrics.md diff --git a/book/src/cluster/stake-delegation-and-rewards.md b/docs/src/cluster/stake-delegation-and-rewards.md similarity index 99% rename from book/src/cluster/stake-delegation-and-rewards.md rename to docs/src/cluster/stake-delegation-and-rewards.md index f6b067c249..9a62482ed0 100644 --- a/book/src/cluster/stake-delegation-and-rewards.md +++ b/docs/src/cluster/stake-delegation-and-rewards.md @@ -1,6 +1,6 @@ # Stake Delegation and Rewards -Stakers are rewarded for helping to validate the ledger. They do this by delegating their stake to validator nodes. Those validators do the legwork of replaying the ledger and send votes to a per-node vote account to which stakers can delegate their stakes. The rest of the cluster uses those stake-weighted votes to select a block when forks arise. Both the validator and staker need some economic incentive to play their part. The validator needs to be compensated for its hardware and the staker needs to be compensated for the risk of getting its stake slashed. The economics are covered in [staking rewards](../implemented-proposals/staking-rewards.md). This chapter, on the other hand, describes the underlying mechanics of its implementation. +Stakers are rewarded for helping to validate the ledger. They do this by delegating their stake to validator nodes. Those validators do the legwork of replaying the ledger and send votes to a per-node vote account to which stakers can delegate their stakes. The rest of the cluster uses those stake-weighted votes to select a block when forks arise. Both the validator and staker need some economic incentive to play their part. The validator needs to be compensated for its hardware and the staker needs to be compensated for the risk of getting its stake slashed. The economics are covered in [staking rewards](../implemented-proposals/staking-rewards.md). This section, on the other hand, describes the underlying mechanics of its implementation. ## Basic Design diff --git a/book/src/cluster/synchronization.md b/docs/src/cluster/synchronization.md similarity index 100% rename from book/src/cluster/synchronization.md rename to docs/src/cluster/synchronization.md diff --git a/book/src/cluster/turbine-block-propagation.md b/docs/src/cluster/turbine-block-propagation.md similarity index 100% rename from book/src/cluster/turbine-block-propagation.md rename to docs/src/cluster/turbine-block-propagation.md diff --git a/book/src/cluster/vote-signing.md b/docs/src/cluster/vote-signing.md similarity index 100% rename from book/src/cluster/vote-signing.md rename to docs/src/cluster/vote-signing.md diff --git a/book/src/implemented-proposals/README.md b/docs/src/implemented-proposals/README.md similarity index 100% rename from book/src/implemented-proposals/README.md rename to docs/src/implemented-proposals/README.md diff --git a/book/src/implemented-proposals/commitment.md b/docs/src/implemented-proposals/commitment.md similarity index 100% rename from book/src/implemented-proposals/commitment.md rename to docs/src/implemented-proposals/commitment.md diff --git a/book/src/implemented-proposals/durable-tx-nonces.md b/docs/src/implemented-proposals/durable-tx-nonces.md similarity index 100% rename from book/src/implemented-proposals/durable-tx-nonces.md rename to docs/src/implemented-proposals/durable-tx-nonces.md diff --git a/book/src/implemented-proposals/ed_overview/README.md b/docs/src/implemented-proposals/ed_overview/README.md similarity index 75% rename from book/src/implemented-proposals/ed_overview/README.md rename to docs/src/implemented-proposals/ed_overview/README.md index b732d5665e..4d7290bb22 100644 --- a/book/src/implemented-proposals/ed_overview/README.md +++ b/docs/src/implemented-proposals/ed_overview/README.md @@ -10,6 +10,6 @@ These protocol-based rewards, to be distributed to participating validation and Transaction fees are market-based participant-to-participant transfers, attached to network interactions as a necessary motivation and compensation for the inclusion and execution of a proposed transaction \(be it a state execution or proof-of-replication verification\). A mechanism for long-term economic stability and forking protection through partial burning of each transaction fee is also discussed below. -A high-level schematic of Solana’s crypto-economic design is shown below in **Figure 1**. The specifics of validation-client economics are described in sections: [Validation-client Economics](ed_validation_client_economics/), [State-validation Protocol-based Rewards](ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md), [State-validation Transaction Fees](ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md) and [Replication-validation Transaction Fees](ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md). Also, the chapter titled [Validation Stake Delegation](ed_validation_client_economics/ed_vce_validation_stake_delegation.md) closes with a discussion of validator delegation opportunties and marketplace. Additionally, in [Storage Rent Economics](ed_storage_rent_economics.md), we describe an implementation of storage rent to account for the externality costs of maintaining the active state of the ledger. The [Replication-client Economics](ed_replication_client_economics/) chapter will review the Solana network design for global ledger storage/redundancy and archiver-client economics \([Storage-replication rewards](ed_replication_client_economics/ed_rce_storage_replication_rewards.md)\) along with an archiver-to-validator delegation mechanism designed to aide participant on-boarding into the Solana economy discussed in [Replication-client Reward Auto-delegation](ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md). An outline of features for an MVP economic design is discussed in the [Economic Design MVP](ed_mvp.md) section. Finally, in chapter [Attack Vectors](ed_attack_vectors.md), various attack vectors will be described and potential vulnerabilities explored and parameterized. +A high-level schematic of Solana’s crypto-economic design is shown below in **Figure 1**. The specifics of validation-client economics are described in sections: [Validation-client Economics](ed_validation_client_economics/), [State-validation Protocol-based Rewards](ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md), [State-validation Transaction Fees](ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md) and [Replication-validation Transaction Fees](ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md). Also, the section titled [Validation Stake Delegation](ed_validation_client_economics/ed_vce_validation_stake_delegation.md) closes with a discussion of validator delegation opportunties and marketplace. Additionally, in [Storage Rent Economics](ed_storage_rent_economics.md), we describe an implementation of storage rent to account for the externality costs of maintaining the active state of the ledger. [Replication-client Economics](ed_replication_client_economics/) will review the Solana network design for global ledger storage/redundancy and archiver-client economics \([Storage-replication rewards](ed_replication_client_economics/ed_rce_storage_replication_rewards.md)\) along with an archiver-to-validator delegation mechanism designed to aide participant on-boarding into the Solana economy discussed in [Replication-client Reward Auto-delegation](ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md). An outline of features for an MVP economic design is discussed in the [Economic Design MVP](ed_mvp.md) section. Finally, in [Attack Vectors](ed_attack_vectors.md), various attack vectors will be described and potential vulnerabilities explored and parameterized. **Figure 1**: Schematic overview of Solana economic incentive design. diff --git a/book/src/implemented-proposals/ed_overview/ed_attack_vectors.md b/docs/src/implemented-proposals/ed_overview/ed_attack_vectors.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_attack_vectors.md rename to docs/src/implemented-proposals/ed_overview/ed_attack_vectors.md diff --git a/book/src/implemented-proposals/ed_overview/ed_economic_sustainability.md b/docs/src/implemented-proposals/ed_overview/ed_economic_sustainability.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_economic_sustainability.md rename to docs/src/implemented-proposals/ed_overview/ed_economic_sustainability.md diff --git a/book/src/implemented-proposals/ed_overview/ed_mvp.md b/docs/src/implemented-proposals/ed_overview/ed_mvp.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_mvp.md rename to docs/src/implemented-proposals/ed_overview/ed_mvp.md diff --git a/book/src/implemented-proposals/ed_overview/ed_references.md b/docs/src/implemented-proposals/ed_overview/ed_references.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_references.md rename to docs/src/implemented-proposals/ed_overview/ed_references.md diff --git a/book/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md b/docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md similarity index 77% rename from book/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md rename to docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md index c92417f09b..e61d34f265 100644 --- a/book/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md +++ b/docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/README.md @@ -2,5 +2,5 @@ **Subject to change.** -Replication-clients should be rewarded for providing the network with storage space. Incentivization of the set of archivers provides data security through redundancy of the historical ledger. Replication nodes are rewarded in proportion to the amount of ledger data storage provided, as proved by successfully submitting Proofs-of-Replication to the cluster.. These rewards are captured by generating and entering Proofs of Replication \(PoReps\) into the PoH stream which can be validated by Validation nodes as described above in the [Replication-validation Transaction Fees](../ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md) chapter. +Replication-clients should be rewarded for providing the network with storage space. Incentivization of the set of archivers provides data security through redundancy of the historical ledger. Replication nodes are rewarded in proportion to the amount of ledger data storage provided, as proved by successfully submitting Proofs-of-Replication to the cluster.. These rewards are captured by generating and entering Proofs of Replication \(PoReps\) into the PoH stream which can be validated by Validation nodes as described in [Replication-validation Transaction Fees](../ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md). diff --git a/book/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md b/docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md rename to docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_replication_client_reward_auto_delegation.md diff --git a/book/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_storage_replication_rewards.md b/docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_storage_replication_rewards.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_storage_replication_rewards.md rename to docs/src/implemented-proposals/ed_overview/ed_replication_client_economics/ed_rce_storage_replication_rewards.md diff --git a/book/src/implemented-proposals/ed_overview/ed_storage_rent_economics.md b/docs/src/implemented-proposals/ed_overview/ed_storage_rent_economics.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_storage_rent_economics.md rename to docs/src/implemented-proposals/ed_overview/ed_storage_rent_economics.md diff --git a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/README.md b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/README.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_validation_client_economics/README.md rename to docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/README.md diff --git a/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md new file mode 100644 index 0000000000..b8c0d58293 --- /dev/null +++ b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_replication_validation_transaction_fees.md @@ -0,0 +1,11 @@ +# Replication-validation Transaction Fees + +**Subject to change.** + +As previously mentioned, validator-clients will also be responsible for validating PoReps submitted into the PoH stream by archiver-clients. In this case, validators are providing compute \(CPU/GPU\) and light storage resources to confirm that these replication proofs could only be generated by a client that is storing the referenced PoH leger block. + +While replication-clients are incentivized and rewarded through protocol-based rewards schedule \(see [Replication-client Economics](../ed_replication_client_economics/README.md)\), validator-clients will be incentivized to include and validate PoReps in PoH through collection of transaction fees associated with the submitted PoReps and distribution of protocol rewards proportional to the validated PoReps. As will be described in detail in the Section 3.1, replication-client rewards are protocol-based and designed to reward based on a global data redundancy factor. I.e. the protocol will incentivize replication-client participation through rewards based on a target ledger redundancy \(e.g. 10x data redundancy\). + +The validation of PoReps by validation-clients is computationally more expensive than state-validation \(detailed in the [Economic Sustainability](../ed_economic_sustainability.md) section\), thus the transaction fees are expected to be proportionally higher. + +There are various attack vectors available for colluding validation and replication clients, also described in detail in [Economic Sustainability](../ed_economic_sustainability.md). To protect against various collusion attack vectors, for a given epoch, validator rewards are distributed across participating validation-clients in proportion to the number of validated PoReps in the epoch less the number of PoReps that mismatch the archivers challenge. The PoRep challenge game is described in [Ledger Replication](../../../cluster/ledger-replication.md#the-porep-game). This design rewards validators proportional to the number of PoReps they process and validate, while providing negative pressure for validation-clients to submit lazy or malicious invalid votes on submitted PoReps \(note that it is computationally prohibitive to determine whether a validator-client has marked a valid PoRep as invalid\). diff --git a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md rename to docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md diff --git a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md rename to docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_transaction_fees.md diff --git a/book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_validation_stake_delegation.md b/docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_validation_stake_delegation.md similarity index 100% rename from book/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_validation_stake_delegation.md rename to docs/src/implemented-proposals/ed_overview/ed_validation_client_economics/ed_vce_validation_stake_delegation.md diff --git a/book/src/implemented-proposals/embedding-move.md b/docs/src/implemented-proposals/embedding-move.md similarity index 100% rename from book/src/implemented-proposals/embedding-move.md rename to docs/src/implemented-proposals/embedding-move.md diff --git a/book/src/implemented-proposals/installer.md b/docs/src/implemented-proposals/installer.md similarity index 100% rename from book/src/implemented-proposals/installer.md rename to docs/src/implemented-proposals/installer.md diff --git a/book/src/implemented-proposals/leader-leader-transition.md b/docs/src/implemented-proposals/leader-leader-transition.md similarity index 100% rename from book/src/implemented-proposals/leader-leader-transition.md rename to docs/src/implemented-proposals/leader-leader-transition.md diff --git a/book/src/implemented-proposals/leader-validator-transition.md b/docs/src/implemented-proposals/leader-validator-transition.md similarity index 100% rename from book/src/implemented-proposals/leader-validator-transition.md rename to docs/src/implemented-proposals/leader-validator-transition.md diff --git a/book/src/implemented-proposals/persistent-account-storage.md b/docs/src/implemented-proposals/persistent-account-storage.md similarity index 100% rename from book/src/implemented-proposals/persistent-account-storage.md rename to docs/src/implemented-proposals/persistent-account-storage.md diff --git a/book/src/implemented-proposals/readonly-accounts.md b/docs/src/implemented-proposals/readonly-accounts.md similarity index 100% rename from book/src/implemented-proposals/readonly-accounts.md rename to docs/src/implemented-proposals/readonly-accounts.md diff --git a/book/src/implemented-proposals/reliable-vote-transmission.md b/docs/src/implemented-proposals/reliable-vote-transmission.md similarity index 100% rename from book/src/implemented-proposals/reliable-vote-transmission.md rename to docs/src/implemented-proposals/reliable-vote-transmission.md diff --git a/book/src/implemented-proposals/rent.md b/docs/src/implemented-proposals/rent.md similarity index 100% rename from book/src/implemented-proposals/rent.md rename to docs/src/implemented-proposals/rent.md diff --git a/book/src/implemented-proposals/repair-service.md b/docs/src/implemented-proposals/repair-service.md similarity index 100% rename from book/src/implemented-proposals/repair-service.md rename to docs/src/implemented-proposals/repair-service.md diff --git a/book/src/implemented-proposals/snapshot-verification.md b/docs/src/implemented-proposals/snapshot-verification.md similarity index 100% rename from book/src/implemented-proposals/snapshot-verification.md rename to docs/src/implemented-proposals/snapshot-verification.md diff --git a/book/src/implemented-proposals/staking-rewards.md b/docs/src/implemented-proposals/staking-rewards.md similarity index 100% rename from book/src/implemented-proposals/staking-rewards.md rename to docs/src/implemented-proposals/staking-rewards.md diff --git a/book/src/implemented-proposals/testing-programs.md b/docs/src/implemented-proposals/testing-programs.md similarity index 100% rename from book/src/implemented-proposals/testing-programs.md rename to docs/src/implemented-proposals/testing-programs.md diff --git a/book/src/implemented-proposals/tower-bft.md b/docs/src/implemented-proposals/tower-bft.md similarity index 100% rename from book/src/implemented-proposals/tower-bft.md rename to docs/src/implemented-proposals/tower-bft.md diff --git a/book/src/implemented-proposals/transaction-fees.md b/docs/src/implemented-proposals/transaction-fees.md similarity index 100% rename from book/src/implemented-proposals/transaction-fees.md rename to docs/src/implemented-proposals/transaction-fees.md diff --git a/book/src/implemented-proposals/validator-timestamp-oracle.md b/docs/src/implemented-proposals/validator-timestamp-oracle.md similarity index 100% rename from book/src/implemented-proposals/validator-timestamp-oracle.md rename to docs/src/implemented-proposals/validator-timestamp-oracle.md diff --git a/book/src/introduction.md b/docs/src/introduction.md similarity index 97% rename from book/src/introduction.md rename to docs/src/introduction.md index 33f5e34d47..5dc372b7ea 100644 --- a/book/src/introduction.md +++ b/docs/src/introduction.md @@ -4,9 +4,9 @@ Solana is an open source project implementing a new, high-performance, permissionless blockchain. Solana is also the name of a company headquartered in San Francisco that maintains the open source project. -## About this Book +## Documentation Overview -This book describes the Solana open source project, a blockchain built from the ground up for scale. The book covers why Solana is useful, how to use it, how it works, and why it will continue to work long after the company Solana closes its doors. The goal of the Solana architecture is to demonstrate there exists a set of software algorithms that when used in combination to implement a blockchain, removes software as a performance bottleneck, allowing transaction throughput to scale proportionally with network bandwidth. The architecture goes on to satisfy all three desirable properties of a proper blockchain: it is scalable, secure and decentralized. +The Solana docs describe the Solana open source project, a blockchain built from the ground up for scale. They cover why Solana is useful, how to use it, how it works, and why it will continue to work long after the company Solana closes its doors. The goal of the Solana architecture is to demonstrate there exists a set of software algorithms that when used in combination to implement a blockchain, removes software as a performance bottleneck, allowing transaction throughput to scale proportionally with network bandwidth. The architecture goes on to satisfy all three desirable properties of a proper blockchain: it is scalable, secure and decentralized. The architecture describes a theoretical upper bound of 710 thousand transactions per second \(tps\) on a standard gigabit network and 28.4 million tps on 40 gigabit. Furthermore, the architecture supports safe, concurrent execution of programs authored in general purpose programming languages such as C or Rust. diff --git a/book/src/offline-signing/README.md b/docs/src/offline-signing/README.md similarity index 100% rename from book/src/offline-signing/README.md rename to docs/src/offline-signing/README.md diff --git a/book/src/offline-signing/durable-nonce.md b/docs/src/offline-signing/durable-nonce.md similarity index 100% rename from book/src/offline-signing/durable-nonce.md rename to docs/src/offline-signing/durable-nonce.md diff --git a/book/src/paper-wallet/README.md b/docs/src/paper-wallet/README.md similarity index 100% rename from book/src/paper-wallet/README.md rename to docs/src/paper-wallet/README.md diff --git a/book/src/paper-wallet/installation.md b/docs/src/paper-wallet/installation.md similarity index 100% rename from book/src/paper-wallet/installation.md rename to docs/src/paper-wallet/installation.md diff --git a/book/src/paper-wallet/usage.md b/docs/src/paper-wallet/usage.md similarity index 100% rename from book/src/paper-wallet/usage.md rename to docs/src/paper-wallet/usage.md diff --git a/book/src/proposals/README.md b/docs/src/proposals/README.md similarity index 63% rename from book/src/proposals/README.md rename to docs/src/proposals/README.md index ac84a4eb45..d4d7b5e626 100644 --- a/book/src/proposals/README.md +++ b/docs/src/proposals/README.md @@ -1,4 +1,3 @@ # Accepted Design Proposals -The following architectural proposals have been accepted by the Solana team, but are not yet fully implemented. The proposals may be implemented as described, implemented differently as issues in the designs become evident, or not implemented at all. If implemented, the descriptions will be moved from this section to earlier chapters in a future version of this book. - +The following architectural proposals have been accepted by the Solana team, but are not yet fully implemented. The proposals may be implemented as described, implemented differently as issues in the designs become evident, or not implemented at all. If implemented, the proposal will be moved to [Implemented Proposals](../implemented-proposals/README.md) and the details will be added to relevant sections of the docs. diff --git a/book/src/proposals/abi-management.md b/docs/src/proposals/abi-management.md similarity index 100% rename from book/src/proposals/abi-management.md rename to docs/src/proposals/abi-management.md diff --git a/book/src/proposals/bankless-leader.md b/docs/src/proposals/bankless-leader.md similarity index 100% rename from book/src/proposals/bankless-leader.md rename to docs/src/proposals/bankless-leader.md diff --git a/book/src/proposals/block-confirmation.md b/docs/src/proposals/block-confirmation.md similarity index 100% rename from book/src/proposals/block-confirmation.md rename to docs/src/proposals/block-confirmation.md diff --git a/book/src/proposals/cluster-test-framework.md b/docs/src/proposals/cluster-test-framework.md similarity index 100% rename from book/src/proposals/cluster-test-framework.md rename to docs/src/proposals/cluster-test-framework.md diff --git a/book/src/proposals/cross-program-invocation.md b/docs/src/proposals/cross-program-invocation.md similarity index 100% rename from book/src/proposals/cross-program-invocation.md rename to docs/src/proposals/cross-program-invocation.md diff --git a/book/src/proposals/interchain-transaction-verification.md b/docs/src/proposals/interchain-transaction-verification.md similarity index 100% rename from book/src/proposals/interchain-transaction-verification.md rename to docs/src/proposals/interchain-transaction-verification.md diff --git a/book/src/proposals/ledger-replication-to-implement.md b/docs/src/proposals/ledger-replication-to-implement.md similarity index 100% rename from book/src/proposals/ledger-replication-to-implement.md rename to docs/src/proposals/ledger-replication-to-implement.md diff --git a/book/src/proposals/simple-payment-and-state-verification.md b/docs/src/proposals/simple-payment-and-state-verification.md similarity index 100% rename from book/src/proposals/simple-payment-and-state-verification.md rename to docs/src/proposals/simple-payment-and-state-verification.md diff --git a/book/src/proposals/slashing.md b/docs/src/proposals/slashing.md similarity index 100% rename from book/src/proposals/slashing.md rename to docs/src/proposals/slashing.md diff --git a/book/src/proposals/snapshot-verification.md b/docs/src/proposals/snapshot-verification.md similarity index 100% rename from book/src/proposals/snapshot-verification.md rename to docs/src/proposals/snapshot-verification.md diff --git a/book/src/proposals/tick-verification.md b/docs/src/proposals/tick-verification.md similarity index 100% rename from book/src/proposals/tick-verification.md rename to docs/src/proposals/tick-verification.md diff --git a/book/src/proposals/validator-proposal.md b/docs/src/proposals/validator-proposal.md similarity index 100% rename from book/src/proposals/validator-proposal.md rename to docs/src/proposals/validator-proposal.md diff --git a/book/src/proposals/vote-signing-to-implement.md b/docs/src/proposals/vote-signing-to-implement.md similarity index 100% rename from book/src/proposals/vote-signing-to-implement.md rename to docs/src/proposals/vote-signing-to-implement.md diff --git a/book/src/running-archiver.md b/docs/src/running-archiver.md similarity index 100% rename from book/src/running-archiver.md rename to docs/src/running-archiver.md diff --git a/book/src/running-validator/README.md b/docs/src/running-validator/README.md similarity index 100% rename from book/src/running-validator/README.md rename to docs/src/running-validator/README.md diff --git a/book/src/running-validator/validator-info.md b/docs/src/running-validator/validator-info.md similarity index 100% rename from book/src/running-validator/validator-info.md rename to docs/src/running-validator/validator-info.md diff --git a/book/src/running-validator/validator-monitor.md b/docs/src/running-validator/validator-monitor.md similarity index 100% rename from book/src/running-validator/validator-monitor.md rename to docs/src/running-validator/validator-monitor.md diff --git a/book/src/running-validator/validator-reqs.md b/docs/src/running-validator/validator-reqs.md similarity index 100% rename from book/src/running-validator/validator-reqs.md rename to docs/src/running-validator/validator-reqs.md diff --git a/book/src/running-validator/validator-software.md b/docs/src/running-validator/validator-software.md similarity index 100% rename from book/src/running-validator/validator-software.md rename to docs/src/running-validator/validator-software.md diff --git a/book/src/running-validator/validator-stake.md b/docs/src/running-validator/validator-stake.md similarity index 100% rename from book/src/running-validator/validator-stake.md rename to docs/src/running-validator/validator-stake.md diff --git a/book/src/running-validator/validator-start.md b/docs/src/running-validator/validator-start.md similarity index 100% rename from book/src/running-validator/validator-start.md rename to docs/src/running-validator/validator-start.md diff --git a/book/src/running-validator/validator-testnet.md b/docs/src/running-validator/validator-testnet.md similarity index 100% rename from book/src/running-validator/validator-testnet.md rename to docs/src/running-validator/validator-testnet.md diff --git a/book/src/running-validator/validator-troubleshoot.md b/docs/src/running-validator/validator-troubleshoot.md similarity index 100% rename from book/src/running-validator/validator-troubleshoot.md rename to docs/src/running-validator/validator-troubleshoot.md diff --git a/book/src/terminology.md b/docs/src/terminology.md similarity index 99% rename from book/src/terminology.md rename to docs/src/terminology.md index c7dec695ff..8cc32de160 100644 --- a/book/src/terminology.md +++ b/docs/src/terminology.md @@ -1,6 +1,6 @@ # Terminology -The following terms are used throughout this book. +The following terms are used throughout the documentation. ## account diff --git a/book/src/transaction.md b/docs/src/transaction.md similarity index 98% rename from book/src/transaction.md rename to docs/src/transaction.md index b53a3921b9..ca14f21b10 100644 --- a/book/src/transaction.md +++ b/docs/src/transaction.md @@ -1,6 +1,6 @@ # Anatomy of a Transaction -This chapter documents the binary format of a transaction. +This section documents the binary format of a transaction. ## Transaction Format diff --git a/book/src/validator/README.md b/docs/src/validator/README.md similarity index 100% rename from book/src/validator/README.md rename to docs/src/validator/README.md diff --git a/book/src/validator/blockstore.md b/docs/src/validator/blockstore.md similarity index 100% rename from book/src/validator/blockstore.md rename to docs/src/validator/blockstore.md diff --git a/book/src/validator/gossip.md b/docs/src/validator/gossip.md similarity index 100% rename from book/src/validator/gossip.md rename to docs/src/validator/gossip.md diff --git a/book/src/validator/runtime.md b/docs/src/validator/runtime.md similarity index 100% rename from book/src/validator/runtime.md rename to docs/src/validator/runtime.md diff --git a/book/src/validator/tpu.md b/docs/src/validator/tpu.md similarity index 100% rename from book/src/validator/tpu.md rename to docs/src/validator/tpu.md diff --git a/book/src/validator/tvu.md b/docs/src/validator/tvu.md similarity index 100% rename from book/src/validator/tvu.md rename to docs/src/validator/tvu.md diff --git a/book/theme/book.js b/docs/theme/book.js similarity index 100% rename from book/theme/book.js rename to docs/theme/book.js diff --git a/book/theme/css/chrome.css b/docs/theme/css/chrome.css similarity index 100% rename from book/theme/css/chrome.css rename to docs/theme/css/chrome.css diff --git a/book/theme/css/general.css b/docs/theme/css/general.css similarity index 100% rename from book/theme/css/general.css rename to docs/theme/css/general.css diff --git a/book/theme/css/print.css b/docs/theme/css/print.css similarity index 100% rename from book/theme/css/print.css rename to docs/theme/css/print.css diff --git a/book/theme/css/variables.css b/docs/theme/css/variables.css similarity index 100% rename from book/theme/css/variables.css rename to docs/theme/css/variables.css diff --git a/book/theme/favicon.png b/docs/theme/favicon.png similarity index 100% rename from book/theme/favicon.png rename to docs/theme/favicon.png diff --git a/book/theme/highlight.css b/docs/theme/highlight.css similarity index 100% rename from book/theme/highlight.css rename to docs/theme/highlight.css diff --git a/book/theme/highlight.js b/docs/theme/highlight.js similarity index 100% rename from book/theme/highlight.js rename to docs/theme/highlight.js diff --git a/book/theme/index.hbs b/docs/theme/index.hbs similarity index 100% rename from book/theme/index.hbs rename to docs/theme/index.hbs diff --git a/programs/btc_spv/README.md b/programs/btc_spv/README.md index 879b779adb..7ff6f7fb89 100644 --- a/programs/btc_spv/README.md +++ b/programs/btc_spv/README.md @@ -60,5 +60,5 @@ Header Store - A data structure for storing and referencing ranges of block head Client Request - Transaction from the client to the SPV Program to trigger creation of a Proof Request. Sub-account - A Solana account owned by another contract account, without its own private key. -For more information on the Inter-chain SPV system, see the book section at: -https://docs.solana.com/book/v/master/proposals/interchain-transaction-verification +For more information on the Inter-chain SPV system, see the docs section at: +https://docs.solana.com/proposals/interchain-transaction-verification