Struct PollingConfig 

pub struct PollingConfig {
    pub max_attempts: u32,
    pub poll_interval_secs: u64,
}

Configuration for attestation polling behavior.

Controls how the bridge polls Circle’s Iris API for attestation availability. Use the builder methods to customize, or use preset configurations for common scenarios.

Examples

use cctp_rs::PollingConfig;

// Use defaults (30 attempts, 60 second intervals)
let config = PollingConfig::default();

// Customize polling behavior
let config = PollingConfig::default()
    .with_max_attempts(20)
    .with_poll_interval_secs(30);

// Use preset for fast transfers (30 attempts, 5 second intervals)
let config = PollingConfig::fast_transfer();

Fields

max_attempts: u32

Maximum number of polling attempts before giving up.

poll_interval_secs: u64

Seconds to wait between polling attempts.

Implementations

impl PollingConfig

pub fn fast_transfer() -> Self

Creates a polling configuration optimized for CCTP v2 fast transfers.

• max_attempts: 30
• poll_interval_secs: 5

Fast transfers typically complete in under 30 seconds, so this configuration polls more frequently with shorter intervals.

pub fn with_max_attempts(self, attempts: u32) -> Self

Sets the maximum number of polling attempts.

Arguments

• attempts - Maximum number of times to poll the attestation API

Example

use cctp_rs::PollingConfig;

let config = PollingConfig::default().with_max_attempts(60);
assert_eq!(config.max_attempts, 60);

pub fn with_poll_interval_secs(self, secs: u64) -> Self

Sets the interval between polling attempts in seconds.

Arguments

• secs - Seconds to wait between each polling attempt

Example

use cctp_rs::PollingConfig;

let config = PollingConfig::default().with_poll_interval_secs(30);
assert_eq!(config.poll_interval_secs, 30);

pub fn total_timeout_secs(&self) -> u64

Returns the total maximum wait time in seconds.

This is calculated as max_attempts * poll_interval_secs.

Example

use cctp_rs::PollingConfig;

let config = PollingConfig::default();
assert_eq!(config.total_timeout_secs(), 30 * 60); // 30 minutes

Trait Implementations

impl Clone for PollingConfig

fn clone(&self) -> PollingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PollingConfig

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

Formats the value using the given formatter.

impl Default for PollingConfig

fn default() -> Self

Creates a default polling configuration suitable for standard CCTP v1 transfers.

• max_attempts: 30
• poll_interval_secs: 60 (1 minute)

This results in a maximum wait time of ~30 minutes, which accommodates the typical 13-19 minute attestation time for v1 transfers.

impl PartialEq for PollingConfig

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PollingConfig

impl Eq for PollingConfig

impl StructuralPartialEq for PollingConfig