Documentation

What TSUNAGI is, how it works, and how to run it

TSUNAGI is an independent, block-producing Cardano node written in Zig — proven with canonical blocks on the Preview network and now supervised for autonomous operation. Everything below is the real, current documentation.

Philosophy

Manifesto

Why an independent Cardano implementation matters — infrastructure monoculture and the case for diversity. Built without grants or treasury funding.

Technical

Whitepaper

The technical design of the node: forge path, propagation, and consensus participation.

Design

Architecture

The five guardian subsystems — KAGAMI, YAMORI, TATE, MUSUBI, KINTSUGI — and the full slot-to-canonical pipeline, with diagrams.

Operate

Guardian

The supervision layer: panic capture, evidence, restart, crash-loop breaker, rollback recommendation. Makes the node operable by humans.

Learn

KINTSUGI

The failure-memory system — every incident that ever cost a block, with root cause, fix, and lesson. The cracks repaired in gold.

Operations

Operations

Day-to-day: status, daily summary, guardianctl, rollback, KES monitoring, recovery procedures.

Install

Install

How TSUNAGI is deployed today: sha-verified bundles, supervised launch, verification.

Autonomy

Autonomy Scorecard

Observe/Protect/Recover/Learn scored implemented / tested / production-proven.