|
4 | 4 | > |
5 | 5 | > This blueprint is a work in progress. |
6 | 6 |
|
7 | | -The Ledger is responsible for validating Blocks and represents the actual semantics of Cardano transactions. The format of blocks and transactions is defined in so-called **eras**: `Byron`, `Shelley`, `Allegra`, `Mary`, `Alonzo`, `Babbage` and `Conway`. |
8 | | - |
9 | | -This blueprint is currently more of an entrypoint to already existing implementation-independent descriptions of Cardano transactions and the ledger rules. While existing work covers a lot already, the `cardano-blueprint` may serve as an incubation or staging area for material to cover gaps. |
10 | | - |
11 | | -For starters, the [EUTxO Crash Course](https://aiken-lang.org/fundamentals/eutxo) from Aiken is a very good introduction about Cardano transactions. |
12 | | - |
13 | | -See [Transaction fee](./transaction-fee.md) for an informal write-up on how transaction fees are currently calculated. |
| 7 | +The Ledger is responsible for validating Blocks and represents the actual |
| 8 | +semantics of Cardano transactions. The format of blocks and transactions is |
| 9 | +defined in so-called **eras**: `Byron`, `Shelley`, `Allegra`, `Mary`, `Alonzo`, |
| 10 | +`Babbage` and `Conway`. |
| 11 | + |
| 12 | +This blueprint is currently more of an entrypoint to already existing |
| 13 | +implementation-independent descriptions of Cardano transactions and the ledger |
| 14 | +rules. While existing work covers a lot already, the `cardano-blueprint` may |
| 15 | +serve as an incubation or staging area for material to cover gaps. |
| 16 | +For starters, the [EUTxO Crash Course](https://aiken-lang.org/fundamentals/eutxo) |
| 17 | +from Aiken is a very good introduction about Cardano transactions. |
| 18 | +See [Transaction fee](./transaction-fee.md) for an informal write-up on how |
| 19 | +transaction fees are currently calculated. |
14 | 20 |
|
15 | 21 | ## Ledger rules |
16 | 22 |
|
17 | | -The [Formal Specification](https://intersectmbo.github.io/formal-ledger-specifications/site/index.html) is the source of truth for ledger semantics. While it is currently being made more accessible by interleaving explanations with Agda definitions, its very dense on the Agda and actively worked on to close the gap latest era descriptions and the old era definitions. The Haskell implementation of the ledger holds a list of [design documents and ledger specifications](https://github.com/IntersectMBO/cardano-ledger?tab=readme-ov-file#cardano-ledger) for all eras. |
18 | | - |
19 | | -See [Block Validation](./block-validation.md) for a description of the `Conway` era block validation rules. |
| 23 | +The [Formal Specification](https://intersectmbo.github.io/formal-ledger-specifications/site/index.html) |
| 24 | +is the source of truth for ledger semantics. While it is currently being |
| 25 | +made more accessible by interleaving explanations with Agda definitions, its |
| 26 | +very dense on the Agda and actively worked on to close the gap latest era |
| 27 | +descriptions and the old era definitions. The Haskell implementation of the |
| 28 | +ledger holds a list of [design documents and ledger specifications](https://github.com/IntersectMBO/cardano-ledger?tab=readme-ov-file#cardano-ledger) |
| 29 | +for all eras. See [Block Validation](./block-validation.md) for a description |
| 30 | +of the `Conway` era block validation rules. |
20 | 31 |
|
21 | 32 | ## Block and transaction format |
22 | 33 |
|
23 | | -The [.cddl files in cardano-ledger](https://github.com/search?q=repo%3AIntersectMBO%2Fcardano-ledger+path%3A.cddl&type=code) define the wire-format of blocks and transactions for each era. These are self-contained for each |
24 | | -era and are referenced in [other blueprint CDDL schemas](../codecs#cddl). |
| 34 | +The [.cddl files in cardano-ledger](https://github.com/search?q=repo%3AIntersectMBO%2Fcardano-ledger+path%3A.cddl&type=code) |
| 35 | +define the wire-format of blocks and transactions for each era. These are |
| 36 | +self-contained for each era and are referenced in |
| 37 | +[other blueprint CDDL schemas](../codecs#cddl). |
25 | 38 |
|
26 | 39 | > [!WARNING] |
27 | 40 | > TODO: make ledger cddls available through blueprint directly |
28 | 41 |
|
29 | 42 | ## Conformance tests |
30 | 43 |
|
31 | | -Despite the formal specification provides a precise definition for semantics, testing the behavior of ledger implementations against the specification and also the ledger implementations against each other is crucial. For this purpose, a conformance test suite with [implementation-independent test vectors](https://github.com/cardano-scaling/cardano-blueprint/tree/main/src/ledger/conformance-test-vectors) can be used. |
| 44 | +Despite the formal specification provides a precise definition for semantics, |
| 45 | +testing the behavior of ledger implementations against the specification |
| 46 | +and also the ledger implementations against each other is crucial. For this |
| 47 | +purpose, a conformance test suite with [implementation-independent test |
| 48 | +vectors](https://github.com/cardano-scaling/cardano-blueprint/tree/main/src/ledger/conformance-test-vectors) |
| 49 | +can be used. |
0 commit comments