Integrate Antithesis using MOOG into Cardano node test suite

Open
  • Is something wrong?
#3,316 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@saratomaz is already working on this.

Since Feb 4, 2026.

Assessment

This issue has not been assessed yet.

Description

enhancement

We want to integrate Antithesis to run the existing Cardano node tests in an autonomous simulation environment with fault injection (network delays, crashes, timing reordering, etc.), in order to find concurrency and distributed-system bugs that are hard to catch in CI alone.

MOOG will be used to invoke Antithesis runs, the full system under test, including Cardano nodes, supporting services, and the pytest test runner, will be provided via prebuilt Docker images.

The goal is to reuse the current pytest-based test suite unchanged where possible, while enabling deterministic execution and replay of failures within Antithesis.

Motivation
  • The current test suite runs pytest-based integration tests against a running Cardano cluster.
  • CI validates expected behavior, but does not systematically explore alternative schedules, timing variations, or failure scenarios.
  • Antithesis allows us to:
    • explore many possible executions of the same workload,
    • replay failures deterministically,
    • find bugs that do not reproduce reliably in CI.
High-level approach
  • Build Docker images using the existing Nix-based build logic:
    • Cardano node and related binaries
    • Python test environment
  • Publish Docker images on a public registry (like DockerHub or GHCR).
  • Use MOOG only to invoke Antithesis
    • Image references will be immutable (e.g. git SHA or digest)
Required changes

Containerization

  • Create Docker images for:
    • Cardano node services
    • Pytest test runner
  • Move Nix-based builds to image build time.

Test adjustments

  • Run the existing pytest test suite in Antithesis unchanged.
  • Identify environment and execution assumptions (e.g. networking, paths, timing).
  • Fix issues that prevent reliable execution under fault injection (e.g. configuration, retries for eventual consistency).
  • Optionally introduce Antithesis Python SDK assertions where they add value.
Dominant language
Python
Stars
59
Forks
28
Avg merge
13h 57m
Merged PRs (30d)
87

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from IntersectMBO/cardano-node-tests

All issues in IntersectMBO/cardano-node-tests

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.