14 packages · 1,853 tests · 96.8% coverage

Attestia financial truth infrastructure.

Structural governance, deterministic accounting, and human-approved intent — unified across chains, organizations, and individuals. We don't move your money. We prove what happened.

See architecture Read the Handbook

Flow

Intent → Approve → Execute → Verify

Test

pnpm test # 1,853 tests, all green

Attest

XRPL witnesses. Ethereum settles.

Three Systems, One Truth

Every interaction follows: Intent → Approve → Execute → Verify. No step is optional.

Personal Vault

Multi-chain portfolio observation, envelope budgeting, and intent declaration. Evolved from NextLedger.

Org Treasury

Deterministic payroll, DAO distributions, dual-gate funding, and double-entry ledger. Evolved from Payroll Engine.

Registrum

Structural registrar — 11 invariants, dual-witness validation, XRPL attestation. The constitutional layer.

Principles

These are not aspirational. They are enforced in code.

Principle

Implementation

Append-only records

No UPDATE, no DELETE — only new entries

Fail-closed

Disagreement halts the system, never heals silently

Deterministic replay

Same events produce the same state, always

Advisory AI only

AI can analyze, warn, suggest — never approve, sign, or execute

Multi-chain observation

Ethereum, XRPL, Solana, L2s — chain-agnostic read layer

Structural identity

Explicit, immutable, unique — constitutional, not biometric

Packages

14 packages, all tested, all typed.

Package

Tests

Purpose

@attestia/types

Shared domain types (zero deps)

@attestia/registrum

297

Constitutional governance — 11 invariants, dual-witness

@attestia/ledger

144

Append-only double-entry engine

@attestia/chain-observer

242

Multi-chain read-only observation (EVM + XRPL + Solana + L2s)

@attestia/vault

Personal vault — portfolios, budgets, intents

@attestia/treasury

Org treasury — payroll, distributions, funding gates

@attestia/reconciler

3D cross-system matching + Registrum attestation

@attestia/witness

245

XRPL on-chain attestation, multi-sig governance, retry

@attestia/verify

200

Replay verification, compliance evidence, SLA enforcement

@attestia/event-store

190

Append-only event persistence, JSONL, hash chain, 34 event types

@attestia/proof

Merkle trees, inclusion proofs, attestation proof packaging

@attestia/sdk

Typed HTTP client SDK for external consumers

@attestia/node

184

Hono REST API — 30+ endpoints, auth, multi-tenancy

Development

Build & test

pnpm install          # Install all dependencies
pnpm build            # Build all packages
pnpm test             # Run all tests (1,853)
pnpm test:coverage    # Run with coverage reporting
pnpm typecheck        # Type-check all packages

XRPL integration

docker compose up -d              # Start standalone rippled
pnpm --filter @attestia/witness \
  run test:integration            # On-chain round-trip tests
docker compose down               # Stop rippled

Documentation

Handbook & Architecture

Executive overview, package graph, data flows, security model, and 5-layer reference architecture.

Integration & Verification

API integration with curl examples, SDK usage, and auditor step-by-step replay guide.

Security & Compliance

STRIDE threat model, control matrix with threat→control→file→test mappings, and responsible disclosure.