Enum OracleError 

#[non_exhaustive]
pub enum OracleError {
    Provider(String),
    Decode(ChainlinkEventDecodeError),
    SignalDecode(OracleSignalDecodeError),
    DuplicateFeedId(String),
    DuplicateProxy(Address),
    FeedNotFound,
    Policy(PricePolicyViolation),
    CodePolicy(Box<OracleCodePolicyViolation>),
    Config(OracleConfigError),
    Unsupported(String),
    FeedSkipped(Box<OracleFeedSkip>),
    Reactive(String),
}

Errors returned by registry, reconciliation, and report application.

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.

Provider(String)

A chain/provider read failed.

This covers only genuine on-chain read failures: RPC transport errors, reverted or undecodable view calls (call_sol), and crate::EvmCacheChainlinkReader read failures. Programming errors, policy rejections, and unsupported-source classifications use the dedicated variants below.

Decode(ChainlinkEventDecodeError)

Event or typed-field decode failed.

Covers Chainlink log decoding and value-range failures where a chain value does not fit the crate’s typed representation (for example a latestRoundData() timestamp that overflows u64, reported as ChainlinkEventDecodeError::Uint64Overflow).

SignalDecode(OracleSignalDecodeError)

Hook signal decode failed.

DuplicateFeedId(String)

Feed id already exists.

DuplicateProxy(Address)

Proxy already exists.

FeedNotFound

A feed was not found.

Policy(PricePolicyViolation)

A configured price policy rejected a value or result.

Covers crate::PricePolicy rejections (stale, pending, invalid, or wrong-denomination prices) and valuation failures while producing a crate::ValuedAmount. The payload classifies the exact violation. Code warmup policy failures use OracleError::CodePolicy.

CodePolicy(Box<OracleCodePolicyViolation>)

The configured crate::OracleCodeWarmupPolicy rejected a code warmup report.

The boxed payload lists exactly the crate::OracleCodeWarmupReport entries that violated the enforced policy toggles.

Config(OracleConfigError)

Caller or programming error.

The payload classifies the failure: a request that references an adapter that is not installed (OracleConfigError::AdapterNotInstalled), a system clock before the UNIX epoch (OracleConfigError::Clock), a malformed or mismatched overlay/reconciliation request (OracleConfigError::InvalidRequest), or another invalid builder configuration or internal invariant violation (OracleConfigError::Other).

Unsupported(String)

A source family, layout, or value shape was recognized but is not supported by this crate.

Covers unsupported adapter variants discovered at runtime (for example an unknown Euler adapter name, a nested CrossAdapter, or a base/quote direction mismatch) and chain values that cannot be represented in the requested ABI or fixed-point shape.

FeedSkipped(Box<OracleFeedSkip>)

An adapter feed skip was surfaced as a fail-fast build error.

The boxed payload carries the complete skip description (feed id/label, proxy, and classified crate::OracleAdapterSkipReason). Use the build_report methods to receive skips as data instead of an error.

Reactive(String)

A reactive-engine operation failed.

Covers handler install/uninstall, subscriber interest registration, and batch ingestion errors surfaced through the evm_fork_cache::reactive runtime.

Trait Implementations

impl Clone for OracleError

fn clone(&self) -> OracleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OracleError

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

Formats the value using the given formatter.

impl Display for OracleError

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

Formats the value using the given formatter.

impl Eq for OracleError

impl Error for OracleError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ChainlinkEventDecodeError> for OracleError

fn from(source: ChainlinkEventDecodeError) -> Self

Converts to this type from the input type.

impl From<OracleConfigError> for OracleError

fn from(source: OracleConfigError) -> Self

Converts to this type from the input type.

impl From<OracleMockError> for OracleError

fn from(value: OracleMockError) -> Self

Converts to this type from the input type.

impl From<OracleSignalDecodeError> for OracleError

fn from(source: OracleSignalDecodeError) -> Self

Converts to this type from the input type.

impl From<PricePolicyViolation> for OracleError

fn from(source: PricePolicyViolation) -> Self

Converts to this type from the input type.

impl PartialEq for OracleError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OracleError