Skip to content

Commit 74c9aab

Browse files
olgahryniukolgahryniuk
authored
Minor copy adjustments (#184)
* site: minor edits & formatting
1 parent c75abe4 commit 74c9aab

File tree

4 files changed

+56
-55
lines changed

4 files changed

+56
-55
lines changed

‎site/docs/how-it-works.md‎

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,31 +8,31 @@ Leios' unique design manages a structured flow of transactions. Here's a
88
breakdown of how it works:
99

1010
1. **Creating input blocks (IBs)**:<br />
11-
Validators bundle transactions into IBs and broadcast them across the network
11+
Validators bundle transactions into IBs and broadcast them across the network.
1212

1313
2. **Proofs of data availability**:<br />
14-
Validators verify that the IBs contain valid and accessible data
14+
Validators verify that the IBs contain valid and accessible data.
1515

1616
3. **Generating endorser blocks (EBs)**:<br />
1717
EBs aggregate several verified IBs and propose them for inclusion in the
18-
blockchain
18+
blockchain.
1919

2020
4. **Pipelined processing**:<br />
21-
The protocol follows a seven-stage endorsing pipeline (described below)
21+
The protocol follows a seven-stage endorsing pipeline (described below).
2222

2323
5. **Voting and certification**:<br />
2424
Validators ensure that IBs contain valid and accessible data by checking
2525
their correctness
2626
This process is primarily handled by the endorser block producer
2727
Includes verifying that all available IBs adhere to network rules and
28-
ensuring transactions are script compliant if required
28+
ensuring transactions are script compliant if required.
2929

3030
6. **Final inclusion in the blockchain**:<br />
3131
A certificate (generated from the voting process and referencing the EB) is
32-
stored in the blockchain
32+
stored in the blockchain.
3333
This certificate is included in the Praos block (ranking block)
3434
Ensures blockchain efficiency while maintaining a verifiable record of
35-
endorsed transactions
35+
endorsed transactions.
3636

3737
## Leios architecture
3838

@@ -42,34 +42,36 @@ A pipeline instance comprises seven stages:
4242
1. **Propose**:
4343
- Validators generate and propose IBs containing transaction data
4444
- IBs proposed during this stage are the focus of the current pipeline
45-
instance
45+
instance.
4646

4747
2. **Deliver1**:
4848
- Allocates time for proposed IBs to be disseminated throughout the network
4949
- Duration is crucial for ensuring all honest nodes receive IBs before the
50-
next stage
50+
next stage.
5151

5252
3. **Link**:
5353
- Validators create EBs that reference the IBs generated in the 'Propose'
5454
stage
55-
- EBs serve as containers for grouping and ordering IBs
55+
- EBs serve as containers for grouping and ordering IBs.
5656

5757
4. **Deliver2**:
5858
- Allows time for dissemination of any adversarial IBs referenced by EBs in
5959
the 'Link' stage
60-
- Ensures honest nodes have received all relevant IBs before casting votes
60+
- Ensures honest nodes have received all relevant IBs before casting votes.
6161

6262
5. **Vote1**:
6363
- Validators cast votes for EBs from the 'Link' stage
6464
- Specifically for EBs whose referenced IBs have been successfully delivered
65-
- An EB becomes Vote1-certified if it receives enough votes
65+
- An EB becomes Vote1-certified if it receives enough votes.
6666

6767
6. **Endorse**:
6868
- Vote1-certified EBs are referenced by new EBs created during this stage
6969
- Links EBs across different pipeline instances
70-
- Strengthens overall confirmation of IBs
70+
- Strengthens overall confirmation of IBs.
7171

7272
7. **Vote2**:
7373
- Validators cast final votes for EBs from the 'Endorse' stage
7474
- An EB becomes Vote2-certified if it meets specific criteria
75-
- Must reference a majority of Vote1-certified EBs
75+
- Must reference a majority of Vote1-certified EBs.
76+
77+
This pipelined architecture ensures the continuous generation, parallel processing, dissemination, and confirmation of IBs, enabling Leios to achieve a high transaction throughput.

‎site/docs/overview.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,4 +43,6 @@ The key idea is to separate transaction ordering (which occurs on the base
4343
chain) from transaction diffusion, availability, and validation. Ultimately,
4444
these multiple lanes must merge into a single, orderly flow of vehicles – just
4545
as the blocks of the underlying main chain consolidate transactions into a
46-
final, agreed-upon sequence.
46+
final, agreed-upon sequence.
47+
48+
*Read the following sections to learn more about the protocol’s properties and high-level architecture.*

‎site/docs/protocol-overview.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,31 +8,31 @@ Leios addresses three interconnected concerns often found in blockchains:
88

99
- Transaction diffusion
1010
- Transaction validation and availability
11-
- Transaction ordering
11+
- Transaction ordering.
1212

1313
By decoupling transaction processing from consensus, Leios allows for more
1414
efficient and continuous resource usage (eg, CPU and bandwidth). Instead of
1515
experiencing short bursts of network load when blocks are fully created,
1616
validated, and diffused, Leios introduces two core components to facilitate this
1717
decoupling:
1818

19-
## Input blocks (IBs)
19+
**Input blocks (IBs)**
2020

2121
- Validators (stakeholders or miners) bundle transactions into lightweight IBs
2222
at high speed
2323
- IBs are generated concurrently, not sequentially, maximizing available
24-
bandwidth
24+
bandwidth.
2525

26-
## Endorser blocks (EBs)
26+
**Endorser blocks (EBs)**
2727

2828
- EBs aggregate batches of IBs and undergo a two-phase voting process to certify
2929
their validity and availability
3030
- This is necessary because blocks are divided into two parts: headers and
3131
bodies
3232
- An input block will not be referenced by an endorser block if its body is not
33-
available
33+
available.
3434

35-
## Key Properties
35+
## Key properties
3636

3737
The following properties set Leios apart from traditional blockchain protocols:
3838

@@ -46,4 +46,4 @@ The following properties set Leios apart from traditional blockchain protocols:
4646
- **Scalability**: The system scales smoothly with network capacity and
4747
available CPU resources needed to run verifiable random function (VRF)
4848
lotteries, process blocks and votes, and generate certificates. It maintains
49-
high performance even as participation fluctuates
49+
high performance even as participation fluctuates.

‎site/docs/resources.md‎

Lines changed: 30 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -4,63 +4,60 @@ sidebar_position: 4
44

55
# Resources
66

7-
This page collects various resources about Ouroboros Leios, from technical
8-
papers to presentations and videos.
7+
This page provides a collection of resources on Ouroboros Leios, including technical papers, presentations, and videos.
98

10-
## Technical Documentation
9+
## Technical documentation
1110

12-
- [Leios CIP](https://github.com/cardano-foundation/CIPs/pull/379) - The Cardano
13-
Improvement Proposal by Duncan Coutts, providing rationale and a high-level
14-
design of the protocol.
11+
- [Leios CIP](https://github.com/cardano-foundation/CIPs/pull/379) – the Cardano
12+
Improvement Proposal by Duncan Coutts, providing the rationale and a high-level
13+
design of the protocol
1514

16-
- [Research Paper](https://iohk.io/en/research/library/papers/high-throughput-blockchain-consensus-under-realistic-network-assumptions/) -
17-
The original research paper defining the core protocol and its theoretical
18-
properties.
15+
- [High-Throughput Blockchain Consensus under Realistic Network Assumptions](https://iohk.io/en/research/library/papers/high-throughput-blockchain-consensus-under-realistic-network-assumptions/) research paper – the original research defining the core protocol and its theoretical properties.
1916

2017
## Videos
2118

22-
- [Scaling Cardano with Leios](https://www.youtube.com/watch?v=Czmg9WmSCcI) -
23-
Professor Aggelos Kiayias, IOG's Chief Scientist, explains Leios in the
24-
context of scaling Cardano.
19+
- [Scaling Cardano with Leios](https://www.youtube.com/watch?v=Czmg9WmSCcI) –
20+
Professor Aggelos Kiayias, IO's chief scientist, explains Leios in the
21+
context of scaling Cardano
2522

26-
- [Understanding Leios](https://www.youtube.com/watch?v=YEcYVygdhzU) - Giorgos
23+
- [Understanding Leios](https://www.youtube.com/watch?v=YEcYVygdhzU) – Giorgos
2724
Panagiotakos, one of the paper's co-authors, provides a detailed explanation
28-
of the protocol.
25+
of the Leios protocol
2926

30-
- **Monthly Leios Meetings**
27+
- **Monthly Leios meetings**:
3128

32-
- [October, 2024](https://drive.google.com/file/d/12VE0__S0knHqXXpIVdXGWvDipK0g89p_/view?usp=sharing)
29+
- [October 2024](https://drive.google.com/file/d/12VE0__S0knHqXXpIVdXGWvDipK0g89p_/view?usp=sharing)
3330

34-
- [November, 2024](https://drive.google.com/file/d/1W4iu4MwOXILXes1Zi43MeM505KAOHXso/view?usp=sharing)
31+
- [November 2024](https://drive.google.com/file/d/1W4iu4MwOXILXes1Zi43MeM505KAOHXso/view?usp=sharing)
3532

36-
- [December, 2024](https://drive.google.com/file/d/1F07oKxBgdOEasGcstxEavkPCgr58sbIO/view?usp=sharing)
33+
- [December 2024](https://drive.google.com/file/d/1F07oKxBgdOEasGcstxEavkPCgr58sbIO/view?usp=sharing)
3734

38-
- [January, 2025](https://www.youtube.com/live/6ovcWDCdqFU?si=-dgnvO7353tUyiDZ&t=120)
35+
- [January 2025](https://www.youtube.com/live/6ovcWDCdqFU?si=-dgnvO7353tUyiDZ&t=120).
3936

4037
## Presentations
4138

42-
- [Leios Overview Slides](https://docs.google.com/presentation/d/1W_KHdvdLNDEStE99D7Af2SRiTqZNnVLQiEPqRHJySqI/edit?usp=sharing) -
43-
Presentation by Sandro Coretti-Drayton offering insights into Leios.
39+
- [Leios overview slides](https://docs.google.com/presentation/d/1W_KHdvdLNDEStE99D7Af2SRiTqZNnVLQiEPqRHJySqI/edit?usp=sharing) –
40+
the presentation by Sandro Coretti-Drayton providing insights into Leios.
4441

45-
- **Monthly Leios Presentations**
42+
- **Monthly Leios presentations**:
4643

47-
- [October, 2024 Slides](https://docs.google.com/presentation/d/1KgjJyP6yZyZKCGum3deoIyooYUOretA9W6dTtXv1fso/edit?usp=sharing)
44+
- [October 2024 slides](https://docs.google.com/presentation/d/1KgjJyP6yZyZKCGum3deoIyooYUOretA9W6dTtXv1fso/edit?usp=sharing)
4845

49-
- [November, 2024 Slides](https://docs.google.com/presentation/d/11LHQeUuv-TQfiy9GwXkrffSimFjSq8tdTB8qIB-Pk3U/edit?usp=sharing)
46+
- [November 2024 slides](https://docs.google.com/presentation/d/11LHQeUuv-TQfiy9GwXkrffSimFjSq8tdTB8qIB-Pk3U/edit?usp=sharing)
5047

51-
- [December, 2024 Slides](https://docs.google.com/presentation/d/1LwpcXnXLgrYTSDalJY1SfpeyU_4lIkYhyMy5Kv0Huzw/edit?usp=sharing)
48+
- [December 2024 slides](https://docs.google.com/presentation/d/1LwpcXnXLgrYTSDalJY1SfpeyU_4lIkYhyMy5Kv0Huzw/edit?usp=sharing)
5249

53-
- [January, 2025 Slides](https://docs.google.com/presentation/d/1qKXe3CvAvJGVWAssjrKpRrRABMT6I39E1FxUWQ_PZzo/edit?usp=sharing)
50+
- [January 2025 slides](https://docs.google.com/presentation/d/1qKXe3CvAvJGVWAssjrKpRrRABMT6I39E1FxUWQ_PZzo/edit?usp=sharing).
5451

55-
## Tools and Simulations
52+
## Tools and simulations
5653

57-
- [Throughput Simulation](https://www.insightmaker.com/insight/5B3Sq5gsrcGzTD11GyZJ0u/Cardano-Throughput-v0-2) -
58-
Interactive simulation demonstrating Leios' throughput capabilities.
54+
- [Throughput simulation](https://www.insightmaker.com/insight/5B3Sq5gsrcGzTD11GyZJ0u/Cardano-Throughput-v0-2) –
55+
an interactive simulation demonstrating Leios' throughput capabilities.
5956

60-
## Development Resources
57+
## Development resources
6158

62-
- [GitHub Repository](https://github.com/input-output-hk/ouroboros-leios) - The
63-
official Leios implementation repository.
59+
- [GitHub repository](https://github.com/input-output-hk/ouroboros-leios) – the
60+
official Leios implementation repository
6461

65-
- [Cost Estimator](https://leios.cardano-scaling.org/cost-estimator/) - Tool for
62+
- [Cost estimator](https://leios.cardano-scaling.org/cost-estimator/) – the tool for
6663
estimating resource costs in Leios.

0 commit comments

Comments
 (0)