Skip to content

Commit eab743e

Browse files
authored
Update website: next monthly and deduplicate pages (#540)
* Allow for exceptions in next monthly meeting calculation The monthly review meeting for september will not be on the last wednesday of the month, but shifted by one week to Oct 1st. * Drop protocol overview and explainers in favor of landing page The landing page now gives a better explanation of how leios works and points to the CIP which is the most up-to-date resource we have. * Update resources Several links were broken, outdated or already included in other parts of the website. * Update logbook
1 parent a860f76 commit eab743e

File tree

9 files changed

+43
-288
lines changed

9 files changed

+43
-288
lines changed

Logbook.md

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

3+
## 2025-09-09
4+
5+
### SN on website updates
6+
7+
- Need to update the next monthly review meeting to be on Oct 1st (shifted due to the node diversity workshop)
8+
- The website computes when the next meeting is (last wednesday of the month)
9+
- Needed to add some logic to consider exceptions to that rule
10+
- Also, the website recently got updated with a more elaborate overview and how Leios works on the landing page, so we should be able to supersede outdated information in the "Documentation" section.
11+
312
## 2025-09-05
413

514
### Bandwidth measurements

site/docs/how-it-works.md

Lines changed: 0 additions & 108 deletions
This file was deleted.

site/docs/input-endorsers.png

-137 KB
Binary file not shown.

site/docs/overview.md

Lines changed: 0 additions & 48 deletions
This file was deleted.

site/docs/protocol-overview.md

Lines changed: 0 additions & 49 deletions
This file was deleted.

site/docs/resources.md

Lines changed: 9 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -9,59 +9,17 @@ technical papers, presentations, and videos.
99

1010
## Technical documentation
1111

12-
### Leios CPS
12+
- [CIP-164: Ouroboros Leios - Greater transaction throughput](https://github.com/cardano-foundation/CIPs/pull/1078) - Cardano Improvement Proposal (CIP) about the concrete Leios protocol changes to Cardano.
1313

14-
- [Leios CPS](https://github.com/cardano-foundation/CIPs/blob/master/CPS-0018/README.md)
14+
- [CPS-18: Greater Transaction
15+
throughput](https://github.com/cardano-foundation/CIPs/blob/master/CPS-0018/README.md) - Cardano Problem Statement (CPS) summarizing why more throughput is needed on Cardano.
1516

16-
#### Summary:
17+
- [High-Throughput Blockchain Consensus under Realistic Network Assumptions](https://iohk.io/en/research/library/papers/high-throughput-permissionless-blockchain-consensus-under-realistic-network-assumptions/) (August 2025, Crypto '25) — Sandro Coretti, Matthias Fitzi, Aggelos Kiayias, Giorgos Panagiotakos, and Alexander Russell. - Research paper on which the Leios consensus upgrade for Cardano is based on.
1718

18-
- Cardano's mainnet periodically faces congestion, with block utilization
19-
exceeding 90%, delaying transactions and impacting user experience, especially
20-
for use cases like airdrops, DEXes, oracles, and DApps. As new applications
21-
and bridges (eg, Cardano-Midnight, Cardano-Bitcoin) increase demand, current
22-
throughput (~12 TPS max) lags far behind competitors like Solana (7229 TPS).
23-
In Ouroboros Praos, security constraints (eg, 5-second block relay within a
24-
20-second slot) limit block size and script execution, underutilizing network
25-
resources. This CPS calls for research into scaling solutions like Ouroboros
26-
Leios to boost transaction volume, size, and execution units, while ensuring
27-
predictable processing times for time-sensitive applications. Goals include
28-
defining stakeholder needs, safely increasing limits, and leveraging underused
29-
resources — all without compromising security or raising node costs. Historical
30-
data shows frequent near-full blocks and Plutus execution bottlenecks,
31-
underscoring the urgency as Cardano aims for nation-state-scale usage by 2030.
19+
## Presentations and videos
3220

33-
### Leios CIP
34-
35-
- [Leios CIP (CIP-0079)](https://github.com/cardano-foundation/CIPs/pull/379) — Cardano Improvement Proposal by Duncan Coutts, November 2022.
36-
37-
**Summary**
38-
39-
CIP-0079 introduces Ouroboros Leios as a long-term solution to raise Cardano
40-
throughput beyond the limits of Ouroboros Praos. The CIP explains the rationale
41-
and provides a high-level protocol design.
42-
43-
### Leios research paper
44-
45-
- [High-Throughput Blockchain Consensus under Realistic Network Assumptions](https://iohk.io/en/research/library/papers/high-throughput-blockchain-consensus-under-realistic-network-assumptions/) (May 31, 2024) — Sandro Coretti, Matthias Fitzi, Aggelos Kiayias, Giorgos Panagiotakos, and Alexander Russell.
46-
47-
**Summary**
48-
49-
The paper presents Leios, a protocol overlay that transforms low-throughput PoW
50-
or PoS systems into high-throughput chains, achieving near-optimal throughput of
51-
(1 − δ) σ_H (where σ_H is the honest-stake fraction and δ > 0). Leios addresses
52-
adversarial tactics such as message bursts and equivocations via:
53-
54-
1. Concurrent input-block (IB) generation
55-
2. Endorser blocks (EBs) with data-availability proofs
56-
3. A seven-stage pipeline for uninterrupted processing
57-
4. Freshest-first diffusion with VRF-based timestamps
58-
5. Equivocation proofs to cap malicious spam.
59-
60-
Applied to Ouroboros, Leios yields a scalable, secure layer-1 for Cardano while
61-
maintaining settlement guarantees and supporting dynamic participation.
62-
63-
64-
## Videos
21+
- [Monthly review videos](./development/monthly-reviews.md) – Latest information
22+
and news on Leios R&D and development progress.
6523

6624
- [Scaling Cardano with Leios](https://www.youtube.com/watch?v=Czmg9WmSCcI)
6725
Professor Aggelos Kiayias, IO's chief scientist, explains Leios in the context
@@ -71,27 +29,10 @@ maintaining settlement guarantees and supporting dynamic participation.
7129
Panagiotakos, one of the paper's co-authors, provides a detailed explanation
7230
of the Leios protocol
7331

74-
- [Monthly review videos](./development/monthly-reviews.md) – recordings and presentations from our monthly public review meetings
75-
76-
## Presentations
77-
78-
- [Leios overview slides](https://docs.google.com/presentation/d/1W_KHdvdLNDEStE99D7Af2SRiTqZNnVLQiEPqRHJySqI/edit?usp=sharing)
32+
- [Leios overview
33+
slides](https://docs.google.com/presentation/d/1W_KHdvdLNDEStE99D7Af2SRiTqZNnVLQiEPqRHJySqI)
7934
– the presentation by Sandro Coretti-Drayton providing insights into Leios.
8035

81-
## Tools and simulations
82-
83-
- [Throughput simulation](https://www.insightmaker.com/insight/5B3Sq5gsrcGzTD11GyZJ0u/Cardano-Throughput-v0-2)
84-
– an interactive simulation demonstrating Leios' throughput capabilities.
85-
86-
## Development resources
87-
88-
- [GitHub repository](https://github.com/input-output-hk/ouroboros-leios) – the
89-
official Leios implementation repository
90-
91-
- [Cost estimator](https://leios.cardano-scaling.org/cost-estimator/) – the tool
92-
for estimating resource costs in Leios.
93-
94-
9536
## Leios Comparisons and Analyses
9637

9738
- [Leios Scorecard Comparison](leios-comparison.md) – How does Cardano’s Ouroboros Leios stack up against Solana, Ethereum, and Bitcoin? This scorecard compares throughput, fees, decentralization, and more.

site/package-lock.json

Lines changed: 3 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

site/sidebars.ts

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,15 +12,6 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
1212
*/
1313
const sidebars: SidebarsConfig = {
1414
documentationSidebar: [
15-
{
16-
type: "category",
17-
label: "Overview",
18-
items: [
19-
"overview",
20-
"protocol-overview",
21-
"how-it-works",
22-
],
23-
},
2415
"faq",
2516
"glossary",
2617
"resources",

site/src/pages/index.tsx

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,26 @@ function getLastWednesdayOfMonth(date = new Date()) {
5555
return lastWednesday;
5656
}
5757

58+
function UTCDateTime(year, month, day, hour, minute = 0, second = 0) {
59+
// NOTE: Not use constructor directly as it uses local time
60+
const date = new Date(year, month, day, hour, minute, second);
61+
date.setUTCHours(hour, minute, second);
62+
return date;
63+
}
64+
65+
let exceptions = {
66+
"2025-9": UTCDateTime(2025, 9, 1, 14)
67+
};
68+
5869
function getNextMeeting(now = new Date()) {
59-
const currentMonthMeeting = getLastWednesdayOfMonth(now);
70+
let nextMeeting = getLastWednesdayOfMonth(now);
71+
const exception = exceptions[`${now.getFullYear()}-${now.getMonth()+1}`];
72+
if (exception) {
73+
console.warn("Exceptional next meeting date:", exception);
74+
nextMeeting = exception;
75+
}
6076
const meetingEndTime = new Date(
61-
currentMonthMeeting.getTime() + 60 * 60 * 1000,
77+
nextMeeting.getTime() + 60 * 60 * 1000,
6278
); // 1 hour after start
6379

6480
// If we're past the current month's meeting end time, get next month's meeting
@@ -67,12 +83,12 @@ function getNextMeeting(now = new Date()) {
6783
return getLastWednesdayOfMonth(nextMonth);
6884
}
6985

70-
return currentMonthMeeting;
86+
return nextMeeting;
7187
}
7288

7389
function isLiveTime(now = new Date()) {
74-
const currentMonthMeeting = getLastWednesdayOfMonth(now);
75-
const meetingStartTime = currentMonthMeeting.getTime();
90+
const nextMeeting = getNextMeeting(now);
91+
const meetingStartTime = nextMeeting.getTime();
7692
const meetingEndTime = meetingStartTime + 60 * 60 * 1000; // 1 hour after start
7793
const currentTime = now.getTime();
7894

@@ -1943,7 +1959,7 @@ function MonthlyReviewsSection() {
19431959
fontWeight: 500,
19441960
}}
19451961
>
1946-
Next update: {nextDate}
1962+
Next review meeting: {nextDate}
19471963
</div>
19481964
)}
19491965
</div>

0 commit comments

Comments
 (0)