Architecture

Deterministic financial architecture.

Modern financial systems fail not because of missing features — but because of undefined states.

Orangepill is built on one principle: every financial action must resolve deterministically. No partial settlement. No orphan fulfillment. No balance drift.

Core Principle

Every financial action must resolve deterministically.

No partial settlement. No ambiguous lifecycle.

Core Model

Intent → Authorization → Settlement → Fulfillment → Ledger

This lifecycle is atomic. When an order settles, a journal is written, balances update, references are constrained, fulfillment executes, and invariants remain intact.

  • Every step is ledger-aligned
  • If any step fails, the transaction rolls back
  • Deterministic execution replaces eventual consistency

Ledger Authority

Ledger as ground truth.

The ledger is not a reporting layer. It is the authority — double-entry enforced, referential integrity protected, and reconciliation invariants continuously verifiable.

Wallet Primitive

Wallets are core objects.

Wallet logic lives inside settlement boundaries: reservations, capture/refund semantics, hybrid wallet and external flows, merchant accounts, and multi‑currency support.

Orchestration

Multi-rail execution through a controlled runtime.

Multi‑Rail Routing

Deterministic, merchant-aware, idempotent routing across payins, payouts, and wallets.

Flow Runtime Engine

Strict invariants, retry-safe boundaries, failure matrices, and deadlock-safe wrappers.

Crash Safety

Atomic, isolation-safe, replay-safe transactions. Rollback is verified and enforced.

Agent‑Ready

Autonomous systems can execute safely.

Financial primitives are exposed through deterministic boundaries. Agents can initiate payins, trigger payouts, create orders, query balances, and execute workflows without violating integrity.

Architecture Diagram

External Rails Flow Runtime Wallets + Payments Ledger Authority Settlement & Fulfillment

One ledger. One lifecycle authority.

Read about Agentic Finance and MCP.