Nara Network Specification

A distributed system with hazy memory.

This document is the authoritative, re-implementation-grade specification for the Nara Network.

Core Principles

• Memory is Social: RAM-only; state replicated to peers.
• Derived State: Events are the only facts; state is interpreted via replaying.
• Subjective Truth: Opinions are shaped by personality and local history.
• Hazy Memory: Intentional data loss and forgetting as a system feature.

---

Spec Index

1. Identity & Being

• Overview: Network myth and principles.
• Styleguide: Terminology and aesthetics.
• Identity: Names, souls, and Ed25519 bonds.
• Personality: Deterministic character traits.
• Aura & Avatar: Visual representation.

2. Event & Memory Model

• Events: Immutable signed facts and ledger.
• Projections: Deriving state from event streams.
• Memory Model: Pruning, recovery, and forgetting.

3. Transport & Sync

• Plaza (MQTT): Public broadcasts.
• Mesh (HTTP): P2P WireGuard transport.
• Zines: Hand-to-hand gossip bundles.
• Sync Protocol: Historical reconciliation.

4. Presence & Consensus

• Presence: Discovery and liveness.
• Observations: Uptime/restart monitoring.
• Checkpoints: Multi-sig historical anchors.

5. Social & World

• Stash: Distributed encrypted storage.
• Social Events: Teasing, trends, and buzz.
• Clout: Subjective reputation ranking.
• World Postcards: Signature-chained messages.
• Coordinates: Vivaldi network latency mapping.

6. Operations & UI

• HTTP API: Public and Inspector endpoints.
• Boot Sequence: Transition to steady-state.
• Configuration: Flags and environment variables.
• Deployment: Production requirements.

---

Maintenance

Discrepancies between code and spec are bugs. Code behavior remains the source of truth.