Python (SDK)

from compass_api_sdk import CompassAPI


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.bridge.cctp_mint(bridge_id="br_cae305798062", burn_tx_hash="0x42c914b870eacc2c1734420f6ab183f95a5b0e0fdbb1c82247183848b76fc8ad", sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B")

    # Handle response
    print(res)

{
  "bridge_id": "<string>",
  "transaction": {
    "chainId": "<string>",
    "data": "<string>",
    "from": "<string>",
    "gas": "<string>",
    "to": "<string>",
    "value": "<string>",
    "nonce": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "status": "ready"
}

Bridge

Complete USDC bridging

Prepare a receiveMessage transaction to mint USDC to any Product Account on the destination chain.

How it works:

This endpoint uses the bridge_id from /burn to:

Look up the bridge session
Check if Circle’s attestation is ready
Depending on the status of the attestation return the following:
- if attestation is still pending, return URLs for real-time updates
- if attestation is ready, return a transaction to complete the bridging process
- if the minting for a given bridge_id has been completed, informs with completed status

Request parameters:

bridge_id: The bridge ID returned from /burn
burn_tx_hash: The transaction hash of the burn transaction on the source chain

Response codes:

200 OK: Attestation is ready, mint transaction is included
202 Accepted: Attestation is pending, SSE URL for real-time updates is included (The real-time update endpoints are in progress)
404 Not found: Bridge not found

After receiving 202:

Either:

Connect to the SSE stream at sse_url and wait for attestation_ready event (The SSE stream and status endpoint are in progress. Keep an eye on the updates from our team)
Poll this endpoint periodically until you get 200

POST

cctp

mint

Python (SDK)

from compass_api_sdk import CompassAPI


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.bridge.cctp_mint(bridge_id="br_cae305798062", burn_tx_hash="0x42c914b870eacc2c1734420f6ab183f95a5b0e0fdbb1c82247183848b76fc8ad", sender="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B")

    # Handle response
    print(res)

{
  "bridge_id": "<string>",
  "transaction": {
    "chainId": "<string>",
    "data": "<string>",
    "from": "<string>",
    "gas": "<string>",
    "to": "<string>",
    "value": "<string>",
    "nonce": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "status": "ready"
}

Authorizations

x-api-key

string

header

required

Your Compass API Key. Get your key here.

Body

application/json

bridge_id

string

required

The bridge identifier returned from /burn endpoint. This is used to look up the bridge session.

burn_tx_hash

string

required

The transaction hash of the burn transaction on the source chain. This is used to find the DepositForBurn event and extract the CCTP message.

sender

string

required

The wallet address that will sign and send the mint transaction. This can be any wallet, the receiver of the minted USDC is not determined by this sender.

Response

Attestation ready with mint transaction, or bridge already completed

MintPrepareReadyResponse
MintPrepareCompletedResponse

Response when attestation is ready and mint transaction can be built.

Returned with 200 OK status code. Contains an unsigned transaction that calls receiveMessage on the MessageTransmitter contract.

bridge_id

string

required

The bridge identifier.

transaction

UnsignedTransaction · object

required

Unsigned transaction that calls receiveMessage on the MessageTransmitter contract. Sign and broadcast this to mint USDC on the destination chain.

Show child attributes

transaction.chainId

string

required

The chain id of the transaction

transaction.data

string

required

The data of the transaction

transaction.from

string

required

The sender of the transaction

transaction.gas

string | null

required

The gas of the transaction

transaction.to

string

required

The recipient of the transaction

transaction.value

string

required

The value of the transaction

transaction.nonce

string

required

The nonce of the address

transaction.maxFeePerGas

string

required

The max fee per gas of the transaction

transaction.maxPriorityFeePerGas

string

required

The max priority fee per gas of the transaction

status

string

default:ready

Indicates the attestation is ready and mint transaction is available.

Allowed value: "ready"

Initiate USDC bridging

⌘I

API Reference

Authorizations

Body

Response