Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
5d31bcf
cip: Ouroboros Leios proposal
will-break-it Aug 27, 2025
7b76a64
Write versioning section
ch1bo Aug 27, 2025
b7175ad
Reduce repetition in protocol parameters section
ch1bo Aug 27, 2025
88e0cf5
Rename and move protocol security section
ch1bo Aug 27, 2025
c48263b
Link to all CDDLs from protocol entities
ch1bo Aug 27, 2025
d3b064e
docs(cip): fix typo
will-break-it Aug 27, 2025
24117f8
Switch colors of the mini-protocols
ch1bo Aug 27, 2025
c2b9491
cip(leios): integrate requested changes
will-break-it Sep 1, 2025
9b7d440
Update CIP-????/README.md
will-break-it Sep 3, 2025
c5089cc
docs(cip): Add Rationale title
will-break-it Sep 3, 2025
c8c6f61
docs(cip): Add Motivation title
will-break-it Sep 3, 2025
6820725
docs(cip): fix dead link
will-break-it Sep 3, 2025
f310c32
docs(cip): integrate requested changes
will-break-it Sep 3, 2025
bd9172f
docs(cip): specify minimal validation
will-break-it Sep 3, 2025
355710c
docs(cip): clarify inclusion rules
will-break-it Sep 3, 2025
dab5bda
docs(cip): moved to CIP-0164
will-break-it Sep 3, 2025
3616efc
docs(cip): clarify disregarding uncertified EBs
will-break-it Sep 3, 2025
05d11d3
docs(cip): add formal spec constraint for non-empty EBs
will-break-it Sep 11, 2025
4ffd557
docs(cip): add design decisions section to rationale for tx references
will-break-it Sep 11, 2025
13b3327
docs(cip): clarify EB referenced tx bytes
will-break-it Sep 11, 2025
adbdc6f
docs(cip): fix typo
will-break-it Sep 11, 2025
0acf2ca
docs(cip): rephrase equivocation security guarantee statement
will-break-it Sep 11, 2025
0714cfc
docs(cip): update utxohd reference
will-break-it Sep 11, 2025
e2b895f
docs(cip): update plutus limits notation
will-break-it Sep 11, 2025
280e91c
Apply selected improvements from sterraf's corrections
will-break-it Sep 11, 2025
263392d
docs(cip): integrated requested changes
will-break-it Sep 11, 2025
c81971b
Regenerated CIP simulation results, see https://github.com/input-outp…
bwbush Aug 28, 2025
4e72ff4
Added 50 TxkB/s case to simulation plots
bwbush Sep 16, 2025
a5bd343
Updated table 6 (efficiency)
bwbush Sep 16, 2025
98b5d36
Revised text discussing simulation results
bwbush Sep 16, 2025
44db860
Revised operational costs
bwbush Sep 16, 2025
eb1c1a6
Merge pull request #14 from cardano-scaling/bwbush/leios-figures
will-break-it Sep 17, 2025
f7d839f
docs(cip): replace logical time periods with physical; minor fixes
will-break-it Sep 17, 2025
ae7e685
docs(cip): clarify mini-protocol message table order
nfrisby Sep 30, 2025
8232f21
fix: group CDDL optional fields for EB announcement; clarified IB use
will-break-it Oct 2, 2025
3190f8c
fix: remove prime from delta RB
will-break-it Oct 2, 2025
2cb475e
fix: clarify fetching txs missing from mempool from peers
will-break-it Oct 2, 2025
fa6c726
docs: add linear to CIP title
will-break-it Oct 2, 2025
7fe8e11
docs: add per-month storage cost estimate to table 8
will-break-it Oct 2, 2025
93b9328
fix: numbers
will-break-it Oct 2, 2025
a977d72
Leios CIP proposed improvements by sterraf (#23)
will-break-it Oct 21, 2025
bd8bd57
Regenerated simulation figures using `sim-cli` 1.3.1 (#22)
bwbush Oct 21, 2025
36e006d
Throughput behavior under varying loads (#24)
bwbush Oct 28, 2025
ed1767a
docs: update cddl EB structure for oset use instead of list
will-break-it Nov 10, 2025
a7d271d
doc(CIP-0164): node-to-client changes (#25)
wolf31o2 Nov 19, 2025
6aae097
Mutually exclusive certs/txs in RBs (#19)
ch1bo Nov 19, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2,992 changes: 2,992 additions & 0 deletions CIP-0164/README.md

Large diffs are not rendered by default.

128 changes: 128 additions & 0 deletions CIP-0164/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,128 @@
# Ouroboros Leios Summary

> [!NOTE]
>
> This summary provides a comprehensive overview of Ouroboros Leios. For the
> complete technical specification, see [CIP-0164](README.md).

## What is Ouroboros Leios?

Ouroboros Leios is a revolutionary consensus protocol designed to dramatically
increase Cardano's transaction throughput while maintaining the security
guarantees of Ouroboros Praos. It's an optimistic protocol that operates
alongside the existing Praos chain, enabling Cardano to support the transaction
volumes needed for long-term economic sustainability.

## The problem it solves

Cardano's current throughput limitations pose a significant challenge as the
ecosystem grows. With increasing transaction volumes and complex decentralized
applications, the network needs a fundamental enhancement to accommodate future
demand without compromising security.

## How It Works: The 5-Step Process

### 1. **EB Proposal**

When a stake pool wins slot leadership, it creates:

- A standard **Ranking Block (RB)** - the normal Praos block
- An optional **Endorser Block (EB)** - containing references to additional
transactions

### 2. **EB Distribution**

The EB and its referenced transactions are rapidly distributed across the
network using optimized diffusion protocols.

### 3. **Committee Validation**

A randomly selected committee of stake pools validates the EB within a specific
voting period, ensuring network consensus.

### 4. **Certification**

If enough committee members vote (≥75% threshold), the EB becomes certified and
ready for inclusion.

### 5. **Chain Inclusion**

Certified EBs are applied to the ledger just before their certifying RB, but the
EB transactions themselves are not registered on-chain as separate blocks.

## Key Characteristics

### **Massive Throughput Increase**

- Achieving 30-65x improvement over current mainnet (140-300 TxkB/s, equivalent
to ~100-200 TPS depending on average transaction sizes)
- Each EB can reference significantly more transactions than standard blocks
- Configurable via protocol parameters to optimize for different network
conditions
- Simulations demonstrate substantial throughput improvements

### **Opportunistic Inclusion**

- Not all EBs get certified due to timing constraints
- This ensures sufficient network diffusion periods for Praos security
guarantees
- Balances throughput with security requirements

### **Security Preservation**

- Maintains all Praos security guarantees
- Committee-based validation ensures network consensus
- Careful timing constraints prevent security vulnerabilities

## Economic Benefits

### **Balanced Scalability**
- increased transaction capacity with moderate increase in confirmation time (45-60 seconds)
- Supports sustainable rewards as Reserve depletes, requiring ~36 TPS by 2029
- Maintains economic sustainability
- Minimal added complexity through few new protocol elements

### **Future-Proof Design**

- Designed to support Cardano's long-term growth
- Configurable parameters allow adaptation to changing needs
- Preserves existing economic incentives

## Implementation Strategy

### **Backward Compatibility**

- Operates alongside existing Praos chain
- No disruption to current network operations
- Gradual rollout possible

### **Protocol Parameters**

The system includes configurable parameters for:

- **Timing parameters**: Control validation and diffusion periods
- **Size parameters**: Determine EB capacity and committee sizes
- **Security parameters**: Maintain safety guarantees

## Research and Development

This specification presents the first version of the Ouroboros Leios protocol
family. For comprehensive research documentation, development history, and
additional technical resources, visit the Leios Innovation R&D site at
[leios.cardano-scaling.org](https://leios.cardano-scaling.org).

## What's Next?

Ouroboros Leios represents a significant step forward in blockchain scalability.
The protocol is designed to:

- Support Cardano's growing ecosystem
- Enable complex decentralized applications
- Maintain security and decentralization
- Provide economic sustainability for long-term growth

---

Read the complete [CIP-0164 specification](README.md) for in-depth technical
documentation, protocol artifacts, security analysis, and implementation
details.
316 changes: 316 additions & 0 deletions CIP-0164/images/contents-ebs-size.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
273 changes: 273 additions & 0 deletions CIP-0164/images/cpu-mean-histogram.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
256 changes: 256 additions & 0 deletions CIP-0164/images/cpu-mean-timeseries.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
641 changes: 641 additions & 0 deletions CIP-0164/images/disposition-size-timeseries.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3,210 changes: 3,210 additions & 0 deletions CIP-0164/images/elapsed-EB.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4,058 changes: 4,058 additions & 0 deletions CIP-0164/images/elapsed-RB.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1,927 changes: 1,927 additions & 0 deletions CIP-0164/images/elapsed-TX.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2,094 changes: 2,094 additions & 0 deletions CIP-0164/images/elapsed-VT.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
305 changes: 305 additions & 0 deletions CIP-0164/images/ingress-average-area.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
117 changes: 117 additions & 0 deletions CIP-0164/images/leios-forecast-sqrt-fill.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
82 changes: 82 additions & 0 deletions CIP-0164/images/leios-variants-comparison-radar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
106 changes: 106 additions & 0 deletions CIP-0164/images/load-cpu.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading