For the complete documentation index, see llms.txt. This page is also available as Markdown.

Oracle Integration

Oracle Integration

The Symmio Options Protocol uses verified price feeds to power settlement, liquidation, and real-time solvency checks. The oracle system is built on the Muon Network, which delivers cryptographically verified price data from a distributed validator set.

Muon Network

  • Threshold Signature Scheme (TSS): removes single points of failure.

  • Schnorr signatures: efficient multi-party signature verification.

  • Gateway validation layer: adds an off-chain signature from a trusted gateway.

  • Decentralized validation: multiple validators must agree on a price update.

Oracle Architecture

Component
Purpose

MuonOracle

Main on-chain oracle contract for price delivery

Schnorr Verifier

Performs cryptographic verification of signatures

Gateway Signature

Ensures a second, trusted source signs data

SettlementPriceSig

Encapsulates verified price + metadata for trades

Verification Process

function verifyTSSAndGW(
    bytes32 _data,
    bytes calldata _reqId,
    SchnorrSign calldata _signature,
    bytes calldata _gatewaySignature
) external view;
  1. TSS Verification:

    Uses Schnorr signatures and public key matching to validate data from Muon.

  2. Gateway Signature:

    Validates an additional ECDSA signature from a trusted gateway signer.

  3. Integrity Checks:

    Confirms request freshness, symbol correctness, and data authenticity.

Key Integration Points

1. Trade Settlement

  • Prices are verified during trade execution.

  • Verified price is used to calculate PnL and finalize trades.

2. Liquidation Triggers

  • Collateral prices and unrealized PnL are validated before liquidation.

  • Oracle data ensures fair execution and risk isolation.

3. Real-Time Risk Monitoring

  • Party-level PnL is updated using oracle-verified snapshots.

  • Enables automated flagging of risky accounts.

Role in Liquidation Lifecycle

Phase
Oracle Role

Flagging

Real-time collateral valuation for solvency checks

Execution

Provides final settlement prices and deficit validation

Closure

Supports asset redistribution based on verified values

Oracle Data Flow

Last updated