Enum FeedSource 

#[non_exhaustive]
pub enum FeedSource {
    Chainlink,
    AavePriceCapStable {
        source: Address,
        underlying_proxy: Address,
        price_cap: I256,
    },
    AaveRatioCap {
        source: Address,
        base_to_usd_proxy: Address,
        ratio_provider: Address,
        current_ratio: I256,
        max_ratio: I256,
        ratio_decimals: u8,
    },
    AaveSynchronicityPegToBase {
        source: Address,
        asset_to_peg_proxy: Address,
        asset_to_peg_aggregator: Address,
        asset_to_peg_answer: I256,
        asset_to_peg_decimals: u8,
        peg_to_base_proxy: Address,
        peg_to_base_aggregator: Address,
        peg_to_base_answer: I256,
        peg_to_base_decimals: u8,
        output_decimals: u8,
    },
    AaveFixedPrice {
        source: Address,
        price: I256,
    },
    MorphoChainlinkV2 {
        source: Address,
        base_vault_assets: I256,
        quote_vault_assets: I256,
        scale_factor: I256,
        feeds: Vec<MorphoChainlinkFeed>,
    },
    EulerQuote {
        source: Address,
        base: Address,
        quote: Address,
        base_decimals: u8,
        quote_decimals: u8,
        leg: EulerQuoteLeg,
    },
    EulerCross {
        source: Address,
        base: Address,
        cross: Address,
        quote: Address,
        base_decimals: u8,
        cross_decimals: u8,
        quote_decimals: u8,
        base_cross: EulerQuoteLeg,
        cross_quote: EulerQuoteLeg,
    },
    Pyth {
        pyth: Address,
        price_id: B256,
        expo: i32,
        conf: u64,
    },
    RedstonePush {
        price_feed: Address,
        adapter: Address,
        data_feed_id: B256,
    },
    Custom(OracleSourceDescriptor),
}

Network source and transform for a registered feed.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Chainlink

Plain Chainlink-compatible proxy with identity answer transform.

AavePriceCapStable

Aave PriceCapAdapterStable source backed by an underlying Chainlink proxy.

Fields

source: Address

User-facing Aave source adapter.

underlying_proxy: Address

Underlying Chainlink proxy read for rounds and aggregator discovery.

price_cap: I256

Maximum answer exposed by the Aave adapter.

AaveRatioCap

Aave ratio-cap/CAPO source backed by a base-to-USD Chainlink proxy.

Fields

source: Address

User-facing Aave source adapter.

base_to_usd_proxy: Address

Underlying base-to-USD Chainlink proxy.

ratio_provider: Address

Ratio provider used by the Aave source.

current_ratio: I256

Current source ratio.

max_ratio: I256

Maximum ratio exposed by the Aave source.

ratio_decimals: u8

Decimals used by the ratio values.

AaveSynchronicityPegToBase

Aave Chainlink synchronicity adapter composing asset-to-peg and peg-to-base feeds.

Fields

source: Address

User-facing Aave source adapter.

asset_to_peg_proxy: Address

Asset-to-peg Chainlink proxy.

asset_to_peg_aggregator: Address

Asset-to-peg current aggregator.

asset_to_peg_answer: I256

Seeded asset-to-peg answer used when the other dependency updates.

asset_to_peg_decimals: u8

Asset-to-peg decimals.

peg_to_base_proxy: Address

Peg-to-base Chainlink proxy.

peg_to_base_aggregator: Address

Peg-to-base current aggregator.

peg_to_base_answer: I256

Seeded peg-to-base answer used when the other dependency updates.

peg_to_base_decimals: u8

Peg-to-base decimals.

output_decimals: u8

Decimals for the user-facing composed answer.

AaveFixedPrice

Aave fixed-price source with no Chainlink dependency.

Fields

source: Address

User-facing Aave source adapter.

price: I256

Fixed user-facing answer.

