Architecture Overview

b1e55ed is an event-sourced signal engine. Producers emit events. The brain reads events and emits events. Execution reads events and emits events.

High-level diagram

Producers (internal + registered) ──────────────────────┐
                                                         │
Curator Pipeline (operator intel → structured signals) ──┤
                                                         ▼
                                               Interpreter Stack
                                              (7 layers per producer)
                                                         │
                                                   FORECAST_V1
                                                         │
                                                   Event Store
                                                  (SQLite + hash chain)
                                                         │
                                           ┌─────────────┼──────────────┐
                                           ▼             ▼              ▼
                                         Brain       Backtest       Oracle
                                    (synthesis +   (walk-forward, (provenance
                                     hierarchy,     gridsweep,    projection,
                                     learning,      megasweep)    no auth)
                                     regime)
                                           │
                                    Kill Switch
                                           │
                                       Execution
                                    (paper/live, Kelly)
                                           │
                              ┌────────────┼────────────────┐
                              ▼            ▼                ▼
                             CLI          REST           Dashboard
                        (authoritative)  (/api/v1/*)    (read-only)
                                         │
                                         ├────── MCP server
                                         ├────── SSE stream
                                         └────── Oracle endpoint (public)

Interpreter Stack (P3/P4 Intelligence Layer)

Every producer’s raw output passes through a layered interpreter chain before becoming a FORECAST_V1 event:

BaseProducer.collect() + normalize()
        ↓
  Interpreter.interpret()              ← rule-based signal → forecast
        ↓
  LLMCriticInterpreter                ← LLM shadow critique (P3.1)
        ↓
  RegimeMatrix conditioning            ← regime-aware confidence scaling (P3.2)
        ↓
  SelfMemoryInterpreter               ← Brier-based confidence ± delta (P3.4)
        ↓
  ProsecutorInterpreter               ← adversarial counter-case (P3.5)
        ↓
  NoveltyInterpreter                  ← cross-producer awareness (P4.3)
        ↓
  FORECAST_V1 event → Event Store

All LLM and adaptive layers default to shadow mode: they observe and log without mutating the forecast. The hierarchy engine (P4.1) adjusts domain weights in brain synthesis based on rolling Brier scores. The meta-producer (P4.4) learns from resolved outcomes and emits ensemble pattern forecasts after 500+ outcomes accumulate. For full details, see producer-intelligence.md.

Contributor layer

Registry

Stored in the local database.
node_id is the stable external identity; contributor_id is the internal primary key.
Signals can be attributed to contributors through POST /api/v1/signals/submit.

Scoring

Contributor scoring is computed from event outcomes and attribution tables. Reference modules:

engine/core/contributors.py
engine/core/scoring.py

Flywheel: Signal → Attribution → Karma → Weight

The flywheel is the closed loop that makes b1e55ed compound:

Producer signal → Synthesis → Trade → Position close
       ↑                                      ↓
       │                              attribute_outcome()
       │                                      ↓
       └─── weight update ← producer_karma table

Attribution layer (S1): When synthesis consumes a domain signal into a conviction, a SIGNAL_ACCEPTED_V1 event is emitted linking the signal to the trade. Karma wiring (S2): When a position closes, attribute_outcome() traces the trade back to contributing producers and updates the producer_karma table via EMA (α = 0.05). Kill switches (S5): 5 conditions gated: consecutive losses (3), single loss >2%, open risk >5%, data feed degradation, fill divergence >0.5%. Cockpit (S6): /cockpit dashboard — 4-quadrant “what do I trade today” view with HTMX 30s refresh. Stratification (S7): StratificationTracker tags signals by confidence band (high ≥ 0.65, low < 0.45) and tracks whether high-confidence signals outperform after fees.

New database tables

Table	Purpose
`producer_karma`	Per-producer karma scores (EMA-updated on each trade close)
`signal_stratification`	Confidence band tagging and outcome tracking
`discretionary_signals`	Human operator override signals
`system_state`	Kill switch state, cockpit state

Curator Pipeline

Operator intel enters the system through the curator pipeline.

CLI: b1e55ed signal "<text>" [--symbols] [--direction] [--conviction]
API: POST /api/v1/signals/submit
Signals are attributed to contributors via node_id
Weight in synthesis: weights.curator (default 0.25)

See: curator.md.

Backtest Engine

The backtest engine reads from the event store and validates strategies against historical data.

Walk-forward validation with FDR correction
Regime-conditioned results (EARLY_BULL, LATE_BULL, BEAR, SIDEWAYS)
Dynamic Kelly sizing: b1e55ed kelly

See: backtest.md.

Agent Interfaces

Three interfaces for AI agents:

Interface	Endpoint	Auth
SSE stream	`GET /api/v1/events/stream`	Required
MCP server	`POST /api/v1/mcp`	Required
Oracle	`GET /api/v1/oracle/producers/{id}/provenance`	None

See: agent-interfaces.md.

Oracle

The oracle is a read-only projection layer over the event store. It answers whether a signal producer has verifiable history. No authentication required. See: oracle.md.

The Forge

The Forge derives an Ethereum identity with a 0xb1e55ed prefix.

Used as the preferred identity for on-chain or off-chain attestations.
Separate from the local Ed25519 node identity used by the security layer.

Reference module:

engine/integrations/forge.py

EAS integration

EAS attestations are optional. Attestation flow (off-chain mode):

Contributor registration
  → (optional) create off-chain EAS attestation
  → store attestation + UID in contributor.metadata.eas
  → verify locally via `b1e55ed eas verify --uid <uid>`

Reference module:

engine/integrations/eas.py

See: eas-integration.md.

Webhook dispatch

Webhook subscriptions are stored in the local database and matched against event types using glob patterns.

Delivery is best-effort.
Dispatch is non-blocking relative to event persistence.
Management is CLI-first (b1e55ed webhooks ...).

Reference module:

engine/core/webhooks.py

Producer registration

Producers exist in two forms:

Built-in producers (discovered at runtime).
Dynamic producer registrations stored in the database and visible to the API/CLI.

Reference modules:

api/routes/producers.py
engine/cli.py (producers subcommands)

Interface surface

REST API: api/main.py mounts the router at /api/v1.
CLI: engine/cli.py is the authoritative command surface.
MCP server: POST /api/v1/mcp (JSON-RPC 2.0).
SSE stream: GET /api/v1/events/stream.
Oracle: GET /api/v1/oracle/producers/{id}/provenance (no auth).

See: api/overview.mdx. For the full flywheel spec (attribution algorithm, kill switch conditions, Phase 0 success metric), see internal/FLYWHEEL_SPEC.md.

Getting Started

Setup

Producers

Operations

Features

Integrations

API Reference

Contributing

Reference

Architecture

Architecture Overview

High-level diagram

Interpreter Stack (P3/P4 Intelligence Layer)

Contributor layer

Registry

Scoring

Flywheel: Signal → Attribution → Karma → Weight

New database tables

Curator Pipeline

Backtest Engine

Agent Interfaces

Oracle

The Forge

EAS integration

Webhook dispatch

Producer registration

Interface surface

​Architecture Overview

​High-level diagram

​Interpreter Stack (P3/P4 Intelligence Layer)

​Contributor layer

​Registry

​Scoring

​Flywheel: Signal → Attribution → Karma → Weight

​New database tables

​Curator Pipeline

​Backtest Engine

​Agent Interfaces

​Oracle

​The Forge

​EAS integration

​Webhook dispatch

​Producer registration

​Interface surface

Architecture Overview

High-level diagram

Interpreter Stack (P3/P4 Intelligence Layer)

Contributor layer

Registry

Scoring

Flywheel: Signal → Attribution → Karma → Weight

New database tables

Curator Pipeline

Backtest Engine

Agent Interfaces

Oracle

The Forge

EAS integration

Webhook dispatch

Producer registration

Interface surface