DeepBook Predict: Oracle SVI State Machine

An OracleSVI object manages the market state for one underlying asset at a specific expiry. It houses spot and forward prices, SVI (Stochastic Volatility Inspired) volatility surface configurations, and the final frozen settlement value.

1. Oracle Lifecycle States

An oracle transitions sequentially through four lifecycle states:

stateDiagram-v2
    [*] --> Inactive : Created
    Inactive --> Active : activate()
    Active --> Pending_Settlement : Clock reaches Expiry
    Pending_Settlement --> Settled : First post-expiry update_prices() freezes settlement
    Settled --> [*]