MorphoChainlinkV2

Morpho Blue MorphoChainlinkOracleV2 source composed from Chainlink feeds and optional vault conversions.

Fields

source: Address

User-facing Morpho oracle.

base_vault_assets: I256

Latest base-vault conversion factor, or 1 when no base vault is configured.

quote_vault_assets: I256

Latest quote-vault conversion factor, or 1 when no quote vault is configured.

scale_factor: I256

Immutable Morpho scale factor.

feeds: Vec<MorphoChainlinkFeed>

Non-zero Chainlink feed dependencies.

EulerQuote

Euler quote source backed by a single leg.

Fields

source: Address

User-facing Euler oracle adapter or router.

base: Address

Base asset for the quote.

quote: Address

Quote asset for the quote.

base_decimals: u8

Base token decimals.

quote_decimals: u8

Quote token decimals.

leg: EulerQuoteLeg

Quote leg.

EulerCross

Euler CrossAdapter quote source backed by two quote legs.

Fields

source: Address

User-facing Euler cross adapter.

base: Address

Base asset for the final quote.

cross: Address

Intermediate asset.

quote: Address

Quote asset for the final quote.

base_decimals: u8

Base token decimals.

cross_decimals: u8

Intermediate token decimals.

quote_decimals: u8

Quote token decimals.

base_cross: EulerQuoteLeg

Base-to-cross leg.

cross_quote: EulerQuoteLeg

Cross-to-quote leg.

Pyth

Pyth EVM price feed keyed by a shared Pyth contract and per-feed price id.

Fields

pyth: Address

Shared Pyth contract that emits updates and serves reads.

price_id: B256

Pyth price feed id.

expo: i32

Pyth fixed-point exponent.

conf: u64

Most recent Pyth confidence interval.

RedstonePush

Available on crate feature redstone only.

RedStone push price feed backed by an on-chain adapter/event source.

Fields

price_feed: Address

User-facing RedStone price feed wrapper.

adapter: Address

RedStone adapter or merged price-feed event source.

data_feed_id: B256

RedStone data feed id.

Custom(OracleSourceDescriptor)

Adapter-owned oracle source.

Implementations

impl FeedSource

pub fn aave_price_cap_stable( source: Address, underlying_proxy: Address, price_cap: I256, ) -> Self

Construct an Aave capped stable source transform.

pub fn aave_ratio_cap( source: Address, base_to_usd_proxy: Address, ratio_provider: Address, current_ratio: I256, max_ratio: I256, ratio_decimals: u8, ) -> Self

Construct an Aave ratio-cap/CAPO source transform.

pub fn aave_synchronicity_peg_to_base( source: Address, asset_to_peg_proxy: Address, asset_to_peg_aggregator: Address, asset_to_peg_answer: I256, asset_to_peg_decimals: u8, peg_to_base_proxy: Address, peg_to_base_aggregator: Address, peg_to_base_answer: I256, peg_to_base_decimals: u8, output_decimals: u8, ) -> Self

Construct an Aave peg-to-base synchronicity source transform.

pub fn aave_fixed_price(source: Address, price: I256) -> Self

Construct an Aave fixed-price source.

pub fn morpho_chainlink_v2( source: Address, base_vault_assets: I256, quote_vault_assets: I256, scale_factor: I256, feeds: Vec<MorphoChainlinkFeed>, ) -> Self

Construct a Morpho Blue Chainlink V2 source transform.

pub fn euler_quote( source: Address, base: Address, quote: Address, base_decimals: u8, quote_decimals: u8, leg: EulerQuoteLeg, ) -> Self

Construct an Euler quote source backed by one quote leg.

pub fn euler_cross( source: Address, base: Address, cross: Address, quote: Address, base_decimals: u8, cross_decimals: u8, quote_decimals: u8, base_cross: EulerQuoteLeg, cross_quote: EulerQuoteLeg, ) -> Self

