Skip to main content
KeyStone OS is built around a small set of composable primitives. Understanding these concepts is key to integrating effectively.

The settlement lifecycle

Every settlement follows the same pattern:
  1. Instruct - A platform sends a settlement instruction with parties, legs, and a template
  2. Validate - KeyStone validates the instruction against the template’s requirements
  3. Orchestrate - The engine advances through the template’s state machine, executing actions at each state
  4. Settle - When all conditions are met, the settlement completes atomically
  5. Finalize - Both platforms receive confirmation and the audit trail is sealed

Building blocks

Settlements

The core transaction object that moves through a state machine.

Templates

Reusable workflow definitions that control how settlements behave.

State Machine

How the settlement engine processes states, transitions, and actions.

Parties and Legs

Who is involved and what obligations they have.

Compliance

Dual-layer compliance screening at every settlement.

Cross-Platform

How settlements span multiple platforms.