Skip to content

Commit a57023f

Browse files
authored
Minor capitalization edits (#217)
* Minor capitalization edits * Minor grammar/formatting edits
1 parent f7a3288 commit a57023f

File tree

2 files changed

+21
-21
lines changed

2 files changed

+21
-21
lines changed

site/docs/faq.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@ sidebar_position: 6
88

99
Ouroboros Leios is a next-generation blockchain consensus protocol designed to improve transaction throughput and reduce latency by using a pipelined endorsing process. It builds upon the core Ouroboros principles (as used by Cardano), introducing separate input blocks (IBs) for transactions and endorser blocks (EBs) that reference those transactions, thus enhancing scalability.
1010

11-
## What are the key benefits of Leios compared with traditional Ouroboros?
11+
## What are the key benefits of Leios over other Ouroboros protocols?
1212

1313
Leios offers several significant advantages:
1414

1515
- **Higher throughput and lower latency.** By splitting transaction processing into IB and EB stages, Leios handles more transactions in parallel.
1616
- **Flexible diffusion strategies.** Nodes can choose different block-propagation methods, such as 'freshest-first' or 'oldest-first.'
17-
- **Enhanced cryptography.** Leios uses BLS (Boneh–Lynn–Shacham) signatures for aggregated verification and verifiable random functions (VRFs) for leader selection.
17+
- **Enhanced cryptography.** Leios uses Boneh–Lynn–Shacham (BLS) signatures for aggregated verification and verifiable random functions (VRFs) for leader selection.
1818
- **Robust simulations and formal methods.** Rust and Haskell simulations measure real-world performance, and executable specifications help ensure correctness.
1919
- **Scalable cost model.** A cost calculator enables node operators to estimate expenses (for example, storage amortization and CPU usage).
2020

@@ -47,11 +47,11 @@ Leios supports multiple strategies for propagating blocks and votes:
4747

4848
- **Oldest-first:** prioritizes older blocks or transactions
4949
- **Freshest-first:** focuses on the newest blocks or transactions first
50-
- **Peer-order:** requests blocks in the order peers announce them
50+
- **Peer-order:** requests blocks in the order peers announce them.
5151

5252
Your choice of strategy can affect latency, network load, and overall throughput.
5353

54-
## Can the system be sharded or self-regulate?
54+
## Can the system be sharded or self-regulated?
5555

5656
Not in its current design. Every node validates the entire chain. Thus, adding more nodes does not inherently increase throughput in the same way sharded protocols do. The community votes on protocol parameters (for example, block size), and the system's load is the same for all. Future research may explore sharding, but it is not yet part of Leios.
5757

@@ -72,7 +72,7 @@ Leios provides an online cost calculator that considers:
7272
- **CPU usage and the number of cores**
7373
- **Bandwidth consumption**
7474
- **Storage** (including the default assumption of 50% disk compression)
75-
- **Perpetual storage cost amortization**
75+
- **Perpetual storage cost amortization**.
7676

7777
It also supports hyperscale and discount cloud providers. For example, you can model single-relay or multi-relay deployments at variable bandwidths.
7878

@@ -83,7 +83,7 @@ Two primary simulation frameworks (Rust and Haskell) are maintained to:
8383
- Test network topologies and measure real or simulated latencies (using the DeltaQ model)
8484
- Evaluate CPU usage for blocks and transactions under varying loads
8585
- Visualize block diffusion (IBs, EBs, and RBs) using different strategies
86-
- Compare ideal conditions vs realistic mainnet-like topologies
86+
- Compare ideal conditions vs realistic mainnet-like topologies.
8787

8888
Developers continually refine these simulations based on real-world data.
8989

@@ -93,7 +93,7 @@ Based on preliminary internal testing and simulations:
9393

9494
- **Block size:** commonly set to about one-third of the available link capacity for IBs
9595
- **Voting stages:** choose single-stage or send-recv, depending on reliability and speed requirements
96-
- **Diffusion strategy:** many operators use 'freshest-first,' though 'peer-order' may help maintain compatibility with older setups
96+
- **Diffusion strategy:** many operators use 'freshest-first,' though 'peer-order' may help maintain compatibility with older setups.
9797

9898
Operators can adjust these parameters, which evolve through community votes.
9999

@@ -108,19 +108,19 @@ You can follow:
108108

109109
These resources provide transparency and regular updates on ongoing development.
110110

111-
## What are downstream effects of deploying Leios?
111+
## What are the downstream effects of deploying Leios?
112112

113113
Leios changes how transactions are validated and how blocks and memory pools operate, potentially affecting:
114114

115115
- **Wallets and SDKs,** which need to accommodate new block types (IBs and EBs)
116116
- **Explorers,** which must handle higher throughput and multi-block referencing
117-
- **Indexers and APIs,** which will see more granular block and vote data
117+
- **Indexers and APIs,** which will see more granular block and vote data.
118118

119-
Weekly progress updates provide deeper analysis of these topics, including how advanced indexing and potential sharding solutions might eventually mitigate challenges.
119+
Weekly progress updates provide a deeper analysis of these topics, including how advanced indexing and potential sharding solutions might eventually mitigate challenges.
120120

121-
## Could the mempool be sized to the throughput of the system?
121+
## Could the mempool be sized according to the system's throughput?
122122

123-
That's already the case. Default mempool size is a small multiple of current block size.
123+
That's already the case. The default mempool size is a small multiple of the current block size.
124124

125125
## Is Leios production-ready?
126126

site/docs/glossary.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -14,30 +14,30 @@ sidebar_position: 5
1414

1515
- **Certificate**: A cryptographic proof that attests to the validity of blocks or transactions.
1616

17-
- **Decentralization Parameter**: A measure of how distributed the control of the network is among its participants.
17+
- **Decentralization parameter**: A measure of how distributed the control of the network is among its participants.
1818

1919
- **DeltaQ model**: A framework for analyzing and predicting network quality of service (QoS) used to assess delay, loss, and other performance factors.
2020

2121
- **Diffusion strategy**: The method used to propagate blocks and votes through the network. Strategies include:
2222
- Oldest-first strategy – prioritizes older blocks for diffusion
2323
- Freshest-first strategy – prioritizes newer blocks for diffusion
24-
- Peer-order strategy – requests blocks in the order they were announced by peers
24+
- Peer-order strategy – requests blocks in the order they were announced by peers.
2525

26-
- **Endorser Block (EB)**: A block that references IBs and is produced by nodes that win the EB sortition lottery.
26+
- **Endorser block (EB)**: A block that references IBs and is produced by nodes that win the EB sortition lottery.
2727

28-
- **Epoch**: A fixed period in the blockchain during which certain processes or calculations are performed.
28+
- **Epoch**: A fixed period in the blockchain during which specific processes or calculations are performed.
2929

3030
- **Equivocation**: The act of producing conflicting blocks or messages in a blockchain network.
3131

3232
- **Executable specification**: A formally defined, executable model of a system that ensures an implementation conforms to its intended design.
3333

3434
- **Fait accompli sortition**: A cryptographic selection process that ensures fairness and verifiability when choosing validators.
3535

36-
- **Freshest First**: A policy for prioritizing newer blocks or transactions over older ones.
36+
- **Freshest first**: A policy for prioritizing newer blocks or transactions over older ones.
3737

3838
- **Haskell simulation**: A parallel simulation of the Leios protocol in Haskell, used for latency measurement, event logging, and parameter tuning.
3939

40-
- **Input Block (IB)**: A block that contains transactions and is produced by nodes that win the IB sortition lottery.
40+
- **Input block (IB)**: A block that contains transactions and is produced by nodes that win the IB sortition lottery.
4141

4242
- **Latency**: The delay between the submission of a transaction and its confirmation on the blockchain.
4343

@@ -63,7 +63,7 @@ sidebar_position: 5
6363

6464
- **Quorum**: The minimum number of votes required to certify a block or decision.
6565

66-
- **Ranking Block (RB)**: A block that ranks other blocks and is part of the consensus mechanism.
66+
- **Ranking block (RB)**: A block that ranks other blocks and is part of the consensus mechanism.
6767

6868
- **Rational arithmetic**: A method used in Leios sortition to replace quad-precision floating-point calculations, improving precision and computational efficiency.
6969

@@ -75,9 +75,9 @@ sidebar_position: 5
7575

7676
- **Short-Leios simulation**: A version of the Leios simulation that models ranking block intervals and outputs diffusion latency data.
7777

78-
- **Sortition**: A probabilistic method for selecting nodes to perform certain roles, based on their stake.
78+
- **Sortition**: A probabilistic method for selecting nodes to perform specific roles based on their stake.
7979

80-
- **Stake**: The amount of cryptocurrency held by a node, which influences its probability of being selected in sortition.
80+
- **Stake**: The amount of cryptocurrency a node holds, which influences its probability of being selected in sortition.
8181

8282
- **Storage cost amortization**: A feature in the cost calculator that spreads storage costs over time, reducing upfront expenses.
8383

0 commit comments

Comments
 (0)