Struct OracleCacheRuntimeBuilder 

pub struct OracleCacheRuntimeBuilder { /* private fields */ }

Cache-native runtime builder with first-class oracle adapter plugins.

Implementations

impl OracleCacheRuntimeBuilder

pub fn install_adapter<A>(self, adapter: A) -> Self

where A: OracleAdapterPlugin + 'static,

Install one oracle adapter plugin.

pub fn now_timestamp(self, now_timestamp: u64) -> Self

Set a fixed timestamp for deterministic registration status classification.

pub fn storage_adapter<A>(self, adapter: A) -> Self

where A: OracleStorageAdapter + 'static,

Add one storage adapter.

pub fn storage_sync(self, storage_sync: OracleStorageSync) -> Self

Replace the storage-sync registry.

pub fn storage_warmup(self, enabled: bool) -> Self

Enable or disable oracle storage warmup during cache-native builds.

Enabled by default. When enabled, the builder asks installed storage adapters which slots must be hot for direct event writes and bulk-loads them through the cache before returning the runtime.

pub fn storage_warmup_mode(self, mode: OracleStorageWarmupMode) -> Self

Set the oracle storage warmup mode.

pub fn storage_cold_start(self) -> Self

Use EvmCache::run_cold_start for declared oracle storage slots.

pub fn disable_storage_warmup(self) -> Self

Disable oracle storage warmup.

pub fn code_registry(self, registry: OracleCodeRegistry) -> Self

Replace the bytecode seed/etch registry.

pub fn code_warmup_policy(self, policy: OracleCodeWarmupPolicy) -> Self

Set the bytecode warmup failure policy.

pub fn code_seed(self, address: Address, code: Bytes) -> Self

Add a canonical bytecode seed that must verify against on-chain code hash.

pub fn code_seeds<I>(self, seeds: I) -> Self

where I: IntoIterator<Item = (Address, Bytes)>,

Add multiple canonical bytecode seeds that must verify against chain code hash.

pub fn code_etch(self, address: Address, code: Bytes) -> Self

Add explicit simulation-only bytecode at address.

pub fn code_etches<I>(self, etches: I) -> Self

where I: IntoIterator<Item = (Address, Bytes)>,

Add multiple explicit simulation-only bytecode etches.

pub fn on_event<F>(self, callback: F) -> Self

where F: Fn(&OracleHookEvent) + Send + Sync + 'static,

Subscribe to every typed oracle event emitted by this runtime.

pub fn on_price_update<F>(self, callback: F) -> Self

where F: Fn(&OraclePriceUpdate) + Send + Sync + 'static,

Subscribe to immediate event-derived price updates.

pub async fn build( self, cache: &mut EvmCache, ) -> Result<OracleRuntime<()>, OracleError>

Register adapter-discovered feeds and construct the runtime.

Errors

Returns OracleError::FeedSkipped when any adapter reported a skipped feed (use Self::build_report to receive skips as data), OracleError::Policy when code warmup fails the configured OracleCodeWarmupPolicy, OracleError::Provider when adapter discovery reads fail, OracleError::DuplicateFeedId/ OracleError::DuplicateProxy when discovered feeds collide, and OracleError::Config when the system clock is before the UNIX epoch and no now_timestamp was set.

pub async fn build_report( self, cache: &mut EvmCache, ) -> Result<OracleCacheRuntimeBuildReport, OracleError>

Register every compatible adapter feed and return skipped feeds instead of failing fast.

Trait Implementations

impl Default for OracleCacheRuntimeBuilder

fn default() -> Self

Returns the “default value” for a type.