Skip to content

Commit ff117a9

Browse files
committed
Update system overview and point to the CIP
1 parent 4a31dec commit ff117a9

File tree

1 file changed

+9
-15
lines changed

1 file changed

+9
-15
lines changed

docs/threat-model.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -27,27 +27,21 @@ Besides past versions of this document, see also the [threat model section in Le
2727

2828
## System Overview
2929

30-
### Description
31-
3230
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.
3331

34-
### Key Components
35-
3632
#### Entities
3733

3834
- **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)
4137
- **Leios Certificate**: Cryptographic proof about aggregated stake-weighted votes on EB validity and transaction availability
4238

4339
#### 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)
5145

5246
#### Roles
5347
- **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
5852
1. **Block Production**: When eligible, stake pools simultaneously create an RB (announcing an EB) and the corresponding EB
5953
2. **EB Distribution**: EBs are discovered via RB headers and fetched by nodes
6054
3. **Committee Validation**: Selected voting committee validates EBs
61-
4. **Certification**: EBs achieving quorum (>60% voting stake) become certified
55+
4. **Certification**: EBs achieving quorum (75% of voting committee) become certified
6256
5. **Chain Inclusion**: Certificates are included in subsequent RBs, making referenced transactions part of the ledger
6357

64-
See also the [CIP draft](https://github.com/input-output-hk/ouroboros-leios/pull/396) for a more detailed specification.
58+
See also [CIP-164](https://github.com/cardano-scaling/CIPs/blob/leios/CIP-0164/README.md) for the complete protocol specification.
6559

6660
## Assets to Protect
6761

0 commit comments

Comments
 (0)