You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/threat-model.md
+9-15Lines changed: 9 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,27 +27,21 @@ Besides past versions of this document, see also the [threat model section in Le
27
27
28
28
## System Overview
29
29
30
-
### Description
31
-
32
30
Leios is an overlay protocol on top of Ouroboros Praos that enhances transaction throughput by allowing block producers to create larger Endorser Blocks (EBs) alongside standard Praos blocks (enhanced as Ranking Blocks - RBs). The system maintains backward compatibility while introducing new responsibilities for stake pools.
33
31
34
-
### Key Components
35
-
36
32
#### Entities
37
33
38
34
-**Mempool**: List of valid, pending transactions that could be added to the chain. Expanded capacity to support both RB and EB production
39
-
-**Ranking Block (RB)**: Standard Praos block enhanced with Leios certificate and EB announcement fields. Limited to current mainnet size (~88 kB)
40
-
-**Endorser Block (EB)**: New block type that references transactions for inclusion. May be substantially larger (~640 kB for 20k transaction references)
35
+
-**Ranking Block (RB)**: Standard Praos block enhanced with Leios certificate and EB announcement fields. Limited to current mainnet size (~90 kB)
36
+
-**Endorser Block (EB)**: New block type that references transactions for inclusion. May be substantially larger (proposed ~512 kB)
41
37
-**Leios Certificate**: Cryptographic proof about aggregated stake-weighted votes on EB validity and transaction availability
42
38
43
39
#### Network Protocols
44
-
-**Transaction Submission Protocol**: Existing protocol, unchanged except for expanded mempool capacity, served upstream
45
-
-**Chain Sync Protocol**: Existing protocol for tracking block headers of currently selected chain, served downstream
46
-
-**Block Fetch Protocol**: Existing protocol for downloading blocks, served downstream
47
-
-**EB Announcement Protocol**: New protocol to gossip EB existence, served downstream
48
-
-**EB Fetch Protocol**: New protocol for retrieving EBs on-demand, served downstream
49
-
-**Transaction Fetch Protocol**: New protocol for retrieving transactions referenced by EBs, served downstream
50
-
-**Vote Diffusion Protocol**: New protocol for propagating votes on EBs, served downstream
40
+
-**Transaction Submission**: Existing protocol, unchanged except for expanded mempool capacity
41
+
-**Chain Sync**: Existing protocol for tracking RB headers of currently selected chain
42
+
-**Block Fetch**: Existing protocol for downloading RBs
43
+
-**Leios Notify**: New protocol for announcing Leios-specific information (EBs, votes, certificates)
44
+
-**Leios Fetch**: New protocol for fetching Leios data on-demand (EBs, transactions, votes)
51
45
52
46
#### Roles
53
47
-**Block Producers**: Produce RBs and simultaneously create EBs, participate in voting
@@ -58,10 +52,10 @@ Leios is an overlay protocol on top of Ouroboros Praos that enhances transaction
58
52
1.**Block Production**: When eligible, stake pools simultaneously create an RB (announcing an EB) and the corresponding EB
59
53
2.**EB Distribution**: EBs are discovered via RB headers and fetched by nodes
0 commit comments