cctp-rs 7.0.0

Type-safe Rust SDK for Circle's Cross-Chain Transfer Protocol (CCTP) v1 and v2 — bridge USDC across 11 v2-capable EVM chain families with fast transfer support; protocol parser recognizes all 21 announced CCTP v2 domain IDs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

// SPDX-FileCopyrightText: 2025 Semiotic AI, Inc.
//
// SPDX-License-Identifier: Apache-2.0
//! Core CCTP bridge implementation
//!
//! This module provides the primary types and functionality for bridging USDC across
//! chains using Circle's Cross-Chain Transfer Protocol (CCTP).

mod bridge_trait;
mod cctp;
mod config;
pub mod multicall;
mod transfer_mode;
mod v2;

pub use bridge_trait::CctpBridge;
pub use cctp::Cctp;
pub use config::PollingConfig;
pub use multicall::{batch_token_state, TokenState};
pub use transfer_mode::TransferMode;
pub use v2::{CctpV2, MintResult};

use crate::error::{AttestationFailureKind, CctpError};
use crate::spans;
use tracing::error;

pub(super) fn attestation_data_missing() -> CctpError {
    spans::record_error_with_context(
        "AttestationDataMissing",
        "Attestation status is complete but attestation field is null",
        Some("This indicates an unexpected API response format"),
    );
    error!(event = "attestation_data_missing");
    CctpError::AttestationFailed(AttestationFailureKind::AttestationMissing)
}

pub(super) fn attestation_api_reported_failed() -> CctpError {
    spans::record_error_with_context(
        "AttestationFailed",
        "Circle API returned failed status for attestation",
        Some("The message may be invalid or the source transaction may have failed"),
    );
    error!(event = "attestation_failed");
    CctpError::AttestationFailed(AttestationFailureKind::ApiReportedFailed)
}