From e2b954fd78f25ee06939cfb87fd4136d3697005b Mon Sep 17 00:00:00 2001 From: Michael Vines Date: Wed, 2 Oct 2019 23:53:43 -0700 Subject: [PATCH] Revert "GitBook: [v0.19] 14 pages and 19 assets modified" This reverts commit 88950d2fb4de006e863055d3e6a329f54c12a234. --- book/src/.gitbook/assets/data-plane (4).svg | 192 ------- .../.gitbook/assets/data-plane-fanout (4).svg | 183 ------- .../assets/data-plane-neighborhood (4).svg | 322 ------------ .../assets/data-plane-seeding (4).svg | 138 ----- .../.gitbook/assets/fork-generation (4).svg | 330 ------------ book/src/.gitbook/assets/forks (4).svg | 122 ----- book/src/.gitbook/assets/forks-pruned (4).svg | 92 ---- .../src/.gitbook/assets/forks-pruned2 (4).svg | 92 ---- book/src/.gitbook/assets/forks.svg | 98 ++-- .../assets/passive-staking-callflow (4).svg | 238 --------- .../assets/passive-staking-callflow (5).svg | 238 --------- .../assets/passive-staking-callflow-3.svg | 238 --------- book/src/.gitbook/assets/runtime (4).svg | 346 ------------ book/src/.gitbook/assets/sdk-tools (4).svg | 237 --------- .../.gitbook/assets/spv-bank-merkle (4).svg | 163 ------ .../.gitbook/assets/spv-block-merkle (4).svg | 203 ------- book/src/.gitbook/assets/tpu (3).svg | 312 ----------- book/src/.gitbook/assets/validator (3).svg | 456 ---------------- .../assets/validator-proposal (4).svg | 496 ------------------ book/src/cluster/fork-generation.md | 2 +- book/src/cluster/managing-forks.md | 2 +- .../cluster/stake-delegation-and-rewards.md | 2 +- book/src/cluster/turbine-block-propagation.md | 6 +- .../passive-stake-delegation-and-rewards.md | 2 +- book/src/programs/README.md | 2 +- ...state_validation_protocol_based_rewards.md | 6 +- .../simple-payment-and-state-verification.md | 4 +- book/src/proposals/validator-proposal.md | 2 +- book/src/running-validator/validator-info.md | 3 +- .../running-validator/validator-software.md | 1 - book/src/validator/runtime.md | 2 +- book/src/validator/tpu.md | 2 +- book/src/validator/tvu/README.md | 2 +- 33 files changed, 58 insertions(+), 4476 deletions(-) delete mode 100644 book/src/.gitbook/assets/data-plane (4).svg delete mode 100644 book/src/.gitbook/assets/data-plane-fanout (4).svg delete mode 100644 book/src/.gitbook/assets/data-plane-neighborhood (4).svg delete mode 100644 book/src/.gitbook/assets/data-plane-seeding (4).svg delete mode 100644 book/src/.gitbook/assets/fork-generation (4).svg delete mode 100644 book/src/.gitbook/assets/forks (4).svg delete mode 100644 book/src/.gitbook/assets/forks-pruned (4).svg delete mode 100644 book/src/.gitbook/assets/forks-pruned2 (4).svg delete mode 100644 book/src/.gitbook/assets/passive-staking-callflow (4).svg delete mode 100644 book/src/.gitbook/assets/passive-staking-callflow (5).svg delete mode 100644 book/src/.gitbook/assets/passive-staking-callflow-3.svg delete mode 100644 book/src/.gitbook/assets/runtime (4).svg delete mode 100644 book/src/.gitbook/assets/sdk-tools (4).svg delete mode 100644 book/src/.gitbook/assets/spv-bank-merkle (4).svg delete mode 100644 book/src/.gitbook/assets/spv-block-merkle (4).svg delete mode 100644 book/src/.gitbook/assets/tpu (3).svg delete mode 100644 book/src/.gitbook/assets/validator (3).svg delete mode 100644 book/src/.gitbook/assets/validator-proposal (4).svg diff --git a/book/src/.gitbook/assets/data-plane (4).svg b/book/src/.gitbook/assets/data-plane (4).svg deleted file mode 100644 index 5a33b8bf6e..0000000000 --- a/book/src/.gitbook/assets/data-plane (4).svg +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Neighborhood - - - - -3 - - - - -Neighborhood - - - - -Neighborhood - - - - -1 - - - - -Neighborhood - - - - -4 - - - - -0 - - - - -Neighborhood - - - - -Neighborhood - - - - -5 - - - - -2 - - - - -Neighborhood - - - - -6 - - - diff --git a/book/src/.gitbook/assets/data-plane-fanout (4).svg b/book/src/.gitbook/assets/data-plane-fanout (4).svg deleted file mode 100644 index ad73f77ef0..0000000000 --- a/book/src/.gitbook/assets/data-plane-fanout (4).svg +++ /dev/null @@ -1,183 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Neighborhood - - - - -Validator - - - - -1 - - - - -1 - - - - -Neighborhood - - - - -0 - - - - -Neighborhood - - - - -Validator - - - - -2 - - - - -2 - - - diff --git a/book/src/.gitbook/assets/data-plane-neighborhood (4).svg b/book/src/.gitbook/assets/data-plane-neighborhood (4).svg deleted file mode 100644 index 1a7f080a31..0000000000 --- a/book/src/.gitbook/assets/data-plane-neighborhood (4).svg +++ /dev/null @@ -1,322 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Neighbor - - - - -Neighbor - - - - -1 - - - - -1 - - - - -Neighbor - - - - -Neighbor - - - - -Neighborhood - - - - -Neighborhood - - - - -2 - - - - -2 - - - - -Above - - - - -Below - - - - -Neighbor - - - - -Neighbor - - - - -3 - - - - -3 - - - - -Neighbor - - - - -Neighbor - - - - -4 - - - - -4 - - - diff --git a/book/src/.gitbook/assets/data-plane-seeding (4).svg b/book/src/.gitbook/assets/data-plane-seeding (4).svg deleted file mode 100644 index 765b53c93f..0000000000 --- a/book/src/.gitbook/assets/data-plane-seeding (4).svg +++ /dev/null @@ -1,138 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Validator - - - - -1 - - - - -Neighborhood - - - - -Leader - - - - -0 - - - - -Validator - - - - -2 - - - diff --git a/book/src/.gitbook/assets/fork-generation (4).svg b/book/src/.gitbook/assets/fork-generation (4).svg deleted file mode 100644 index 3d13d7549b..0000000000 --- a/book/src/.gitbook/assets/fork-generation (4).svg +++ /dev/null @@ -1,330 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -time - - - - -L1 - - - - -L2 - - - - -L3 - - - - -L4 - - - - -L5 - - - - -x - - - - -xx - - - - -E3 - - - - -xx - - - - -E2 - - - - -E4 - - - - -xx - - - - -x - - - - -E5 - - - - -E1 - - - - -xx - - - - -E3' - - - - -xx - - - - -x - - - - -xx - - - - -xx - - - - -validator - - - - -vote(E1) - - - - -vote(E2) - - - - -slash(E3) - - - - -vote(E4) - - - - -hang - - - - -on - - - - -to - - - - -action - - - - -E4 - - - - -and - - - - -E5 - - - - -for - - - - -more... - - - diff --git a/book/src/.gitbook/assets/forks (4).svg b/book/src/.gitbook/assets/forks (4).svg deleted file mode 100644 index 725a73f5d3..0000000000 --- a/book/src/.gitbook/assets/forks (4).svg +++ /dev/null @@ -1,122 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5 - - - - -1 - - - - -2 - - - - -4 - - - - -3 - - - - -6 - - - - -7 - - - diff --git a/book/src/.gitbook/assets/forks-pruned (4).svg b/book/src/.gitbook/assets/forks-pruned (4).svg deleted file mode 100644 index 5a8f41f21c..0000000000 --- a/book/src/.gitbook/assets/forks-pruned (4).svg +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5 - - - - -1 - - - - -2 - - - - -4 - - - diff --git a/book/src/.gitbook/assets/forks-pruned2 (4).svg b/book/src/.gitbook/assets/forks-pruned2 (4).svg deleted file mode 100644 index f57f691d73..0000000000 --- a/book/src/.gitbook/assets/forks-pruned2 (4).svg +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -1 - - - - -3 - - - - -6 - - - - -7 - - - diff --git a/book/src/.gitbook/assets/forks.svg b/book/src/.gitbook/assets/forks.svg index e57f128fca..725a73f5d3 100644 --- a/book/src/.gitbook/assets/forks.svg +++ b/book/src/.gitbook/assets/forks.svg @@ -1,80 +1,62 @@ - + - + - + - + - + - + - + diff --git a/book/src/.gitbook/assets/passive-staking-callflow (4).svg b/book/src/.gitbook/assets/passive-staking-callflow (4).svg deleted file mode 100644 index 378686284a..0000000000 --- a/book/src/.gitbook/assets/passive-staking-callflow (4).svg +++ /dev/null @@ -1,238 +0,0 @@ - - - - - -VoteSigner - - - - -Validator - - - - -Cluster - - - - -StakerX - - - - -StakerY - - - - - - - - - - - - - - - - - - -boot.. - - - - - - - - - - - - -register - - - - - - - -(optional) - - - - - - - - - - -VoteState::Initialize(VoteSigner) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - - - - - - - - - - - - - -validate - - - - - - - - - - - - - - -sign(vote) - - - - - - - - - - -signed vote - - - - - - - - - - -gossip(vote) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -max - - - -lockout - - - - - - - - - - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - diff --git a/book/src/.gitbook/assets/passive-staking-callflow (5).svg b/book/src/.gitbook/assets/passive-staking-callflow (5).svg deleted file mode 100644 index 378686284a..0000000000 --- a/book/src/.gitbook/assets/passive-staking-callflow (5).svg +++ /dev/null @@ -1,238 +0,0 @@ - - - - - -VoteSigner - - - - -Validator - - - - -Cluster - - - - -StakerX - - - - -StakerY - - - - - - - - - - - - - - - - - - -boot.. - - - - - - - - - - - - -register - - - - - - - -(optional) - - - - - - - - - - -VoteState::Initialize(VoteSigner) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - - - - - - - - - - - - - -validate - - - - - - - - - - - - - - -sign(vote) - - - - - - - - - - -signed vote - - - - - - - - - - -gossip(vote) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -max - - - -lockout - - - - - - - - - - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - diff --git a/book/src/.gitbook/assets/passive-staking-callflow-3.svg b/book/src/.gitbook/assets/passive-staking-callflow-3.svg deleted file mode 100644 index 378686284a..0000000000 --- a/book/src/.gitbook/assets/passive-staking-callflow-3.svg +++ /dev/null @@ -1,238 +0,0 @@ - - - - - -VoteSigner - - - - -Validator - - - - -Cluster - - - - -StakerX - - - - -StakerY - - - - - - - - - - - - - - - - - - -boot.. - - - - - - - - - - - - -register - - - - - - - -(optional) - - - - - - - - - - -VoteState::Initialize(VoteSigner) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - -StakeState::Delegate(Validator) - - - - - - - - - - - - - - - - - - - - - - -validate - - - - - - - - - - - - - - -sign(vote) - - - - - - - - - - -signed vote - - - - - - - - - - -gossip(vote) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -max - - - -lockout - - - - - - - - - - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - - - - -StakeState::RedeemCredits() - - - - - - - diff --git a/book/src/.gitbook/assets/runtime (4).svg b/book/src/.gitbook/assets/runtime (4).svg deleted file mode 100644 index 0a9b8289b2..0000000000 --- a/book/src/.gitbook/assets/runtime (4).svg +++ /dev/null @@ -1,346 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -PoH - - - - -verify - - - - -TVU - - - - -load - - - - -accounts - - - - -sigverify - - - - -execute - - - - -lock - - - - -PoH - - - - -accounts - - - - -TPU - - - - -record - - - - -validate - - - - -commit - - - - -accounts - - - - -fee - - - - -allocate - - - - -unlock - - - - -new - - - - -accounts - - - - -accounts - - - diff --git a/book/src/.gitbook/assets/sdk-tools (4).svg b/book/src/.gitbook/assets/sdk-tools (4).svg deleted file mode 100644 index 629a3feaa3..0000000000 --- a/book/src/.gitbook/assets/sdk-tools (4).svg +++ /dev/null @@ -1,237 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Client - - - - -Verifier - - - - -Loader - - - - -Solana - - - - -LoadAccounts - - - - -Runtime - - - - -Interpreter - - - - -Accounts - - - diff --git a/book/src/.gitbook/assets/spv-bank-merkle (4).svg b/book/src/.gitbook/assets/spv-bank-merkle (4).svg deleted file mode 100644 index a07908d17e..0000000000 --- a/book/src/.gitbook/assets/spv-bank-merkle (4).svg +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Hash(Account1) - - - - -Bank-Diff-Merkle - - - - -Hash - - - - -Hash(Account2) - - - - -Previous - - - - -Bank-Merkle - - - - -Bank-Diff-Merkle - - - - -Block-Merkle - - - diff --git a/book/src/.gitbook/assets/spv-block-merkle (4).svg b/book/src/.gitbook/assets/spv-block-merkle (4).svg deleted file mode 100644 index 18ea80cadd..0000000000 --- a/book/src/.gitbook/assets/spv-block-merkle (4).svg +++ /dev/null @@ -1,203 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Hash(T1, - - - - -status) - - - - -Hash - - - - -Entry-Merkle - - - - -Hash(T2, - - - - -status) - - - - -Block-Merkle - - - - -Hash(T3, - - - - -Entry-Merkle - - - - -status) - - - - -Hash - - - - -0 - - - diff --git a/book/src/.gitbook/assets/tpu (3).svg b/book/src/.gitbook/assets/tpu (3).svg deleted file mode 100644 index 1de96c7927..0000000000 --- a/book/src/.gitbook/assets/tpu (3).svg +++ /dev/null @@ -1,312 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Clients - - - - -TPU - - - - -Fetch - - - - -Stage - - - - -SigVerify - - - - -Stage - - - - -PoH - - - - -Banking - - - - -Stage - - - - -Service - - - - -Bank - - - - -Broadcast - - - - -Stage - - - - -Downstream - - - - -Validators - - - diff --git a/book/src/.gitbook/assets/validator (3).svg b/book/src/.gitbook/assets/validator (3).svg deleted file mode 100644 index 11be7b6a71..0000000000 --- a/book/src/.gitbook/assets/validator (3).svg +++ /dev/null @@ -1,456 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Client - - - - -Validator - - - - -Bank - - - - -Forks - - - - -JSON - - - - -TPU - - - - -RPC - - - - -Service - - - - -Gossip - - - - -Replay - - - - -Stage - - - - -Broadcast - - - - -Stage - - - - -Blocktree - - - - -Service - - - - -BlobFetch - - - - -Stage - - - - -Validators - - - - -Upstream - - - - -Validators - - - - -Downstream - - - - -Validators - - - diff --git a/book/src/.gitbook/assets/validator-proposal (4).svg b/book/src/.gitbook/assets/validator-proposal (4).svg deleted file mode 100644 index bf8410aba8..0000000000 --- a/book/src/.gitbook/assets/validator-proposal (4).svg +++ /dev/null @@ -1,496 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Client - - - - -Fetch - - - - -Stage - - - - -Validator - - - - -TPU - - - - -Fetch - - - - -Stage - - - - -TPU - - - - -SigVerify - - - - -Stage - - - - -Upstream - - - - -Validators - - - - -Repair - - - - -Stage - - - - -Blockstore - - - - -Multicast - - - - -Stage - - - - -Downstream - - - - -Validators - - - - -PoH - - - - -Service - - - - -Banking - - - - -Stage - - - - -Banktree - - - - -Blockstore - - - diff --git a/book/src/cluster/fork-generation.md b/book/src/cluster/fork-generation.md index d1397d9de2..14bcaa75fa 100644 --- a/book/src/cluster/fork-generation.md +++ b/book/src/cluster/fork-generation.md @@ -58,7 +58,7 @@ Validators vote based on a greedy choice to maximize their reward described in [ The diagram below represents a validator's view of the PoH stream with possible forks over time. L1, L2, etc. are leader slots, and `E`s represent entries from that leader during that leader's slot. The `x`s represent ticks only, and time flows downwards in the diagram. -![Fork generation](../.gitbook/assets/fork-generation%20%283%29.svg) +![Fork generation](../.gitbook/assets/fork-generation.svg) Note that an `E` appearing on 2 forks at the same slot is a slashable condition, so a validator observing `E3` and `E3'` can slash L3 and safely choose `x` for that slot. Once a validator commits to a forks, other forks can be discarded below that tick count. For any slot, validators need only consider a single "has entries" chain or a "ticks only" chain to be proposed by a leader. But multiple virtual entries may overlap as they link back to the a previous slot. diff --git a/book/src/cluster/managing-forks.md b/book/src/cluster/managing-forks.md index 6f2e422b4a..0146ffe843 100644 --- a/book/src/cluster/managing-forks.md +++ b/book/src/cluster/managing-forks.md @@ -29,7 +29,7 @@ The new root is 2, and any active forks that are not descendants from 2 are prun Alternatively, a vote on 6: -![Forks](../.gitbook/assets/forks-pruned2%20%281%29.svg) +![Forks](../.gitbook/assets/forks-pruned2.svg) The tree remains with a root of 1, since the active fork starting at 6 is only 2 checkpoints from the root. diff --git a/book/src/cluster/stake-delegation-and-rewards.md b/book/src/cluster/stake-delegation-and-rewards.md index 599ad0f3d0..ce7c3660f0 100644 --- a/book/src/cluster/stake-delegation-and-rewards.md +++ b/book/src/cluster/stake-delegation-and-rewards.md @@ -138,7 +138,7 @@ Lamports build up over time in a Stake account and any excess over activated sta ## Example Callflow -![Passive Staking Callflow](../.gitbook/assets/passive-staking-callflow%20%282%29.svg) +![Passive Staking Callflow](../.gitbook/assets/passive-staking-callflow.svg) ## Staking Rewards diff --git a/book/src/cluster/turbine-block-propagation.md b/book/src/cluster/turbine-block-propagation.md index 6c1a4dc714..6ba92b083f 100644 --- a/book/src/cluster/turbine-block-propagation.md +++ b/book/src/cluster/turbine-block-propagation.md @@ -24,11 +24,11 @@ The following diagram shows how the Leader sends blobs with a Fanout of 2 to Nei The following diagram shows how Neighborhood 0 fans out to Neighborhoods 1 and 2. -![Neighborhood 0 Fanout to Neighborhood 1 and 2](../.gitbook/assets/data-plane-fanout%20%282%29.svg) +![Neighborhood 0 Fanout to Neighborhood 1 and 2](../.gitbook/assets/data-plane-fanout.svg) Finally, the following diagram shows a two layer cluster with a Fanout of 2. -![Two layer cluster with a Fanout of 2](../.gitbook/assets/data-plane%20%281%29.svg) +![Two layer cluster with a Fanout of 2](../.gitbook/assets/data-plane.svg) ### Configuration Values @@ -40,5 +40,5 @@ Currently, configuration is set when the cluster is launched. In the future, the The following diagram shows how two neighborhoods in different layers interact. To cripple a neighborhood, enough nodes \(erasure codes +1\) from the neighborhood above need to fail. Since each neighborhood receives blobs from multiple nodes in a neighborhood in the upper layer, we'd need a big network failure in the upper layers to end up with incomplete data. -![Inner workings of a neighborhood](../.gitbook/assets/data-plane-neighborhood%20%281%29.svg) +![Inner workings of a neighborhood](../.gitbook/assets/data-plane-neighborhood.svg) diff --git a/book/src/implemented-proposals/passive-stake-delegation-and-rewards.md b/book/src/implemented-proposals/passive-stake-delegation-and-rewards.md index 08651b8e99..601f80fdf3 100644 --- a/book/src/implemented-proposals/passive-stake-delegation-and-rewards.md +++ b/book/src/implemented-proposals/passive-stake-delegation-and-rewards.md @@ -128,7 +128,7 @@ The total stake allocated to a VoteState program can be calculated by the sum of ## Example Callflow -![Passive Staking Callflow](../.gitbook/assets/passive-staking-callflow%20%284%29.svg) +![Passive Staking Callflow](../.gitbook/assets/passive-staking-callflow.svg) ## Future work diff --git a/book/src/programs/README.md b/book/src/programs/README.md index a2fd0a7a20..f35badba8b 100644 --- a/book/src/programs/README.md +++ b/book/src/programs/README.md @@ -4,7 +4,7 @@ A client _app_ interacts with a Solana cluster by sending it _transactions_ with ## Deploying Programs to a Cluster -![SDK tools](../.gitbook/assets/sdk-tools%20%283%29.svg) +![SDK tools](../.gitbook/assets/sdk-tools.svg) As shown in the diagram above a client creates a program and compiles it to an ELF shared object containing BPF bytecode and sends it to the Solana cluster. The cluster stores the program locally and makes it available to clients via a _program ID_. The program ID is a _public key_ generated by the client and is used to reference the program in subsequent transactions. diff --git a/book/src/proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md b/book/src/proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md index ca38742c13..e7e67b7474 100644 --- a/book/src/proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md +++ b/book/src/proposals/ed_overview/ed_validation_client_economics/ed_vce_state_validation_protocol_based_rewards.md @@ -17,11 +17,11 @@ The first factor is a function of protocol parameters only \(i.e. independent of At any given point in time, a specific validator's interest rate can be determined based on the porportion of circulating supply that is staked by the network and the validator's uptime/activity in the previous epoch. For an illustrative example, consider a hypothetical instance of the network with an initial circulating token supply of 250MM tokens with an additional 250MM vesting over 3 years. Additionally an inflation rate is specified at network launch of 7.5%, and a disinflationary schedule of 20% decrease in inflation rate per year \(the actual rates to be implemented are to be worked out during the testnet experimentation phase of mainnet launch\). With these broad assumptions, the 10-year inflation rate \(adjusted daily for this example\) is shown in **Figure 2**, while the total circulating token supply is illustrated in **Figure 3**. Neglected in this toy-model is the inflation supression due to the portion of each transaction fee that is to be destroyed. -\*\*Figure 2:\*\* In this example schedule, the annual inflation rate \[%\] reduces at around 20% per year, until it reaches the long-term, fixed, 1.5% rate. + \*\*Figure 2:\*\* In this example schedule, the annual inflation rate \[%\] reduces at around 20% per year, until it reaches the long-term, fixed, 1.5% rate. -\*\*Figure 3:\*\* The total token supply over a 10-year period, based on an initial 250MM tokens with the disinflationary inflation schedule as shown in \*\*Figure 2\*\* Over time, the interest rate, at a fixed network staked percentage, will reduce concordant with network inflation. Validation-client interest rates are designed to be higher in the early days of the network to incentivize participation and jumpstart the network economy. As previously mentioned, the inflation rate is expected to stabalize near 1-2% which also results in a fixed, long-term, interest rate to be provided to validator-clients. This value does not represent the total interest available to validator-clients as transaction fees for both state-validation and ledger storage replication \(PoReps\) are not accounted for here. Given these example parameters, annualized validator-specific interest rates can be determined based on the global fraction of tokens bonded as stake, as well as their uptime/activity in the previous epoch. For the purpose of this example, we assume 100% uptime for all validators and a split in interest-based rewards between validators and replicator nodes of 80%/20%. Additionally, the fraction of staked circulating supply is assummed to be constant. Based on these assumptions, an annualized validation-client interest rate schedule as a function of % circulating token supply that is staked is shown in\*\* Figure 4\*\*. + \*\*Figure 3:\*\* The total token supply over a 10-year period, based on an initial 250MM tokens with the disinflationary inflation schedule as shown in \*\*Figure 2\*\* Over time, the interest rate, at a fixed network staked percentage, will reduce concordant with network inflation. Validation-client interest rates are designed to be higher in the early days of the network to incentivize participation and jumpstart the network economy. As previously mentioned, the inflation rate is expected to stabalize near 1-2% which also results in a fixed, long-term, interest rate to be provided to validator-clients. This value does not represent the total interest available to validator-clients as transaction fees for both state-validation and ledger storage replication \(PoReps\) are not accounted for here. Given these example parameters, annualized validator-specific interest rates can be determined based on the global fraction of tokens bonded as stake, as well as their uptime/activity in the previous epoch. For the purpose of this example, we assume 100% uptime for all validators and a split in interest-based rewards between validators and replicator nodes of 80%/20%. Additionally, the fraction of staked circulating supply is assummed to be constant. Based on these assumptions, an annualized validation-client interest rate schedule as a function of % circulating token supply that is staked is shown in\*\* Figure 4\*\*. -![drawing](https://github.com/solana-labs/solana/tree/11bc11f0b7ab73a82f34d593c9fb97792b6733a7/book/src/proposals/ed_overview/.gitbook/assets/p_ex_interest.png) +![drawing](../.gitbook/assets/p_ex_interest.png) **Figure 4:** Shown here are example validator interest rates over time, neglecting transaction fees, segmented by fraction of total circulating supply bonded as stake. diff --git a/book/src/proposals/simple-payment-and-state-verification.md b/book/src/proposals/simple-payment-and-state-verification.md index baa83b52f4..09fae7b993 100644 --- a/book/src/proposals/simple-payment-and-state-verification.md +++ b/book/src/proposals/simple-payment-and-state-verification.md @@ -30,7 +30,7 @@ A payment receipt is a data structure that contains a Merkle Path from a transac An Entry-Merkle is a Merkle Root including all transactions in the entry, sorted by signature. -![Block Merkle Diagram](../.gitbook/assets/spv-block-merkle%20%283%29.svg) +![Block Merkle Diagram](../.gitbook/assets/spv-block-merkle.svg) A Block-Merkle is a Merkle root of all the Entry-Merkles sequenced in the block. Transaction status is necessary for the receipt because the state receipt is constructed for the block. Two transactions over the same state can appear in the block, and therefore, there is no way to infer from just the state whether a transaction that is committed to the ledger has succeeded or failed in modifying the intended state. It may not be necessary to encode the full status code, but a single status bit to indicate the transaction's success. @@ -48,7 +48,7 @@ At the end of the block, A and B are in the exact same starting state, and any s The Bank-Merkle is computed from the Merkle Tree of the new state changes, along with the Previous Bank-Merkle, and the Block-Merkle. -![Bank Merkle Diagram](../.gitbook/assets/spv-bank-merkle%20%283%29.svg) +![Bank Merkle Diagram](../.gitbook/assets/spv-bank-merkle.svg) A state receipt contains only the state changes occurring in the block. A direct Merkle Path to the current Bank-Merkle guarantees the state value at that bank hash, but it cannot be used to generate a “current” receipt to the latest state if the state modification occurred in some previous block. There is no guarantee that the path provided by the validator is the latest one available out of all the previous Bank-Merkles. diff --git a/book/src/proposals/validator-proposal.md b/book/src/proposals/validator-proposal.md index 4828e4ab52..1c31574f68 100644 --- a/book/src/proposals/validator-proposal.md +++ b/book/src/proposals/validator-proposal.md @@ -12,7 +12,7 @@ The fundamental difference between the pipelines is when the PoH is present. In We unwrap the many abstraction layers and build a single pipeline that can toggle leader mode on whenever the validator's ID shows up in the leader schedule. -![Validator block diagram](../.gitbook/assets/validator-proposal%20%281%29.svg) +![Validator block diagram](../.gitbook/assets/validator-proposal.svg) ## Notable changes diff --git a/book/src/running-validator/validator-info.md b/book/src/running-validator/validator-info.md index deb887c1d4..a80721a82f 100644 --- a/book/src/running-validator/validator-info.md +++ b/book/src/running-validator/validator-info.md @@ -5,9 +5,8 @@ You can publish your validator information to the chain to be publicly visible t ## Run solana-validator-info Run the solana CLI to populate a validator info account: - ```bash -$ solana validator-info publish --keypair ~/validator-keypair.json +$ solana validator-info publish --keypair ~/validator-keypair.json ``` For details about optional fields for VALIDATOR\_INFO\_ARGS: diff --git a/book/src/running-validator/validator-software.md b/book/src/running-validator/validator-software.md index 466c3810be..7525c7049b 100644 --- a/book/src/running-validator/validator-software.md +++ b/book/src/running-validator/validator-software.md @@ -48,4 +48,3 @@ If you are unable to use the prebuilt binaries or prefer to build it yourself fr $ ./scripts/cargo-install-all.sh . $ export PATH=$PWD/bin:$PATH ``` - diff --git a/book/src/validator/runtime.md b/book/src/validator/runtime.md index cd9f557792..9b428b566a 100644 --- a/book/src/validator/runtime.md +++ b/book/src/validator/runtime.md @@ -20,7 +20,7 @@ Transactions are batched and processed in a pipeline. The TPU and TVU follow a s The TVU runtime ensures that PoH verification occurs before the runtime processes any transactions. -![Runtime pipeline](../.gitbook/assets/runtime%20%283%29.svg) +![Runtime pipeline](../.gitbook/assets/runtime.svg) At the _execute_ stage, the loaded accounts have no data dependencies, so all the programs can be executed in parallel. diff --git a/book/src/validator/tpu.md b/book/src/validator/tpu.md index ae27f4ef26..4831daa84e 100644 --- a/book/src/validator/tpu.md +++ b/book/src/validator/tpu.md @@ -1,4 +1,4 @@ # TPU -![TPU Block Diagram](../.gitbook/assets/tpu%20%282%29.svg) +![TPU Block Diagram](../.gitbook/assets/tpu.svg) diff --git a/book/src/validator/tvu/README.md b/book/src/validator/tvu/README.md index d9925fed9a..de270d0276 100644 --- a/book/src/validator/tvu/README.md +++ b/book/src/validator/tvu/README.md @@ -1,4 +1,4 @@ # TVU -![TVU Block Diagram](https://github.com/solana-labs/solana/tree/11bc11f0b7ab73a82f34d593c9fb97792b6733a7/book/src/validator/.gitbook/assets/tvu.svg) +![TVU Block Diagram](../.gitbook/assets/tvu.svg)