Construct an Euler cross-adapter source backed by two quote legs.

pub fn pyth(pyth: Address, price_id: B256, expo: i32, conf: u64) -> Self

Construct a Pyth EVM source.

pub fn redstone_push( price_feed: Address, adapter: Address, data_feed_id: B256, ) -> Self

Available on crate feature redstone only.

Construct a RedStone push source.

pub fn custom(descriptor: OracleSourceDescriptor) -> Self

Construct an adapter-owned custom source.

Custom sources participate in Chainlink-style proxy reconciliation by default: Self::supports_proxy_reconciliation returns true for Custom, so reconciliation reads OracleSourceDescriptor::read_proxy with latestRoundData() after every accepted event (and during crate::OracleTracker::reconcile). The read_proxy address therefore must answer latestRoundData() or reconciliation will fail with crate::OracleError::Provider. There is currently no per-descriptor flag to opt a custom source out of this path — if the source is not Chainlink-shaped, point read_proxy at a contract that exposes a Chainlink-compatible latestRoundData() view for it.

pub fn is_identity(&self) -> bool

Return true when this source is a plain identity Chainlink source.

pub fn uses_builtin_chainlink_handler(&self) -> bool

Return true when the built-in Chainlink reactive handler should route this source.

pub fn supports_proxy_reconciliation(&self) -> bool

Return true when this source can be reconciled by reading a Chainlink proxy.

Sources that fail this predicate are either reconciled through their own protocol view (see Self::supports_derived_reconciliation) or not reconciled at all.

pub fn supports_derived_reconciliation(&self) -> bool

Return true when this source is reconciled by reading its own protocol view instead of a Chainlink proxy.

Morpho MorphoChainlinkOracleV2 sources re-read price() and Euler quote/cross sources re-read getQuote(one base unit, base, quote); both promote event-derived snapshots to Confirmed/Corrected through crate::OracleTracker::reconcile_derived_pending_with. Each family only participates when its adapter feature (morpho / euler) is enabled, so builds without the feature never queue derived requests they cannot serve.

pub fn read_proxy(&self, registration_proxy: Address) -> Address

Proxy that should be read for authoritative Chainlink round data.

pub fn event_aggregators( &self, current_aggregator: Option<Address>, ) -> Vec<Address>

Aggregators whose Chainlink events should drive this source.

pub fn event_value_source(&self) -> OracleValueSource

Source classification for a value produced from this source’s event path.

pub fn accepts_event_from( &self, current_aggregator: Option<Address>, aggregator: Address, ) -> bool

Return true when an event from aggregator is acceptable for this source.

pub fn wants_answer_updated_from( &self, current_aggregator: Option<Address>, aggregator: Address, ) -> bool

Return true when this source should use AnswerUpdated events for aggregator.

pub fn supports_direct_chainlink_storage_effects(&self) -> bool

Return true when Chainlink storage adapters can safely mirror this event.

pub fn normalize_answer(&self, answer: I256) -> I256

Apply the source transform to an event or read answer.

pub fn normalize_answer_from_event( &self, aggregator: Option<Address>, answer: I256, ) -> I256

Apply the source transform to an answer emitted by a specific dependency aggregator.

pub fn normalize_round(&self, round: RoundData) -> RoundData

Apply the source transform to round data.

pub fn pyth_source(&self) -> Option<(Address, B256, i32, u64)>

Return Pyth source fields for Pyth-backed registrations.

pub fn with_pyth_event_metadata( &self, price_id: B256, expo: i32, conf: u64, ) -> Option<Self>

Return this Pyth source with event-updated metadata.

Trait Implementations

impl Clone for FeedSource

fn clone(&self) -> FeedSource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FeedSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FeedSource

fn default() -> FeedSource

Returns the “default value” for a type.

impl Eq for FeedSource

impl PartialEq for FeedSource

fn eq(&self, other: &FeedSource) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FeedSource