Documentation

Sovereign Wallet OS

Everything you need to run the framework, integrate the SDK, and understand the constitutional execution model.

Getting started

Install, seed, and run all demo flows locally.

The proposal-only developer client. No signing surface.

HTTP endpoints for intents, provenance, trading, and accounting.

Security invariants and the no-signing guarantee.

The first agent client — SDK-only, constitutionally bounded.

System diagram, packages, and domain model.

EconomicIntent — The typed request surface that agents use. No direct signing access.
Constitution — Per-wallet policy that governs budget, merchants, risk, and authority.
DecisionPacket — Scoped, signed, expiring authorization from the runtime.
Execution Adapter — The layer that translates approved packets into protocol actions.
Provenance — The artifact graph connecting data to the decision that funded it.

The SDK has no signTransaction, sendTransaction, or rawCall.
Live trading is denied by default. Paper trading requires a passing risk check.
Snapshot mode works without Docker. Postgres mode for durable validation.
Every settled action generates an audit event, journal entry, and provenance record.