OMENA Technical Documentation v0.2

Chapter 3: Architecture

Phase 1 is designed as a minimal dashboard product, not a trading interface.

User flow:

1. User opens /app
2. User pastes a Solana token address
3. OMENA validates the address
4. OMENA fetches market data from DexScreener
5. OMENA runs Risk, Behavior, Signal, and Context modules
6. OMENA returns a readable report in /app/analyze

Current runtime layers:

Layer 1 - Web App

• Next.js App Router frontend
• Landing page
• Dashboard routes
• Docs pages

Layer 2 - Data and Analysis

• DexScreener market snapshot
• Optional Helius enrichment
• Modular intelligence functions
• Mock fallback when live data is incomplete

Chapter 4: Risk Intelligence

Core Capabilities

• Liquidity quality scoring
• Pair age and market depth checks
• Volume versus liquidity stress checks
• Plain-language risk summary

Output

{
  "level": "Low | Medium | High",
  "score": 0,
  "summary": "Readable explanation",
  "flags": [],
  "liquidityHealth": "string",
  "holderConcentration": "string"
}

Chapter 5: Behavior Intelligence

Core Capabilities

• Buy versus sell activity interpretation
• Accumulation versus distribution status
• Deployer visibility note
• Graceful partial-data handling

Chapter 6: Signal Intelligence

Core Capabilities

• 24h price movement review
• Volume abnormality checks
• Transaction flow shifts
• Severity classification: Normal, Watch, Alert

Chapter 7: Context Intelligence

Core Capabilities

• Merge module outputs into one report
• Keep language readable and non-hype
• Produce final verdict and caution level
• Make report easy to copy or share

Chapter 8: API Overview

Analyze Token

POST /api/analyze-token

Request body:

{
  "tokenAddress": "SOLANA_TOKEN_ADDRESS",
  "mode": "auto"
}

Response shape:

{
  "status": "ok | insufficient_data | error",
  "token": {},
  "risk": {},
  "behavior": {},
  "signals": {},
  "context": {},
  "meta": {
    "dataSource": "mock | live | mixed",
    "generatedAt": "ISO timestamp",
    "insufficientDataReasons": []
  }
}

Chapter 9: FAQ

What makes OMENA different?

OMENA focuses on intelligence output, not trading execution.

Does OMENA execute transactions?

No. OMENA is an intelligence layer only.

Does Phase 1 require API keys?

No. The dashboard works with mock fallback when live coverage is incomplete.

Which live data source is active first?

DexScreener is the first live source in Phase 1.

Chapter 10: Roadmap

1. UI shell and reusable module cards
2. Mock-backed report flow
3. DexScreener live market integration
4. Helius enrichment for behavior and signal depth
5. Stronger saved analysis and sharing workflows