How minculusofia-wq/ironvault works
IRONVAULT is a Polymarket trading bot with a PySide6 operator interface. The main workflow is operator controls → orchestration and risk/capital checks → market signals and strategy decisions → order execution and position/PnL tracking, with audit and performance data surfaced to the UI. Strategy A reacts to triggers; Strategy B provides multi-market liquidity and manages exits. The graph reflects the README and shown excerpts plus SOURCE INDEX references; unsampled implementation details and some wiring remain unverified.
Main entry points: orchestrator.py Bot orchestrator · strategy_b_market_making.py Market-making strategy · main_window.py Application window · strategy_a_front_running.py Front-running strategy
Components 25
Operator interface
- Application window
frontend/main_window.py - Dashboard
frontend/dashboard.py - Controls and config
frontend/controls.py - Auto optimizer
frontend/auto_optimizer_tab.py
Bot coordination
- Bot orchestrator
backend/orchestrator.py - Configuration loader
backend/config_loader.py
Market signals
- Front-running strategy
backend/strategies/strategy_a_front_running.py - Market-making strategy
backend/strategies/strategy_b_market_making.py - Polymarket price feed
backend/data_feeds/polymarket_feed.py - Scoreboard monitor
backend/scoreboard_monitor.py - Market scanner
backend/market_scanner.py - Market data
backend/market_data.py - CLOB adapter
backend/clob_adapter.py - WebSocket client
backend/websocket_client.py
Trading and risk
- Execution engine
backend/execution_engine.py - Capital manager
backend/capital_manager.py - Policy layer
backend/policy_layer.py - Volatility filter
backend/volatility_filter.py - Kill switch
backend/kill_switch.py - Secure vault
backend/secure_vault.py
Audit and metrics
- Audit logger
backend/audit_logger.py - Performance tracker
backend/performance_tracker.py - Analytics engine
backend/analytics_engine.py
Other components
- Operator
- Polymarket
Connections 35
- Operator → Application window: operates
- Application window → Bot orchestrator: controls bot
frontend/main_window.py - Application window → Dashboard: displays
frontend/main_window.py - Application window → Controls and config: hosts controls
frontend/main_window.py - Application window → Auto optimizer: hosts optimizer
frontend/main_window.py - Bot orchestrator → Configuration loader: loads config
backend/orchestrator.py - Bot orchestrator → Front-running strategy: dispatches ticks
backend/orchestrator.py - Bot orchestrator → Market-making strategy: dispatches ticks
backend/orchestrator.py - Bot orchestrator → Execution engine: manages execution
backend/orchestrator.py - Bot orchestrator → Capital manager: allocates capital
backend/orchestrator.py - Bot orchestrator → Policy layer: checks policy
backend/orchestrator.py - Bot orchestrator → Kill switch: manages safety
backend/orchestrator.py - Bot orchestrator → Scoreboard monitor: coordinates monitor
backend/orchestrator.py - Bot orchestrator → WebSocket client: manages connection
backend/orchestrator.py - Bot orchestrator → Performance tracker: records trades
backend/orchestrator.py - Bot orchestrator → Audit logger: logs events
backend/orchestrator.py - Front-running strategy → Execution engine: submits orders
backend/strategies/strategy_a_front_running.py - Front-running strategy → CLOB adapter: fetches books
backend/strategies/strategy_a_front_running.py - Front-running strategy → Scoreboard monitor: uses triggers
backend/strategies/strategy_a_front_running.py - Front-running strategy → Volatility filter: checks volatility
backend/strategies/strategy_a_front_running.py - Market-making strategy → Execution engine: submits orders
backend/strategies/strategy_b_market_making.py - Market-making strategy → WebSocket client: receives updates
backend/strategies/strategy_b_market_making.py - Market-making strategy → Volatility filter: checks volatility
backend/strategies/strategy_b_market_making.py - Market-making strategy → Market data: uses market data
backend/strategies/strategy_b_market_making.py - Market-making strategy → Performance tracker: tracks positions
backend/strategies/strategy_b_market_making.py - Polymarket price feed → CLOB adapter: fetches books
backend/data_feeds/polymarket_feed.py - Polymarket price feed → Market scanner: gets markets
backend/data_feeds/polymarket_feed.py - Market scanner → Market data: reads market data
backend/market_scanner.py - Market scanner → CLOB adapter: fetches books
backend/market_scanner.py - Execution engine → Audit logger: logs trades
backend/execution_engine.py - CLOB adapter → Polymarket: requests book data
backend/clob_adapter.py - WebSocket client → Polymarket: connects stream
backend/websocket_client.py - Analytics engine → Audit logger: reads audit data
backend/analytics_engine.py - Bot orchestrator → Analytics engine: updates metrics
backend/orchestrator.py - Bot orchestrator → Secure vault: handles credentials