OFFICIAL DEVELOPER MANUAL

SairaOS System Documentation

Comprehensive technical manual for operators, quants, and engineers interacting with the SairaOS executive trading engine, autonomous swarm nodes, and macro-economic state machine.

1.1 Core Architecture Overview

SairaOS is structured around a real-time reactive state loop that integrates simulated geopolitical shocks, high-frequency stock volatility, automated memecoin minting, and continuous physical cashflow streams into a centralized executive dashboard.

State Engine

Reactive memory store maintaining sovereign cash, systemic corruption, social inequality, and popularity.

Tick Dispatcher

Generates 1-second interval ticks simulating passive yield generation and order book price movement.

Synthesizer Core

Real-time Web Audio API procedural sound engine generating 8-bit retro feedback for every market action.

1.2 Game State Data Model

The sovereign state is represented by a single immutable reactive state schema in index.js:

let gameState = {
  cash: 50000000,        // Starting Liquid Reserve ($50,000,000 USD)
  corruption: 15,        // Systemic Corruption Index (0 - 100%)
  inequality: 20,        // Gini Wealth Inequality Meter (0 - 100%)
  popularity: 45,        // Public Approval Rating (0 - 100%)
  alliesGained: 0,      // Count of foreign diplomatic allegiances
  alliesLost: 0,        // Count of diplomatic embargoes
  historyData: [],       // Historical time-series of total portfolio Net Worth
  isMarketOpen: true,    // Session boolean flag
  marketTimer: 60,       // 60-second market trading window
  activeTab: 'trading',  // Current active viewport: trading, empire, crypto, laws, geopolitics
  activeCall: null,      // Current pending executive hotline negotiation
  memecoins: []          // Registered active synthetic memecoin tokens
};
        

1.3 Financial Metrics & Net Worth Calculation

Net Worth is dynamically computed across three distinct balance-sheet tiers:

function calculateMetrics() {
  let stockVal = stocks.reduce((acc, s) => acc + (s.owned * s.price), 0);
  let empireVal = empireAssets.reduce((acc, a) => acc + a.value, 0);
  let cashflow = empireAssets.reduce((acc, a) => acc + a.revenue, 0);

  const totalNW = gameState.cash + stockVal + empireVal;
  return { totalNW, stockVal, empireVal, cashflow };
}
        

2.1 Stock Equities Schema & Volatility Profile

Six primary speculative equities are simulated on the order book:

ID	Ticker	Corporate Name	Base Price	Vol (σ)	Sensitivity Focus
slaughter	$WAR	General Slaughter Defense	$270	0.06	Military contracts, geopolitical war threats
oil	$DRILL	Exxon-Valdez-Again	$98	0.04	Sanctuary drilling, environmental deregulation
xcrement	$XCRM	X-crement Social	$45	0.11	App store competitor bans (+45%), bot swarms
glaze	$GLZ	GlazeAI Silicon	$510	0.09	GPU fab subsidies (+50%), compute monopoly
pear	$PEAR	Pear Computer	$180	0.04	Hardware consumer monopoly, supply chain tariffs
rockets	$RKT	SpaceRockets AI	$220	0.08	Orbital permits, CEO hotline favors (+35%)

3.1 Empire Assets & Passive Cashflow

Empire holdings generate perpetual liquid cash flow per second without risking capital on exchange volatility:

Mar-a-Resort & Club

Yield: +$350,000/s

Valuation: $40,000,000

Presidential Tower NY

Yield: +$500,000/s

Valuation: $65,000,000

Patriot Social Network

Yield: +$200,000/s

Valuation: $25,000,000

4.1 Memecoin Grift Studio Mechanics

Operators can deploy synthetic meme tokens or launch speculative AI casinos with one click:

// Launching AI Crypto Casino venture
function foundVenture(type) {
  if (type === 'casino') {
    if (gameState.cash < 10000000) return alert('Insufficient funds ($10M required)');
    gameState.cash -= 10000000;
    gameState.corruption += 10;
    gameState.inequality += 8;
    // Adds perpetual high-yield revenue stream (+ $450,000/s)
  }
}
        

5.1 Sovereign Decrees & Multipliers

Decrees directly modify equity prices by applying instant step multipliers:

const lawsData = [
  {
    id: 'ban_app',
    name: 'Ban Foreign Competitor App',
    cost: 15000000,
    corr: +8, ineq: +5, pop: -5,
    impacts: [
      { id: 'xcrement', mult: 1.45 }, // +45% spike
      { id: 'pear', mult: 0.82 }      // -18% drop
    ]
  },
  {
    id: 'defense_mandate',
    name: 'Defense Sector Mandatory Contracts',
    cost: 25000000,
    corr: +14, ineq: +10, pop: -2,
    impacts: [{ id: 'slaughter', mult: 1.50 }] // +50% spike
  }
];
        

6.1 Geopolitical Regimes & Foreign Sanctions

Foreign nation states interact with sovereign trade diplomacy:

Europia Union

Type: Democracy | Nukes: No

Power: 65 | Stance: Neutral

Eastern Bear Empire

Type: Oligarchy | Nukes: YES

Power: 90 | Stance: Hostile

Petro Sultanate

Type: Dictatorship | Nukes: No

Power: 55 | Stance: Friendly

7.1 Web Audio Synthesizer & Themes

All UI interactions produce procedural audio tones via the browser native AudioContext without external audio asset downloads.

playBuySFX()

playSellSFX()

playRingSFX()

playGavelSFX()