Check CCTP bridge transaction status

curl --request GET \
  --url https://api.enso.build/api/v1/cctp/bridge/check

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/cctp/bridge/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/cctp/bridge/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/cctp/bridge/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "sourceChainId": 143,
  "sourceTxHash": "0x4ac72089eef92b827702281bb2668b416ee6d3e9d953600dc363842e473a157c",
  "status": "pending",
  "destinationChainId": 1,
  "destinationTxHash": "<string>",
  "transferType": "fast",
  "delayReason": "insufficient_fee",
  "forward": {
    "state": "FAILED",
    "errorCode": "INSUFFICIENT_FEE",
    "errorDetails": "Fee provided insufficient for forwarding",
    "txHash": "<string>"
  },
  "depositForBurn": {
    "amount": "100000",
    "destinationDomain": 0,
    "mintRecipient": "0x00000000000000000000000042d023187acedd3306e3dce2f1b9e4a81d636503",
    "burnToken": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
    "destinationCaller": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "maxFee": "0",
    "minFinalityThreshold": 1000
  },
  "depositForBurnDecoded": {
    "burnToken": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "destinationChainId": 1,
    "mintRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
    "destinationCaller": "0x0000000000000000000000000000000000000000",
    "maxFee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "minFinalityThreshold": {
      "value": 1000,
      "type": "fast"
    },
    "finalityThresholdExecuted": {
      "value": 1000,
      "type": "fast"
    },
    "feeExecuted": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    }
  },
  "depositForBurnWithHook": {
    "amount": "100000",
    "destinationDomain": 0,
    "mintRecipient": "0x00000000000000000000000042d023187acedd3306e3dce2f1b9e4a81d636503",
    "burnToken": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
    "destinationCaller": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "maxFee": "0",
    "minFinalityThreshold": 1000,
    "hookData": "0x636374702d666f72776172640000000000000000000000000000000000000000"
  },
  "depositForBurnWithHookDecoded": {
    "burnToken": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "destinationChainId": 1,
    "mintRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
    "destinationCaller": "0x0000000000000000000000000000000000000000",
    "maxFee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "minFinalityThreshold": {
      "value": 1000,
      "type": "fast"
    },
    "hookData": {
      "raw": "0x636374702d666f72776172640000000000000000000000000000000000000000",
      "forwardingService": true,
      "hyperCoreTransfer": true,
      "hyperCoreRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
      "hyperCoreDestinationDex": 4294967295,
      "hyperCoreDestinationDexType": "spot"
    },
    "finalityThresholdExecuted": {
      "value": 1000,
      "type": "fast"
    },
    "feeExecuted": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    }
  },
  "ensoSourceEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "ensoDestinationEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "intent": {
    "requestId": "<string>",
    "executor": "<string>",
    "phase": "awaiting_funds",
    "status": "<string>",
    "source": "keeper",
    "executionChainId": 123,
    "statusDescription": "<string>",
    "deadline": "<string>",
    "executionTxHash": "<string>",
    "executionExplorerUrl": "<string>",
    "executedAt": "<string>",
    "refundTxHash": "<string>",
    "refundExplorerUrl": "<string>",
    "refundedAt": "<string>",
    "error": "<string>"
  },
  "destinationExecutionTxHash": "<string>",
  "error": "<string>"
}

GET

api

cctp

bridge

check

Check CCTP bridge transaction status

