v2.1.3 · 15 packages · 2,605 tests

Attestia proof that it happened.

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 # 2,597 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

15 workspace packages: 13 tested libraries, the npm bundle and the demo. Counts are from CI.

Package	Tests	Purpose
@attestia/types	75	Shared domain types (zero deps)
@attestia/registrum	368	Constitutional governance — 11 invariants, dual-witness
@attestia/ledger	156	Append-only double-entry engine
@attestia/chain-observer	295	Multi-chain read-only observation (EVM + XRPL + Solana + L2s)
@attestia/vault	91	Personal vault — portfolios, budgets, intents
@attestia/treasury	109	Org treasury — payroll, distributions, funding gates
@attestia/reconciler	98	3D cross-system matching + Registrum attestation
@attestia/witness	295	XRPL on-chain attestation, multi-sig governance, retry
@attestia/verify	273	Replay verification, compliance evidence, SLA enforcement
@attestia/event-store	263	Append-only event persistence, JSONL, hash chain, 34 event types, crash recovery
@attestia/proof	94	Merkle trees, inclusion proofs, attestation proof packaging
@attestia/sdk	115	Typed HTTP client SDK for external consumers
@attestia/node	362	Hono REST API — 57 endpoints, auth, multi-tenancy

Development

Build & test

pnpm install          # Install all dependencies
pnpm build            # Build all packages
pnpm test             # Run all tests (2,597)
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.