Skip to content

Commit 88bc732

Browse files
committed
Created page of post-CIP findings.
1 parent 88bd26e commit 88bc732

File tree

3 files changed

+44
-1
lines changed

3 files changed

+44
-1
lines changed

Logbook.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Leios logbook
22

3+
> [!IMPORTANT]
4+
>
5+
> Now that the [Leios CIP](https://github.com/cardano-foundation/CIPs/pull/1078) is under review and implementation work has begun, this Leios logbook has been retired in favor of github tickets in the [Leios implementation roadmap](https://github.com/orgs/input-output-hk/projects/167/views/3).
6+
>
7+
> See the [Post-CIP R&D Findings](docs/post-cip-findings.md) document for additional (after 2025-11-01) findings and artifacts not directly related to the implementation of Linear Leios.
8+
9+
310
## 2025-10-21
411

512
### Mainnet data on "canary transactions"

analysis/markov/ReadMe.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The protocol state is represented by three quantities.
2121
- Whether an honest RB was produced.
2222
- Whether a certificate is ready for inclusion in the next RB.
2323

24-
Time is tracked in terms of block-forging opportunties instead of in terms of slots.
24+
Time is tracked in terms of block-forging opportunities instead of in terms of slots.
2525

2626
Transitions occur in several substeps:
2727

docs/post-cip-findings.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Post-CIP R&D Findings
2+
3+
This document catalogs Leios-related findings and artifacts that were created subsequent to the [Leios CIP](https://github.com/cardano-foundation/CIPs/pull/1078).
4+
5+
## Markovian model of Linear Leios
6+
7+
[Markovian simulation of Linear Leios](../analysis/markov/) computes the probability of EB certifications as RBs are produced.
8+
9+
The protocol state is represented by three quantities.
10+
11+
- The number of RBs that have been produced.
12+
- The number of EBs that have been produced.
13+
- Whether an honest RB was produced.
14+
- Whether a certificate is ready for inclusion in the next RB.
15+
16+
Time is tracked in terms of block-forging opportunities instead of in terms of slots.
17+
18+
Transitions occur in several substeps:
19+
20+
1. _Forge RB:_ create a new RB.
21+
2. _Certify:_ include a certificate in the RB.
22+
3. _Forge EB:_ create a new EB.
23+
4. _Vote:_ cast votes to reach a quorum.
24+
25+
The `linleios` program executes the Markov model for EB production in Linear Leios. The protocol parameters and network characteristic are specified as flags on the command line. The program outputs the following information:
26+
27+
- The efficiencies, on `/dev/stdout`.
28+
- RB efficiency: the fraction of possible RBs that were actually produced.
29+
- EB efficiency: the fraction of possible EBs that were actually produced.
30+
- Efficiency: the fraction o possible payload bytes that were actual produced.
31+
- The "missing probability" resulting from the finite-resolution arithmetic of the computations, on `/dev/stderr`.
32+
- Optionally, a JSON file containing the probabilities of the given number of certified EBs.
33+
34+
The figure below shows example results for the probability distribution of the number of EBs generated per 100 RBs. This directly relates to Leios efficiency.
35+
36+
![Example results](../analysis/markov/example-results.png)

0 commit comments

Comments
 (0)