Struct OfferLayer 

#[non_exhaustive]
pub struct OfferLayer<P> {
    pub provider: P,
    pub config: OfferLayerConfig,
    pub price_provider: Option<PriceProviderArc>,
}

Available on non-target_os=zkvm only.

A layer responsible for configuring the offer part of a proof request.

This layer uses an Ethereum provider to estimate gas costs and sets appropriate pricing parameters for the proof request. It combines cycle count estimates with gas price information to determine minimum and maximum prices for the request.

If a price provider is configured, it will be used to fetch market prices when OfferParams doesn’t explicitly set min_price or max_price.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

provider: P

The Ethereum provider used for gas price estimation.

config: OfferLayerConfig

Configuration for offer generation.

price_provider: Option<PriceProviderArc>

Optional price provider for fetching market-based prices. If set, will be used when OfferParams doesn’t specify prices.

Implementations

impl<P> OfferLayer<P>

where P: Provider<Ethereum> + 'static + Clone,

pub fn new(provider: P, config: OfferLayerConfig) -> Self

Creates a new OfferLayer with the given provider and configuration.

The provider is used to fetch current gas prices for estimating transaction costs, which are factored into the offer pricing.

pub fn with_price_provider( self, price_provider: Option<PriceProviderArc>, ) -> Self

Set the price provider for the OfferLayer.

The price provider will be used to fetch market prices when OfferParams doesn’t explicitly set min_price or max_price.

Parameters

• price_provider: The price provider to use.

Returns

A new OfferLayer with the price provider set.

pub fn estimate_gas_usage_upper_bound( &self, requirements: &Requirements, request_id: &RequestId, ) -> Result<u64>

Estimates the maximum gas usage for a proof request.

This calculates the upper bound of gas usage based on the request’s requirements, configuration settings, and request ID characteristics.

The estimate includes gas for locking, fulfilling, signature verification, callback execution, and proof verification.

pub fn estimate_gas_cost_upper_bound( &self, requirements: &Requirements, request_id: &RequestId, gas_price: u128, ) -> Result<U256>

Estimates the maximum gas cost for a proof request.

This calculates the cost in wei based on the estimated gas usage and the provided gas price.

The result is used to determine appropriate pricing parameters for the proof request offer.

pub async fn max_price_with_gas( &self, requirements: &Requirements, request_id: &RequestId, max_price: U256, ) -> Result<U256>

Computes max price as cycle-based price plus 2x current gas cost estimate.

Fetches gas price from the provider, estimates gas cost for the request, and returns the sum with max_price_cycle.

Trait Implementations

impl<P> Adapt<OfferLayer<P>> for RequestParams

where P: Provider<Ethereum> + 'static + Clone,

type Output = RequestParams

The output type after processing by the layer.

type Error = Error

Error type that may be returned during processing.

async fn process_with( self, layer: &OfferLayer<P>, ) -> Result<Self::Output, Self::Error>

Processes this value with the provided layer.

impl<P: Clone> Clone for OfferLayer<P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Clone> From<P> for OfferLayer<P>

fn from(provider: P) -> Self

Converts to this type from the input type.

impl<P> Layer<(&Requirements, &RequestId, Option<u64>, &OfferParams)> for OfferLayer<P>

where P: Provider<Ethereum> + 'static + Clone,

type Output = Offer

The output type produced by this layer.

type Error = Error

Error type that may be returned by this layer.

async fn process( &self, __arg1: (&Requirements, &RequestId, Option<u64>, &OfferParams), ) -> Result<Self::Output, Self::Error>

Processes the input and returns the transformed output.