Institutional Financial Distress Dashboard & Real-Time Risk Terminal

SolSignal is a high-fidelity, autonomous risk monitoring platform designed for institutional investors and treasury managers. It bridges the gap between qualitative SEC regulatory filings and real-time on-chain execution, using Gemini 2.5 Flash for deep semantic analysis and the Solana Blockchain for immutable audit trails and automated circuit breakers.

• Real-Time Data Ingestion: Consumes official SEC 10-K and 10-Q filings as they are released in timestamped order.
• Deep Semantic Analysis: Uses LLMs to detect "Language Drift"—subtle changes in risk disclosure that signal impending liquidity events before they become public math.
• 15-Company Baseline: Currently monitoring a diversified baseline of the world's most systemic financial and technology entities.

• Quantitative Scoring (0-100): Every entity is assigned a numeric risk score where >80 represents "Critical Distress."
• AI Confidence Metric: Provides transparency into the model's architectural certainty (0-100%) for every assessment.
• Decision Matrix: Automatically maps scores to institutional decision rules:
  • HOLD: Strong liquidity, routine operational risk.
  • MONITOR: Elevated volatility or minor earnings compression.
  • ALERT: Multi-factor distress (M&A leverage, regulatory pressure).
  • IMMEDIATE_EXIT: Critical de-pegging or insolvency triggers.

• Circuit Breakers: Scores > 90 automatically trigger the assembly and signing of emergency "De-Risk" SPL-token transfer instructions.
• Versioned Transactions (V0): Utilizes modern Solana V0 transaction standards for high-throughput, efficient state management.
• Point-in-Time Proofs: Injects the latest Solana Slot and Blockhash during inference to prove "Sign-Off" at a specific ledger moment.
• Risk State PDAs: Tick-based Program Derived Addresses ([risk_state, TICKER]) serve as on-chain conceptual records of every model adjustment.

• Real-Time Vault View: Dynamic "Blockchain Audit Vault" with live 10-second polling and "Verified Immutable" ledger badges.
• Detail Reasoning Logic: Deterministic execution logs showing exactly why the AI assigned a specific score and action.
• Institutional Aesthetic: Premium "Midnight Navy" and "Slate" dark-mode theme with high-fidelity Fintech icons (Lucide/Shadcn).

├── backend/data/
│   ├── secFilingScraper.py   # Ingests SEC filings and processes assets
│   ├── ai_scorer.py          # Gemini AI risk analysis and consensus trail logic
│   ├── solana_rebalancer.py  # Assembles and broadcasts on-chain circuit breakers
│   ├── ai_signals.json       # The "Golden Record" feeding the live terminal
│   └── backtest_baseline.py  # Z-Score comparison vs. SolSignal performance
├── src/
│   ├── app/                  # Next.js routes (Homepage, Triage Feed, Vault)
│   ├── components/           # High-fidelity dashboard & terminal UI units
│   └── lib/                  # Shared types and Web3 connection utilities
└── README.md

Create a .env file in the root with your API keys and a Solana private key:

SEC_API_KEY=your_key
GEMINI_API_KEY=your_ai_key
SOLANA_PRIVATE_KEY=[your_key_array]

# 1. Scrape the latest filings
python backend/data/secFilingScraper.py

# 2. Run AI Scoring & Solana Circuit Breakers
python backend/data/ai_scorer.py

npm run dev

1. Navigate to the "Real-Time Risk Terminal" (Vault).
2. Tickers with a signature value support the "Verify on Ledger" feature.
3. Clicking verify will perform a real RPC ping to the Solana Devnet to confirm the transaction's immutable status.