Price Oracle

CalixOracle is a Chainlink AggregatorV3Interface-compatible price feed with multi-feeder median aggregation and TWAP support. Any Chainlink-aware protocol works with it out of the box.

Design

Multi-feeder median — multiple approved feeders submit prices each round; the contract computes the median via insertion sort and finalizes when minSubmissions are received.
TWAP — cumulative (price × elapsed time) checkpoints are stored on every finalized round; callers can query a time-weighted average over any historical window.
Circuit breaker — if a submitted price deviates more than maxDeviationPct (default 10%) from the current answer, the breaker trips and submissions are paused until the owner calls resetCircuitBreaker.
Chainlink-compatible — implements latestRoundData() and getRoundData(), so it slots into any protocol that reads a Chainlink feed.

Key Functions

Function	Access	Description
`submitPrice(int256 price)`	feeder	Submit price for the current round
`twap(uint256 window)`	public	Return time-weighted average price over `window` seconds
`latestRoundData()`	public	Chainlink-compatible latest answer + metadata
`getRoundData(uint80 id)`	public	Historical round data by ID
`resetCircuitBreaker()`	owner	Resume submissions after a circuit-breaker trip
`addFeeder(address)`	owner	Approve a new price feeder address

Consuming the Oracle in Solidity

import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol";

AggregatorV3Interface feed = AggregatorV3Interface(oracleAddress);
(, int256 price,,,) = feed.latestRoundData();
// price is scaled by 10 ** feed.decimals()

Querying TWAP

// Get 1-hour TWAP
ICalixOracle oracle = ICalixOracle(oracleAddress);
int256 twapPrice = oracle.twap(3600);

💡

Best practice. Set minSubmissions to at least 3 for production feeds. A single feeder can be compromised or go offline; majority agreement provides meaningful manipulation resistance. Use the circuit breaker threshold as a secondary safety net, not the primary one.

⚠️

Circuit breaker resets. The circuit breaker pauses all new submissions when it trips. Investigate the root cause before calling resetCircuitBreaker() — a compromised feeder should be removed via removeFeeder first.

ℹ️

Oracle contract addresses will be published on Calix Scan at mainnet launch.