READ IT, THEN RUN IT.

01 · Quickstart

OVREN is dormant capital intelligence on Solana. This release is a complete SYNTHETIC research session, with no RPC, browser wallet or signing.

# download and unzip this release
cd ovren
npm link
ovren doctor
npm start

Download the OVREN release source. Node 20+; no application dependencies. Open http://127.0.0.1:4938/terminal.html. The archive includes the browser terminal, CLI, fixtures, rules and tests.

Sixty seconds

ovren rules
ovren sleepers
ovren wake --cast-only
ovren flow
ovren record night_porter --format md

Use the same short commands without the prefix in the browser terminal. Browser and CLI import the same evaluator; their sessions are separate. Export an OVREN record to preserve either trace.

02 · Terminal

LIVE OBSERVATION is a running synthetic event stream, not a live-chain claim. The stream, wall inspector and flow desk retain the full decision context. Click a row to inspect it, a handle to read the wallet, or a token to follow its contributing actions. Every number and address in this release is fabricated demonstration data.

Keys

Enter runs a command. ↑ ↓ recalls command history while typing. Space starts or pauses the stream when focus is outside a control. Tab / Enter reaches and activates interactive rows. The mark is a visual detail, not a connection indicator.

Session

Select SESSION #... or run session to inspect UPTIME, TRACKED, SLEEPING, WAKES, CASTS, REFUSED and FLOW. A new seed varies wallet context, pool liquidity and coherent flow. Initial evidence includes each refusal; START continues with timestamped WAKE, wall, decision, FLOW and TRACE events. The session is retained across page navigation and reload in the same tab.

START runs one owned event loop. Repeated starts keep the same session. STOP pauses generation and pending evaluation; START resumes it. CLEAR resets current session evidence and counters, retaining ROOST and provider configuration. START after CLEAR begins a fresh wake. Export evidence before CLEAR or session new. Hidden tabs suspend evaluation; uptime and the 60-minute flow window still advance.

Modes

03 · Strategy

The wake

ACTIVE → SILENT → DORMANT → WAKE. A WAKE is meaningful on-chain activity returning after measured silence. This release simulates that Solana behavior. A WAKE enters five decision walls. CAST is the acceptance result; REFUSED names the first blocked wall. Neither is a price prediction.

The five decision walls

One wake. Five walls. One refusal.

Each wall returns PASS, REFUSED or UNKNOWN. The first REFUSED or UNKNOWN blocks the observation. Later walls display NOT EVALUATED and emit no wall events. SLEEP reports NOT REQUIRED for an INFLOW. Wallet DNA is behavioral context: past actions, token activity and consistency. Current scores are synthetic, not AI predictions.

Unknown is not zero

Missing timestamps, metrics or liquidity remain null. A missing or non-positive liquidity value cannot produce an impact estimate. The simulator’s zero-liquidity endpoint means unavailable liquidity; DEPTH returns UNKNOWN. It never quietly becomes 0%.

Where did dormant capital go?

Only a wallet with an accepted WAKE in this session enters the observed flow cohort. Subsequent actions must pass their applicable walls. Reductions cannot exceed the previously observed position. Refused actions remain in the OVREN record but never add flow.

Net flow is the sum of accepted signed USD movements within the last 60 minutes. At least two distinct wallets are required to rank. Average ticket is the mean absolute USD movement; trend is cumulative net movement. Negative flow means capital leaving. Each contribution links accepted WAKE → wallet → swap → token mint → pool → capital direction. Future depth inputs must come from Solana DEX liquidity sources. Fixture valuations use 1 SOL = $155, not a live exchange rate.

Try the wall simulator.

04 · Commands

Browser terminal

The on-screen terminal accepts the same command words without ovren, plus trigger HANDLE to simulate a wake, check HANDLE to open its dossier, export HANDLE json|md to download, trace ID|HANDLE to open linked evidence, and start / stop / clear to control the session. It also accepts an optional ovren prefix.

ROOST · monitored sleepers

ovren roost add night_porter
ovren roost
ovren record night_porter --format json
ovren roost remove night_porter

ROOST is a device-local watchlist, capped at 40 wallets. Add a known handle or valid Solana public address, search, filter, watch, stop watching or remove. All activity is simulated, including added addresses. WAKE → EVALUATING → CAST / REFUSED comes from the same engine as the stream. Stopping watch suppresses ROOST tagging; removing a watch preserves existing evidence. No live-chain history or cloud monitoring is claimed.

Local state

The browser uses sessionStorage for the active session and localStorage for ROOST. The CLI uses .ovren-solana-synthetic/session.json and roost.json; OVREN_DEMO_DIR overrides that directory. PORT changes the local preview server port. The Solana storage namespace isolates older sessions; incompatible snapshots are not reinterpreted as SOL. No credentials are required.

05 · The OVREN Record

THE TRACE REMAINS. Each wake creates an observation Record with its own ID, wallet, measured dormancy, ordered walls, decision, flow and timestamped trace. A wallet Record aggregates these observations without changing their evidence. CAST and REFUSED are observation decisions, not trade recommendations.

ovren record night_porter
ovren record night_porter --format json
ovren record night_porter --format md

Use record ID for a specific wake or record HANDLE for its wallet history. VIEW TRACE links wallet, dormancy, each evaluated wall, decision, flow and Record. JSON, Markdown and COPY RECORD use the same complete record object. JSON preserves null values. The homepage previews wake, wall and flow history; exported trails are not truncated. Prior real-world history remains explicitly unknown.

Schema: recordType (ovren.record.v1), synthetic, session, coverage, wallet, dormancyDays, priorHistory, observed, flow, trail. Each decision includes the five ordered walls and first refusal, when present. Flow entries link to an action and its qualifying wake. Additive network, dataMode, provider and units metadata identify Solana / SOL / USD. Candidate action fields preserve wallet, tokenMint, poolAddress, direction, observedAt and source; signature is null for synthetic events.

UNKNOWN ≠ 0. NULL ≠ 0. SYNTHETIC ≠ LIVE. REFUSED ≠ FAILED DATA. NEGATIVE FLOW ≠ MISSING DATA.

Inspect and export an OVREN record.

06 · Architecture

The release archive contains the browser terminal, five-wall evaluator, synthetic session engine, fixtures and CLI. Both interfaces use the same rules and data model. The evaluator is provider-agnostic. SyntheticProvider owns deterministic fixture variation and proposals. SolanaProvider accepts an adapter for the same normalized inputs; the shipped application uses SyntheticProvider and makes no RPC requests.

dist/js/walls.js       ordered, pure decision rules
dist/js/engine.js      staged walls, session, trace, flow
dist/js/providers.js  initialize / next / normalizeActivity
dist/js/observation.js unified observation schema
dist/js/runtime.js    one cancellable evaluation loop
dist/data/seed.json    synthetic wallets, mints, pools
scripts/ovren.mjs      Node CLI using the same modules

State structures

• Wallet pool: last observed activity and historical context. Null timestamps remain unknown.
• Evidence trail: immutable candidate snapshots, sequential IDs, decisions and linked FLOW / TRACE updates.
• Flow ledger: accepted-wake cohort, signed movements, observed positions and a rolling 60-minute window.

Same rules. Same walls. Same data model.

Provider → normalizer → Observation → ordered evaluation → decision → flow → Record / Trace. beginActivity stores a wake; advanceEvaluation commits one step. CLI activity drains the same state machine synchronously. Identical candidates and timestamps produce identical decisions in browser and CLI. Their sessions and storage remain separate. Download the matching OVREN release source to inspect and run the implementation locally.

Observation coverage

CURRENT: the complete synthetic observation lifecycle, interactive ROOST, linked Trace, per-wake Record and shared CLI. A future Solana adapter must supply covered wallet history, parsed activity, token/pool identities, liquidity, timestamps and valuations through the same schema. Only a configured real adapter uses SOLANA LIVE. Missing facts remain unknown. No RPC is connected in this release.

07 · Safety

Read-only observations

• No wallet connection, transaction signing or automatic trading.
• No private keys or seed phrases are requested.
• No price predictions or token safety ratings.
• Every fixture, event and export is explicitly synthetic.

What a verdict means

A wake is a behavioral change, not an endorsement. CAST records that specific conditions held in an observation. REFUSED records the first condition that did not qualify. Neither predicts a profitable outcome.

Unknown fields stay unknown. Synthetic historical values are fabricated context; they are not verified performance. An export only covers its documented synthetic session.

Keep the trace

Export before clearing browser storage, closing a session or starting session new. Roost is local to this device. If storage is unavailable or full, the current in-memory record remains readable, but it must be exported before leaving.