Struct Cctp

pub struct Cctp<P: Provider<Ethereum> + Clone> { /* private fields */ }

CCTP v1 bridge implementation

This struct provides the core functionality for bridging USDC across chains using Circle’s Cross-Chain Transfer Protocol (CCTP).

Example

let bridge = Cctp::builder()
    .source_chain(NamedChain::Mainnet)
    .destination_chain(NamedChain::Arbitrum)
    .source_provider(ProviderBuilder::new().on_builtin("http://localhost:8545").await?)
    .destination_provider(ProviderBuilder::new().on_builtin("http://localhost:8546").await?)
    .recipient("0x...".parse()?)
    .build();

Implementations

impl<P: Provider<Ethereum> + Clone> Cctp<P>

pub fn builder() -> CctpBuilder<P>

Create an instance of Cctp using the builder syntax

impl<P: Provider<Ethereum> + Clone> Cctp<P>

pub fn api_url(&self) -> &'static str

Returns the CCTP API URL for the current environment

pub fn source_chain(&self) -> &NamedChain

Returns the source chain

pub fn destination_chain(&self) -> &NamedChain

Returns the destination chain

pub fn destination_domain_id(&self) -> Result<u32>

Returns the destination domain id

pub fn source_provider(&self) -> &P

Returns the source provider

pub fn destination_provider(&self) -> &P

Returns the destination provider

pub fn token_messenger_contract(&self) -> Result<Address>

Returns the CCTP token messenger contract, the address of the contract that handles the deposit and burn of USDC

pub fn message_transmitter_contract(&self) -> Result<Address>

Returns the CCTP message transmitter contract, the address of the contract that handles the receipt of messages

pub fn recipient(&self) -> &Address

Returns the recipient address

pub fn iris_api_url(&self, message_hash: &FixedBytes<32>) -> String

Constructs the Iris API URL for a given message hash

Arguments

• message_hash - The message hash to query

Returns

The full URL to query the attestation status

pub async fn get_message_sent_event( &self, tx_hash: TxHash, ) -> Result<(Vec<u8>, FixedBytes<32>)>

Gets the MessageSent event data from a CCTP bridge transaction

Arguments

• tx_hash: The hash of the transaction to get the MessageSent event for

Returns

Returns the message bytes and its hash

pub async fn get_attestation_with_retry( &self, message_hash: FixedBytes<32>, max_attempts: Option<u32>, poll_interval: Option<u64>, ) -> Result<AttestationBytes>

Gets the attestation for a message hash from the CCTP API

Arguments

• message_hash: The hash of the message to get the attestation for
• max_attempts: Maximum number of polling attempts (default: 30)
• poll_interval: Time to wait between polling attempts in seconds (default: 60)

Returns

The attestation bytes if successful

pub fn create_url(&self, message_hash: FixedBytes<32>) -> String

See https://developers.circle.com/stablecoins/cctp-apis

pub async fn get_attestation( &self, client: &Client, url: &str, ) -> Result<Response>

Gets the attestation for a message hash from the CCTP API

Arguments

• client: The HTTP client to use
• url: The URL to get the attestation from

Trait Implementations

impl<P: Clone + Provider<Ethereum> + Clone> Clone for Cctp<P>

fn clone(&self) -> Cctp<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug + Provider<Ethereum> + Clone> Debug for Cctp<P>

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

Formats the value using the given formatter.