oracle

module

v1.0.0 Latest Latest Go to latest Published: May 19, 2026 License: BSD-3-Clause

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/luxfi/oracle

Links

Open Source Insights

README ¶

Lux Oracle

License: AGPL-3.0-only

This repository contains the UMA-derived Optimistic Oracle and registry contracts for the Lux prediction market ecosystem.

Why AGPL?

These contracts are derived from UMA Protocol's Optimistic Oracle which is licensed under AGPL-3.0. To comply with the copyleft requirements, this code is maintained in a separate repository and imported as a library by other Lux projects.

Contracts

Prediction Oracle (`contracts/prediction/`)

Oracle.sol - Optimistic Oracle with assert-dispute-settle pattern
IOracle.sol - Oracle interface with callbacks

Registry (`contracts/registry/`)

Finder.sol - Service locator for ecosystem contracts
Store.sol - Fee management and final fees
IdentifierWhitelist.sol - Supported query identifiers

Usage

Add as a git submodule or forge dependency:

forge install luxfi/oracle

Then import:

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

Lux Standard (@luxfi/contracts) - MIT-licensed contracts that use this lib
UMA Protocol - Original source of the Optimistic Oracle design

Directories ¶

Path	Synopsis
cmd
oracled command Package main runs `oracled` — the Lux oracle operator daemon.	Package main runs `oracled` — the Lux oracle operator daemon.
pkg
profile Package profile carries the oracle's signing-profile decision in ONE place.	Package profile carries the oracle's signing-profile decision in ONE place.
zaptransport Package zaptransport wraps github.com/luxfi/zap as the intra-Lux operator transport for oracled.	Package zaptransport wraps github.com/luxfi/zap as the intra-Lux operator transport for oracled.
vm Package oraclevm implements the Oracle Virtual Machine (O-Chain) for the Lux network.	Package oraclevm implements the Oracle Virtual Machine (O-Chain) for the Lux network.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL