Struct RetryLayer 

pub struct RetryLayer { /* private fields */ }

A Tower layer that adds retry logic with exponential backoff to RPC requests.

This layer wraps each RPC request and automatically retries on transient failures using exponential backoff. The backoff formula is:

delay = min(base_delay * 2^attempt, max_delay)

Example

use semioscan::transport::RetryLayer;
use alloy_rpc_client::ClientBuilder;
use std::time::Duration;

// Retry up to 3 times with exponential backoff
let layer = RetryLayer::new();

// Or with custom configuration
let layer = RetryLayer::builder()
    .max_retries(5)
    .base_delay(Duration::from_millis(200))
    .max_delay(Duration::from_secs(60))
    .build();

let client = ClientBuilder::default()
    .layer(layer)
    .http(rpc_url);

Implementations

impl RetryLayer

pub fn new() -> Self

Creates a new retry layer with default settings.

Default settings:

• 3 retry attempts
• 100ms base delay
• 30s maximum delay

Example

use semioscan::transport::RetryLayer;

let layer = RetryLayer::new();

pub fn builder() -> RetryLayerBuilder

Creates a builder for customizing retry configuration.

Example

use semioscan::transport::RetryLayer;
use std::time::Duration;

let layer = RetryLayer::builder()
    .max_retries(5)
    .base_delay(Duration::from_millis(200))
    .build();

pub fn with_max_retries(max_retries: u32) -> Self

Creates a retry layer with a specific number of retries.

Uses default base and max delays.

Example

use semioscan::transport::RetryLayer;

// Retry up to 5 times
let layer = RetryLayer::with_max_retries(5);

pub fn aggressive() -> Self

Creates a retry layer with aggressive retry settings.

This preset uses:

• 5 retry attempts
• 50ms base delay
• 10s maximum delay

Suitable for high-availability scenarios where quick retries are needed.

Example

use semioscan::transport::RetryLayer;

let layer = RetryLayer::aggressive();

pub fn conservative() -> Self

Creates a retry layer with conservative retry settings.

This preset uses:

• 3 retry attempts
• 500ms base delay
• 60s maximum delay

Suitable for scenarios where RPC endpoints may need time to recover.

Example

use semioscan::transport::RetryLayer;

let layer = RetryLayer::conservative();

Trait Implementations

impl Clone for RetryLayer

fn clone(&self) -> RetryLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryLayer

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

Formats the value using the given formatter.

impl Default for RetryLayer

fn default() -> Self

Returns the “default value” for a type.

impl<S> Layer<S> for RetryLayer

type Service = RetryService<S>

The wrapped service

fn layer(&self, service: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.