Check bridge transaction status

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

const options = {method: 'GET'};

fetch('https://api.enso.build/api/v1/layerzero/bridge/check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/layerzero/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/layerzero/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/layerzero/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": 123,
  "sourceTxHash": "<string>",
  "status": "pending",
  "destinationChainId": 123,
  "destinationTxHash": "<string>",
  "isMultiBridge": true,
  "hops": [
    {
      "sourceChainId": 123,
      "sourceTxHash": "<string>",
      "status": "pending",
      "destinationChainId": 123,
      "destinationTxHash": "<string>",
      "layerZeroMessage": {
        "srcEid": 123,
        "dstEid": 123,
        "status": "<string>",
        "srcChainId": 123,
        "dstChainId": 123,
        "srcTxHash": "<string>",
        "dstTxHash": "<string>",
        "srcBlockNumber": 123,
        "dstBlockNumber": 123,
        "srcTimestamp": "<string>",
        "dstTimestamp": "<string>",
        "sender": "<string>",
        "receiver": "<string>"
      },
      "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
        }
      }
    }
  ],
  "layerZeroMessage": {
    "srcEid": 123,
    "dstEid": 123,
    "status": "<string>",
    "srcChainId": 123,
    "dstChainId": 123,
    "srcTxHash": "<string>",
    "dstTxHash": "<string>",
    "srcBlockNumber": 123,
    "dstBlockNumber": 123,
    "srcTimestamp": "<string>",
    "dstTimestamp": "<string>",
    "sender": "<string>",
    "receiver": "<string>"
  },
  "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
    }
  },
  "ensoMetadata": {
    "tokenIn": "<string>",
    "tokenOut": "<string>",
    "amountIn": "<string>",
    "chainId": 123,
    "timestamp": 123
  },
  "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

layerzero

bridge

check

Check bridge transaction status

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

const options = {method: 'GET'};

fetch('https://api.enso.build/api/v1/layerzero/bridge/check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/layerzero/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/layerzero/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/layerzero/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": 123,
  "sourceTxHash": "<string>",
  "status": "pending",
  "destinationChainId": 123,
  "destinationTxHash": "<string>",
  "isMultiBridge": true,
  "hops": [
    {
      "sourceChainId": 123,
      "sourceTxHash": "<string>",
      "status": "pending",
      "destinationChainId": 123,
      "destinationTxHash": "<string>",
      "layerZeroMessage": {
        "srcEid": 123,
        "dstEid": 123,
        "status": "<string>",
        "srcChainId": 123,
        "dstChainId": 123,
        "srcTxHash": "<string>",
        "dstTxHash": "<string>",
        "srcBlockNumber": 123,
        "dstBlockNumber": 123,
        "srcTimestamp": "<string>",
        "dstTimestamp": "<string>",
        "sender": "<string>",
        "receiver": "<string>"
      },
      "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
        }
      }
    }
  ],
  "layerZeroMessage": {
    "srcEid": 123,
    "dstEid": 123,
    "status": "<string>",
    "srcChainId": 123,
    "dstChainId": 123,
    "srcTxHash": "<string>",
    "dstTxHash": "<string>",
    "srcBlockNumber": 123,
    "dstBlockNumber": 123,
    "srcTimestamp": "<string>",
    "dstTimestamp": "<string>",
    "sender": "<string>",
    "receiver": "<string>"
  },
  "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
    }
  },
  "ensoMetadata": {
    "tokenIn": "<string>",
    "tokenOut": "<string>",
    "amountIn": "<string>",
    "chainId": 123,
    "timestamp": 123
  },
  "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

txHash

string

required

Transaction hash

Example:

"0x1234567890abcdef..."

Response

Bridge transaction status and details

sourceChainId

number

required

Source chain ID

sourceTxHash

string

required

Source transaction hash

status

enum<string>

required

Overall bridge status

Available options:

pending,

inflight,

delivered,

failed,

ready_for_manual_execution,

unknown

destinationChainId

number

Destination chain ID (if known)

destinationTxHash

string

Destination transaction hash (if completed)

isMultiBridge

boolean

Whether this transaction involves multiple sequential bridges. Only present when true.

hops

object[]

Array of individual bridge hops. Only present for multi-bridge transactions.

Show child attributes

layerZeroMessage

object

LayerZero message information

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 destination chain (ShortcutExecuted + execution result). Null if not found. On an intent route this is read from the keeper's execution transaction (destinationExecutionTxHash), not from the bridge delivery.

Show child attributes

ensoMetadata

object

Enso transaction metadata

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 something went wrong

Api Reference

Reference

Quoter Reference

Check bridge transaction status

Query Parameters

Response