Check Relay bridge transaction status

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/relay/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/relay/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/relay/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": 1,
  "sourceTxHash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
  "status": "pending",
  "destinationChainId": 8453,
  "destinationTxHash": "0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d",
  "refundChainId": 42161,
  "refundTxHash": "<string>",
  "relayRequest": {
    "status": "success",
    "user": "0x1234567890123456789012345678901234567890",
    "recipient": "0x1234567890123456789012345678901234567890",
    "inTxs": [
      {
        "hash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
        "chainId": 8453,
        "block": 12345678,
        "timestamp": 1700000000,
        "status": "success"
      }
    ],
    "outTxs": [
      {
        "hash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
        "chainId": 8453,
        "block": 12345678,
        "timestamp": 1700000000,
        "status": "success"
      }
    ],
    "currency": {
      "chainId": 1,
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6
    },
    "fees": {
      "gas": "50000000000000",
      "fixed": "0",
      "price": "100000",
      "gateway": "0"
    },
    "feesUsd": {
      "gas": "50000000000000",
      "fixed": "0",
      "price": "100000",
      "gateway": "0"
    },
    "failReason": "EXECUTION_REVERTED",
    "createdAt": "2024-01-15T12:00:00Z",
    "updatedAt": "2024-01-15T12:05:00Z"
  },
  "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": "Transaction receipt not found for 0x..."
}

GET

api

relay

bridge

check

Check Relay bridge transaction status

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/relay/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/relay/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/relay/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": 1,
  "sourceTxHash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
  "status": "pending",
  "destinationChainId": 8453,
  "destinationTxHash": "0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d",
  "refundChainId": 42161,
  "refundTxHash": "<string>",
  "relayRequest": {
    "status": "success",
    "user": "0x1234567890123456789012345678901234567890",
    "recipient": "0x1234567890123456789012345678901234567890",
    "inTxs": [
      {
        "hash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
        "chainId": 8453,
        "block": 12345678,
        "timestamp": 1700000000,
        "status": "success"
      }
    ],
    "outTxs": [
      {
        "hash": "0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4",
        "chainId": 8453,
        "block": 12345678,
        "timestamp": 1700000000,
        "status": "success"
      }
    ],
    "currency": {
      "chainId": 1,
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6
    },
    "fees": {
      "gas": "50000000000000",
      "fixed": "0",
      "price": "100000",
      "gateway": "0"
    },
    "feesUsd": {
      "gas": "50000000000000",
      "fixed": "0",
      "price": "100000",
      "gateway": "0"
    },
    "failReason": "EXECUTION_REVERTED",
    "createdAt": "2024-01-15T12:00:00Z",
    "updatedAt": "2024-01-15T12:05:00Z"
  },
  "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": "Transaction receipt not found for 0x..."
}

Query Parameters

chainId

number

required

Chain ID of the source transaction

Example:

1

txHash

string

required

Transaction hash of the Relay bridge transaction on source chain

Example:

"0x94e5ea92d395fc8969b3253395ce58d51b27781c7305376d494f0804b109a8b5"

Response

Bridge transaction status and details

sourceChainId

number

required

Source chain ID where the Relay message was sent from

Example:

1

sourceTxHash

string

required

Source chain transaction hash

Example:

"0x80f1faf0652a5618ea1de0fc5142418e380676b3c6c74d482cfac1237638d6d4"

status

enum<string>

required

Overall bridge status

Available options:

pending,

inflight,

delivered,

failed,

unknown

destinationChainId

number

Destination chain ID where the Relay message was delivered

Example:

8453

destinationTxHash

string

Destination chain transaction hash (if message was delivered)

Example:

"0x9a3e6a8a52b82a1f4b523b0d50be133df0ad9407814b32e42d67119e1ae1947d"

refundChainId

number

Chain the funds were refunded on — the origin chain — present when the request was refunded instead of delivered. destinationChainId then names the intended destination and destinationTxHash is absent (nothing arrived there).

Example:

42161

refundTxHash

string

The refund payout transaction, present when the request was refunded instead of delivered

relayRequest

object

Relay API request data with fee breakdown and status details

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

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 API request failed (e.g., transaction not found, API errors)

Example:

"Transaction receipt not found for 0x..."

Api Reference

Reference

Quoter Reference

Check Relay bridge transaction status

Query Parameters

Response