mcp-tool-shop-org/Attestia

English | 日本語 | 中文 | Español | Français | हिन्दी | Italiano | Português

Financial truth infrastructure for the decentralized world.

Mission

We believe that money — wherever it lives, however it moves — deserves the same rigor as the systems that created it. Smart contracts execute. Blockchains record. But no one attests.

Attestia is the missing layer: structural governance, deterministic accounting, and human-approved intent — unified across chains, organizations, and individuals.

We don't move your money. We prove what happened, constrain what can happen, and make the financial record unbreakable.

What We Stand For

• Truth over speed. Every financial event is append-only, replayable, and reconcilable. If it can't be proven, it didn't happen.
• Humans approve; machines verify. AI advises, smart contracts execute, but nothing moves without explicit human authorization. Ever.
• Structural governance, not political governance. We don't vote on what's valid. We define invariants that hold unconditionally — identity is explicit, lineage is unbroken, ordering is deterministic.
• Intent is not execution. Declaring what you want and doing it are separate acts with separate gates. The gap between them is where trust lives.
• Chains are witnesses, not authorities. XRPL attests. Ethereum settles. But authority flows from structural rules, not from any chain's consensus.
• Boring infrastructure wins. The world doesn't need another DeFi protocol. It needs the accounting layer underneath — the financial plumbing that makes everything else trustworthy.

Architecture

Attestia is three systems, one truth:

┌─────────────────────────────────────────────────────────┐
│                      ATTESTIA                           │
│                                                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │   Personal   │  │     Org      │  │              │  │
│  │    Vault     │  │   Treasury   │  │   Registrum  │  │
│  │              │  │              │  │              │  │
│  │  Observe.    │  │  Distribute. │  │  Govern.     │  │
│  │  Budget.     │  │  Account.    │  │  Attest.     │  │
│  │  Allocate.   │  │  Reconcile.  │  │  Constrain.  │  │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  │
│         │                 │                 │           │
│         └────────────┬────┘                 │           │
│                      │                      │           │
│              ┌───────┴───────┐              │           │
│              │  Cross-System │◀─────────────┘           │
│              │ Reconciliation│                           │
│              └───────┬───────┘                           │
│                      │                                   │
│              ┌───────┴───────┐                           │
│              │ XRPL Witness  │                           │
│              │  (attestation)│                           │
│              └───────────────┘                           │
└─────────────────────────────────────────────────────────┘

Core Pattern

Every interaction follows one flow:

Intent → Approve → Execute → Verify

1. Intent — A user or system declares a desired outcome
2. Approve — Registrum validates structurally; a human signs explicitly
3. Execute — The on-chain transaction is submitted
4. Verify — Reconciliation confirms; XRPL attests the record

No step is optional. No step is automated away.

Principles

Status

14 packages, 1,853 tests, 96.80% coverage, all green. Building in public.

Development

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
pnpm bench            # Run benchmarks

XRPL Integration Testing

A standalone rippled node runs in Docker for deterministic on-chain integration tests — no testnet dependency, no faucet, sub-second ledger close.

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

Documentation

Security & Data Scope

• Data accessed: Reads and writes financial ledger entries, attestation records, and cryptographic proofs. Connects to blockchain nodes (XRPL) when witness module is active.
• Data NOT accessed: No telemetry. No user credential storage. No third-party analytics.
• Permissions required: Read/write access to local data directories. Network access for blockchain attestation only. See THREAT_MODEL.md for full STRIDE analysis.

Scorecard

License

MIT

Built by MCP Tool Shop