TSUNAGI

Deterministic Cardano Node

Let It Run. Let It Resolve.

TSUNAGI is an independent Cardano node project focused on deterministic ledger execution, runtime verification, persistent storage, and self-healing operator infrastructure. Independent Cardano infrastructure research in Zig.

Whitepaper Manifesto Roadmap GitHub Treasury
Preview Network Validation Whitepaper Published Shadow Verification Active LMDB Truth Mode Self-Healing Architecture
System Design

Architecture

TSUNAGI is organized as a layered architecture where each subsystem addresses a specific operational concern. The observability stack (KAGAMI, YAMORI, TATE, KURA) monitors and stabilizes the node. The TSURUGI protocol engine manages Ouroboros communication. The deterministic ledger pipeline processes blocks through a modular state machine. LMDB provides persistent storage with transactional guarantees.

TSUNAGI Architecture Diagram
Figure 1 — TSUNAGI layered node architecture showing observability subsystems, protocol engine, deterministic ledger pipeline, and LMDB persistent storage.
Foundation

Core Pillars

Four foundational capabilities define the TSUNAGI architecture.

Ledger Engine

Deterministic Ledger

A modular pipeline separating delta extraction, state application, undo management, and persistent storage into independently testable components. No global state. Identical inputs produce identical outputs on every execution.

Verification

Shadow Verification

An independent pipeline instance processes identical deltas on every block and compares parity with the primary ledger. Divergence is detected within one block of occurrence. The shadow never influences the primary path.

Persistence

LMDB Truth Mode

Three-stage persistence with preflight coverage scan, atomic LMDB writes, and automatic memory fallback. Shadow-writes progressively converge the store with live chain state. Operators select the persistence guarantee they require.

Operations

Self-Healing Infrastructure

Four observability subsystems — KAGAMI, YAMORI, TATE, KURA — evaluate health, verify integrity, and stabilize artifacts automatically. The node explains its own health rather than requiring external diagnostic inference.

Documentation

Research & Documentation

The architecture, methodology, and vision behind TSUNAGI are documented across four primary documents.

Whitepaper

Complete architecture, verification methodology, security model, and experimental validation.

Manifesto

Engineering philosophy, design principles, and the vision for deterministic infrastructure.

Roadmap

Development phases from deterministic foundation through ecosystem contribution.

Architecture Article

Building TSUNAGI — motivation, architecture, and philosophy behind the project.