Repository navigation
Conversation
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Two active issues remain: the generated Leios configuration omits the required SQLite backend, and the ancillary snapshot check mishandles the final partial immutable chunk, causing normal Leios end-to-end restores to fail.
2 open issues
What changed in this PR
This PR prototypes Leios-aware Cardano database snapshots by configuring a Leios devnet, capturing and restoring leios.imm.db through signed ancillary archives, and validating certified endorser-block closures in end-to-end tests.
Changes:
- Adds Leios devnet configuration, BLS keys, transaction-load generation, CLI options, documentation, and CI coverage.
- Introduces
mithril-cardano-node-leiosfor reading certifying blocks, selecting database layouts, and creating consistent SQLite snapshots. - Integrates the Leios database into aggregator archives and verifies restored database closures.
| File | Description |
|---|---|
| mithril-test-lab/mithril-end-to-end/src/utils/mithril_command.rs | Exposes command working-directory information for end-to-end test utilities. |
| mithril-test-lab/mithril-end-to-end/src/toolkit/exec.rs | Adds support for executing transaction-load commands. |
| mithril-test-lab/mithril-end-to-end/src/toolkit/check/cardano_database.rs | Validates restored Leios database files and certified endorser-block closures. |
| mithril-test-lab/mithril-end-to-end/src/scenario/minimal.rs | Adds Leios transaction loading and database restoration checks to minimal scenarios. |
| mithril-test-lab/mithril-end-to-end/src/scenario/full.rs | Adds Leios transaction loading and database restoration checks to full scenarios. |
| mithril-test-lab/mithril-end-to-end/src/mithril/infrastructure.rs | Propagates Leios-mode configuration through the end-to-end infrastructure. |
| mithril-test-lab/mithril-end-to-end/src/mithril/client.rs | Locates restored Cardano database v2 files. |
| mithril-test-lab/mithril-end-to-end/src/main.rs | Adds Leios command-line options, defaults, validation, and wiring. |
| mithril-test-lab/mithril-end-to-end/src/devnet/cardano.rs | Passes Leios settings to the devnet and starts transaction-load generation. |
| mithril-test-lab/mithril-end-to-end/README.md | Documents running Leios end-to-end tests. |
| mithril-test-lab/mithril-end-to-end/Cargo.toml | Adds the Leios node crate dependency. |
| mithril-test-lab/cardano-devnet/README.md | Documents standalone Leios devnet operation. |
| mithril-test-lab/cardano-devnet/mkfiles/mkfiles-topology-cardano.sh | Adds a dedicated transaction-load UTxO address to the topology. |
| mithril-test-lab/cardano-devnet/mkfiles/mkfiles-start.sh | Adds BLS node arguments and transaction-load shutdown handling. |
| mithril-test-lab/cardano-devnet/mkfiles/mkfiles-leios.sh | Generates Leios configuration and transaction-load scripts. |
| mithril-test-lab/cardano-devnet/mkfiles/mkfiles-init.sh | Adds Leios defaults and version validation to devnet initialization. |
| mithril-test-lab/cardano-devnet/mkfiles/mkfiles-cardano.sh | Generates additional UTxO keys and distributes BLS key material. |
| mithril-test-lab/cardano-devnet/mkfiles/lib/mkfiles-leios-genesis.sh | Generates Leios BLS genesis data and configures Leios parameters. |
| mithril-test-lab/cardano-devnet/devnet-mkfiles.sh | Integrates Leios artifact generation into the devnet build. |
| mithril-aggregator/src/services/snapshotter/compressed_archive_snapshotter.rs | Copies the Leios database into signed ancillary snapshot archives. |
| mithril-aggregator/Cargo.toml | Adds the Leios node crate dependency to the aggregator. |
| internal/cardano-node/mithril-cardano-node-leios/src/test/mod.rs | Provides Leios database and immutable-file test fixtures. |
| internal/cardano-node/mithril-cardano-node-leios/src/lib.rs | Defines and exports the new Leios crate modules. |
| internal/cardano-node/mithril-cardano-node-leios/src/leios_immutable_database_snapshotter.rs | Implements consistent Leios database snapshots with retry and closure validation. |
| internal/cardano-node/mithril-cardano-node-leios/src/entities/mod.rs | Exports Leios entity types. |
| internal/cardano-node/mithril-cardano-node-leios/src/entities/certifying_block.rs | Defines certifying-block metadata and related entities. |
| internal/cardano-node/mithril-cardano-node-leios/src/database/mod.rs | Organizes Leios database adapters and layout components. |
| internal/cardano-node/mithril-cardano-node-leios/src/database/leios_immutable_database.rs | Provides read-only access and consistent-copy support for the Leios SQLite database. |
| internal/cardano-node/mithril-cardano-node-leios/src/database/layout.rs | Defines database layout abstraction and version selection. |
| internal/cardano-node/mithril-cardano-node-leios/src/database/layout_rc_2026w44.rs | Implements the rc-2026w44 Leios SQLite database layout. |
| internal/cardano-node/mithril-cardano-node-leios/src/certifying_blocks_reader.rs | Reads Leios announcements and certifying blocks from immutable files. |
| internal/cardano-node/mithril-cardano-node-leios/README.md | Documents the new crate and its database layout extension model. |
| internal/cardano-node/mithril-cardano-node-leios/Makefile | Adds build, test, check, and documentation targets for the crate. |
| internal/cardano-node/mithril-cardano-node-leios/Cargo.toml | Defines the new workspace crate and its dependencies. |
| Cargo.toml | Registers the Leios crate as a workspace member. |
| Cargo.lock | Records dependencies for the new Leios crate. |
| .github/workflows/ci.yml | Adds a Leios-mode end-to-end CI scenario. |
Review effort: Lite
…tion and a transaction load USE_LEIOS runs the devnet in Leios mode with pools able to vote, trustable local roots, short Leios periods, a small block body and a tx-firehose load.
--use-leios runs the devnet in Leios mode with a transaction load, whose duration is set with --leios-load-duration.
jpraynaud
force-pushed
the
jpraynaud/3691-hard-fork-dijkstra-with-leios
branch
from
November 19, 2026 18:02
e02bcd5 to
315c055
Compare
Map the `musashinet` network code to the network magic `164`.
Map the `musashinet` network code to the DMQ network magic `2147483812`.
Adds a 'leios' mode to the e2e matrix running the rc-2026w46 Leios node with 15s epochs and a 60s transaction load.
…e of a Cardano node Takes a consistent copy of leios.imm.db and checks it holds the closure of every endorser block certified in the shipped immutable files.
…ancillary archive The copy of leios.imm.db is taken after the partial immutable file, checked for the closures of the certifying blocks and added to the signed manifest.
The Cardano database check verifies that the restored database holds the closure of every certified endorser block.
jpraynaud
force-pushed
the
jpraynaud/3691-hard-fork-dijkstra-with-leios
branch
from
November 20, 2026 11:12
315c055 to
75734a5
Compare
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.


Content
This PR includes a prototype of the Cardano database snapshot and restoration with the Leios database:
USE_LEIOS) with BLS keys for the pools, trustable local roots, short Leios periods and a transaction load that gets endorser blocks certified--use-leiosand--leios-load-durationoptions to the end-to-end tests, which run the scenarios on a Leios devnetleiosmode to the end-to-end tests of the CI, running a release candidate of the Leios nodemithril-cardano-node-leioscrate, which takes a consistent copy ofleios.imm.dband checks that it holds the closure of every endorser block certified in the shipped immutable files (temporary implementation)leios.imm.dbin the signed ancillary archive of the aggregator, restored by the client with the other ancillary files (temporary implementation)Pre-submit checklist
Issue(s)
Relates to #3691