Ledger

Deterministic source of truth for balances, journal entries, double-entry postings, and transaction references.

Source: docs/03_primitives.md

Ledger

The source of truth for balances and financial postings.

Responsibilities:

  • Accounts
  • Balances
  • Journal entries
  • Double-entry postings
  • Holds
  • Reversals
  • Adjustments
  • Transaction references
  • Available balance
  • Current balance

The ledger should be deterministic, strict, and domain-neutral. It should not know about QRPh, cards, KYC, fraud, or product-specific business logic.

Typical events:

  • journal.posted
  • balance.updated
  • hold.created
  • hold.released
  • transaction.reversed