Lux Oracle

Lux Oracle (github.com/luxfi/oracle) provides an optimistic oracle system for the Lux ecosystem. Contracts assert truths about the world, and disputes are resolved through an escalation game backed by bonded stakes.

Architecture

Asserter ──► Oracle.assertTruth(claim, bond)
                    │
                    ▼
             ┌─────────────┐
             │  Liveness    │  (challenge period)
             │  Window      │
             └──────┬──────┘
                    │
          ┌─────────┼──────────┐
          ▼                    ▼
   No Dispute              Disputed
   settleAssertion()       disputeAssertion()
   Bond returned           ──► Escalation Manager / DVM
                               resolves truth

Contracts

Key Concepts

• Assertion -- a bonded claim about the world (e.g. "ETH price is above 3000 at timestamp T")
• Liveness period -- time window during which anyone can dispute the assertion
• Bond -- ERC-20 collateral locked by the asserter and returned on truthful settlement
• Escalation Manager -- optional contract that controls dispute policy and arbitration

Installation

forge install luxfi/oracle

import "@luxfi/oracle/prediction/Oracle.sol";
import "@luxfi/oracle/registry/Finder.sol";

License

AGPL-3.0-only (derived from UMA Protocol Optimistic Oracle).