curl --request GET \
  --url https://api.enso.build/api/v1/cctp/bridge/check

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/cctp/bridge/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/cctp/bridge/check"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/cctp/bridge/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "sourceChainId": 143,
  "sourceTxHash": "0x4ac72089eef92b827702281bb2668b416ee6d3e9d953600dc363842e473a157c",
  "status": "pending",
  "destinationChainId": 1,
  "destinationTxHash": "<string>",
  "transferType": "fast",
  "delayReason": "insufficient_fee",
  "forward": {
    "state": "FAILED",
    "errorCode": "INSUFFICIENT_FEE",
    "errorDetails": "Fee provided insufficient for forwarding",
    "txHash": "<string>"
  },
  "depositForBurn": {
    "amount": "100000",
    "destinationDomain": 0,
    "mintRecipient": "0x00000000000000000000000042d023187acedd3306e3dce2f1b9e4a81d636503",
    "burnToken": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
    "destinationCaller": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "maxFee": "0",
    "minFinalityThreshold": 1000
  },
  "depositForBurnDecoded": {
    "burnToken": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "destinationChainId": 1,
    "mintRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
    "destinationCaller": "0x0000000000000000000000000000000000000000",
    "maxFee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "minFinalityThreshold": {
      "value": 1000,
      "type": "fast"
    },
    "finalityThresholdExecuted": {
      "value": 1000,
      "type": "fast"
    },
    "feeExecuted": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    }
  },
  "depositForBurnWithHook": {
    "amount": "100000",
    "destinationDomain": 0,
    "mintRecipient": "0x00000000000000000000000042d023187acedd3306e3dce2f1b9e4a81d636503",
    "burnToken": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
    "destinationCaller": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "maxFee": "0",
    "minFinalityThreshold": 1000,
    "hookData": "0x636374702d666f72776172640000000000000000000000000000000000000000"
  },
  "depositForBurnWithHookDecoded": {
    "burnToken": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "destinationChainId": 1,
    "mintRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
    "destinationCaller": "0x0000000000000000000000000000000000000000",
    "maxFee": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    },
    "minFinalityThreshold": {
      "value": 1000,
      "type": "fast"
    },
    "hookData": {
      "raw": "0x636374702d666f72776172640000000000000000000000000000000000000000",
      "forwardingService": true,
      "hyperCoreTransfer": true,
      "hyperCoreRecipient": "0x42d023187acedd3306e3dce2f1b9e4a81d636503",
      "hyperCoreDestinationDex": 4294967295,
      "hyperCoreDestinationDexType": "spot"
    },
    "finalityThresholdExecuted": {
      "value": 1000,
      "type": "fast"
    },
    "feeExecuted": {
      "token": {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 18
      },
      "amount": "1000000000000000000"
    }
  },
  "ensoSourceEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "ensoDestinationEvent": {
    "blockNumber": 123,
    "transactionHash": "<string>",
    "chainId": 123,
    "success": true,
    "accountId": "<string>",
    "requestId": "<string>",
    "error": "<string>",
    "refundDetails": {
      "token": "<string>",
      "amount": "<string>",
      "recipient": "<string>",
      "isNative": true
    }
  },
  "intent": {
    "requestId": "<string>",
    "executor": "<string>",
    "phase": "awaiting_funds",
    "status": "<string>",
    "source": "keeper",
    "executionChainId": 123,
    "statusDescription": "<string>",
    "deadline": "<string>",
    "executionTxHash": "<string>",
    "executionExplorerUrl": "<string>",
    "executedAt": "<string>",
    "refundTxHash": "<string>",
    "refundExplorerUrl": "<string>",
    "refundedAt": "<string>",
    "error": "<string>"
  },
  "destinationExecutionTxHash": "<string>",
  "error": "<string>"
}

Query Parameters

chainId

number

required

Chain ID of the source transaction

Example:

143

txHash

string

required

Transaction hash of the CCTP bridge transaction on source chain

Example:

"0x4ac72089eef92b827702281bb2668b416ee6d3e9d953600dc363842e473a157c"

Response

Bridge transaction status and details

sourceChainId

number

required

Source chain ID where the CCTP burn was initiated

Example:

143

sourceTxHash

string

required

Source chain transaction hash

Example:

"0x4ac72089eef92b827702281bb2668b416ee6d3e9d953600dc363842e473a157c"

status

enum<string>

required

Overall bridge status. ready_for_manual_execution: the burn is attested but the destination mint has not been executed — claim it via /api/v1/cctp/bridge/claim.

Available options:

pending,

inflight,

delivered,

failed,

ready_for_manual_execution,

unknown

destinationChainId

number

Destination chain ID where the mint occurs

Example:

1

destinationTxHash

string

Destination chain transaction hash (if mint has completed)

transferType

enum<string>

CCTP transfer type based on finalityThresholdExecuted: "fast" (<= 1000) or "standard" (>= 2000)

Available options:

fast,

standard

delayReason

string

Reason Circle reports for delayed message processing (insufficient_fee, amount_above_max, insufficient_allowance_available).

Example:

"insufficient_fee"

forward

object

Forwarding Service status for transfers with a forwarding hook (incl. HyperCore deposits). The bridge is only 'delivered' once the forward completes.

Show child attributes

depositForBurn

object

Raw depositForBurn function parameters. Present iff the source-chain call was plain depositForBurn (no hookData).

Show child attributes

depositForBurnDecoded

object

Decoded depositForBurn parameters with token metadata, chain IDs, and human-readable values.

Show child attributes

depositForBurnWithHook

object

Raw depositForBurnWithHook function parameters. Present iff the source-chain call was depositForBurnWithHook (non-empty hookData).

Show child attributes

depositForBurnWithHookDecoded

object

Decoded depositForBurnWithHook parameters with token metadata, chain IDs, and human-readable values.

Show child attributes

ensoSourceEvent

object | null

Enso shortcut event from source chain (ShortcutExecuted + execution result). Null if not found.

Show child attributes

ensoDestinationEvent

object | null

Enso shortcut event from the destination chain. Standard CCTP transfers carry none; on an intent route it is read from the keeper's execution transaction (destinationExecutionTxHash).

Show child attributes

intent

object

Present when the source transaction published a cross-chain intent: this bridge only delivers funds to the intent's ephemeral executor, and a keeper then executes the intent (or refunds it past its deadline) in a separate destination transaction. status: delivered means the bridge delivered the funds to the executor; the execution itself is reported here (phase, keeper status, execution / repayment transactions).

Show child attributes

destinationExecutionTxHash

string

The keeper's intent execution transaction on the destination chain, once executed - the transaction that performed the Enso swap. destinationTxHash is only the bridge delivery that funded the executor.

error

string

Error message if the check failed

Api Reference

Reference

Quoter Reference

Check CCTP bridge transaction status

Query Parameters

Response