Enum FinalityThreshold 

#[repr(u32)]
pub enum FinalityThreshold {
    Fast = 1_000,
    Standard = 2_000,
}

Finality threshold for CCTP v2 messages

Determines the level of finality required before Circle’s attestation service will sign a message. Lower thresholds enable faster transfers but may have slightly higher fees.

Examples

use cctp_rs::FinalityThreshold;

let fast = FinalityThreshold::Fast;
assert_eq!(fast.as_u32(), 1000);
assert_eq!(fast.name(), "Fast Transfer");

let standard = FinalityThreshold::Standard;
assert_eq!(standard.as_u32(), 2000);

Variants

Fast = 1_000

Fast Transfer - Attestation at confirmed block level (threshold: 1000)

• Settlement time: Under 30 seconds
• Fee: 0-14 basis points (chain-dependent)
• Use case: Time-sensitive operations, arbitrage, real-time DeFi

Standard = 2_000

Standard Transfer - Attestation at finalized block level (threshold: 2000)

• Settlement time: 13-19 minutes (same as v1)
• Fee: 0 basis points
• Use case: Non-urgent transfers, maximum security

Implementations

impl FinalityThreshold

pub const fn as_u32(self) -> u32

Returns the numeric threshold value

Example

use cctp_rs::FinalityThreshold;

assert_eq!(FinalityThreshold::Fast.as_u32(), 1000);
assert_eq!(FinalityThreshold::Standard.as_u32(), 2000);

pub const fn from_u32(value: u32) -> Option<Self>

Attempts to create a FinalityThreshold from a u32 value

Example

use cctp_rs::FinalityThreshold;

assert_eq!(
    FinalityThreshold::from_u32(1000),
    Some(FinalityThreshold::Fast)
);
assert_eq!(
    FinalityThreshold::from_u32(2000),
    Some(FinalityThreshold::Standard)
);
assert_eq!(FinalityThreshold::from_u32(1500), None);

pub const fn name(self) -> &'static str

Returns a descriptive name for this threshold

Example

use cctp_rs::FinalityThreshold;

assert_eq!(FinalityThreshold::Fast.name(), "Fast Transfer");
assert_eq!(FinalityThreshold::Standard.name(), "Standard Transfer");

pub const fn is_fast(self) -> bool

Returns true if this is a Fast Transfer threshold

Example

use cctp_rs::FinalityThreshold;

assert!(FinalityThreshold::Fast.is_fast());
assert!(!FinalityThreshold::Standard.is_fast());

pub const fn is_standard(self) -> bool

Returns true if this is a Standard Transfer threshold

Example

use cctp_rs::FinalityThreshold;

assert!(FinalityThreshold::Standard.is_standard());
assert!(!FinalityThreshold::Fast.is_standard());

Trait Implementations

impl Clone for FinalityThreshold

fn clone(&self) -> FinalityThreshold

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FinalityThreshold

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

Formats the value using the given formatter.

impl Default for FinalityThreshold

fn default() -> Self

Returns Standard as the default threshold

Standard transfers have no fees and are the safest option.

impl Display for FinalityThreshold

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

Formats the value using the given formatter.

impl From<FinalityThreshold> for u32

fn from(threshold: FinalityThreshold) -> Self

Converts to this type from the input type.

impl Hash for FinalityThreshold

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FinalityThreshold

fn eq(&self, other: &FinalityThreshold) -> 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 TryFrom<u32> for FinalityThreshold

type Error = InvalidFinalityThreshold

The type returned in the event of a conversion error.

fn try_from(value: u32) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for FinalityThreshold

impl Eq for FinalityThreshold

impl StructuralPartialEq for FinalityThreshold