Skip to content

Commit 10a48db

Browse files
committed
Write about the impact of leios onto the ecosystem
1 parent 248284c commit 10a48db

File tree

3 files changed

+53
-5
lines changed

3 files changed

+53
-5
lines changed

docs/ImpactAnalysis.md

Lines changed: 51 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,58 @@ This document is the first iteration of a high-level design document for the Lei
2828

2929
# Ecosystem
3030

31+
Most users interact with the Cardano system through a wallet or a dApp. Both of these systems provide end-user interfaces and are directly or indirectly connected to the Cardano network. A varying number of services in between the Cardano network and those user-facing applications determines the impact of the Leios upgrade onto the Cardano ecosystem. The Cardano network itself is operated by so-called stake pool operators (SPOs). The following context diagram illustrates notable personas, a few example systems of the Cardano ecosystem and their interactions:
32+
33+
![](./context-diagram.svg)
34+
35+
## Impact on operations
36+
37+
The Leios upgrade does not change the roles and responsibilities for SPOs and only small changes to their operations are expected. Besides a modest increase in compute and network requirements (see [resource requirements summary in the CIP](https://github.com/cardano-scaling/CIPs/blob/leios/CIP-0164/README.md#resource-requirements)), one additional step in the block producing node setup is required: One additional key pair is needed to sign votes for EBs.
38+
39+
- **REQ-GenerateBLSKeys** SPOs must be able to generate BLS key pairs.
40+
- **REQ-RegisterBLSKeys** SPOs must be able to register their BLS public key to become part of the voting committee.
41+
- **REQ-RotateBLSKeys** SPOs must be able to rotate their BLS key and limit usage of compromised keys.
42+
43+
Concretely, these BLS keys could be generated and managed alongside the existing VRF keys. The node configuration needs to be extended to include the BLS signing key and the public key will need to become part of the operational certificate. With the signing key available, the node will be able to automatically issue votes for EBs.
44+
45+
## Impact on user experience
46+
47+
End-users are not expected to be impacted by the Leios upgrade. The transaction format and ledger semantics remain unchanged. Functionally, end-users will be able to use wallets and dApps as before, while dApp developers can continue to build on top of Cardano as before. However, throughput increases often come with a trade-off in latency. The proposed Leios upgrade only increases latency for transactions that need to be processed via EBs in times of higher than "Praos-only" load. The CIP provides more detail on expected latency under varying load [in the simulation results](https://github.com/cardano-scaling/CIPs/blob/leios/CIP-0164/README.md#simulation-results).
48+
49+
- **REQ-LowLatency** End-users expect low inclusion latency of transactions.
50+
- **REQ-NoLostTransactions** Even under high load, end-users expect that transactions are eventually included on chain.
51+
52+
While first inclusion latency might increase in high load situations, the fact that Leios certificates require a supermajority of votes could provide a stronger finality guarantee for transactions than a first inclusion in a Praos block. This does not give rise to a specific requirement at this point, but needs to be further investigated.
53+
54+
## Impacted infrastructure
55+
56+
The Leios consensus upgrade does "only" change the algorithm of how consensus on a transaction sequence is achieved. The currently proposed protocol does _not_ change the transaction format or ledger semantics. Therefore, the impact of the Leios upgrade onto the Cardano ecosystem is generally bounded by the client interfaces offered by the Cardano network system (its various node implementations). The following system diagram depicts the Cardano peer to peer network as a set of nodes in block producing, relay or data serving roles, as well as examples of key infrastructure applications:
57+
58+
59+
![](./system-diagram.svg)
60+
61+
Block producing and relay nodes represent the backbone of the Cardano chain, are typically operated by SPOs, and only few implementations exist. On the other hand, there is an increasing number of implementations for data serving purposes, which are typical entry points into the Cardano network for major wallets and dApps. Interaction between nodes happens via the node-to-node network protocols and most node implementations also offer client interfaces to interact with the chain and create integrations with other systems. Most applications using the cardano network utilize indexers and other middleware to provide performant access to chain data - dbSync is one example for such a component. Hydra nodes are depicted as an example of a directly integrated dApp, which creates a so-called layer 2 - a ledger running on top of Cardano that is faster, cheaper, or has different functionality. Layer 2 infrastructure like Hydra or bridges to other chains are important systems to be considered when estimating the impact of the Leios upgrade. However, there are many more components in the Cardano ecosystem, and this document only captures a few relevant ones.
62+
63+
> [!WARNING]
64+
> TODO: Write about
65+
>
66+
> - Client interfaces (vs. network protocols)
67+
> - node to client
68+
> - utxo-rpc
69+
>
70+
> - Systems not impacted by Leios
71+
> - Direct usage of node-to-client interface
72+
> - Indirect use of N2C interface
73+
>
74+
> - Systems impacted
75+
> - directly contributing to consensus
76+
> - interested in consensus/block structure
77+
> - sensitive to longer inclusion latenc
78+
79+
A survey of various Cardano ecosystem components was conducted to estimate the impact of Leios in its base form in comparison to more complex variants (e.g., including sharding). Various projects across several categories in the Cardano ecosystem were considered, analysed and their creators interviewed for their expected impact (this was prior to publishing CIP-164). Find the results of this survey in [this spreadsheet](https://docs.google.com/spreadsheets/d/1NpXhfRl50xr4jYouk6aeXXQyeW4KVlKsELa3dpGBtVI).
80+
3181
> [!WARNING]
32-
> TODO: Introduce the "cardano node system" and its context
33-
> - c4 landscape diagram
34-
> - characterize ecosystem / dependency graph
35-
> - cover external interfaces of the cardano node
36-
> - ecosystem impact (onto relevant personas)
82+
> TODO: Convert spreadsheet to markdown table in appendix
3783
3884
# Consensus
3985

0 commit comments

Comments
 (0)